Aller au contenu
SkillCodex
Menu

Tooltip

Infobulle

Une courte aide non interactive qui apparaît au survol ou lorsque le contrôle reçoit le focus clavier.

Essayer le composant
Repères, sources et actions
Sources et révision
Mis à jour le
Version
v1.0.26 · r2
Sources
5 sources
Statut
Publié
Consulter les sources

Tu as peut-être cherché : une petite étiquette quand je survole l'icôneun texte qui explique un bouton au focusune mini aide près du point d'interrogation

Toutes les formulations
Enregistrer et partager

Reconnaître

Petites surfaces contextuelles

Essayer

As-tu besoin d’une explication brève, d’un contenu contextuel interactif ou d’une liste d’actions ?

Infobulle

Contexte commun aux essais

Un espace projet doit révéler une aide brève, des détails complémentaires ou une courte liste d'actions depuis un contrôle compact sans quitter la tâche en cours.

Infobulle

Mission

Info-bulle - Tooltip

Révéler le nom de l'icône au pointeur et au clavier, puis fermer avec Échap.

Exporter le rapport

report-july.pdf

Libellé visible pour le tactile : Exporter le rapport

Résultat de l’essai

L'indication est masquée. Le focus peut rester sur Exporter le rapport.

Étape 1 sur 3

Essayer

Manipule le composant. Le résultat de ton essai apparaît juste au-dessus. Avance à ton rythme.

Comportement et cas limite
À observer
L'aide apparaît près du bouton d'export focalisé, qui reste utilisable.
Cas limite
Sur écran tactile, l'icône garde un moyen visible d'obtenir son nom et aucune information ne dépend uniquement du survol.

Ce que cet essai montre

Choisir Infobulle seulement pour un contenu bref sans élément interactif ; utiliser Popover pour des contrôles ou un contenu plus riche.

Lequel convient à ton besoin ?

Infobulle

Expliquer une icône peu familière

Fenêtre contextuelle

Afficher une explication compacte avec un lien

Quel composant utilises-tu ici ?
Différence et sources

Choisir Infobulle seulement pour un contenu bref sans élément interactif ; utiliser Popover pour des contrôles ou un contenu plus riche.

