Buttons
+A button consists of text and/or an image that clearly communicates what action will occur when the user touches it. Android supports two different types of buttons: basic buttons and borderless buttons. Both can contain text labels and/or images.
@@ -38,9 +45,3 @@ than basic buttons and integrate nicely with other content.
-
-Developer Guide
-For information about how to build and customize buttons in your app, - see the Buttons API guide.
-Dialogs
+Dialogs prompt the user for decisions or additional information required by the app to continue a task. Such requests can range from simple Cancel/OK decisions to more complex layouts asking the user to adjust settings or enter text.
@@ -123,11 +130,6 @@ available based on the title and the text of the action buttons. -Developer Guide
-For information about how to build dialogs in your app, - see the Dialogs API guide.
-Toasts provide lightweight feedback about an operation in a small popup. For example, navigating away from an email before you send it triggers a "Draft saved" toast to let you know that you can continue editing later. Toasts automatically disappear after a timeout.
+ +Toasts
+Developer Guide
-For information about how to create toasts, - see the Toasts API guide.
-
+
+ Grid View
+Grid lists are an alternative to standard list views. They are best suited for showing data sets that represent themselves through images. In contrast to simple lists, grid lists may scroll either vertically or horizontally.
diff --git a/docs/html/design/building-blocks/lists.jd b/docs/html/design/building-blocks/lists.jd index 16927a61ceb04..5514824b056b3 100644 --- a/docs/html/design/building-blocks/lists.jd +++ b/docs/html/design/building-blocks/lists.jd @@ -2,6 +2,13 @@ page.title=Lists page.tags="listview","layout" @jd:body + +List View
+Lists present multiple line items in a vertical arrangement. They can be used for data selection as well as drilldown navigation.
diff --git a/docs/html/design/building-blocks/pickers.jd b/docs/html/design/building-blocks/pickers.jd index 47363d075e62c..6dd72ba06c22c 100644 --- a/docs/html/design/building-blocks/pickers.jd +++ b/docs/html/design/building-blocks/pickers.jd @@ -2,6 +2,13 @@ page.title=Pickers page.tags="datepicker","timepicker" @jd:body + +Pickers
+Pickers provide a simple way to select a single value from a set. In addition to touching the up/down arrow buttons, it's possible to set the desired value from the keyboard or via a swipe gesture.
@@ -31,9 +38,3 @@ correctly. The format of a time and date picker adjusts automatically to the loc
-
-Developer Guide
-For information about how to create date and time pickers, - see the Pickers API guide.
-Spinners
+Spinners provide a quick way to select one value from a set. In the default state, a spinner shows its currently selected value. Touching the spinner displays a dropdown menu with all other available values, from which the user can select a new one.
@@ -37,9 +44,3 @@ tabs. Spinners in the Holo Dark and Holo Light themes, in various states. - -Developer Guide
-For information about how to create spinners, - see the Spinners API guide.
-Switches allow the user to select options. There are three kinds of switches: checkboxes, radio buttons, and on/off switches.
+ + +Checkboxes
+Checkboxes allow the user to select multiple options from a set. Avoid using a single checkbox to turn an option off or on. Instead, use an on/off switch.
+
+
Radio Buttons
+Radio buttons allow the user to select one option from a set. Use radio buttons for exclusive selection if you think that the user needs to see all available options side-by-side. Otherwise, consider a spinner, which uses less space.
+
+
Toggle Buttons
+On/off switches toggle the state of a single settings option.
-Developer Guide
-For information about how to create these different switches, - see the Checkboxes, - Radio Buttons, or - Toggle Buttons API guides.
-
+
+ Creating Swipe Views with Tabs
+Tabs in the action bar make it easy to explore and switch between different views or functional aspects of your app, or to browse categorized data sets.
@@ -59,9 +66,3 @@ permits fast view switching even on narrower screens.
-
-Developer Guide
-For information about how to create tabs, - see the Action Bar API guide.
-Text Fields
+Text fields allow the user to type text into your app. They can be either single line or multi-line. Touching a text field places the cursor and automatically displays the keyboard. In addition to typing, text fields allow for a variety of other activities, such as text selection (cut, copy, @@ -70,10 +77,3 @@ Selection mode includes:
- -Developer Guide
-For information about how to create text fields, provide auto-complete suggestions, - and specify the input mode, - see the Text Fields API guide.
-Implementing Accessibility
+One of Android's missions is to organize the world's information and make it universally accessible and useful. Accessibility is the measure of how successfully a product can be used by people with varying abilities. Our mission applies to all users-including people with disabilities such as visual impairment, color deficiency, hearing loss, and limited dexterity.
Universal design is the practice of making products that are inherently accessible to all users, regardless of ability. The Android design patterns were created in accordance with universal design principles, and following them will help your app meet basic usability standards. Adhering to universal design and enabling Android's accessibility tools will make your app as accessible as possible.
Robust support for accessibility will increase your app's user base. It may also be required for adoption by some organizations.
@@ -71,13 +78,6 @@ page.tags="accessibility","navigation","input"Turn on the TalkBack service in Settings > Accessibility and navigate your application using directional controls or eyes-free navigation.
-Developer Guide
-For information about how to properly implement accessibility in your app, see the - Accessibility - API guide.
-Supporting Different Devices
+Significant changes in Android 3.0 included:
Building a Dynamic UI with Fragments
+When writing an app for Android, keep in mind that Android devices come in many different screen sizes and types. Make sure that your app consistently provides a balanced and aesthetically pleasing layout by adjusting its content to varying screen sizes and orientations.
@@ -88,15 +96,6 @@ you can use to adjust the layout after orientation change while keeping function -Developer Guide
-For information about how to create multi-pane layouts, read - see the Building - a Dynamic UI with Fragments and - Designing for Multiple Screens. -
-Implementing Effective Navigation
+Consistent navigation is an essential component of the overall user experience. Few things frustrate users more than basic navigation that behaves in inconsistent and unexpected ways. Android 3.0 introduced significant changes to the global navigation behavior. Thoughtfully following the @@ -203,15 +210,3 @@ with Task B—the prior context is abandoned in favor of the user's new goal
When your app registers to handle intents with an activity deep within the app's hierarchy, refer to Navigation into Your App via Home Screen Widgets and Notifications for guidance on how to specify Up navigation.
- - - -Developer Guide
-For information about how to build your app with proper Up and Back navigation, read - Implementing - Ancestral Navigation and - Implementing - Temporal Navigation, respectively. -
-Notifying the User
+The notification system allows your app to keep the user informed about events, such as new chat messages or a calendar event. Think of notifications as a news channel that alerts the user to important events as they happen or a log that chronicles events while the user is not paying attention.
Developer Guide
-For information about how to build notifications, see the - Notifications - API guide.
-Menus: Creating Contextual Menus
+Android 3.0 changed the long press gesture—that is, a touch that's held in the same position for a moment—to be the global gesture to select data.. This affects the way you should handle multi-select and contextual actions in your apps.
diff --git a/docs/html/design/patterns/settings.jd b/docs/html/design/patterns/settings.jd index 4748e48c96429..fa3e538c2c5c1 100644 --- a/docs/html/design/patterns/settings.jd +++ b/docs/html/design/patterns/settings.jd @@ -2,6 +2,13 @@ page.title=Settings page.tags="preferences","sharedpreferences" @jd:body + +Settings
+Settings is a place in your app where users indicate their preferences for how your app should behave. This benefits users because:
@@ -681,13 +688,6 @@ it doesn't mean anything to most users and would have taken up a lot of space. -Developer Guide
-For information about how to build a settings interface, see the - Settings - API guide.
-Creating Swipe Views with Tabs
+Efficient navigation is one of the cornerstones of a well-designed app. While apps are generally built in a hierarchical fashion, there are instances where horizontal navigation can flatten vertical hierarchies and make access to related data items faster and more enjoyable. Swipe views @@ -79,12 +86,3 @@ using the swipe gesture to navigate to the next/previous detail view.
- -Developer Guide
-For information about how to create swipe views, read - Implementing Lateral Navigation. -
-App Widgets
+Widgets are an essential aspect of home screen customization. You can imagine them as "at-a-glance" views of an app's most important data and functionality that is accessible right from the user's home screen. Users can move widgets across their home screen panels, and, if supported, resize them to tailor the amount of information within a widget to their preference.
Developer Guide
-For information about how to build widgets for the home screen, see the - App Widgets - API guide.
-