ActionBarDrawerToggle

Kotlin |Java

open class ActionBarDrawerToggle : DrawerLayout.DrawerListener

kotlin.Any
↳	androidx.appcompat.app.ActionBarDrawerToggle

This class provides a handy way to tie together the functionality of DrawerLayout and the framework ActionBar to implement the recommended design for navigation drawers.

To use ActionBarDrawerToggle, create one in your Activity and call through to the following methods corresponding to your Activity callbacks:

• onConfigurationChanged
• onOptionsItemSelected

Call syncState() from your Activity's onPostCreate to synchronize the indicator with the state of the linked DrawerLayout after onRestoreInstanceState has occurred.

ActionBarDrawerToggle can be used directly as a DrawerLayout.DrawerListener, or if you are already providing your own listener, call through to each of the listener methods from your own.

You can customize the the animated toggle by defining the androidx.appcompat.R.styleable#DrawerArrowToggle in your ActionBar theme.

Summary

Nested classes
abstract	Delegate
abstract	DelegateProvider Allows an implementing Activity to return an ActionBarDrawerToggle.Delegate to use with ActionBarDrawerToggle.

Public constructors
<init>(activity: Activity!, drawerLayout: DrawerLayout!, @StringRes openDrawerContentDescRes: Int, @StringRes closeDrawerContentDescRes: Int) Construct a new ActionBarDrawerToggle.
<init>(activity: Activity!, drawerLayout: DrawerLayout!, toolbar: Toolbar!, @StringRes openDrawerContentDescRes: Int, @StringRes closeDrawerContentDescRes: Int) Construct a new ActionBarDrawerToggle with a Toolbar.

Public methods
open DrawerArrowDrawable	getDrawerArrowDrawable()
open OnClickListener!	getToolbarNavigationClickListener() Returns the fallback listener for Navigation icon click events.
open Boolean	isDrawerIndicatorEnabled()
open Boolean	isDrawerSlideAnimationEnabled()
open Unit	onConfigurationChanged(newConfig: Configuration!) This method should always be called by your Activity's onConfigurationChanged method.
open Unit	onDrawerClosed(drawerView: View) DrawerLayout.DrawerListener callback method.
open Unit	onDrawerOpened(drawerView: View) DrawerLayout.DrawerListener callback method.
open Unit	onDrawerSlide(drawerView: View, slideOffset: Float) DrawerLayout.DrawerListener callback method.
open Unit	onDrawerStateChanged(newState: Int) DrawerLayout.DrawerListener callback method.
open Boolean	onOptionsItemSelected(item: MenuItem!) This method should be called by your Activity's onOptionsItemSelected method.
open Unit	setDrawerArrowDrawable(@NonNull drawable: DrawerArrowDrawable) Sets the DrawerArrowDrawable that should be shown by this ActionBarDrawerToggle.
open Unit	setDrawerIndicatorEnabled(enable: Boolean) Enable or disable the drawer indicator.
open Unit	setDrawerSlideAnimationEnabled(enabled: Boolean) Specifies whether the drawer arrow should animate when the drawer position changes.
open Unit	setHomeAsUpIndicator(indicator: Drawable!) Set the up indicator to display when the drawer indicator is not enabled.
open Unit	setHomeAsUpIndicator(resId: Int) Set the up indicator to display when the drawer indicator is not enabled.
open Unit	setToolbarNavigationClickListener(onToolbarNavigationClickListener: OnClickListener!) When DrawerToggle is constructed with a Toolbar, it sets the click listener on the Navigation icon.
open Unit	syncState() Synchronize the state of the drawer indicator/affordance with the linked DrawerLayout.

Public constructors

<init>

ActionBarDrawerToggle(
    activity: Activity!, 
    drawerLayout: DrawerLayout!, 
    @StringRes openDrawerContentDescRes: Int, 
    @StringRes closeDrawerContentDescRes: Int)

