diff --git a/docs/html/guide/guide_toc.cs b/docs/html/guide/guide_toc.cs index a044ceaecd3b9..da5192a1091df 100644 --- a/docs/html/guide/guide_toc.cs +++ b/docs/html/guide/guide_toc.cs @@ -146,6 +146,7 @@
  • UI Guidelines
  • diff --git a/docs/html/guide/practices/ui_guidelines/icon_design.jd b/docs/html/guide/practices/ui_guidelines/icon_design.jd new file mode 100644 index 0000000000000..3432a096b46ce --- /dev/null +++ b/docs/html/guide/practices/ui_guidelines/icon_design.jd @@ -0,0 +1,1410 @@ +page.title=Icon Design Guidelines +@jd:body + +
    +
    + +

    Icon design quickview

    + + + +

    In this document

    + +
      +
    1. Launcher icon
    2. +
    3. Menu icon
    4. +
    5. Status bar icon
    6. +
    7. Tab icon
    8. +
    9. Dialog icon
    10. +
    11. List view icon
    12. + +
    13. General guidelines
    14. +
    15. Using the Icon Templates Pack
    16. +
    17. Icon appendix +
        +
      1. Launcher icons
      2. +
      3. Menu icons
      4. +
      5. Status bar icons
      6. +
      +
    18. + +
    + +

    See also

    + +
      +
    1. Android Icon +Templates Pack »
    2. +
    + +
    +
    + +

    Creating a unified look and feel throughout a user interface adds value to +your product. Streamlining the graphic style will also make the UI seem more +professional to the user.

    + +

    This document shows you how to create icons for various parts +of your application’s user interface that fit the style set by the Android UI +team. Following these guidelines will help you to create a polished and unified +experience for the user.

    + +

    To get started creating conforming icons more quickly, you can download +the Android Icon Templates Pack. For more information, see +Using the Android Icon Template Pack.

    + +

    Launcher icon

    + +

    A launcher icon is the graphic that represents your application on an Android +device’s Home screen. It is a simplified 3D icon with a fixed perspective. The +required perspective is shown in Figure 1.

    + +

    Structure

    + + + + + + + + +
    + A view of
+launcher icon corners and perspective angles + +
    +

    Figure 1. Perspective angles for launcher icons (90° is +vertical).

    +
    + + + + + + + + + + + + +
    1.92°
    2.92°
    3.173°
    4.171°
    5.49°
    6.171°
    7.64°
    8.97°
    9.75°
    10.93°
    11.169°
    +
    +
    +
    +

    Figure 2. Rounded corners for launcher icons.

    +
    +
    + +

    Light, effects, and shadows

    + +

    Launcher icons are simplified 3D icons using light and shadows for +definition. A light source is placed slightly to the left in front of the icon, +and therefore the shadow expands to the right and back.

    + + + + + + +
    + A view of
+light, effects, and shadows for launcher icons. + +
    +

    Figure 3. Light, effects, and shadows for launcher icons.

    +
    + + + + + + +
    1.Edge highlight:white
    2.Icon shadow:black | 20px blur
    50% opacity | angle 67°
    3.Front part:Use light gradient from color palette
    4.Detail shadow:black | 10px blur
    75% opacity
    5. Side part:Use medium gradient from color palette
    +
    +
    +
    + + + + + + + +
    + +

    Launcher icon color palette

    + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Color palette, whiteWhite
    r 0 | g 0 | b 0
    Used for highlights on edges.
    Color palette, light gradientLight gradient
    1:  r 0 | g 0 | b 0
    2:  r 217 | g 217 | b 217
    Used on the front (lit) part of the icon.
    Color palette, medium gradienMedium gradient
    1:  r 190 | g 190 | b 190
    2:  r 115 | g 115 | b 115
    Used on the side (shaded) part of the icon.
    Color palette, dark gradientDark gradient
    1:  r 100 | g 100 | b 100
    2:  r 25 | g 25 | b 25
    Used on details and parts in the shade of the icon.
    Color palette, blackBlack
    r 255 | g 255 | b 255
    Used as base color in shadows.
    + +
    + +

    Step by step

    + +
      +
    1. Create the basic shapes with a tool like Adobe Illustrator, using the +angles described in Launcher icon: structure. +The shapes and effects must fit within a 250x250 pixel artboard.
    2. +
    3. Add depth to shapes by extruding them and create the rounded corners as +described for the launcher icon structure.
    4. +
    5. Add details and colors. Gradients should be treated as if there is a light +source placed slightly to the left in front of the icon.
    6. +
    7. Create the shadows with the correct angle and blur effect.
    8. +
    9. Import the icon into a tool like Adobe Photoshop and scale to fit an image +size of 48x48 px on a transparent background.
    10. +
    11. Export the icon at 48x48 as a PNG file with transparency enabled.
    12. +
    + +
    + + + +

    Menu icons are graphical elements placed in the pop-up menu shown to users +when they press the Menu button. They are drawn in a flat-front perspective. +Elements in a menu icon must not be visualized in 3D or perspective.

    + +

    Structure

    + + + + + + + + +
    + A view of menu
