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. 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 do support library v4
, ele 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 é: 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.
A posição dele pode variar a vontade, isso é uma das vantagens de utilizar o Toolbar
.
Definição do Toolbar
<?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 fica:
<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);
Toolbar tlb = findViewById(R.id.toolbar);
setSupportActionBar(tlb);
// ou
//setActionBar(tlb);
// Apos isso, podera configurar sua ActionBar
// Por exemplo:
getSupportActionBar().setDisplayHomeAsUpEnabled(true);
getSupportActionBar().setHomeButtonEnabled(true);
Em relação a construção de menus, usando setSupportActionBar
ou setActionBar
, as demais callbacks (onCreateOptionsMenu
, onOptionsItemSelected
e etc...) continuam sendo chamados. Logo não é preciso realizar nenhuma alteração ao 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 o Toolbar
usando o setSupportActionBar
ou setActionBar
, irá ter problemas com NullPointerException
nas chamadas do getSupportActionBar
ou getActionBar
.
Se estiver usando Action Mode com o Toolbar
no topo da tela, o Toolbar
não é sobreposto pela barra do Action Mode, como no Action Bar
padrão. A barra do Action Mode fica acima do Toolbar
, logo é recomendado que esconda o Toolbar
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 do setNavigationMode
, logo se usa navegação por abas ou lista (NAVIGATION_MODE_LIST
ou NAVIGATION_MODE_TABS
), deverá migrar para o Toolbar
.
Essa migração pode ser feita adicionando View's
ao Toolbar
, já que ele é um ViewGroup
. Para navegação por abas, poderá adicionar um PagerTabStrip
, ou semelhantes, no Toolbar
. Se estiver usando navegação por lista, poderá adicionar um Spinner
ao Toolbar
, onde terá o mesmo efeito.
Referências:
- http://android-developers.blogspot.com.br/2014/10/appcompat-v21-material-design-for-pre.html
- https://chris.banes.me/2014/10/17/appcompat-v21/