Pular para o conteúdo

Mais visitados

Visitados recentemente

navigation

Configuração da barra do aplicativo

Em sua forma mais básica, a barra de ações exige o título da atividade em um lado e um menu flutuante no outro. Mesmo nesse formato simples, a barra do aplicativo fornece informações úteis para os usuários e ajuda a dar uma aparência consistente aos aplicativos Android.

Figura 1. Uma barra de aplicativo com o título do aplicativo e um menu flutuante.

A partir do Android 3.0 (nível de API 11), todas as atividades que usarem o tema padrão terão ActionBar como barra do aplicativo. No entanto, os recursos da barra do aplicativo foram gradualmente adicionados à ActionBar nativa ao longo de várias versões do Android. Consequentemente, a ActionBar nativa se comporta de forma diferente dependendo da versão do sistema Android usada pelo dispositivo. Em contraste, os recursos mais recentes foram adicionados à versão do Toolbar da biblioteca de suporte e eles estão dispositivos em qualquer dispositivo que use essa biblioteca.

Por esse motivo, você deve usar a classe Toolbar da biblioteca de suporte para implementar as barras de aplicativo das suas atividades. O uso da barra de ferramentas da biblioteca de suporte ajuda a garantir que seu aplicativo tenha um comportamento consistente no conjunto mais amplo de dispositivos. Por exemplo, o widget Toolbar fornece uma experiência de material design em dispositivos com o Android 2.1 (nível de API 7) ou posterior, mas a barra de ações nativa não oferece suporte ao material design a não ser que o dispositivo esteja executando o Android 5.0 (nível de API 21) ou posterior.

Adicionar uma barra de ferramentas a uma atividade

Essas etapas descrevem como configurar um Toolbar como a barra de aplicativo da sua atividade:
  1. Adicione a biblioteca de suporte v7 appcompat ao seu projeto, conforme é descrito na seção Configuração da biblioteca de suporte.
  2. Certifique-se de que a atividade estenda AppCompatActivity:
    public class MyActivity extends AppCompatActivity {
      // ...
    }
    

    Observação: Faça essa alteração para cada atividade do seu aplicativo que use um Toolbar como barra de aplicativo.

  3. No manifesto do aplicativo, configure o elemento <application> para usar um dos temas NoActionBar da appcompat. O uso de um desses temas impede que o aplicativo use a classe ActionBar nativa para fornecer a barra do aplicativo. Por exemplo:
    <application
        android:theme="@style/Theme.AppCompat.Light.NoActionBar"
        />
    
  4. Adicione um Toolbar ao layout da atividade. Por exemplo, o código de layout a seguir adiciona um Toolbar e faz com que ele pareça flutuar acima da atividade:
    <android.support.v7.widget.Toolbar
       android:id="@+id/my_toolbar"
       android:layout_width="match_parent"
       android:layout_height="?attr/actionBarSize"
       android:background="?attr/colorPrimary"
       android:elevation="4dp"
       android:theme="@style/ThemeOverlay.AppCompat.ActionBar"
       app:popupTheme="@style/ThemeOverlay.AppCompat.Light"/>
    

    A especificação de Material Design recomenda que barras de aplicativos tenham uma elevação de 4 dp.

    Posicione a barra de ferramentas no topo do layout da atividade, pois você a usará como uma barra de aplicativo.

  5. No método onCreate() da atividade, chame o método setSupportActionBar() da atividade e passe a barra de ferramentas da atividade. Esse método define a barra de ferramentas como a barra do aplicativo para a atividade. Por exemplo:
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_my);
        Toolbar myToolbar = (Toolbar) findViewById(R.id.my_toolbar);
        setSupportActionBar(myToolbar);
        }
    

Seu aplicativo agora tem uma barra de ações básica. Por padrão, a barra de ações contém apenas o nome do aplicativo e um menu flutuante. O menu de opções inicialmente contém apenas o item Settings. Você pode adicionar mais ações à barra de ações e ao menu flutuante, conforme é descrito em Adição e gerenciamento de ações.

Usar os métodos utilitários da barra do aplicativo

Após definir a barra de ferramentas como a barra de aplicativo de uma atividade, você tem acesso aos vários métodos utilitários fornecidos pela classe ActionBar da biblioteca de suporte v7 appcompat. Essa abordagem permite que você realize várias atividades úteis, como ocultar e mostrar a barra do aplicativo.

Para usar os métodos utilitários da ActionBar, chame o método getSupportActionBar() da atividade. Esse método retorna uma referência a um objeto ActionBar da appcompat. Quando tiver essa referência, você pode chamar qualquer um dos métodos da ActionBar para ajustar a barra do aplicativo. Por exemplo, para ocultar a barra do aplicativo, chame ActionBar.hide().

Este site usa cookies para armazenar suas preferências quanto às opções de idioma e exibição específicas ao site.

Receba as dicas e notícias mais recentes para desenvolvedores Android que ajudarão você a ter sucesso no Google Play.

* Campos obrigatórios

Uhu!

Siga o Google Developers no WeChat

Navegar neste site em ?

Você solicitou uma página em , mas sua preferência de idioma para este site está definida como .

Quer alterar sua preferência de idioma e navegar neste site em ? Para alterar a preferência de idioma depois, use o menu de idiomas na parte inferior de cada página.

É preciso ter o nível de API ou superior para esta aula

Este documento está oculto porque o nível de API selecionado para a documentação é o . Para alterar o nível, clique no seletor acima da barra de navegação esquerda.

Para mais informações sobre como especificar o nível de API que o seu app precisa, leia o artigo Compatibilidade com diferentes versões de plataforma.

Take a short survey?
Help us improve the Android developer experience. (April 2018 — Developer Survey)