Trevor Johns 682c24e228 Resolve merge conflicts of a5060ee to nyc-dev
This undoes the automerger skip which occured in
commit e740c84dc32180214a7fd157105d6c18d30408ee and
replays it as a standard (NOT -s ours) merge.

Change-Id: If5a47be26f73d6a0735c425cd66310a3e2a89086
2016-04-19 02:03:59 -07:00

102 lines
2.9 KiB
Plaintext
Executable File

page.title=Adding the App Bar
page.tags="appbar","actionbar"
helpoutsWidget=true
trainingnavtop=true
startpage=true
@jd:body
<div id="tb-wrapper">
<div id="tb">
<h2>You should also read</h2>
<ul>
<li><a href="{@docRoot}training/implementing-navigation/index.html">
Implementing Effective Navigation</a></li>
<li><a href="http://www.google.com/design/spec/layout/structure.html#structure-app-bar">
Material Design: App Bar</a></li>
</ul>
</div>
</div>
<p>
The <em>app bar</em>, also known as the <em>action bar</em>, is one of the most
important design elements in your app's activities, because
it provides a visual structure and interactive elements that are familiar to
users. Using the app bar makes your app consistent with other Android apps,
allowing users to quickly understand how to operate your app and have a great
experience.
The key functions of the app bar
are as follows:
</p>
<ul>
<li>A dedicated space for giving your app an identity and indicating the
user's location in the app.
</li>
<li>Access to important actions in a predictable way, such as search.
</li>
<li>Support for navigation and view switching (with tabs or drop-down lists).
</li>
</ul>
<img src="{@docRoot}images/training/appbar/appbar_sheets_2x.png"
srcset="{@docRoot}images/training/appbar/appbar_sheets.png 1x,
{@docRoot}images/training/appbar/appbar_sheets_2x.png 2x"
width="400" alt="" />
<p>
This class describes how to use the
<a href="{@docRoot}tools/support-library/features.html#v7-appcompat">v7
appcompat</a> support library's {@link
android.support.v7.widget.Toolbar} widget as an app bar. There are other ways
to implement an app bar—for example, some themes set up an {@link
android.app.ActionBar} as an app bar by default—but using the appcompat
{@link android.support.v7.widget.Toolbar} makes it easy to set up an app bar
that works on the widest range of devices, and also gives you room to
customize your app bar later on as your app develops.
</p>
<h2>Lessons</h2>
<dl>
<dt>
<b><a href="setting-up.html">Setting Up the App Bar</a></b>
</dt>
<dd>
Learn how to add a {@link android.support.v7.widget.Toolbar} widget to your
activity, and set it as the activity's app bar.
</dd>
<dt>
<b><a href="actions.html">Adding and Handling Actions</a></b>
</dt>
<dd>
Learn how to add actions to the app bar and its overflow menu, and how to
respond when users choose those actions.
</dd>
<dt>
<b><a href="up-action.html">Adding an Up Action</a></b>
</dt>
<dd>
Learn how to add an <em>Up</em> button to your app bar, so users
can navigate back to the app's home screen.
</dd>
<dt>
<b><a href="action-views.html">Action Views and Action Providers</a></b>
</dt>
<dd>
Learn how to use these widgets to provide advanced functionality in your
app bar.
</dd>
</dl>