Tutoriel sur les barres d’outils Android – Mise en page XML et Kotlin
Table des matières
Introduction
Une barre d’outils est un composant crucial de l’interface utilisateur d’Android qui fournit un accès rapide aux actions courantes ou aux options de navigation. Pour créer une barre d’outils personnalisée dans votre application Android, vous devez utiliser une combinaison de mise en page XML et de code Kotlin. Ce tutoriel vous guidera étape par étape dans le processus de création d’une barre d’outils Android fonctionnelle à l’aide de ces technologies.
Configuration de la mise en page XML
Créer un nouveau projet
Commencez par créer un nouveau projet Android dans Android Studio. Nommez-le « ToolbarTutorial ».
Ajouter une barre d’outils au fichier de mise en page
Dans le fichier de mise en page MainActivity.xml, ajoutez le code suivant pour définir la barre d’outils :
xml
<androidx.appcompat.widget.Toolbar
android:id="@+id/toolbar"
android:layout_width="match_parent"
android:layout_height="?attr/actionBarSize"
android:background="?attr/colorPrimary"
app:title="Ma barre d'outils" />
* android:id="@+id/toolbar"
: attribue un ID à la barre d’outils pour y faire référence dans le code.
* android:layout_width="match_parent"
: fait correspondre la largeur de la barre d’outils à celle du parent.
* android:layout_height="?attr/actionBarSize"
: définit la hauteur de la barre d’outils à la taille de la barre d’action.
* android:background="?attr/colorPrimary"
: définit la couleur d’arrière-plan de la barre d’outils selon la couleur principale du thème.
* app:title="Ma barre d'outils"
: définit le titre de la barre d’outils.
Implémentation du code Kotlin
Obtenir une instance de la barre d’outils
Dans le fichier MainActivity.kt, obtenez une instance de la barre d’outils à l’aide de la méthode findViewById()
:
kotlin
val toolbar = findViewById<androidx.appcompat.widget.Toolbar>(R.id.toolbar)
Définir la barre d’outils comme barre d’action
Pour utiliser la barre d’outils comme barre d’action, appelez la méthode setSupportActionBar()
sur l’instance de la barre d’outils :
kotlin
setSupportActionBar(toolbar)
Modifier les propriétés de la barre d’outils
Vous pouvez modifier les propriétés de la barre d’outils, telles que le titre et le sous-titre, en utilisant les méthodes appropriées :
kotlin
toolbar.title = "Nouveau titre"
toolbar.subtitle = "Nouveau sous-titre"
Options de menu
Ajouter des options de menu
Pour ajouter des options de menu à la barre d’outils, créez un fichier de menu XML dans le répertoire res/menu
. Par exemple, créez toolbar_menu.xml
:
xml
<menu xmlns:android="http://schemas.android.com/apk/res/android">
<item
android:id="@+id/action_settings"
android:title="Paramètres"
android:icon="@drawable/ic_settings" />
</menu>
Gonfler et gérer les options de menu
Dans MainActivity.kt
, gonflez le fichier de menu et gérez les clics sur les options de menu :
kotlin
override fun onCreateOptionsMenu(menu: Menu?): Boolean {
menuInflater.inflate(R.menu.toolbar_menu, menu)
return super.onCreateOptionsMenu(menu)
}
override fun onOptionsItemSelected(item: MenuItem): Boolean {
when (item.itemId) {
R.id.action_settings -> {
// Gérer le clic sur l'option Paramètres
return true
}
}
return super.onOptionsItemSelected(item)
}
Conclusion
Ce tutoriel vous a guidé dans le processus de création d’une barre d’outils Android fonctionnelle à l’aide de XML et de Kotlin. Vous avez appris à configurer la mise en page de la barre d’outils, à obtenir une instance de celle-ci, à modifier ses propriétés et à ajouter des options de menu. En utilisant ces techniques, vous pouvez créer des barres d’outils personnalisées pour améliorer l’expérience utilisateur de vos applications.
N’oubliez pas que la personnalisation des barres d’outils peut varier selon les versions d’Android et les appareils. Testez toujours votre application sur différents appareils et versions d’Android pour assurer la compatibilité.
FAQ
1. Comment masquer la barre d’outils ?
– Utilisez la méthode setSupportActionBar(null)
pour masquer la barre d’outils.
2. Comment modifier la couleur de la barre d’outils ?
– Définissez la propriété android:background
dans le fichier de mise en page ou utilisez la méthode setBackgroundColor()
dans le code Kotlin.
3. Comment ajouter un logo à la barre d’outils ?
– Utilisez la propriété app:logo
dans le fichier de mise en page ou appelez la méthode setLogo()
dans le code Kotlin.
4. Comment ajouter un bouton de navigation à la barre d’outils ?
– Ajoutez un bouton de navigation dans le fichier de mise en page et personnalisez-le à l’aide du code Kotlin.
5. Comment afficher un bouton de débordement dans la barre d’outils ?
– Ajoutez un menu au fichier de mise en page et utilisez la méthode setDisplayHomeAsUpEnabled()
pour afficher le bouton de débordement.
6. La barre d’outils n’affiche pas le titre. Pourquoi ?
– Vérifiez si la barre d’outils a été définie comme barre d’action à l’aide de setSupportActionBar()
.
7. Les options de menu ne sont pas cliquables. Pourquoi ?
– Assurez-vous d’avoir gonflé le fichier de menu et d’avoir géré les clics sur les éléments du menu dans le code Kotlin.
8. La barre d’outils ne s’affiche pas sur tous les appareils. Pourquoi ?
– Vérifiez la compatibilité de la mise en page de la barre d’outils avec différents appareils et versions d’Android.