Para usar o Toolbar
, você tem duas opções:
- Se seu aplicativo precisa suportar versões anteriores a 21 então deve usar o
android.support.v7.widget.Toolbar
em seus layouts; - Caso contrário basta usar o
android.widget.Toolbar
.
Para começar, infelizmente, o Toolbar
precisa estar em todos os layouts. Por questões de configurações de atributos de tema e posicionamento. Se instanciar o Toolbar
e adicioná-lo manualmente no layout pode ser complicado ter de configurar sua posição e adicionar todos os atributos para estilizá-lo.
Lembrando que nessa resposta, é preciso importar a library do appcompat v7 21
, ou adicionando o jar se for no Eclipse, ou importando a dependência se for no Android Studio. E como o appcompat
depende da support library v4
, ela precisa ser adicionado também.
Como estou usando o Android Studio, utilizo essas duas dependências:
compile 'com.android.support:appcompat-v7:21.+'
compile 'com.android.support:support-v4:21.+'
Atenção, se está usando o Toolbar como substituto da Action Bar, é preciso usar um tema sem o ActionBar
. Para isso use os temas com final NoActionBar
, tanto do appcompat
quanto na versão 21. Um dos temas que uso eu uso do appcompat
para esse propósito é o Theme.AppCompat.Light.NoActionBar
.
Um exemplo de layout usando o Toolbar
é:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical">
<include android:id="@+id/toolbar" layout="@layout/toolbar_support" />
<FrameLayout
android:id="@+id/am_frame_layout"
android:layout_width="match_parent"
android:layout_height="match_parent" />
</LinearLayout>
Nesse caso, utilizei o include
por questões de reaproveitamento (DRY), supondo que o Toolbar
terá sempre os mesmo atributos em todos os layouts não faz sentido repetir em todos os lugares.
A posição dele pode variar a vontade no layout, e isso é uma das vantagens de se utilizar o Toolbar
.
Definição do Toolbar
no include
:
<?xml version="1.0" encoding="utf-8"?>
<android.support.v7.widget.Toolbar
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
android:id="@+id/toolbar"
android:layout_height="@dimen/ab_height"
android:layout_width="match_parent"
android:minHeight="@dimen/ab_height"
android:background="?attr/colorPrimary"
app:theme="@style/ThemeOverlay.AppCompat.ActionBar"
app:popupTheme="@style/ThemeOverlay.AppCompat.Light" />
Se estiver usando android.widget.Toolbar
, a definição ficaria:
<android.widget.Toolbar
xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/toolbar"
android:layout_height="@dimen/ab_height"
android:layout_width="match_parent"
android:minHeight="@dimen/ab_height"
android:background="?attr/colorPrimary"
android:theme="@style/ThemeOverlay.Material.ActionBar"
android:popupTheme="@style/ThemeOverlay.Material.Light" />
Na Activity
, algumas coisas precisam ser feitas.
Se quiser usar o Toolbar
como um substituto para o ActionBar
, basta usar o método setSupportActionBar
(appcompat) ou setActionBar
(Android 21) após o setContentView
. Se está usando o appcompat
, é primordial que sua Activity
seja uma subclasse de ActionBarActivity
.
Exemplo:
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// Dando a responsabilidade de Action Bar para o Toolbar
Toolbar tlb = findViewById(R.id.toolbar);
setSupportActionBar(tlb);
// ou
//setActionBar(tlb);
// Apos isso, podera configurar sua Action Bar normalmente
// Por exemplo:
getSupportActionBar().setDisplayHomeAsUpEnabled(true);
getSupportActionBar().setHomeButtonEnabled(true);
Para usar setSupportActionBar
ou setActionBar
, é preciso usar um tema que não tenha Action Bar
, senão terá problemas. Pois está adicionando um Action Bar
a uma Window
que já tem um. Para isso use um dos temas com sufixo *.NoActionBar
(e.g: Theme.AppCompat.NoActionBar
, Theme.Material.NoActionBar
e etc...)
Em relação a construção de menus, usando setSupportActionBar
ou setActionBar
, as demais callbacks (onCreateOptionsMenu
, onOptionsItemSelected
e etc...) continuam sendo chamados igualmente. Logo não é preciso realizar nenhuma alteração no código.
Caso não esteja setando o Toolbar
como ActionBar
, é preciso usar o método Toolbar.inflateMenu
para adicionar itens de menu ao Toolbar
.
Algumas observações importantes
Se usar um dos temas sem Action Bar (e.g:
Theme.AppCompat.Light.NoActionBar
), e não setar oToolbar
usando osetSupportActionBar
ousetActionBar
, irá ter problemas comNullPointerException
nas chamadas dogetSupportActionBar
ougetActionBar
.Se estiver usando Action Mode com o
Toolbar
no topo da tela, oToolbar
não é sobreposto pela barra do Action Mode , como noAction Bar
padrão. A barra do Action Mode fica acima doToolbar
. Para evitar esse problema recomendo que esconda oToolbar
durante o Action Mode.Um exemplo seria:
@Override public boolean onCreateActionMode(ActionMode actionMode, Menu menu) { MenuInflater inflater = actionMode.getMenuInflater(); inflater.inflate(R.menu.custom_deck_cab, menu); Toolbar tlb = findViewById(R.id.toolbar); tlb.setVisibility(View.GONE); return true; } @Override public void onDestroyActionMode(ActionMode actionMode) { Toolbar tlb = findViewById(R.id.toolbar); tlb.setVisibility(View.VISIBLE); }
Nessa nova versão, houve a depreciação dos métodos relacionados aos modos de navegação do
Action Bar
(e.g:setNavigationMode
,setSelectedNavigationItem
esetListNavigationCallbacks
), logo se usa navegação por abas ou lista (NAVIGATION_MODE_LIST
ouNAVIGATION_MODE_TABS
), deverá migrar para oToolbar
.Essa migração pode ser feita adicionando
View's
aoToolbar
, já que ele é umViewGroup
. Para navegação por abas, poderá adicionar umPagerTabStrip
, ou semelhantes, noToolbar
. Se estiver usando navegação por lista, poderá adicionar umSpinner
aoToolbar
, e conseguirá o mesmo efeito.