Titanium Mobile # Titanium.UI.iOS.SystemButton
A set of constants for creating standard iOS system buttons.
5.4.0
9.2.0# Overview
Most of these constants are used with the Titanium.UI.Button.systemButton property to define a standard iOS system buttons for use in navigation bars and toolbars.
See Titanium.UI.Button for more information on the systemButton property, including details
on where system buttons can be used. In an Alloy application you can omit the Ti.UI.iOS.SystemButton
namespace when assigning a value to the <Button> element's systemButton attribute,
for example:
<Button systemButton="CAMERA"/>
<!-- Instead of -->
<Button systemButton="Titanium.UI.iOS.SystemButton.CAMERA"/>
A few of these constants are used with Titanium.UI.Button.style to create standard iOS buttons that can be used in other places, including table view rows. Note: Starting at Titanium SDK 5.0, all icons have are automatically sized in the native behavior and are not distorted any more. These standard button types are:
- Titanium.UI.iOS.SystemButton.CONTACT_ADD
- Titanium.UI.iOS.SystemButton.DISCLOSURE
- Titanium.UI.iOS.SystemButton.INFO_DARK
- Titanium.UI.iOS.SystemButton.INFO_LIGHT
See Apple's iOS Human Interface Guidelines (opens new window) in the iOS Developer Library for details on the proper usage of iOS standard buttons and icons.
# Constants
# ACTION
5.4.0 9.2.0Use with systemButton to specify an Action button.
The resulting button can only be used in navigation bars and toolbars.
# ACTIVITY
5.4.0 9.2.0Use with systemButton to create an activity indicator that can be used in navigation bars and toolbars.
When visible, the activity indicator is already started.
# ADD
5.4.0 9.2.0Use with systemButton to specify an Add button.
The resulting button can only be used in navigation bars and toolbars.
# BOOKMARKS
5.4.0 9.2.0Use with systemButton to specify a Bookmarks button.
The resulting button can only be used in navigation bars and toolbars.
# CAMERA
5.4.0 9.2.0Use with systemButton to specify a Camera button.
The resulting button can only be used in navigation bars and toolbars.
# CANCEL
5.4.0 9.2.0Use with systemButton to specify a Cancel button.
This button is displayed as a bordered button with localized text.
The resulting button can only be used in navigation bars and toolbars.
# COMPOSE
5.4.0 9.2.0Use with systemButton to specify a Compose button.
The resulting button can only be used in navigation bars and toolbars.
# CONTACT_ADD
5.4.0 9.2.0Use with style to specify a ContactAdd button.
The resulting button is not restricted to use in navigation bars and toolbars.
# DISCLOSURE
5.4.0 9.2.0Use with style to specify a Disclosure button.
The resulting button is not restricted to use in navigation bars and toolbars.
# DONE
5.4.0 9.2.0Use with systemButton to specify a Done button.
This button is displayed as a bordered button with localized text.
The resulting button can only be used in navigation bars and toolbars.
# EDIT
5.4.0 9.2.0Use with systemButton to specify an Edit button.
This button is displayed as a bordered button with localized text.
The resulting button can only be used in navigation bars and toolbars.
# FAST_FORWARD
5.4.0 9.2.0Use with systemButton to specify a Fast Forward button.
The resulting button can only be used in navigation bars and toolbars.
# FIXED_SPACE
5.4.0 9.2.0Use with systemButton to create a fixed-width blank space for spacing items in toolbars.
Only the width property is used when this value is set.
# FLEXIBLE_SPACE
5.4.0 9.2.0Use with systemButton to create a flexible blank space for spacing items in toolbars.
The space is distributed equally between the other items. Other item properties are ignored when this value is set.
# INFO_DARK
5.4.0 9.2.0Use with style to specify a dark-colored Info button.
The resulting button is not restricted to use in navigation bars and toolbars.
# INFO_LIGHT
5.4.0 9.2.0Use with style to specify a light-colored Info button.
The resulting button is not restricted to use in navigation bars and toolbars.
# ORGANIZE
5.4.0 9.2.0Use with systemButton to specify an Organize button.
The resulting button can only be used in navigation bars and toolbars.
# PAUSE
5.4.0 9.2.0Use with systemButton to specify a Pause button.
The resulting button can only be used in navigation bars and toolbars.
# PLAY
5.4.0 9.2.0Use with systemButton to specify a Play button.
The resulting button can only be used in navigation bars and toolbars.
# REFRESH
5.4.0 9.2.0Use with systemButton to specify a Refresh button.
The resulting button can only be used in navigation bars and toolbars.
# REPLY
5.4.0 9.2.0Use with systemButton to specify a Reply button.
The resulting button can only be used in navigation bars and toolbars.
# REWIND
5.4.0 9.2.0Use with systemButton to specify a Rewind button.
The resulting button can only be used in navigation bars and toolbars.
# SAVE
5.4.0 9.2.0Use with systemButton to specify a Save button.
This button is displayed as a bordered button with localized text.
The resulting button can only be used in navigation bars and toolbars.
# STOP
5.4.0 9.2.0Use with systemButton to specify a Stop button.
The resulting button can only be used in navigation bars and toolbars.
# TRASH
5.4.0 9.2.0Use with systemButton to specify a Trash button.
The resulting button can only be used in navigation bars and toolbars.