Skip to content

Commit 3ba792c

Browse files
committed
docs: Update designing-navigation training class to link to Android Design
Change-Id: I1cdda032f31798f9a32b7bec583dcfaa6eafb8c2
1 parent 5e5b57a commit 3ba792c

File tree

5 files changed

+56
-9
lines changed

5 files changed

+56
-9
lines changed

docs/html/training/design-navigation/ancestral-temporal.jd

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,7 @@ next.link=wireframing.html
2121

2222
<h2>You should also read</h2>
2323
<ul>
24+
<li><a href="{@docRoot}design/patterns/navigation.html">Android Design: Navigation</a></li>
2425
<li><a href="{@docRoot}guide/topics/fundamentals/tasks-and-back-stack.html">Tasks and Back Stack</a></li>
2526
</ul>
2627

@@ -30,6 +31,11 @@ next.link=wireframing.html
3031

3132
<p>Now that users can navigate <a href="descendant-lateral.html">deep into</a> the application's screen hierarchy, we need to provide a method for navigating up the hierarchy, to parent and ancestor screens. Additionally, we should ensure that temporal navigation via the BACK button is respected to respect Android conventions.</p>
3233

34+
<div class="design-announce">
35+
<p><strong>Back/Up Navigation Design</strong></p>
36+
<p>For design guidelines, read Android Design's <a
37+
href="{@docRoot}design/patterns/navigation.html">Navigation</a> pattern guide.</p>
38+
</div>
3339

3440
<h2 id="temporal-navigation">Support Temporal Navigation: <em>Back</em></h2>
3541

@@ -49,7 +55,7 @@ next.link=wireframing.html
4955

5056
<h2 id="ancestral-navigation">Provide Ancestral Navigation: <em>Up</em> and <em>Home</em></h2>
5157

52-
<p>Before Android 3.0, the most common form of ancestral navigation was the <em>Home</em> metaphor. This was generally implemented as a <em>Home</em> item accessible via the device's MENU button, or a <em>Home</em> button at the top-left of the screen, usually as a component of the <a href="{@docRoot}guide/topics/ui/actionbar.html">Action Bar</a>. Upon selecting <em>Home</em>, the user would be taken to the screen at the top of the screen hierarchy, generally known as the application's home screen.</p>
58+
<p>Before Android 3.0, the most common form of ancestral navigation was the <em>Home</em> metaphor. This was generally implemented as a <em>Home</em> item accessible via the device's MENU button, or a <em>Home</em> button at the top-left of the screen, usually as a component of the Action Bar (<a href="{@docRoot}design/patterns/actionbar.html">pattern docs</a> at Android Design). Upon selecting <em>Home</em>, the user would be taken to the screen at the top of the screen hierarchy, generally known as the application's home screen.</p>
5359

5460
<p>Providing direct access to the application's home screen can give the user a sense of comfort and security. Regardless of where they are in the application, if they get lost in the app, they can select <em>Home</em> to arrive back at the familiar home screen.</p>
5561

docs/html/training/design-navigation/descendant-lateral.jd

Lines changed: 38 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,18 @@ next.link=ancestral-temporal.html
1818
<li><a href="#buttons">Buttons and Simple Targets</a></li>
1919
<li><a href="#lists">Lists, Grids, Carousels, and Stacks</a></li>
2020
<li><a href="#tabs">Tabs</a></li>
21-
<li><a href="#paging">Horizontal Paging</a></li>
21+
<li><a href="#paging">Horizontal Paging (Swipe Views)</a></li>
2222
</ol>
2323

24+
<h2>You should also read</h2>
25+
<ul>
26+
<li><a href="{@docRoot}design/building-blocks/buttons.html">Android Design: Buttons</a></li>
27+
<li><a href="{@docRoot}design/building-blocks/lists.html">Android Design: Lists</a></li>
28+
<li><a href="{@docRoot}design/building-blocks/grid-lists.html">Android Design: Grid Lists</a></li>
29+
<li><a href="{@docRoot}design/building-blocks/tabs.html">Android Design: Tabs</a></li>
30+
<li><a href="{@docRoot}design/patterns/swipe-views.html">Android Design: Swipe Views</a></li>
31+
</ul>
32+
2433
</div>
2534
</div>
2635

