Skip to content
This repository was archived by the owner on Sep 5, 2024. It is now read-only.

Commit ae8997a

Browse files
topherfangiohansl
authored andcommitted
docs(navbar): Add mdNavBar note to tab docs. (#9472)
Some users are unaware of the new `<md-nav-bar>` component which can provide a better option for page-level navigation. - Update tabs demo and docs to include a note about, and link to, the `<md-nav-bar>` component demo & docs. - Update some tab docs with proper line wrapping to follow our standards. Fixes #6676
1 parent d0a7765 commit ae8997a

File tree

2 files changed

+27
-7
lines changed

2 files changed

+27
-7
lines changed
Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,11 @@
1-
<p>The Dynamic Height demo shows how tabs can be used to display content with varying heights.</p>
1+
<p>
2+
The Dynamic Height demo shows how tabs can be used to display content with varying heights.
3+
</p>
4+
5+
<p>
6+
<i>
7+
<b>Note:</b> If you are using the Tabs component for page-level navigation, please take a look
8+
at the <a href="./demo/navBar">NavBar component</a> instead as it can handle this case a bit
9+
more natively.
10+
</i>
11+
</p>

src/components/tabs/js/tabsDirective.js

Lines changed: 16 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,10 @@
66
* @restrict E
77
*
88
* @description
9-
* The `<md-tabs>` directive serves as the container for 1..n `<md-tab>` child directives to produces a Tabs components.
10-
* In turn, the nested `<md-tab>` directive is used to specify a tab label for the **header button** and a [optional] tab view
11-
* content that will be associated with each tab button.
9+
* The `<md-tabs>` directive serves as the container for 1..n `<md-tab>` child directives to
10+
* produces a Tabs components. In turn, the nested `<md-tab>` directive is used to specify a tab
11+
* label for the **header button** and a [optional] tab view content that will be associated with
12+
* each tab button.
1213
*
1314
* Below is the markup for its simplest usage:
1415
*
@@ -26,9 +27,18 @@
2627
* 2. Tabs with internal view content
2728
* 3. Tabs with external view content
2829
*
29-
* **Tab-only** support is useful when tab buttons are used for custom navigation regardless of any other components, content, or views.
30-
* **Tabs with internal views** are the traditional usages where each tab has associated view content and the view switching is managed internally by the Tabs component.
31-
* **Tabs with external view content** is often useful when content associated with each tab is independently managed and data-binding notifications announce tab selection changes.
30+
* **Tab-only** support is useful when tab buttons are used for custom navigation regardless of any
31+
* other components, content, or views.
32+
*
33+
* <i><b>Note:</b> If you are using the Tabs component for page-level navigation, please take a look
34+
* at the <a ng-href="./api/directive/mdNavBar">NavBar component</a> instead as it can handle this
35+
* case a bit more natively.</i>
36+
*
37+
* **Tabs with internal views** are the traditional usages where each tab has associated view
38+
* content and the view switching is managed internally by the Tabs component.
39+
*
40+
* **Tabs with external view content** is often useful when content associated with each tab is
41+
* independently managed and data-binding notifications announce tab selection changes.
3242
*
3343
* Additional features also include:
3444
*

0 commit comments

Comments
 (0)