+icon structure. + +
    +

    Figure 4. Safeframe and corner-rounding for menu +icons. Icon size is 48x48.

    +
    +
    + + + + +

    Menu icons are flat and pictured face on. A slight deboss and some other +effects, which are shown below, are used to create depth.

    + + + + + + +
    + A view of light, effects, and shadows for launcher icons. + +
    +

    Figure 5. Light, effects, and shadows for launcher icons.

    +
    + + + + + +
    1.Front part:Use fill gradient from primary color palette
    2.Inner shadow:black | 20 % opacity
    angle 90° | distance 2px
    size 2px
    3.Outer glow:white | 55% opacity
    spread 10% | size 3px
    5.Inner bevel:depth 1% | direction down size 0px
    angle 90° | altitude 10°
    highlight white 70% opacity
    shadow black 25% opacity
    +
    +
    +
    + + + + + + + +
    + + + + + + + + + + + + + + + + + + + +
    Color palette, whiteWhite
    r 0 | g 0 | b 0
    Used for outer glow and bevel highlight.
    Color palette, medium gradientFill gradient
    1:  r 163 | g 163 | b 163
    2:  r 120 | g 120 | b 120
    Used as color fill.
    Color palette, blackBlack
    r 255 | g 255 | b 255
    Used for inner shadow and bevel shadow.
    + +
    + + + +
      +
    1. Create the basic shapes using a tool like Adobe Illustrator.
    2. +
    3. Import the shape into a tool like Adobe Photoshop and scale to fit an image +of 48x48 px on a transparent background. Mind the safeframe.
    4. +
    5. Add the effects seen as described in Figure 5.
    6. +
    7. Export the icon at 48x48 as a PNG file with transparency enabled.
    8. +
    + +
    + + +

    Status bar icon

    + +

    Status bar icons are used to represent notifications from your application in +the status bar. Graphically, they are very similar to menu icons, but are +smaller and higher in contrast.

    + +

    Structure

    + + + + + + + + +
    + A view of
+status bar icon structure. + +
    +

    Figure 6. Safeframe and corner-rounding for status bar +icons. Icon size is 25x25.

    +
    +
    + + +

    Light, effects, and shadows

    + +

    Status bar icons are slightly debossed, high in contrast, and pictured +face-on to enhance clarity at small sizes.

    + + + + + + +
    + A view of