@@ -48,6 +57,12 @@ next.link=ancestral-temporal.html
4857

4958
<h2 id="buttons">Buttons and Simple Targets</h2>
5059

60+
<div class="design-announce">
61+
<p><strong>Button Design</strong></p>
62+
<p>For design guidelines, read Android Design's <a
63+
href="{@docRoot}design/building-blocks/buttons.html">Buttons</a> guide.</p>
64+
</div>
65+
5166
<p>For section-related screens, offering touchable and keyboard-focusable targets in the parent is generally the most straightforward and familiar kind of touch-based navigation interface. Examples of such targets include buttons, fixed-size list views, or text links, although the latter is not an ideal UI (user interface) element for touch-based navigation. Upon selecting one of these targets, the child screen is opened, replacing the current context (screen) entirely. Buttons and other simple targets are rarely used for representing items in a collection.</p>
5267

5368

@@ -64,6 +79,13 @@ next.link=ancestral-temporal.html
6479

6580
<h2 id="lists">Lists, Grids, Carousels, and Stacks</h2>
6681

82+
<div class="design-announce">
83+
<p><strong>List and Grid List Design</strong></p>
84+
<p>For design guidelines, read Android Design's <a
85+
href="{@docRoot}design/building-blocks/lists.html">Lists</a> and <a
86+
href="{@docRoot}design/building-blocks/grid-lists.html">Grid Lists</a> guides.</p>
87+
</div>
88+
6789
<p>For collection-related screens, and especially for textual information, vertically scrolling lists are often the most straightforward and familiar kind of interface. For more visual or media-rich content items such as photos or videos, vertically scrolling grids of items, horizontally scrolling lists (sometimes referred to as <em>carousels</em>), or stacks (sometimes referred to as <em>cards</em>) can be used instead. These UI elements are generally best used for presenting item collections or large sets of child screens (for example, a list of stories or a list of 10 or more news topics), rather than a small set of unrelated, sibling child screens.</p>
6890

6991

@@ -80,6 +102,12 @@ next.link=ancestral-temporal.html
80102

81103
<h2 id="tabs">Tabs</h2>
82104

105+
<div class="design-announce">
106+
<p><strong>Tab Design</strong></p>
107+
<p>For design guidelines, read Android Design's <a
108+
href="{@docRoot}design/building-blocks/tabs.html">Tabs</a> guide.</p>
109+
</div>
110+
83111
<p>Using tabs is a very popular solution for lateral navigation. This pattern allows grouping of sibling screens, in that the tab content container in the parent screen can embed child screens that otherwise would be entirely separate contexts. Tabs are most appropriate for small sets (4 or fewer) of section-related screens.</p>
84112

85113

@@ -89,7 +117,7 @@ next.link=ancestral-temporal.html
89117
<p class="img-caption"><strong>Figure 5.</strong> Example phone and tablet tab-based navigation interfaces with relevant screen map excerpt.</p>
90118

91119

92-
<p>Several best practices apply when using tabs. Tabs should be persistent across immediate related screens. Only the designated content region should change when selecting a tab, and tab indicators should remain available at all times. Additionally, tab switches should not be treated as history. For example, if a user switches from a tab <em>A</em> to another tab <em>B</em>, pressing the BACK button (more on that in the <a href="ancestral-temporal.html">next lesson</a>) should not re-select tab <em>A</em>. Tabs are usually laid out horizontally, although other presentations of tab navigation such as using a drop-down list in the <a href="{@docRoot}guide/topics/ui/actionbar.html">Action Bar</a> are sometimes appropriate. Lastly, and most importantly, <em>tabs should always run along the top of the screen</em>, and should not be aligned to the bottom of the screen.</p>
120+
<p>Several best practices apply when using tabs. Tabs should be persistent across immediate related screens. Only the designated content region should change when selecting a tab, and tab indicators should remain available at all times. Additionally, tab switches should not be treated as history. For example, if a user switches from a tab <em>A</em> to another tab <em>B</em>, pressing the BACK button (more on that in the <a href="ancestral-temporal.html">next lesson</a>) should not re-select tab <em>A</em>. Tabs are usually laid out horizontally, although other presentations of tab navigation such as using a drop-down list in the Action Bar (<a href="{@docRoot}design/patterns/actionbar.html">pattern docs</a> at Android Design) are sometimes appropriate. Lastly, and most importantly, <em>tabs should always run along the top of the screen</em>, and should not be aligned to the bottom of the screen.</p>
93121

