Tutorial da barra de ferramentas do Android – Layout XML e Kotlin

Tutorial da Barra de Ferramentas do Android: Layout XML e Kotlin

Introdução

A barra de ferramentas é um componente essencial na interface do usuário do Android que fornece um local consistente para ações comuns, como navegação, pesquisa e configurações. Ela é composta por uma barra de título, que contém o título da tela atual, e uma barra de ações, que contém ícones de ação e widgets.

Neste tutorial, aprenderemos como criar e personalizar uma barra de ferramentas usando XML e Kotlin. Vamos orientá-lo no processo de definição do layout XML da barra de ferramentas, adicionando ícones de ação e widgets e gerenciando cliques em itens da barra de ações.

Definindo o Layout XML da Barra de Ferramentas

Para definir o layout XML da barra de ferramentas, abra o arquivo activity_main.xml e adicione o seguinte código:

xml
<androidx.appcompat.widget.Toolbar
android:id="@+id/toolbar"
android:layout_width="match_parent"
android:layout_height="?attr/actionBarSize"
android:background="?attr/colorPrimary"
android:theme="@style/ThemeOverlay.AppCompat.Dark.ActionBar" />

Este código cria uma barra de ferramentas com um ID de “toolbar”. Ela tem uma largura de largura total e uma altura que corresponde ao tamanho da barra de ação. A barra de ferramentas tem um plano de fundo de cor primária e usa o tema padrão do Android para barras de ações escuras.

  Como escolher seu software de gerenciamento de projetos

Adicionando Ícones de Ação

Os ícones de ação são exibidos na barra de ações e representam ações comuns, como pesquisar, compartilhar ou salvar. Para adicionar um ícone de ação, use o elemento <item> dentro do elemento <menu>:

xml
<menu xmlns:android="http://schemas.android.com/apk/res/android">
<item
android:id="@+id/action_search"
android:title="Pesquisar"
android:icon="@drawable/ic_search" />
<item
android:id="@+id/action_share"
android:title="Compartilhar"
android:icon="@drawable/ic_share" />
</menu>

Este código define dois ícones de ação: um para pesquisar e outro para compartilhar. O ID do ícone de ação é usado para identificar o item quando ele é clicado.

Manipulando Cliques em Itens da Barra de Ações

Para lidar com os cliques nos itens da barra de ações, precisamos registrar um ouvinte para eventos de clique:

kotlin
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)

// Cria a Toolbar como a barra de ação da atividade
setSupportActionBar(findViewById(R.id.toolbar))

// Registra o ouvinte de eventos de clique
toolbar.setOnMenuItemClickListener { menuItem ->
when (menuItem.itemId) {
R.id.action_search -> {
// Código para a ação de pesquisa
true
}
R.id.action_share -> {
// Código para a ação de compartilhamento
true
}
else -> false
}
}
}

Este código registra um ouvinte para o evento onMenuItemClick da barra de ferramentas. Quando um item da barra de ações é clicado, o ouvinte chama o método onMenuItemClick e passa o item do menu clicado como argumento. O código manipula o clique com base no ID do item do menu.

Customizando a Aparência da Barra de Ferramentas

Além de definir o layout e adicionar ícones de ação, você também pode personalizar a aparência da barra de ferramentas alterando as seguintes propriedades:

Título: Defina o título da tela atual usando o método setTitle da barra de ferramentas.
Tema: Você pode usar um tema personalizado para alterar a aparência geral da barra de ferramentas, como cor do texto, cor do plano de fundo e ícones.
Fonte: Você pode alterar a fonte do texto na barra de ferramentas usando a propriedade android:fontFamily.
Altura: Você pode ajustar a altura da barra de ferramentas usando a propriedade android:layout_height.

Conclusão

A barra de ferramentas é um recurso poderoso que pode melhorar a usabilidade e a experiência do usuário em seus aplicativos Android. Ao entender como criar e personalizar uma barra de ferramentas usando XML e Kotlin, você pode fornecer aos usuários uma interface de usuário consistente e intuitiva.

Lembre-se de testar cuidadosamente seu aplicativo para garantir que a barra de ferramentas esteja funcionando corretamente e atendendo às necessidades de seus usuários. Ao seguir as práticas recomendadas e abordar as personalizações de forma consciente, você pode criar barras de ferramentas eficazes que aprimorem a experiência geral do usuário de seus aplicativos.

FAQs

1. Como eu defino o título da barra de ferramentas?
Use o método setTitle da barra de ferramentas e passe o título desejado como argumento.

2. Como eu adiciono um botão Voltar à barra de ferramentas?
Use o método setNavigationIcon da barra de ferramentas e passe um ícone de retorno como argumento.

3. Como eu altero a cor do plano de fundo da barra de ferramentas?
Altere a propriedade android:background no layout XML da barra de ferramentas.

4. Posso adicionar um widget de pesquisa à barra de ferramentas?
Sim, use o elemento <SearchView> no layout XML da barra de ferramentas.

5. Como eu manipulo o evento de clique em um ícone de ação?
Registre um ouvinte para o evento onMenuItemClick da barra de ferramentas e manipule o clique com base no ID do item do menu.

6. Posso ocultar a barra de ferramentas?
Sim, use o método setVisibility(View.GONE) para ocultar a barra de ferramentas.

7. Como eu altero o tamanho do texto na barra de ferramentas?
Use a propriedade android:textSize no layout XML da barra de ferramentas.

8. Posso usar imagens personalizadas como ícones de ação?
Sim, use a propriedade android:icon no elemento <item> do menu e forneça o ID do recurso da imagem.