react-native/docs/toolbarandroid.md

id	title	layout	category	permalink	next	previous
toolbarandroid	ToolbarAndroid	docs	components	docs/toolbarandroid.html	touchablehighlight	textinput

React component that wraps the Android-only Toolbar widget. A Toolbar can display a logo, navigation icon (e.g. hamburger menu), a title & subtitle and a list of actions. The title and subtitle are expanded so the logo and navigation icons are displayed on the left, title and subtitle in the middle and the actions on the right.

If the toolbar has an only child, it will be displayed between the title and actions.

Although the Toolbar supports remote images for the logo, navigation and action icons, this should only be used in DEV mode where require('./some_icon.png') translates into a packager URL. In release mode you should always use a drawable resource for these icons. Using require('./some_icon.png') will do this automatically for you, so as long as you don't explicitly use e.g. {uri: 'http://...'}, you will be good.

Example:

render: function() {
  return (
    <ToolbarAndroid
      logo={require('./app_logo.png')}
      title="AwesomeApp"
      actions={[{title: 'Settings', icon: require('./icon_settings.png'), show: 'always'}]}
      onActionSelected={this.onActionSelected} />
  )
},
onActionSelected: function(position) {
  if (position === 0) { // index of 'Settings'
    showSettings();
  }
}

Props

• View props...
• overflowIcon
• actions
• contentInsetStart
• logo
• navIcon
• onActionSelected
• onIconClicked
• contentInsetEnd
• rtl
• subtitle
• subtitleColor
• testID
• title
• titleColor

---

Reference

Props

overflowIcon

Sets the overflow icon.

Type	Required
optionalImageSource	No

---

actions

Sets possible actions on the toolbar as part of the action menu. These are displayed as icons or text on the right side of the widget. If they don't fit they are placed in an 'overflow' menu.

This property takes an array of objects, where each object has the following keys:

• title: required, the title of this action
• icon: the icon for this action, e.g. require('./some_icon.png')
• show: when to show this action as an icon or hide it in the overflow menu: always, ifRoom or never
• showWithText: boolean, whether to show text alongside the icon or not

Type	Required
array of object: {title: string,icon: optionalImageSource,show: enum('always', 'ifRoom', 'never'),showWithText: bool}	No

---

contentInsetStart

Sets the content inset for the toolbar starting edge.

The content inset affects the valid area for Toolbar content other than the navigation button and menu. Insets define the minimum margin for these components and can be used to effectively align Toolbar content along well-known gridlines.

Type	Required
number	No

---

logo

Sets the toolbar logo.

Type	Required
optionalImageSource	No

---

navIcon

Sets the navigation icon.

Type	Required
optionalImageSource	No

---

onActionSelected

Callback that is called when an action is selected. The only argument that is passed to the callback is the position of the action in the actions array.

Type	Required
function	No

---

onIconClicked

Callback called when the icon is selected.

Type	Required
function	No

---

contentInsetEnd

Sets the content inset for the toolbar ending edge.

The content inset affects the valid area for Toolbar content other than the navigation button and menu. Insets define the minimum margin for these components and can be used to effectively align Toolbar content along well-known gridlines.

Type	Required
number	No

---

rtl

Used to set the toolbar direction to RTL. In addition to this property you need to add

android:supportsRtl="true"

to your application AndroidManifest.xml and then call setLayoutDirection(LayoutDirection.RTL) in your MainActivity onCreate method.

Type	Required
bool	No

---

subtitle

Sets the toolbar subtitle.

Type	Required
string	No

---

subtitleColor

Sets the toolbar subtitle color.

Type	Required
color	No

---

testID

Used to locate this view in end-to-end tests.

Type	Required
string	No

---

title

Sets the toolbar title.

Type	Required
string	No

---

titleColor

Sets the toolbar title color.

Type	Required
color	No