94122
<p>There are some obvious immediate benefits of tabs over simpler list- and button-based navigation:</p>
95123

@@ -101,9 +129,15 @@ next.link=ancestral-temporal.html
101129
<p>A common criticism is that space must be reserved for the tab indicators, detracting from the space available to tab contents. This consequence is usually acceptable, and the tradeoff commonly weighs in favor of using this pattern. You should also feel free to customize tab indicators, showing text and/or icons to make optimal use of vertical space. When adjusting indicator heights however, ensure that tab indicators are large enough for a human finger to touch without error.</p>
102130

103131

104-
<h2 id="paging">Horizontal Paging</h2>
132+
<h2 id="paging">Horizontal Paging (Swipe Views)</h2>
133+
134+
<div class="design-announce">
135+
<p><strong>Swipe Views Design</strong></p>
136+
<p>For design guidelines, read Android Design's <a
137+
href="{@docRoot}design/patterns/swipe-views.html">Swipe Views</a> pattern guides.</p>
138+
</div>
105139

106-
<p>Another popular lateral navigation pattern is horizontal paging. This pattern applies best to collection-related sibling screens, such as a list of categories (world, business, technology, and health stories). Like tabs, this pattern also allows grouping screens in that the parent presents the contents of child screens embedded within its own layout.</p>
140+
<p>Another popular lateral navigation pattern is horizontal paging, also referred to as swipe views. This pattern applies best to collection-related sibling screens, such as a list of categories (world, business, technology, and health stories). Like tabs, this pattern also allows grouping screens in that the parent presents the contents of child screens embedded within its own layout.</p>
107141

108142

109143
<img src="{@docRoot}images/training/app-navigation-descendant-lateral-paging.png"

docs/html/training/design-navigation/index.jd

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ next.link=screen-planning.html
1414

1515
<p>This class is not specific to any particular version of the Android platform. It is also primarily design-focused and does not require knowledge of the Android SDK. That said, you should have experience using an Android device for a better understanding of the context in which Android applications run.</p>
1616

17-
<p>You should also have basic familiarity with the <a href="{@docRoot}guide/topics/ui/actionbar.html">Action Bar</a>, used across most applications in devices running Android 3.0 and later.</p>
17+
<p>You should also have basic familiarity with the Action Bar (<a href="{@docRoot}design/patterns/actionbar.html">pattern docs</a> at Android Design), used across most applications in devices running Android 3.0 and later.</p>
1818

1919

2020
</div>

docs/html/training/design-navigation/multiple-sizes.jd

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,7 @@ next.link=descendant-lateral.html
2222

2323
<h2>You should also read</h2>
2424
<ul>
25+
<li><a href="{@docRoot}design/patterns/multi-pane-layouts.html">Android Design: Multi-pane Layouts</a></li>
2526
<li><a href="{@docRoot}training/multiscreen/index.html">Designing for Multiple Screens</a></li>
2627
</ul>
2728

@@ -35,6 +36,12 @@ next.link=descendant-lateral.html
3536

3637
<h2 id="multi-pane-layouts">Group Screens with Multi-pane Layouts</h2>
3738

39+
<div class="design-announce">
40+
<p><strong>Multi-pane Layout Design</strong></p>
41+
<p>For design guidelines, read Android Design's <a
42+
href="{@docRoot}design/patterns/multi-pane-layouts.html">Multi-pane Layouts</a> pattern guide.</p>
43+
</div>
44+
3845
<p>3 to 4-inch screens are generally only suitable for showing a single vertical pane of content at a time, be it a list of items, or detail information about an item, etc. Thus on such devices, screens generally map one-to-one with levels in the information hierarchy (<em>categories</em> &rarr; <em>object list</em> &rarr; <em>object detail</em>).</p>
3946

