Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: Review the User Interface section for the L API Preview

Browse Source 
Change-Id: Ied0002d5c4b0a29919be28f2feb04a419c563160
This commit is contained in:
Ricardo Cervera
2014-06-15 16:01:28 -07:00
parent d6beebffe4
commit d3e426bebd
1 changed files with 22 additions and 24 deletions
Download Patch File Download Diff File Expand all files Collapse all files

44
docs/html/preview/api-overview.jd
View File

@@ -170,26 +170,24 @@ information.</p>
<h3 id="MaterialDesign">Material design support</h3> <h3 id="MaterialDesign">Material design support</h3>
<p>L adds support for the material design style. You can create <p>The L Developer Preview adds support for the material design style. You can create
material design apps that are visually dynamic and have UI element transitions material design apps that are visually dynamic and have UI element transitions
which feel natural and delightful to users. This support includes:</p> which feel natural and delightful to users. This support includes:</p>
<ul> <ul>
<li>Material design theme <li>The Material theme</li>
<li>View shadows <li>View shadows</li>
<li>{@code RecyclerView} widget <li>The {@code RecyclerView} widget</li>
<li>Drawable animation and styling effects <li>Drawable animation and styling effects</li>
<li>Material design animation and activity transitions effects <li>Material design animation and activity transition effects</li>
<li>Ability to define animators to run on the view, with <li>Animators for view properties based on the state of a view</li>
{@code android.animation.StateListAnimator}. <li>Customizable UI widgets and app bars with color palettes that you control</li>
<li>Ability to change your status bar color to match the action bar and other
UI elements with {@code android.view.Window.setStatusBarColor()}.
</ul> </ul>
<p>To learn more about adding material design functionality to your app, see <p>To learn more about adding material design functionality to your app, see
<a href="{@docRoot}preview/material/index.html">Material design on Android</a>.</p> <a href="{@docRoot}preview/material/index.html">Material design on Android</a>.</p>
<h3 id="LockscreenNotifications">Lockscreen notifications</h3> <h3 id="LockscreenNotifications">Lockscreen notifications</h3>
<p>Lockscreens in L Developer Preview have the ability to present notifications. <p>Lockscreens in the L Developer Preview have the ability to present notifications.
User can choose via <em>Settings</em> whether to allow sensitive notification Users can choose via <em>Settings</em> whether to allow sensitive notification
content to be shown over a secure lockscreen.</p> content to be shown over a secure lockscreen.</p>
<p>Your app can control the level of detail visible when its notifications are <p>Your app can control the level of detail visible when its notifications are
@@ -200,35 +198,35 @@ values:</p>
<li>{@code VISIBILITY_PRIVATE}. Shows basic information, such as the <li>{@code VISIBILITY_PRIVATE}. Shows basic information, such as the
notification’s icon, but hides the notification’s full content. If you want to notification’s icon, but hides the notification’s full content. If you want to
provide a redacted public version of your notification for the system to display provide a redacted public version of your notification for the system to display
on a secure lockscreen, set the public notification object in the publicVersion on a secure lockscreen, set the public notification object in the <code>publicVersion</code>
field. field.</li>
<li>{@code VISIBILITY_PUBLIC}. Shows the notification’s full content. This is <li>{@code VISIBILITY_PUBLIC}. Shows the notification’s full content. This is
the system default if visibility is left unspecified. the system default if visibility is left unspecified.</li>
<li>{@code VISIBILITY_SECRET}. Shows only the most minimal information, <li>{@code VISIBILITY_SECRET}. Shows only the most minimal information,
excluding even the notification’s icon. excluding even the notification’s icon.</li>
</ul> </ul>
<h3 id="NotificationsMetadata">Notifications metadata</h3> <h3 id="NotificationsMetadata">Notifications metadata</h3>
<p>The L Developer Preview uses metadata associated with your app notifications <p>The L Developer Preview uses metadata associated with your app notifications
to more intelligently sort your notifications. The metadata you set also to more intelligently sort your notifications. The metadata you set also
controls how the system presents your app notifications when the user is in Do controls how the system presents your app notifications when the user is in <em>Do
not disturb mode. When constructing your notification, you can call the not disturb</em> mode. When constructing your notification, you can call the
following methods in {@code android.app.Notification.Builder}:</p> following methods in {@code android.app.Notification.Builder}:</p>
<ul> <ul>
<li>{@code setCategory()}. Allows the system to handle your app notifications <li>{@code setCategory()}. Allows the system to handle your app notifications
in Do not disturb mode (for example, if your notification represents an in <em>Do not disturb mode</em> (for example, if your notification represents an
incoming call, instant message, or alarm). incoming call, instant message, or alarm).</li>
<li>{@code setPriority()}. Notifications with the priority field set to <li>{@code setPriority()}. Notifications with the priority field set to
{@code PRIORITY_MAX} or {@code PRIORITY_HIGH} will appear in a small floating {@code PRIORITY_MAX} or {@code PRIORITY_HIGH} will appear in a small floating
window if the notification also has sound or vibration. window if the notification also has sound or vibration.</li>
<li>{@code addPerson()}. Allows you to add a list of people to a notification. <li>{@code addPerson()}. Allows you to add a list of people to a notification.
Your app can use this to signal to the system that it should group together Your app can use this to signal to the system that it should group together
notifications from the specified people, or rank notifications from these notifications from the specified people, or rank notifications from these
people as being more important. people as being more important.</li>
</ul> </ul>
<h3 id="Recents">Concurrent documents and activities in Recents screen</h3> <h3 id="Recents">Concurrent documents and activities in the Recents screen</h3>
<p>In previous releases, the <p>In previous releases, the
<a href="{@docRoot}design/get-started/ui-overview.html">Recents screen</a> <a href="{@docRoot}design/get-started/ui-overview.html">Recents screen</a>