+light, effects, and shadows for launcher icons. + +
    +

    Figure 7. Light, effects, and shadows for launcher icons.

    +
    + + + + + +
    1.Front part:Use fill gradient from primary color palette
    2.Inner bevel:depth 100% | direction down
    size 0px | angle 90° |
    altitude 30°
    highlight white 75% opacity
    shadow black 75% opacity
    3.Detail:white
    4.Disabled detail:grey gradient from palette
    + inner bevel: smooth | depth 1% | direction down | size 0px | angle 117° |
    altitude 42° | highlight white 70% | no shadow
    +
    +
    +
    + + + + + + + +
    + + + +

    Only status bar icons related to the phone function use full color; all other status bar icons should remain monochromatic.

    + + + + + + + + + + + + + + + + + + + + + + +
    Color palette, whiteWhite
    r 0 | g 0 | b 0
    Used for details within the icons and bevel highlight.
    Color palette, grey gradientGrey gradient
    1:  r 169 | g 169 | b 169
    2:  r 126 | g 126 | b 126
    Used for disabled details within the icon.
    Color palette, fill gradientFill gradient
    1:  1 r 105 | g 105 | b 105
    2:  r 10 | g 10 | b 10
    Used as color fill.
    Color palette, blackBlack
    r 255 | g 255 | b 255
    Used for bevel shadow.
    + +
    + + + +
      +
    1. In a tool like Adobe Photoshop, create the base shape within a 25x25 px +image on a transparent background. Mind the safeframe, and keep the upper and +lower 2 pixels free.
    2. +
    3. Add rounded corners as specified in Figure 6.
    4. +
    5. Add light, effects, and shadows as specified in Figure 7.
    6. +
    7. Export the icon at 25x25 as a PNG file with transparency enabled.
    8. +
    + +
    + + +

    Tab icon

    + +

    Tab icons are graphical elements used to represent individual tabs in a +multi-tab interface. Each tab icon has two states: unselected and selected.

    + +

    Structure

    + + + + + + + + + + + + +
    + A view of
+unselected tab icon structure. + +
    +

    Figure 8. Safeframe and fill gradient for unselected tab +icons. Icon size is 32x32.

    +
    +
    + A view of
+selected tab icon structure. + +
    +

    Figure 9. Safeframe and fill gradient for tab icons in +selected state. Icon size is 32x32.

    +
    +
    + +

    Unselected tab icon

    + +

    Light, effects, and shadows

    + +

    Unselected tab icons look just like the selected tab icons, but with a +fainter inner shadow, and the same front part gradient as the dialog icons.

    + + + + + + +
    + A view
+of light, effects, and shadows for unselected tab icons. + +
    +

    Figure 10. Light, effects, and shadows for unselected +tab icons.

    +
    + + + + +
    1.Front part:gradient overlay | angle 90°
    bottom color: r 223 | g 223 | b 223
    top color: r 249 | g 249 | b 249
    bottom color location: 0%
    top color location: 75%
    2.Inner shadow:black | 10 % opacity | angle 90° distance 2px | size 2px
    3.Inner bevel:depth 1% | direction down | size 0px | angle 90° | altitude 10°
    highlight white 70% opacity
    shadow black 25% opacity
    +
    +
    +
    + + + + + + +
    + + + +
      +
    1. Create the basic shapes using a tool like Adobe Illustrator.
    2. +
    3. Import the shape to a tool like Adobe Photoshop and scale to fit an image of +32x32 px on a transparent background.
    4. +
    5. Add the effects seen in Figure 10 for the unselected state filter.
    6. +
    7. Export the icon at 32x32 as a PNG file with transparency enabled.
    8. +
    + +
    + +

    Selected tab icon

    + +

    The selected tab icons have the same fill gradient and effects as the menu +icon, but with no outer glow.

    + + + + + + +
    + A view of
+light, effects, and shadows for selected tab icons. + +
    +

    Figure 11. Light, effects, and shadows for selected tab +icons.

    +
    + + + + +
    1.Front part:Use fill gradient from color palette.
    2.Inner shadow:black | 20% opacity |
    angle 90° | distance 2px |
    size 2px
    3.Inner bevel:depth 1% | direction down | size 0px | angle 90° |
    altitude 10°
    highlight white 70% opacity
    shadow black 25% opacity
    +
    +
    +
    + + + + + + + +
    + + + + + + + + + +
    Color palette, fill gradientFill gradient
    1:  r 163 | g 163 | b 163
    2:  r 120 | g 120 | b 120
    Used as color fill on unselected tab icons.
    + +
    + + + +
      +
    1. Create the basic shape using a tool like Adobe Illustrator.
    2. +
    3. Import the shape into a tool like Adobe Photoshop and scale to fit a 32x32 +px artboard with a transparent background.
    4. +
    5. Add the effects seen in Figure 11 for the selected state filter.
    6. +
    7. Export the icon at 32x32 as a PNG file with transparency enabled.
    8. +
    + +
    + + +

    Dialog icon

    + +

    Dialog icons are shown in pop-up dialog boxes that prompt the user for +interaction. They use a light gradient and inner +shadow in order to stand out against a dark background.

    + +

    Structure

    + + + + + + + + +
    + A view of dialog