4047
<p>Larger screens such as those found on tablets and TVs, on the other hand, generally have much more available screen space and are able to present multiple panes of content. In landscape, panes are usually ordered from left to right in increasing detail order. Users are especially accustomed to multiple panes on larger screens from years and years of desktop application and desktop web site use. Many desktop applications and websites offer a left-hand navigation pane or use a master/detail two-pane layout.</p>
@@ -76,12 +83,12 @@ next.link=descendant-lateral.html
7683
<li><strong>Expand/collapse</strong>
7784
<img src="{@docRoot}images/training/app-navigation-multiple-sizes-strategy-collapse.png"
7885
alt="Expand/collapse strategy">
79-
<p>A variation on the stretch strategy is to collapse the contents of the left pane when in portrait. This works quite well with master/detail panes where the left (master) pane contains easily collapsible list items. An example would be for a realtime chat application. In landscape, the left list could contain chat contact photos, names, and online statuses. In portrait, horizontal space could be collapsed by hiding contact names and only showing photos and online status indicator icons.</p></li>
86+
<p>A variation on the stretch strategy is to collapse the contents of the left pane when in portrait. This works quite well with master/detail panes where the left (master) pane contains easily collapsible list items. An example would be for a realtime chat application. In landscape, the left list could contain chat contact photos, names, and online statuses. In portrait, horizontal space could be collapsed by hiding contact names and only showing photos and online status indicator icons. Optionally also provide an expand control that allows the user to expand the left pane content to its larger width and vice versa.</p></li>
8087

8188
<li><strong>Show/Hide</strong>
8289
<img src="{@docRoot}images/training/app-navigation-multiple-sizes-strategy-show-hide.png"
8390
alt="Show/Hide strategy">
84-
<p>In this scenario, the left pane is completely hidden in portrait mode. However, <em>to ensure the functional parity</em> of your screen in portrait and landscape, the left pane should be made available via an onscreen affordance (such as a button). It's usually appropriate to use the <em>Up</em> button in the <a href="{@docRoot}guide/topics/ui/actionbar.html">Action Bar</a> to show the left pane, as is discussed in a <a href="ancestral-temporal.html">later lesson</a>.</p></li>
91+
<p>In this scenario, the left pane is completely hidden in portrait mode. However, <em>to ensure the functional parity</em> of your screen in portrait and landscape, the left pane should be made available via an onscreen affordance (such as a button). It's usually appropriate to use the <em>Up</em> button in the Action Bar (<a href="{@docRoot}design/patterns/actionbar.html">pattern docs</a> at Android Design) to show the left pane, as is discussed in a <a href="ancestral-temporal.html">later lesson</a>.</p></li>
8592

8693
<li><strong>Stack</strong>
8794
<img src="{@docRoot}images/training/app-navigation-multiple-sizes-strategy-stack.png"

docs/html/training/design-navigation/wireframing.jd

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -121,5 +121,5 @@ previous.link=ancestral-temporal.html
121121
<li><a href="{@docRoot}guide/topics/ui/index.html">Developer's Guide: User Interface</a>: learn how to implement your user interface designs using the Android SDK.</li>
122122
<li><a href="{@docRoot}guide/topics/ui/actionbar.html">Action Bar</a>: implement tabs, up navigation, on-screen actions, etc.
123123
<li><a href="{@docRoot}guide/topics/fundamentals/fragments.html">Fragments</a>: implement re-usable, multi-pane layouts
124-
<li><a href="{@docRoot}sdk/compatibility-library.html">Support Library</a>: implement horizontal paging using <code>ViewPager</code></li>
124+
<li><a href="{@docRoot}sdk/compatibility-library.html">Support Library</a>: implement horizontal paging (swipe views) using <code>ViewPager</code></li>
125125
</ul>

0 commit comments

Comments
 (0)