From cbcd17d352a73419d39af798d1e40977c4422ae3 Mon Sep 17 00:00:00 2001 From: Scott Main Date: Tue, 14 May 2013 08:46:55 -0700 Subject: [PATCH] add new notice link from design docs to developer docs Change-Id: Ia8581781e1a7bc9a2458a5ac8f61190501b0eb06 --- docs/html/design/building-blocks/buttons.jd | 13 ++++----- docs/html/design/building-blocks/dialogs.jd | 27 ++++++++++--------- docs/html/design/building-blocks/grid-lists.jd | 7 +++++ docs/html/design/building-blocks/lists.jd | 7 +++++ docs/html/design/building-blocks/pickers.jd | 13 ++++----- docs/html/design/building-blocks/spinners.jd | 13 ++++----- docs/html/design/building-blocks/switches.jd | 36 ++++++++++++++++++++----- docs/html/design/building-blocks/tabs.jd | 13 ++++----- docs/html/design/building-blocks/text-fields.jd | 14 +++++----- docs/html/design/patterns/accessibility.jd | 14 +++++----- docs/html/design/patterns/compatibility.jd | 7 +++++ docs/html/design/patterns/multi-pane-layouts.jd | 17 ++++++------ docs/html/design/patterns/navigation.jd | 19 +++++-------- docs/html/design/patterns/notifications.jd | 16 +++++------ docs/html/design/patterns/selection.jd | 7 +++++ docs/html/design/patterns/settings.jd | 14 +++++----- docs/html/design/patterns/swipe-views.jd | 16 +++++------ docs/html/design/patterns/widgets.jd | 14 +++++----- 18 files changed, 157 insertions(+), 110 deletions(-) diff --git a/docs/html/design/building-blocks/buttons.jd b/docs/html/design/building-blocks/buttons.jd index 600ec6c58a3b..7957ef8a3e1b 100644 --- a/docs/html/design/building-blocks/buttons.jd +++ b/docs/html/design/building-blocks/buttons.jd @@ -2,6 +2,13 @@ page.title=Buttons page.tags="button","input" @jd:body + +
+

Developer Docs

+

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.

-
diff --git a/docs/html/design/building-blocks/dialogs.jd b/docs/html/design/building-blocks/dialogs.jd index 2f6ca2709182..f4bb87e9303c 100644 --- a/docs/html/design/building-blocks/dialogs.jd +++ b/docs/html/design/building-blocks/dialogs.jd @@ -2,6 +2,13 @@ page.title=Dialogs page.tags="dialog","alert","popup","toast" @jd:body + +
+

Developer Docs

+

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.

-

Popups

@@ -144,12 +146,19 @@ advances the workflow, and simply touching outside the popup dismisses it.

-
+

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.

+ +
+

Developer Docs

+

Toasts

+
+ +
@@ -158,9 +167,3 @@ continue editing later. Toasts automatically disappear after a timeout.

- -
-

Developer Guide

-

For information about how to create toasts, - see the Toasts API guide.

-
diff --git a/docs/html/design/building-blocks/grid-lists.jd b/docs/html/design/building-blocks/grid-lists.jd index 8c82ba97f023..1a09ef551082 100644 --- a/docs/html/design/building-blocks/grid-lists.jd +++ b/docs/html/design/building-blocks/grid-lists.jd @@ -4,6 +4,13 @@ page.tags="gridview","layout","listview" + +
+

Developer Docs

+

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 16927a61ceb0..5514824b056b 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 + +
+

Developer Docs

+

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 47363d075e62..6dd72ba06c22 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 + +
+

Developer Docs

+

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.

-
diff --git a/docs/html/design/building-blocks/spinners.jd b/docs/html/design/building-blocks/spinners.jd index 3550b0cd5fb8..c00b639b39fb 100644 --- a/docs/html/design/building-blocks/spinners.jd +++ b/docs/html/design/building-blocks/spinners.jd @@ -2,6 +2,13 @@ page.title=Spinners page.tags="spinner","dropdown" @jd:body + +
+

Developer Docs

+

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.

-
diff --git a/docs/html/design/building-blocks/switches.jd b/docs/html/design/building-blocks/switches.jd index 0b195b907fb1..74cab5ae2101 100644 --- a/docs/html/design/building-blocks/switches.jd +++ b/docs/html/design/building-blocks/switches.jd @@ -4,31 +4,53 @@ page.tags="switch","checkbox","radiobutton","button"

Switches allow the user to select options. There are three kinds of switches: checkboxes, radio buttons, and on/off switches.

+ + +

Checkboxes

+ +
+

Developer Docs

+

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

+ +
+

Developer Docs

+

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.

+ +

On/off Switches

+ +
+

Developer Docs

+

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.

-
+ diff --git a/docs/html/design/building-blocks/tabs.jd b/docs/html/design/building-blocks/tabs.jd index 79cc9c76bf42..47784009b035 100644 --- a/docs/html/design/building-blocks/tabs.jd +++ b/docs/html/design/building-blocks/tabs.jd @@ -4,6 +4,13 @@ page.tags="tabs","actionbar","navigation","viewpager" + +
+

Developer Docs

+

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.

-
diff --git a/docs/html/design/building-blocks/text-fields.jd b/docs/html/design/building-blocks/text-fields.jd index 82321f03d365..383531b1adad 100644 --- a/docs/html/design/building-blocks/text-fields.jd +++ b/docs/html/design/building-blocks/text-fields.jd @@ -2,6 +2,13 @@ page.title=Text Fields page.tags="text","edittext","input" @jd:body + +
+

Developer Docs

+

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.

-
diff --git a/docs/html/design/patterns/accessibility.jd b/docs/html/design/patterns/accessibility.jd index 5f46082c0207..16a39d68e42f 100644 --- a/docs/html/design/patterns/accessibility.jd +++ b/docs/html/design/patterns/accessibility.jd @@ -2,6 +2,13 @@ page.title=Accessibility page.tags="accessibility","navigation","input" @jd:body + +
+

Developer Docs

+

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.

-
-

Checklist