+icon structure. + +
    +

    Figure 12. Safeframe and fill gradient for dialog icons. +Icon size is 32x32.

    +
    +
    + + +

    Light, effects, and shadows

    + +

    Dialog icons are flat and pictured face-on. In order to stand out against a +dark background, they are built up using a light gradient and inner shadow.

    + + + + + + +
    + A view of light,
+effects, and shadows for dialog icons. + +
    +

    Figure 13. Light, effects, and shadows for dialog +icons.

    +
    + + + +
    1.Front part:gradient overlay | angle 90°
    bottom: r 223 | g 223 | b 223
    top: r 249 | g 249 | b 249
    bottom color location: 0%
    top color location: 75%
    2.Inner shadow:black | 25% opacity |
    angle -90° | distance 1px | size 0px
    +
    +
    +
    + + + + + + +
    + + + +
      +
    1. Create the basic shapes using a tool like Adobe Illustrator.
    2. +
    3. Import the shape into a tool like Adobe Photoshop and scale to fit an image +of 32x32 px on a transparent background.
    4. +
    5. Add the effects seen in Figure 13 for the proper filter.
    6. +
    7. Export the icon at 32x32 as a PNG file with transparency enabled.
    8. +
    + +
    + + +

    List view icon

    + +

    List view icons look a lot like dialog icons, but they use an inner shadow +effect where the light source is above the object. They are also designed to be +used only in a list view. Examples include the Android Market application home +screen and the driving directions screen in the Maps application.

    + +

    Structure

    + + + + + + + + +
    + A view of list
+view icon structure. + +
    +

    Figure 14. Safeframe and fill gradient for list view +icons. Icon size is 32x32.

    +
    +
    + +

    Light, effects, and shadows

    + +

    List view icons are flat and pictured face-on with an inner shadow. Built up +by a light gradient and inner shadow, they stand out well on a dark +background.

    + + + + + + +
    + A view
+of light, effects, and shadows for list view icons. + +
    +

    Figure 15. Light, effects, and shadows for list view +icons.

    +
    + + + + +
    1.Inner shadow:black | 57 % opacity | angle 120° | blend mode normal | distance 1px | size 1px
    2.Background:black | standard system color
    These icons are displayed in list views only.
    Note: The list view icon sits on 32x32 px artboard in Photoshop, without a safeframe.
    +
    +
    +
    + + + + + +
    + + + +
      +
    1. Add the effects seen in Figure 15 for the proper filter.
    2. +
    3. Export the icon at 32x32 as a PNG file with transparency enabled.
    4. +
    5. Create the basic shapes using a tool like Adobe Illustrator.
    6. +
    7. Import the shape into a tool like Adobe Photoshop and scale to fit an image +of 32x32 px on a transparent background.
    8. +
    + +
    + + +

    General guidelines

    + +

    Below are some "do and don't" guidelines to consider when creating icons for +your application. By following the guidelines, you can ensure that your icons +will work well with other parts of the Android platform UI and will meet the +expectations of your application's users.

    + + + + + + + + +
    + +

    Do...

    + +
      +
    • Use a normal perspective. The depth of an object should be realistic.
    • +
    • Keep it simple! By overdoing an icon, it loses it purpose and +readability.
    • +
    • Use colors only when necessary. Mind that the base of a launcher icon should +be grey and feel solid.
    • +
    • Use the correct angles for the specific icon types.
    • +
    +
    + +

    Don’t...

    + +
      +
    • Use open elements like text alone as icons. Instead place those elements on +a base shape.
    • +
    • Use colors for your status bar notifications. Those are reserved for +specific phone-only functions.
    • +
    +
    +Side-by-side examples
