• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1page.title=App Structure
2page.tags=navigation,layout,tablet
3@jd:body
4
5    <p>Apps come in many varieties that address very different needs. For example:</p>
6<ul>
7<li>Apps such as Calculator or Camera that are built around a single focused activity handled from a
8  single screen</li>
9<li>Apps such as Phone whose main purpose is to switch between different activities without deeper
10  navigation</li>
11<li>Apps such as Gmail or the Play Store that combine a broad set of data views with deep navigation</li>
12</ul>
13<p>Your app's structure depends largely on the content and tasks you want to surface for your users.</p>
14<h2 id="general-structure">General Structure</h2>
15
16<p>A typical Android app consists of top level and detail/edit views. If the navigation hierarchy is
17deep and complex, category views connect top level and detail views.</p>
18
19<div class="layout-content-row">
20  <div class="layout-content-col span-9">
21
22    <img src="{@docRoot}design/media/app_structure_overview.png">
23
24  </div>
25  <div class="layout-content-col span-4">
26
27<h4>Top level views</h4>
28<p>The top level of the app typically consists of the different views that your app supports. The views
29either show different representations of the same data or expose an altogether different functional
30facet of your app.</p>
31<div class="vspace size-3">&nbsp;</div>
32
33<h4>Category views</h4>
34<p>Category views allow you to drill deeper into your data.</p>
35<div class="vspace size-11">&nbsp;</div>
36
37<h4>Detail/edit view</h4>
38<p>The detail/edit view is where you consume or create data.</p>
39
40  </div>
41</div>
42
43<h2 id="top-level">Top Level</h2>
44
45<p>The layout of your start screen requires special attention. This is the first screen people see
46after launching your app, so it should be an equally rewarding experience for new and frequent
47visitors alike.</p>
48<p>Ask yourself: "What are my typical users most likely going to want to do in my app?", and structure
49your start screen experience accordingly.</p>
50
51<div class="layout-content-row">
52  <div class="layout-content-col span-5">
53
54<h4>Put content forward</h4>
55<p>Many apps focus on the content display. Avoid navigation-only screens and instead let people get to
56the meat of your app right away by making content the centerpiece of your start screen. Choose
57layouts that are visually engaging and appropriate for the data type and screen size.</p>
58
59  </div>
60  <div class="layout-content-col span-8">
61
62    <img src="{@docRoot}design/media/app_structure_market.png">
63    <div class="figure-caption">
64      Play Music allows navigation among artists, albums, and playlists through rich content display.
65      It is also enriched with tailored recommendations and promotions that surface content of interest
66      to the user. Search is readily available from the action bar.
67    </div>
68
69  </div>
70</div>
71
72<h4>Set up action bars for navigation and actions</h4>
73
74<div class="layout-content-row">
75  <div class="layout-content-col span-5">
76
77  <p>All screens in your app should display action bars to provide consistent navigation and surface
78important actions.</p>
79    <p>At the top level, special considerations apply to the action bar:</p>
80  <ul>
81    <li>Use the action bar to display your app's icon or title.</li>
82    <li>If your top level consists of multiple views, make sure that it's easy for the user to navigate between them by adding view controls to your action bar.</li>
83    <li>If your app allows people to create content, consider making the content accessible right from the
84  top level.</li>
85        <li>If your content is searchable, include the Search action in the action bar so people can cut
86  through the navigation hierarchy.</li>
87    </ul>
88
89  </div>
90  <div class="layout-content-col span-8">
91
92    <img src="{@docRoot}design/media/app_structure_gmail.png">
93    <div class="figure-caption">
94      A calendar is about productivity, so an efficient, easy-to-skim view with higher data density works
95      well. Navigation supports switching views of day, week, month, and agenda views.
96    </div>
97
98  </div>
99</div>
100
101<h2 id="top-level-switching">Top Level Switching With View Controls</h2>
102<p>The top level communicates your app’s capabilities by introducing the user to the major functional areas. In many cases the top level will consist of multiple views, and you need to make sure that the user can navigate between them efficiently. Android supports a number of view controls for this task. Use the control that best matches your app's navigation needs:</p>
103
104<h4>Fixed tabs</h4>
105<div class="layout-content-row">
106  <div class="layout-content-col span-6">
107<p><em>Fixed tabs</em> display top-level views concurrently and make it easy to explore and switch between them. They are always visible on the screen, and can't be moved out of the way like scrollable tabs. <em>Fixed tabs</em> should always allow the user to navigate between the views by swiping left or right on the content area.</p>
108<p><strong>Use tabs if</strong>:</p>
109<ul>
110<li>You expect your app's users to switch views frequently.</li>
111<li>You have a limited number of up to three top-level views.</li>
112<li>You want the user to be highly aware of the alternate views.</li>
113</ul>
114
115  </div>
116  <div class="layout-content-col span-7">
117
118    <img src="{@docRoot}design/media/app_structure_default_tabs.png">
119    <div class="figure-caption">
120      Default fixed tabs shown in Holo Dark &amp; Light.
121    </div>
122
123  </div>
124</div>
125
126<div class="layout-content-row">
127  <div class="layout-content-col span-6">
128
129<h4>Spinners</h4>
130<p>A <em>spinner</em> is a drop-down menu that allows users to switch between views of your app. </p>
131<p><strong>Use a spinner in the main action bar if</strong>:</p>
132<ul>
133<li>You don't want to give up the vertical screen real estate for a dedicated tab bar.</li>
134<li>The user is switching between views of the same data set (for example: calendar events viewed by day, week, or month) or data sets of the same type (such as content for two different accounts).</li>
135</ul>
136
137  </div>
138  <div class="layout-content-col span-7">
139
140    <img src="{@docRoot}design/media/app_structure_spinner.png">
141    <div class="figure-caption">
142      Action bar spinner from Calendar application.
143    </div>
144
145  </div>
146</div>
147
148<h4>Navigation drawers</h4>
149<div class="layout-content-row">
150  <div class="layout-content-col span-6">
151<p>A <em>navigation drawer</em> is a slide-out menu that allows users to switch between views of your app. It can hold a large number of items and is accessible from anywhere in your app. Navigation drawers show your app's top-level views, but can also provide navigation to lower-level screens. This makes them particularly suitable for complex apps.</p>
152
153<p><strong>Use navigation drawers if</strong>:</p>
154<ul>
155<li>You don't want to give up the vertical screen real estate for a dedicated tab bar.</li>
156<li>You have a large number of top-level views.</li>
157<li>You want to provide direct access to screens on lower levels.</li>
158<li>You want to provide quick navigation to views which don't have direct relationships between each other.</li>
159<li>You have particularly deep navigation branches.</li>
160</ul>
161
162  </div>
163  <div class="layout-content-col span-7">
164    <img src="{@docRoot}design/media/app_structure_drawer.png">
165    <div class="figure-caption">
166      Navigation drawer from the Keep app.
167    </div>
168  </div>
169</div>
170
171<h4>Don't mix and match</h4>
172<p>After choosing the best top-level navigation for your app, don't mix and match patterns. For example, if you decide to use tabs for top-level switching, don't add a drawer, even if your navigation branches are deep. In this case, the navigation drawer would simply duplicate the information on the tabs, confusing your users.</p>
173
174<h2 id="categories">Categories</h2>
175
176<p>Generally, the purpose of a deep, data-driven app is to navigate through organizational categories
177to the detail level, where data can be viewed and managed. Minimize perceived navigation effort by
178keeping your apps shallow.</p>
179<p>Even though the number of vertical navigation steps from the top level down to the detail views is
180typically dictated by the structure of your app's content, there are several ways you can cut down
181on the perception of onerous navigation.</p>
182<h4>Use tabs to combine category selection and data display</h4>
183<p>This can be successful if the categories are familiar or the number of categories is small. It has
184the advantage that a level of hierarchy is removed and data remains at the center of the user's
185attention. Navigating laterally between data-rich categories is more akin to a casual browsing
186experience than to an explicit navigation step.</p>
187
188<div class="vspace size-1">&nbsp;</div>
189
190<div class="layout-content-row">
191  <div class="layout-content-col span-8">
192
193<p>If the categories are familiar, predictable, or closely related, use scrolling tabs (where not all
194items are in view simultaneously). Keep the number of scrolling tabs at a manageable level to
195minimize navigational effort. Rule of thumb: no more than 5&ndash;7 tabs.</p>
196
197    <img src="{@docRoot}design/media/app_structure_scrolltabs.png">
198    <div class="figure-caption">
199      The Play Store app uses tabs to simultaneously show category choice and content. To navigate
200      between categories, users can swipe left/right on the content.
201    </div>
202
203  </div>
204  <div class="layout-content-col span-5">
205
206<p>If the categories in the tabs are not closely related, favor fixed tabs, so that all categories are
207in view at the same time.</p>
208
209    <img src="{@docRoot}design/media/app_structure_fixedtabs.png">
210    <div class="figure-caption">
211      People uses fixed tabs to switch between different, relatively unrelated functional areas.
212    </div>
213
214
215  </div>
216</div>
217
218<p>For more discussion, see the <a href="{@docRoot}design/building-blocks/tabs.html">Tabs</a>
219design guide.</p>
220
221
222<h4>Allow cutting through hierarchies</h4>
223<p>Take advantage of shortcuts that allow people to reach their goals quicker. To allow top-level
224invocation of actions for a data item from within list or grid views, display prominent actions
225directly on list view items using drop-downs or split list items. This lets people invoke actions on
226data without having to navigate all the way down the hierarchy.</p>
227
228<img src="{@docRoot}design/media/app_structure_shortcut_on_item.png">
229<div class="figure-caption">
230  Music allows the user to act upon a data item (song) from within the category view (album),
231  thereby removing the need to navigate all the way down to the song's detail view.
232</div>
233
234<h4>Acting upon multiple data items</h4>
235<p>Even though category views mostly serve to guide people to content detail, keep in mind that there
236are often good reasons to act on collections of data as well.</p>
237<p>For example, if you allow people to delete an item in a detail view, you should also allow them to
238delete multiple items in the category view. Analyze which detail view actions are applicable to
239collections of items. Then use multi-select to allow application of those actions to multiple items
240in a category view.</p>
241
242
243<p>For more discussion, see the <a href="{@docRoot}design/patterns/selection.html">Selection</a>
244design guide.</p>
245
246
247<h2 id="details">Details</h2>
248
249<p>The detail view allows you to view and act on your data. The layout of the detail view depends on the data type being displayed, and therefore differs widely among apps.</p>
250
251<div class="layout-content-row">
252  <div class="layout-content-col span-4">
253
254<h4>Layout</h4>
255<p>Consider the activities people will perform in the detail view and arrange the layout accordingly.</p>
256
257  </div>
258  <div class="layout-content-col span-9">
259
260    <img src="{@docRoot}design/media/app_structure_people_detail.png">
261
262    <div class="figure-caption">
263      The purpose of the People app's detail view is to surface communication options. The list view
264      allows for efficient scanning and quick access of phone numbers, email addresses and other
265      information items. Split items are used to combine calling and messaging into one compact line
266      item.
267    </div>
268  </div>
269</div>
270
271
272<h4>Make navigation between detail views efficient</h4>
273<p>If your users are likely to want to look at multiple items in sequence, allow them to navigate
274between items from within the detail view. Use swipe views or other techniques, such as thumbnail view controls,
275to achieve this.</p>
276
277<img src="{@docRoot}design/media/app_structure_gmail_swipe.png">
278<div class="figure-caption">
279  Gmail using swipe views to navigate from detail view to detail view.
280</div>
281
282<img src="{@docRoot}design/media/app_structure_gallery_filmstrip.png">
283<div class="figure-caption">
284  In addition to supporting swipe gestures to move left or right through pages, Magazines provides a
285  thumbnail view control that lets people quickly jump to specific pages.
286</div>
287
288<p>For more discussion, see the <a href="{@docRoot}design/patterns/swipe-views.html">Swipe Views</a>
289design guide.</p>
290
291
292<h2 id="checklist">Checklist</h2>
293
294<ul>
295<li>
296<p>Find ways to display useful content on your start screen.</p>
297</li>
298<li>
299<p>Use action bars to provide consistent navigation.</p>
300</li>
301<li>
302<p>Keep your hierarchies shallow by using horizontal navigation and shortcuts.</p>
303</li>
304<li>
305<p>Use multi-select to allow the user to act on collections of data.</p>
306</li>
307<li>
308<p>Allow for quick navigation between detail items with swipe views.</p>
309</li>
310</ul>
311