Construct a new ActionBarDrawerToggle.

The given Activity will be linked to the specified DrawerLayout and its Actionbar's Up button will be set to a custom drawable.

This drawable shows a Hamburger icon when drawer is closed and an arrow when drawer is open. It animates between these two states as the drawer opens.

String resources must be provided to describe the open/close drawer actions for accessibility services.

Parameters
activity	Activity!: The Activity hosting the drawer. Should have an ActionBar.
drawerLayout	DrawerLayout!: The DrawerLayout to link to the given Activity's ActionBar
openDrawerContentDescRes	Int: A String resource to describe the "open drawer" action for accessibility
closeDrawerContentDescRes	Int: A String resource to describe the "close drawer" action for accessibility

<init>

ActionBarDrawerToggle(
    activity: Activity!, 
    drawerLayout: DrawerLayout!, 
    toolbar: Toolbar!, 
    @StringRes openDrawerContentDescRes: Int, 
    @StringRes closeDrawerContentDescRes: Int)

Construct a new ActionBarDrawerToggle with a Toolbar.

The given Activity will be linked to the specified DrawerLayout and the Toolbar's navigation icon will be set to a custom drawable. Using this constructor will set Toolbar's navigation click listener to toggle the drawer when it is clicked.

This drawable shows a Hamburger icon when drawer is closed and an arrow when drawer is open. It animates between these two states as the drawer opens.

String resources must be provided to describe the open/close drawer actions for accessibility services.

Please use ActionBarDrawerToggle(Activity, DrawerLayout, int, int) if you are setting the Toolbar as the ActionBar of your activity.

Parameters
activity	Activity!: The Activity hosting the drawer.
toolbar	Toolbar!: The toolbar to use if you have an independent Toolbar.
drawerLayout	DrawerLayout!: The DrawerLayout to link to the given Activity's ActionBar
openDrawerContentDescRes	Int: A String resource to describe the "open drawer" action for accessibility
closeDrawerContentDescRes	Int: A String resource to describe the "close drawer" action for accessibility

Public methods

getDrawerArrowDrawable

@NonNull open fun getDrawerArrowDrawable(): DrawerArrowDrawable

Return
DrawerArrowDrawable	DrawerArrowDrawable that is currently shown by the ActionBarDrawerToggle.

getToolbarNavigationClickListener

open fun getToolbarNavigationClickListener(): OnClickListener!

Returns the fallback listener for Navigation icon click events.

Return
OnClickListener!	The click listener which receives Navigation click events from Toolbar when drawer indicator is disabled.

See Also

• #setToolbarNavigationClickListener(android.view.View.OnClickListener)
• #setDrawerIndicatorEnabled(boolean)
• #isDrawerIndicatorEnabled()

isDrawerIndicatorEnabled

open fun isDrawerIndicatorEnabled(): Boolean

Return
Boolean	true if the enhanced drawer indicator is enabled, false otherwise

See Also

• #setDrawerIndicatorEnabled(boolean)

isDrawerSlideAnimationEnabled

open fun isDrawerSlideAnimationEnabled(): Boolean

Return
Boolean	whether the drawer slide animation is enabled

onConfigurationChanged

open fun onConfigurationChanged(newConfig: Configuration!): Unit

This method should always be called by your Activity's onConfigurationChanged method.

Parameters
newConfig	Configuration!: The new configuration

onDrawerClosed

open fun onDrawerClosed(drawerView: View): Unit

DrawerLayout.DrawerListener callback method. If you do not use your ActionBarDrawerToggle instance directly as your DrawerLayout's listener, you should call through to this method from your own listener object.

Parameters
drawerView	View: Drawer view that is now closed

onDrawerOpened

open fun onDrawerOpened(drawerView: View): Unit

DrawerLayout.DrawerListener callback method. If you do not use your ActionBarDrawerToggle instance directly as your DrawerLayout's listener, you should call through to this method from your own listener object.