+of good/bad icon design. +
    + +

    Using the Android Icon Templates Pack

    + +

    The Android Icon Templates Pack is a collection of template designs, filters, +and settings that make it easier for you to create icons that conform to the +general specifications given in this document. We recommend downloading the +template pack archive before you get started with your icon design.

    + +

    The icon templates are provided in Adobe Photoshop and Adobe Illustrator file +formats, which preserves the layers and design treatments we used when creating the +standard icons for the Android platform. You can load the template files into any +compatible image-editing program, although your ability to work directly with the +layers and treatments may vary based on the program you are using.

    + +The Templates Pack provides templates in Adobe Photoshop and Adobe Illustrator file formats, which preserves the layers and design treatments we used when creating the standard icons for the Android platform. + +

    You can obtain the Icon Templates Pack archive using the link below:

    + +

    Download the Icon Templates +Pack » + + +

    Icon appendix

    + +

    Standard launcher icons

    + +

    Shown below are examples of launcher icons used by Android applications. The +icons are provided for your reference only — please do not reuse these +icons in your applications.. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + Android asset +
    Alarm Clock
    + Android asset +
    Browser
    + Android asset +
    Calculator
    + Android asset +
    Calendar
    + Android asset +
    Camcorder
    + Android asset +
    Camera
    + Android asset +
    Contacts
    + Android asset +
    Dialer
    + Android asset +
    Email
    + Android asset +
    Gallery
    + Android asset +
    Generic application
    + Android asset +
    Gmail
    + Android asset +
    Google Talk
    + Android asset +
    IM
    + Android asset +
    Maps
    + Android asset +
    Market
    + Android asset +
    Messaging
    + Android asset +
    Music
    + Android asset +
    Settings
    + Android asset +
    Voice Dialer
    + Android asset +
    Voice Search
    + Android asset +
    YouTube
    + +

    + +

    Shown below are standard menu icons that are included in the Android platform +(as of Android 1.5). You can reference any of these icon resources from your +application as needed, but make sure that the action you assign to the icon is +consistent with that listed. Note that this is not a complete list of icons and +that the actual appearance of standard icons may change across platform +versions.

    + +

    To reference one of the icons from your code, use +android.R.drawable.<icon_resource_identifier>. For example, +you can call a menu item's {@link android.view.MenuItem#setIcon(android.graphics.drawable.Drawable) setIcon()} +method and pass the resource name:

    + +

    .setIcon(android.R.drawable.ic_menu_more);. + +

    You could reference the same icon from a layout file using +android:icon="@android:drawable/ic_menu_more">.

    + +

    To determine the resource ID for an icon listed below, hover over the icon or +simply look at image filenames, which use the format +"<icon_resource_identifier>.png".

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + Android asset +
    Add
    + Android asset +
    Archive
    + Android asset +
    Attach
    + Android asset +
    Back
    + Android asset +
    Call
    + Android asset +
    Camera
    + Android asset +
    Clear / Close / Cancel / Discard
    + Android asset +
    Compass
    + Android asset +
    Delete
    + Android asset +
    Directions
    + Android asset +
    Edit
    + Android asset +
    Favorite
    + Android asset +
    Forward
    + Android asset +
    Gallery
    + Android asset +
    Go to
    + Android asset +
    Help
    + Android asset +
    History
    + Android asset +
    Home
    + Android asset +
    Info / details
    + Android asset +
    Map mode
    + Android asset +
    Mark
    + Android asset +
    My Location
    + Android asset +
    More
    + Android asset +
    Play
    + Android asset +
    Preferences
    + Android asset +
    Refresh
    + Android asset +
    Rotate
    + Android asset +
    Save
    + Android asset +
    Send
    + Android asset +
    Search
    + Android asset +
    Share
    + Android asset +
    Shuffle
    + Android asset +
    Upload
    + Android asset +
    View
    + Android asset +
    Video
    + Android asset +
    Zoom
    + + +

    Standard status bar icons

    + +

    Shown below are standard status bar icons included in the Android platform +(as of Android 1.5). You can reference any of these icon resources from your +application as needed, but make sure that the meaning of the icon is consistent +with the standard meaning listed. Note that this is not a complete list of icons +and that the actual appearance of standard icons may change across platform +versions.

    + +

    To reference one of the icons from your code, use +android.R.drawable.<icon_resource_identifier>. For example, +you can construct a simple notification that references one of the icons like +this:

    + +

    new Notification(R.drawable.stat_notify_calendar, +"sample text", System.currentTimeMillis());

    + +

    To determine the resource ID for an icon listed below, hover over the icon +or simply look at the image filename, which use the format +"<icon_resource_identifier>.png".

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + Android asset +
    3G
    + Android asset +
    Battery 100%
    + Android asset +
    Battery empty
    + Android asset +
    Call
    + Android asset +
    Call forward
    + Android asset +
    Call on hold
    + Android asset +
    GPS on
    + Android asset +
    Missed call
    + Android asset +
    Airplane mode
    + Android asset +
    Alarm
    + Android asset +
    Bluetooth
    + Android asset +
    Bluetooth connected
    + Android asset +
    Calendar
    + Android asset +
    Disk full
    + Android asset +
    EDGE
    + Android asset +
    Email
    + Android asset +
    Gmail
    + Android asset +
    GPRS
    + Android asset +
    IM
    + Android asset +
    Installation complete
    + Android asset +
    Music
    + Android asset +
    Roaming
    + Android asset +
    Signal
    + Android asset +
    Signal unavailable
    + Android asset +
    Silent mode
    + Android asset +
    SMS/MMS
    + Android asset +
    Speaker phone
    + Android asset +
    Sync
    + Android asset +
    Sync error
    + Android asset +
    USB connected
    + Android asset +
    Vibrate
    + Android asset +
    Voicemail
    + Android asset +
    Warning
    + Android asset +
    WiFi
    + Android asset +
    WiFi network available
    + Android asset +
    WiFi unavailable
    + + diff --git a/docs/html/guide/practices/ui_guidelines/index.jd b/docs/html/guide/practices/ui_guidelines/index.jd index e19d5b49f3ff8..61e310a8ea67b 100644 --- a/docs/html/guide/practices/ui_guidelines/index.jd +++ b/docs/html/guide/practices/ui_guidelines/index.jd @@ -6,18 +6,27 @@ page.title=User Interface Guidelines

    The Android UI team has begun developing guidelines for the interaction and -design of Android applications. Look here for articles that describe these -visual guidelines as we release them.

    +visual design of Android applications. Look here for articles that describe +these guidelines as we release them.

    - +
    +
    Icon +Design Guidelines and Android Icon Templates Pack +»
    +
    Your applications need a wide variety of icons, from a launcher icon to +icons in menus, dialogs, tabs, the status bar, and lists. The Icon Guidelines +describe each kind of icon in detail, with specifications for the size, color, +shading, and other details for making all your icons fit in the Android system. +The Icon Templates Pack is an archive of Photoshop and Illustrator templates and +filters that make it much simpler to create conforming icons.
    +
    Widget Design Guidelines
    -
    Widgets are a new feature introduced in Cupcake. A widget displays -an application's most important or timely information at a glance, on a user's -Home screen. These design guidelines describe how to design widgets that fit -with others on the Home screen. They include links to graphics files and -templates that will make your designer's life easier.
    - +
    A widget displays an application's most important or timely information +at a glance, on a user's Home screen. These design guidelines describe how to +design widgets that fit with others on the Home screen. They include links to +graphics files and templates that will make your designer's life easier.
    diff --git a/docs/html/shareables/icon_templates-v1.0.zip b/docs/html/shareables/icon_templates-v1.0.zip new file mode 100644 index 0000000000000..3e64f9aacd50c Binary files /dev/null and b/docs/html/shareables/icon_templates-v1.0.zip differ