22c024657d
Replaces the existing action views/action providers section in the (soon to be removed) "ActionBar API Guide" page. Builds on http://ag/730414 (which covers the basic app bar topics). Some of the action providers doc is being moved into the Javadoc reference for appropriate classes--that's being tracked with CL http://ag/748902 See comment on patch set 2 for doc stage location. Change-Id: Ia62b5155d7f67dc8922fc11917a12a957bf27fb1
108 lines
3.0 KiB
Plaintext
108 lines
3.0 KiB
Plaintext
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>Dependencies and prerequisites</h2>
|
|
<ul>
|
|
<li>Android 2.1 (API level 7) or higher</li>
|
|
</ul>
|
|
|
|
|
|
<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>
|