Info-bulles

Essayer Compose
Jetpack Compose est le kit d'outils d'interface utilisateur recommandé pour Android. Découvrez comment ajouter des composants dans Compose.

Une info-bulle est un petit message descriptif qui s'affiche à côté d'une vue lorsque les utilisateurs appuient dessus de manière prolongée ou passent la souris dessus. Cela est utile lorsque votre application utilise une icône pour représenter une action ou une information afin d'économiser de l'espace dans la mise en page. Cette page vous explique comment ajouter ces info-bulles sous Android 8.0 (niveau d'API 26) ou version ultérieure.

Certains scénarios, tels que ceux des applications de productivité, nécessitent une méthode descriptive pour communiquer des idées et des actions. Vous pouvez utiliser des info-bulles pour afficher un message descriptif, comme illustré dans la figure 1.

capture d'écran de l'info-bulle

Figure 1 : Info-bulle affichée dans une application Android.

Certains widgets standards affichent des info-bulles en fonction du contenu des propriétés title ou content description. À partir d'Android 8.0, vous pouvez spécifier le texte affiché dans l'info-bulle, quelle que soit la valeur des autres propriétés.

Définition du texte de l'info-bulle

Vous pouvez spécifier le texte de l'info-bulle dans un élément View en appelant la méthode setTooltipText(). Vous pouvez définir la propriété tooltipText à l'aide de l'attribut XML ou de l'API correspondants.

Pour spécifier le texte de l'info-bulle dans vos fichiers XML, définissez l'attribut android:tooltipText, comme indiqué dans l'exemple suivant:

<android.support.design.widget.FloatingActionButton
        android:id="@+id/fab"
        android:tooltipText="Send an email" />

Pour spécifier le texte de l'info-bulle dans votre code, utilisez la méthode setTooltipText(CharSequence), comme indiqué dans l'exemple suivant:

Kotlin

val fab: FloatingActionButton = findViewById(R.id.fab)
fab.tooltipText = "Send an email"

Java

FloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab);
fab.setTooltipText("Send an email");

L'API inclut également une méthode getTooltipText() que vous pouvez utiliser pour récupérer la valeur de la propriété tooltipText.

Android affiche la valeur de la propriété tooltipText lorsque les utilisateurs passent la souris sur la vue ou appuient dessus de manière prolongée.