The Action Bar: Front to Back

Copyright © 2011 CommonsWare, LLC

The Action Bar:Front to Back


Action Bar and System Bar

Action Bar

System Bar


Targeting Honeycomb● <uses-sdk android:targetSdkVersion=“11”>

● Effects– Action bar added– Options menu hoisted from status bar soft

button to normal action bar “overflow” position– Holographic theme for widgets


Toolbar Buttons

● Toolbar Buttons = Options Menu Items● Add android:showAsAction to <item> in

menu resource– ifRoom to indicate it can remain an options

menu item if there is no room– withText if you want icon & title

● Backwards-compatible automatically– Attribute ignored on older Android versions




Toolbar Widgets

● Substitute Own Inflated Layout for Standard Toolbar Button– Add android:actionLayout to <item> in

menu resource– Call getActionView() on MenuItem to

configure at runtime● New method in API Level 11● Requires special care to remain backwards-

compatible




Home Affordance

● Fancy Term for “Icon On The Left”– Default = activity icon– Optional android:logo in <application> to

supply alternative image● Virtual menu choice: android.R.id.home

– Handle in onOptionsItemSelected()● setDisplayHomeAsUpEnabled()

– Adds arrowhead


Navigation Modes

● Tabs– Replacement for TabHost– Use setNavigationMode() to enable tabs– Call addTab() on ActionBar for each tab

● Supply a TabListener

– Process tab events● Selected● Unselected● Reselected





Navigation Modes

● “List”– Puts Spinner in navigation area of action bar– Call setNavigationMode() to enable this

mode– Call setListNavigationCallbacks() to

supply SpinnerAdapter and an OnNavigationListener

– Respond to selection events





Navigation Modes

● setCustomView()

– You supply your own View or layout resource ID– Used in the navigation space on the action bar,

instead of tabs or Spinner– Example: AutoCompleteTextView for browser– getCustomView() to retrieve inflated layout for

runtime configuration


Action Modes

● Alternate Action Bar for Contextual Actions– Operations on multiple selections– Replacement for context menu


Action Modes

● DIY Action Mode– Call startActionMode() with

ActionMode.Callback– Configure ActionMode in onCreateActionMode()– onActionItemClicked() if user clicks a toolbar

button– finish() the ActionMode when done


Action Modes

● Automatic Multiple-Choice Action Mode– CHOICE_MODE_MULTIPLE_MODAL and an appropriate

row layout– Long-press checks item, enables remaining

checkboxes, toggles on action mode with your supplied MultiChoiceModeListener callback

● Serves as ActionBar.Callback, plus onItemCheckedStateChanged() for check/uncheck events



Styles and Themes

● Theme.Holo / Theme.Holo.Light– Standard themes, standard color scheme

● Can Style the Action Bar– Lightly-documented– Nick Butcher blog post: http://goo.gl/wUSxN

● Does not work – cannot inherit from private theme● Carlos Sessa workaround: http://goo.gl/TNN0S


What About the Phone?

● ActionBarSherlock– Modified Android Compatibility Library with

backwards-compatible action bar● Ice Cream Sandwich


Source Code

● http://github.com/commonsguy/cw-android– Menus/InflationBC project

● http://github.com/commonsguy/cw-advandroid– Honeycomb/* projects

The Action Bar: Front to Back

Technology

arrowhead copyright

action modes diy action

navigation area of action

honeycomb effects action

selection events copyright

status bar softbutton

navigation modes setcustomview

holo theme