Parameters
drawerView	View: Drawer view that is now open

onDrawerSlide

open fun onDrawerSlide(
    drawerView: View, 
    slideOffset: Float
): Unit

DrawerLayout.DrawerListener callback method. If you do not use your ActionBarDrawerToggle instance directly as your DrawerLayout's listener, you should call through to this method from your own listener object.

Parameters
drawerView	View: The child view that was moved
slideOffset	Float: The new offset of this drawer within its range, from 0-1

onDrawerStateChanged

open fun onDrawerStateChanged(newState: Int): Unit

DrawerLayout.DrawerListener callback method. If you do not use your ActionBarDrawerToggle instance directly as your DrawerLayout's listener, you should call through to this method from your own listener object.

Parameters
newState	Int: The new drawer motion state

onOptionsItemSelected

open fun onOptionsItemSelected(item: MenuItem!): Boolean

This method should be called by your Activity's onOptionsItemSelected method. If it returns true, your onOptionsItemSelected method should return true and skip further processing.

Parameters
item	MenuItem!: the MenuItem instance representing the selected menu item

Return
Boolean	true if the event was handled and further processing should not occur

setDrawerArrowDrawable

open fun setDrawerArrowDrawable(@NonNull drawable: DrawerArrowDrawable): Unit

Sets the DrawerArrowDrawable that should be shown by this ActionBarDrawerToggle.

Parameters
drawable	DrawerArrowDrawable: DrawerArrowDrawable that should be shown by this ActionBarDrawerToggle

setDrawerIndicatorEnabled

open fun setDrawerIndicatorEnabled(enable: Boolean): Unit

Enable or disable the drawer indicator. The indicator defaults to enabled.

When the indicator is disabled, the ActionBar will revert to displaying the home-as-up indicator provided by the Activity's theme in the android.R.attr.homeAsUpIndicator attribute instead of the animated drawer glyph.

Parameters
enable	Boolean: true to enable, false to disable

setDrawerSlideAnimationEnabled

open fun setDrawerSlideAnimationEnabled(enabled: Boolean): Unit

Specifies whether the drawer arrow should animate when the drawer position changes.

Parameters
enabled	Boolean: if this is true then the animation will run, else it will be skipped

setHomeAsUpIndicator

open fun setHomeAsUpIndicator(indicator: Drawable!): Unit

Set the up indicator to display when the drawer indicator is not enabled.

If you pass null to this method, the default drawable from the theme will be used.

Parameters
indicator	Drawable!: A drawable to use for the up indicator, or null to use the theme's default

See Also

• #setDrawerIndicatorEnabled(boolean)

setHomeAsUpIndicator

open fun setHomeAsUpIndicator(resId: Int): Unit

Set the up indicator to display when the drawer indicator is not enabled.

If you pass 0 to this method, the default drawable from the theme will be used.

Parameters
resId	Int: Resource ID of a drawable to use for the up indicator, or 0 to use the theme's default

See Also

• #setDrawerIndicatorEnabled(boolean)

setToolbarNavigationClickListener

open fun setToolbarNavigationClickListener(onToolbarNavigationClickListener: OnClickListener!): Unit

When DrawerToggle is constructed with a Toolbar, it sets the click listener on the Navigation icon. If you want to listen for clicks on the Navigation icon when DrawerToggle is disabled (setDrawerIndicatorEnabled(boolean), you should call this method with your listener and DrawerToggle will forward click events to that listener when drawer indicator is disabled.

See Also

• #setDrawerIndicatorEnabled(boolean)

syncState

open fun syncState(): Unit

Synchronize the state of the drawer indicator/affordance with the linked DrawerLayout.

This should be called from your Activity's onPostCreate method to synchronize after the DrawerLayout's instance state has been restored, and any other time when the state may have diverged in such a way that the ActionBarDrawerToggle was not notified. (For example, if you stop forwarding appropriate drawer events for a period of time.)