Consulter les sources

    Parties du spécimen

    Sélectionne un repère numéroté sur le schéma, ou utilise la liste ci-dessous, pour afficher son rôle. Le schéma montre l'état représentatif du concept.

    Déclencheur

    Le contrôle qui ouvre ou révèle la surface.

    Position dans l’atlas

    Carte relationnelle

    Repère le chapitre, les concepts proches et la prochaine décision utile.

    • Chapitre

      Petites surfaces contextuelles

      Infobulle appartient à ce groupe de concepts comparés.

    • Ne pas confondre

      Fenêtre contextuelle

      Choisis Infobulle si quelques mots clarifient une icône peu familière et que leur absence sur mobile est acceptable. Choisis Fenêtre contextuelle si le contenu comprend un lien, un contrôle ou plus d’une phrase ou deux.

      Comparer cette paire
    • Ne pas confondre

      Menu d'actions déroulant

      Choisis Infobulle si un texte court explique simplement une icône ou un contrôle et que rien n’y est cliquable. Choisis Menu d’actions déroulant si l’utilisateur doit choisir une action comme Modifier, Dupliquer ou Archiver.

      Comparer cette paire
    • Prochaine étape

      Compare les concepts du chapitre avant de retenir une implémentation.

      Ouvrir le chapitre

    Avec tes mots

    Comprendre

    Ce que les gens décrivent

    Alias documentés : bulle d'aide, aide au survol, info-bulle

    • une petite étiquette quand je survole l'icône
    • un texte qui explique un bouton au focus
    • une mini aide près du point d'interrogation
    • afficher le sens de l'icône sans cliquer
    • un texte d'aide qui disparaît quand je pars
    • le nom d'une icône seule dans une barre d'outils

    Choisir

    À utiliser quand

    • Expliquer une icône peu familière
    • Développer un libellé court tronqué

    À éviter quand

    • L'information est indispensable pour terminer la tâche
    • Le contenu nécessite des liens, boutons ou champs

    Comparer

    Comparer les concepts proches

    Équivalents par plateforme

    Une même interaction peut changer de nom ou de contrat selon la plateforme. Vérifie la correspondance avant de choisir une API.

    • HTML

      Aucune primitive directe

      Aucune primitive directe

      HTML n'a pas d'élément tooltip robuste ; l'attribut title n'offre pas un contrat clavier et tactile équivalent.

      Vérifié
    • WAI-ARIA APG

      Partiel

      role="tooltip"

      WAI-ARIA APG 2026-09

      Le modèle encore en chantier définit la sémantique et la fermeture, mais le délai, la continuité du pointeur et le placement restent à implémenter.

      Vérifié Documentation officielle
    • Radix UI

      Direct

      Tooltip.Root

      @radix-ui/react-tooltip 1.2.x

      La primitive coordonne déclencheur, délai, portail, contenu, fermeture par Échap, survol et focus.

      Vérifié Documentation officielle
    • shadcn/ui

      Direct

      Tooltip

      shadcn/ui docs 2026-09-03

      La recette Tooltip enveloppe la primitive et le provider Tooltip de Radix.

      Vérifié Documentation officielle
    • Material UI

      Direct

      Tooltip

      Material UI v9.4.0

      Tooltip ancre un contenu descriptif à un enfant et gère focus, survol, tactile, placement et délais.

      Vérifié Documentation officielle
    • SwiftUI

      Partiel

      .help(_:)

      SwiftUI documentation 2026-09

      Le texte d'aide devient une aide au survol sur les plateformes Apple compatibles, sans interaction tooltip uniforme sur iOS.

      Vérifié Documentation officielle
    • Jetpack Compose

      Direct

      TooltipBox + PlainTooltip

      Android Developers 2026-08

      TooltipBox ancre une infobulle simple ou riche et gère survol, appui long, position et état.

      Vérifié Documentation officielle
    • Flutter

      Direct

      Tooltip

      Flutter API docs 2026-09

      Tooltip fournit la surface de libellé Material et les déclencheurs d'entrée de la plateforme autour de son enfant.

      Vérifié Documentation officielle

    Profil d’impact

    Coûts d’implémentation mesurés et contraintes d’exploitation de ce spécimen SkillCodex. Une valeur non évaluée n’est jamais présentée comme gratuite.

    Rendu
    Client
    Poids différé
    22 kB-gzip
    Mesuré ·
    Environnement
    macOS 26.6.2; Node 24.19.0; pnpm 10.34.5; Next.js 16.3.0 Turbopack; Chromium 140
    Méthode
    Sum of gzip -9 bytes for the lazy files of module 50349 in .next/server/app/(en)/term/[slug]/page/react-loadable-manifest.json after pnpm build:local at c9f1299.
    Appareils modestes
    Correct
    Mesuré ·
    Environnement
    macOS 26.6.2; Node 24.19.0; pnpm 10.34.5; Next.js 16.3.0 Turbopack; Chromium 140
    Méthode
    Loaded the 390 x 844 term route in isolated Chromium with 6x CPU throttling and reduced motion, then exercised the first state change; failures are recorded as non-blocking warnings.
    CPU / GPU
    Radix positionne une petite surcouche DOM depuis les événements de pointeur et de focus ; aucun rendu canvas ou WebGL n’est présent.
    Mesuré ·
    Environnement
    macOS 26.6.2; Node 24.19.0; pnpm 10.34.5; Next.js 16.3.0 Turbopack; Chromium 140
    Méthode
    Static source inspection of the target lab module plus an interaction on the isolated Chromium verification route; checked DOM/React work and absence of canvas or WebGL.
    Réduction des animations
    Le contrat global de réduction des animations ramène leurs durées et celles des transitions au minimum ; les mêmes états et contrôles restent disponibles.
    Mesuré ·
    Environnement
    macOS 26.6.2; Node 24.19.0; pnpm 10.34.5; Next.js 16.3.0 Turbopack; Chromium 140
    Méthode
    Inspected src/app/globals.css prefers-reduced-motion rules and repeated the target interaction with reducedMotion=reduce in Chromium.
    Repli statique
    Sans JavaScript, la fiche reste sur son repli Chargement localisé ; le profil et le spécimen initial ne sont pas révélés.
    Mesuré ·
    Environnement
    macOS 26.6.2; Node 24.19.0; pnpm 10.34.5; Next.js 16.3.0 Turbopack; Chromium 140
    Méthode
    Loaded all ten prerendered routes from a local next start build in Chromium with JavaScript disabled; each HTTP 200 remained on the localized Loading fallback, so the profile and specimen were not revealed.
    Rendu serveur
    S’hydrate
    Mesuré ·
    Environnement
    macOS 26.6.2; Node 24.19.0; pnpm 10.34.5; Next.js 16.3.0 Turbopack; Chromium 140
    Méthode
    Inspected the prerendered route response, then loaded the same route with JavaScript enabled and exercised the hydrated client specimen.
    Maintenance
    Stable

    Bon choix

    • Les libellés ou aides brefs et complémentaires pour des contrôles déjà utilisables seuls.

    À éviter quand

    • Le contenu interactif, les instructions indispensables ou une découverte uniquement tactile.

    Checklist de vérification

    Essaie ces gestes dans le lab, puis vérifie les mêmes comportements dans le résultat de ton agent. Adapte les noms d’exemple à ton interface.

    1. 1. À faire

      Survole l’icône, puis atteins cette même icône avec Tab.

      Résultat attendu

      La même explication courte apparaît à la souris et au clavier ; le focus reste sur l’icône.

    2. 2. À faire

      Appuie sur Échap pendant que l’explication est visible, puis continue avec Tab.

      Résultat attendu

      L’explication se ferme sans activer l’icône, et aucun bouton ou lien dans l’infobulle n’entre dans le parcours clavier.

    3. 3. À faire

      Utilise le même bouton sur un écran tactile, sans survol.

      Résultat attendu

      Le rôle du bouton reste compréhensible ; les consignes indispensables sont accessibles sans l’infobulle.

    Contrat complet
    1. 1La même aide est disponible au survol et au focus clavier
    2. 2L'infobulle ne contient aucun contrôle interactif
    3. 3Échap la ferme sans déplacer le focus
    4. 4Les utilisateurs tactiles ne perdent aucune information essentielle

    Comprendre → Reconnaître → Choisir → Comparer

    Pack pour ton agent

    Instructions pré-écrites à coller dans ton agent. Copier n’exécute rien.

    Implémenter correctement

    Construis Infobulle sans casser son comportement

    # Implémenter Infobulle dans ton agent
    
    ## Objectif
    Implémente Infobulle pour ce comportement vérifié : Une courte aide non interactive qui apparaît au survol ou lorsque le contrôle reçoit le focus clavier.
    
    ## Prérequis
    - Inspecte d’abord le dépôt, le design system et les tests existants.
    - Préserve les changements sans rapport et borne les fichiers modifiés.
    - Confirme qu’Infobulle répond au besoin avant de coder.
    
    ## Comportement requis
    - Le survol ou le focus clavier révèle l’information après un court délai.
    - Échap ferme l’infobulle sans déplacer le focus hors de son déclencheur.
    
    ## États à couvrir
    - Infobulle masquée
    - Infobulle visible
    
    ## Accessibilité
    - Rôle ARIA : tooltip
    - Le contrôle principal ou la région nommée pour Infobulle possède un nom accessible stable issu d’un texte visible ou d’un libellé programmatique explicite.
    - Le focus reste sur le déclencheur ; l’infobulle n’entre jamais dans l’ordre de tabulation.
    - Elle se ferme avec Échap et lorsque le focus et le pointeur quittent le déclencheur et la surface.
    - Le déclencheur référence la description de l’infobulle afin que la technologie d’assistance la lise sans déplacer le focus.
    - Tab place le focus sur le déclencheur
    - Échap ferme l’infobulle visible
    
    ## Quand ne pas utiliser
    - L’information est indispensable pour terminer la tâche
    - Le contenu nécessite des liens, boutons ou champs
    
    ## Critères d’acceptation
    - La même aide est disponible au survol et au focus clavier
    - L’infobulle ne contient aucun contrôle interactif
    - Échap la ferme sans déplacer le focus
    - Les utilisateurs tactiles ne perdent aucune information essentielle
    
    ## Garde-fous
    - Montre d’abord les changements envisagés avant toute action externe.
    - Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite.
    - Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu.
    
    ## Format de sortie
    - Résultat obtenu ou verdict.
    - Fichiers ou actions concernés.
    - Vérifications exécutées et preuves observables.
    - Blocages ou limites restantes.
    
    • @radix-ui/react-tooltip
    • Prérequis · Accès au dépôt, au design system et aux tests
    Pourquoi ça marche
    • Le besoin est relié au comportement canonique avant toute décision technique.
    • Les états, l’accessibilité et les non-objectifs empêchent une implémentation seulement visuelle.
    • Les critères d’acceptation et le format de sortie rendent la vérification observable.

    À essayer ensuite

    Vérifie Infobulle sur un parcours réel

    # Vérifier Infobulle après l’implémentation
    
    ## Objectif
    Audite l’implémentation d’Infobulle au regard de son comportement, de ses états et de ses exigences d’accessibilité sans la modifier automatiquement.
    
    ## Contrôles
    - Rejoue le plus petit parcours représentatif.
    - Contrôle le clavier, le focus, le nom accessible et les annonces.
    - Relie chaque écart à un critère d’acceptation précis.
    
    ## Garde-fous
    - Montre d’abord les changements envisagés avant toute action externe.
    - Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite.
    - Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu.
    
    ## Format de sortie
    - Résultat obtenu ou verdict.
    - Fichiers ou actions concernés.
    - Vérifications exécutées et preuves observables.
    - Blocages ou limites restantes.
    

    sha256:e868e85db125d3a82ee626f9769cd0fd0d6743e8bf18cc292f95eeec2f6c2223

    Diagnostiquer un problème

    Trouve et corrige le défaut d’Infobulle

    # Déboguer Infobulle dans ton agent
    
    ## Symptôme observé
    [DÉCRIS ICI LE SYMPTÔME]
    
    ## Contrôles observables
    - Reproduis le problème avec le plus petit parcours pertinent.
    - Compare le comportement aux états et transitions documentés d’Infobulle.
    - Vérifie le clavier, le focus, le nom accessible et les annonces.
    
    ## Causes possibles
    - La primitive employée ne correspond pas au comportement attendu.
    - Un état, une transition ou un retour de focus manque.
    - Le composant voisin capture un événement ou masque un signal accessible.
    
    ## Corrections bornées
    - Corrige la cause reproduite sans recréer les composants voisins.
    - Conserve le contrat public et ajoute un test ciblé de non-régression.
    - N’installe aucune dépendance et ne modifie aucun état distant sans autorisation.
    
    ## Vérification finale
    - La même aide est disponible au survol et au focus clavier
    - L’infobulle ne contient aucun contrôle interactif
    - Échap la ferme sans déplacer le focus
    - Les utilisateurs tactiles ne perdent aucune information essentielle
    
    ## Garde-fous
    - Montre d’abord les changements envisagés avant toute action externe.
    - Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite.
    - Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu.
    
    ## Format de sortie
    - Résultat obtenu ou verdict.
    - Fichiers ou actions concernés.
    - Vérifications exécutées et preuves observables.
    - Blocages ou limites restantes.
    
    • @radix-ui/react-tooltip
    • Prérequis · Accès au dépôt, au design system et aux tests
    Pourquoi ça marche
    • Le symptôme explicite évite de partir d’une correction supposée.
    • Les contrôles séparent comportement, accessibilité et interférences voisines.
    • La correction reste bornée et doit produire une preuve de non-régression.

    À essayer ensuite

    Verrouille la correction d’Infobulle

    # Empêcher la régression d’Infobulle
    
    ## Objectif
    Transforme la cause reproduite en test de non-régression ciblé et compare Infobulle aux concepts voisins avant d’élargir la correction.
    
    ## Contrôles
    - Prouve que le test échoue avant la correction.
    - Prouve qu’il passe après la correction bornée.
    - Vérifie qu’aucun composant voisin n’a changé de comportement.
    
    ## Garde-fous
    - Montre d’abord les changements envisagés avant toute action externe.
    - Ne publie, n’envoie, ne supprime, ne paie et ne modifie aucun état distant sans autorisation explicite.
    - Préserve les changements sans rapport et arrête-toi si le périmètre devient ambigu.
    
    ## Format de sortie
    - Résultat obtenu ou verdict.
    - Fichiers ou actions concernés.
    - Vérifications exécutées et preuves observables.
    - Blocages ou limites restantes.
    

    sha256:9d39ac8dc723ea6868aea1c3885f3b8fb9f8fe1d580429f666c95177e9739dbe

    Fiche complète, enregistrement et provenance

    Instruction pré-écrite par SkillCodex — ta demande n’est ni envoyée ni utilisée pour adapter ce texte ; aucun contenu n’est généré et copier n’exécute rien.

    Digest du Pack: sha256:720625a157248227162f6515e2ccb985cd42be2766f7c815a117b65b371b50c7

    Dans le code

    TechnologiePrimitiveVersionLimite
    @radix-ui/react-tooltip

    Tooltip.Root

    @radix-ui/react-tooltip@1.2.12Radix fournit la primitive ; le contenu, la temporisation, le repli tactile et les tests d’accessibilité finaux restent à la charge du produit.

    Détails techniques

    Comportements

    • Révéler au focus ou au survol

      Le survol ou le focus clavier révèle l'information après un court délai.

    • Fermer l’infobulle avec Échap

      Échap ferme l’infobulle sans déplacer le focus hors de son déclencheur.

    États

    • Infobulle masquée

      Infobulle masquée

    • Infobulle visible

      Infobulle visible

    Transitions d’état

    • Infobulle masquée → Infobulle visible

      Le survol au pointeur ou le focus clavier atteint le déclencheur.

    • Infobulle visible → Infobulle masquée

      Le pointeur et le focus quittent à la fois le déclencheur et la surface de l’infobulle, ou Échap ferme l’aide.

    Scénarios de test

    Contexte
    Une barre d'outils d'analyse compacte contient une icône d'export peu familière.
    Mission
    Révéler le nom de l'icône au pointeur et au clavier, puis fermer avec Échap.
    État principal
    L'aide apparaît près du bouton d'export focalisé, qui reste utilisable.
    Cas limite
    Sur écran tactile, l'icône garde un moyen visible d'obtenir son nom et aucune information ne dépend uniquement du survol.

    Signaux visuels

    • Petite surface de texte flottante
    • Ancrée visuellement à un contrôle
    • Aucun contrôle de formulaire à l'intérieur

    Signaux comportementaux

    • S'ouvre au survol et au focus
    • Se ferme quand le survol ou le focus part
    • Ne demande jamais un clic pour être lue

    Accessibilité

    Rôle
    tooltip
    Nom accessible
    Le contrôle principal ou la région nommée pour Infobulle possède un nom accessible stable issu d’un texte visible ou d’un libellé programmatique explicite.
    Focus clavier
    Le focus reste sur le déclencheur ; l'infobulle n'entre jamais dans l'ordre de tabulation.
    Fermeture
    Elle se ferme avec Échap et lorsque le focus et le pointeur quittent le déclencheur et la surface.
    Défilement
    Le défilement de la page reste disponible. La surface flottante reste ancrée à son déclencheur ou se ferme lorsque celui-ci quitte la zone visible.
    Annonce
    Le déclencheur référence la description de l'infobulle afin que la technologie d'assistance la lise sans déplacer le focus.
    Clavier
    • Tab place le focus sur le déclencheur
    • Échap ferme l'infobulle visible

    Implémentations

    Ouvrir la matrice HTML, ARIA, Radix et shadcn
    • Tooltip.Root

      implementationKind
      radix
      nativeElement
      Non applicable
      ariaPattern
      tooltip
      radixPrimitive
      Tooltip
      shadcnRecipe
      Tooltip
      runtimeDependency
      @radix-ui/react-tooltip@1.2.12
      packageName
      @radix-ui/react-tooltip
      exportName
      Tooltip.Root
      exactVersion
      1.2.12
      status
      verified
      sourceId
      source-ui-radix-tooltip
      deprecationStatus
      active
      replacement
      Non applicable
      validFrom
      Non applicable
      validUntil
      Non applicable

      Limite d’équivalence : Radix fournit la primitive ; le contenu, la temporisation, le repli tactile et les tests d’accessibilité finaux restent à la charge du produit.

      Vérifier la source du binding

    Sources

    • WAI-ARIA APG: Tooltip Pattern
      sourceId
      source-ui-aria-tooltip
      kind
      documentation
      canonicalUrl
      https://www.w3.org/WAI/ARIA/apg/patterns/tooltip/
      publisher
      W3C WAI
      sourceRevision
      http-last-modified:2026-07-09T07:07:36Z
      consultedAt
      2026-07-19
      license
      Non indiquée
      contentDigest
      sha256:28c008aec8fa19be8f285665c3947ac8c9f2604a07d4265c152ffa706cc92461
      status
      verified

      Affirmation couverte : Infobulle : guide APG informatif encore en chantier sur le rôle tooltip, la description du déclencheur, le maintien du focus et du pointeur, et la fermeture avec Échap.

    • Radix Primitives: Tooltip
      sourceId
      source-ui-radix-tooltip
      kind
      documentation
      canonicalUrl
      https://www.radix-ui.com/primitives/docs/components/tooltip
      publisher
      Radix Primitives
      sourceRevision
      http-etag:W/"1f572f9b054bd892ec8e5278b0f51784"
      consultedAt
      2026-07-19
      license
      Non indiquée
      contentDigest
      sha256:9903397fd5843b9540c50b93b3a2b676de6a51dafe5251383aa1761987d996c7
      status
      verified

      Affirmation couverte : Infobulle : parties, API d'état, interactions et limites d'implémentation documentées pour Radix Tooltip.

    • WAI-ARIA 1.2: Roles Model
      sourceId
      source-ui-wai-aria-roles
      kind
      standard
      canonicalUrl
      https://www.w3.org/TR/wai-aria-1.2/#roles
      publisher
      W3C WAI
      sourceRevision
      W3C-REC-wai-aria-1.2-20230606
      consultedAt
      2026-07-19
      license
      Non indiquée
      contentDigest
      sha256:c0fea16fc747779569ab754d2d25bca3e2b7e8a673b8ef5362aeb9ebc73a4849
      status
      verified

      Affirmation couverte : Infobulle : définitions normatives des rôles ARIA et contraintes du rôle accessible indiqué.

    • WCAG 2.2: Focus Appearance
      sourceId
      source-ui-wcag-understanding-focus-appearance
      kind
      documentation
      canonicalUrl
      https://www.w3.org/WAI/WCAG22/Understanding/focus-appearance.html
      publisher
      W3C WAI
      sourceRevision
      http-last-modified:2026-07-02T10:07:49Z
      consultedAt
      2026-07-19
      license
      Non indiquée
      contentDigest
      sha256:fdcf316a1f0e3cc758eda9618322d132862124ff0a3f3b1a3acbf20daf804ff0
      status
      verified

      Affirmation couverte : Infobulle : guide WCAG informatif pour évaluer l'apparence visible du focus clavier.

    • Radix Primitives: Popover
      sourceId
      source-ui-radix-popover
      kind
      documentation
      canonicalUrl
      https://www.radix-ui.com/primitives/docs/components/popover
      publisher
      Radix Primitives
      sourceRevision
      http-etag:W/"336d513dc97145e18c472483daaa33ec"
      consultedAt
      2026-07-19
      license
      Non indiquée
      contentDigest
      sha256:b1da962392e2eef1748cf3038190d63d3a3ac94b2267bfb5e38414c773620964
      status
      verified

      Affirmation couverte : Infobulle : parties, API d'état, interactions et limites d'implémentation documentées pour Radix Popover.