Aller au contenu
SkillCodex
Menu

Icon button

Bouton icône

Un bouton compact représenté visuellement par une icône mais doté de son propre nom d'action accessible et stable.

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 icône corbeille sur laquelle appuyerun bouton compact sans texte visiblele symbole copier dans une barre

Toutes les formulations
Enregistrer et partager

Reconnaître

Déclencher ou naviguer

Essayer

Le contrôle déclenche-t-il une action, change-t-il de destination ou doit-il rester iconique ?

Bouton icône

Contexte commun aux essais

Un écran de projet permet à l'utilisateur de déclencher une opération ou d'atteindre une destination depuis un contrôle adapté à l'espace disponible.

Bouton icône

Mission

Bouton icône - Icon button

Atteindre Copier avec Tab, entendre son nom, activer avec Espace puis révéler son infobulle complémentaire.

pnpm test

Prêt

Résultat de l’essai

Le code n'est pas encore copié.

É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
La cible complète du bouton possède un focus visible, une icône décorative et le nom accessible indépendant Copier le code.
Cas limite
Si l'icône ne charge pas, le nom accessible et la cible restent intacts et l'action reste compréhensible pour la technologie d'assistance.

Ce que cet essai montre

Icon button exécute une action comme Button mais sans texte visible ; Link exige toujours une vraie destination de navigation.

Lequel convient à ton besoin ?

Bouton icône

Une action familière se répète dans une barre dense

Bouton

Envoyer ou réinitialiser un formulaire

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

Icon button exécute une action comme Button mais sans texte visible ; Link exige toujours une vraie destination de navigation.

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.

    Contrôle

    L'élément interactif qui reçoit la saisie et expose son état.

    Position dans l’atlas

    Carte relationnelle

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

    • Chapitre

      Déclencher ou naviguer

      Bouton icône appartient à ce groupe de concepts comparés.

    • Ne pas confondre

      Bouton

      Choisis Bouton icône si une action familière se répète dans une barre dense et que l’espace compte plus qu’un libellé visible. Choisis Bouton si l’action est principale ou peu familière et qu’un libellé visible évite un malentendu.

      Comparer cette paire
    • Ne pas confondre

      Lien

      Choisis Bouton icône si l’activation agit sur place, comme copier, fermer ou ajouter aux favoris. Choisis Lien si l’activation mène vers une autre page ou route, même quand seule une icône est visible.

      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 : bouton sans texte, icône de barre d'outils, bouton symbole

    • une icône corbeille sur laquelle appuyer
    • un bouton compact sans texte visible
    • le symbole copier dans une barre
    • une action icône avec un nom lu
    • un bouton carré pour fermer
    • une petite action modifier représentée par un crayon

    Choisir

    À utiliser quand

    • Une action familière se répète dans une barre dense
    • Une action fermer, copier ou lecture possède un symbole connu

    À éviter quand

    • L'icône est ambiguë pour le public
    • L'espace permet un bouton texte plus clair

    Comparer

    Comparer les concepts proches

    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

      Atteins le bouton à icône avec Tab et consulte son nom dans l’inspecteur d’accessibilité du navigateur ou avec un lecteur d’écran.

      Résultat attendu

      Le nom décrit l’action même lorsque son infobulle est fermée.

    2. 2. À faire

      Active le bouton une fois avec Entrée et une fois avec Espace.

      Résultat attendu

      Chaque touche exécute une fois l’action prévue ; le focus reste visible autour de la zone utilisable du bouton.

    3. 3. À faire

      Utilise le bouton sur écran tactile, y compris en touchant près du bord de sa zone visible.

      Résultat attendu

      La cible utilisable dépasse le petit dessin, les actions voisines ne se déclenchent pas et l’action reste compréhensible sans survol.

    Contrat complet
    1. 1Le bouton possède son propre nom accessible stable
    2. 2L'icône appartient à l'unique famille du projet
    3. 3La cible tactile reste facilement utilisable au-delà du glyphe
    4. 4L'infobulle est complémentaire et accessible au clavier

    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 Bouton icône sans casser son comportement

    # Implémenter Bouton icône dans ton agent
    
    ## Objectif
    Implémente Bouton icône pour ce comportement vérifié : Un bouton compact représenté visuellement par une icône mais doté de son propre nom d’action accessible et stable.
    
    ## 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 que Bouton icône répond au besoin avant de coder.
    
    ## Comportement requis
    - L’activation au pointeur, avec Entrée ou Espace, exécute une action nommée une seule fois.
    - Le survol ou le focus clavier révèle l’information après un court délai.
    
    ## États à couvrir
    - Copie du code prête
    - Code copié
    
    ## Accessibilité
    - Rôle ARIA : button
    - Le contrôle principal ou la région nommée pour Bouton icône possède un nom accessible stable issu d’un texte visible ou d’un libellé programmatique explicite ; le placeholder et l’infobulle ne servent pas de nom.
    - Toute la cible du bouton, pas seulement le glyphe, reçoit un focus visible.
    - Le bouton lui-même ne se ferme pas ; toute surface contrôlée suit son propre contrat.
    - Un aria-label stable ou un texte masqué visuellement nomme l’action ; Tooltip n’est jamais le seul nom accessible.
    - Tab focalise le bouton icône
    - Entrée et Espace l’activent
    - Échap ferme l’infobulle complémentaire
    
    ## Quand ne pas utiliser
    - L’icône est ambiguë pour le public
    - L’espace permet un bouton texte plus clair
    
    ## Critères d’acceptation
    - Le bouton possède son propre nom accessible stable
    - L’icône appartient à l’unique famille du projet
    - La cible tactile reste facilement utilisable au-delà du glyphe
    - L’infobulle est complémentaire et accessible au clavier
    
    ## 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.
    
    • Web platform
    • 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 Bouton icône sur un parcours réel

    # Vérifier Bouton icône après l’implémentation
    
    ## Objectif
    Audite l’implémentation de Bouton icône 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:0127d3414cf32b298c47114b731b967bbe62d56a851c869606f16e249388ec66

    Diagnostiquer un problème

    Trouve et corrige le défaut de Bouton icône

    # Déboguer Bouton icône 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 de Bouton icône.
    - 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
    - Le bouton possède son propre nom accessible stable
    - L’icône appartient à l’unique famille du projet
    - La cible tactile reste facilement utilisable au-delà du glyphe
    - L’infobulle est complémentaire et accessible au clavier
    
    ## 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.
    
    • Web platform
    • 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 de Bouton icône

    # Empêcher la régression de Bouton icône
    
    ## Objectif
    Transforme la cause reproduite en test de non-régression ciblé et compare Bouton icône 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:64b94465af13051eecdb5a5161c737496198e7d197cc34880f0e3c4665fd6a52

    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:e1a0494eb404804f5b1e585cbc1b5f20f8d0ce922df5b36928dcd88508a8a906

    Dans le code

    TechnologiePrimitiveVersionLimite
    Web platform

    button[type=button] with accessible name

    NatifL’icône peut être décorative, mais le bouton exige son propre nom accessible stable ; l’infobulle reste seulement complémentaire.

    Détails techniques

    Comportements

    • Exécuter une action

      L'activation au pointeur, avec Entrée ou Espace, exécute une action nommée une seule fois.

    • 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.

    États

    • Copie du code prête

      Copie du code prête

    • Code copié

      Code copié

    Transitions d’état

    • Copie du code prête → Code copié

      Entrée, Espace, le pointeur ou le toucher active le bouton nommé Copier le code.

    • Code copié → Copie du code prête

      La confirmation temporaire de copie se termine ou le spécimen rejouable est réinitialisé.

    Scénarios de test

    Contexte
    Une barre de code contient les boutons icônes Copier, Agrandir et Fermer dans une seule famille.
    Mission
    Atteindre Copier avec Tab, entendre son nom, activer avec Espace puis révéler son infobulle complémentaire.
    État principal
    La cible complète du bouton possède un focus visible, une icône décorative et le nom accessible indépendant Copier le code.
    Cas limite
    Si l'icône ne charge pas, le nom accessible et la cible restent intacts et l'action reste compréhensible pour la technologie d'assistance.

    Signaux visuels

    • Une icône reconnaissable dans une cible de bouton
    • Aucun libellé textuel visible
    • Une infobulle complète mais ne nomme pas le contrôle

    Signaux comportementaux

    • Utilise la sémantique d’activation d’un bouton natif
    • Le nom accessible existe sans Infobulle
    • La cible tactile dépasse le glyphe

    Accessibilité

    Rôle
    button
    Nom accessible
    Le contrôle principal ou la région nommée pour Bouton icône possède un nom accessible stable issu d’un texte visible ou d’un libellé programmatique explicite ; le placeholder et l’infobulle ne servent pas de nom.
    Focus clavier
    Toute la cible du bouton, pas seulement le glyphe, reçoit un focus visible.
    Fermeture
    Le bouton lui-même ne se ferme pas ; toute surface contrôlée suit son propre contrat.
    Défilement
    L'activation du contrôle avec Espace ne fait pas défiler la page, et le retour apparaît sans déplacer le focus ni provoquer de saut inattendu.
    Annonce
    Un aria-label stable ou un texte masqué visuellement nomme l'action ; Tooltip n'est jamais le seul nom accessible.
    Clavier
    • Tab focalise le bouton icône
    • Entrée et Espace l'activent
    • Échap ferme l'infobulle complémentaire

    Implémentations

    Ouvrir la matrice HTML, ARIA, Radix et shadcn
    • button[type=button] with accessible name

      implementationKind
      native
      nativeElement
      button[type=button] with accessible name
      ariaPattern
      button
      radixPrimitive
      Non applicable
      shadcnRecipe
      Non applicable
      runtimeDependency
      Non applicable
      packageName
      Non applicable
      exportName
      Non applicable
      exactVersion
      Non applicable
      status
      verified
      sourceId
      source-ui-html-button
      deprecationStatus
      active
      replacement
      Non applicable
      validFrom
      Non applicable
      validUntil
      Non applicable

      Limite d’équivalence : L’icône peut être décorative, mais le bouton exige son propre nom accessible stable ; l’infobulle reste seulement complémentaire.

      Vérifier la source du binding

    Sources

    • WHATWG HTML: The button element
      sourceId
      source-ui-html-button
      kind
      standard
      canonicalUrl
      https://html.spec.whatwg.org/multipage/form-elements.html#the-button-element
      publisher
      WHATWG
      sourceRevision
      http-last-modified:2026-07-19T13:52:46Z
      consultedAt
      2026-07-19
      license
      Non indiquée
      contentDigest
      sha256:418a8f9ce1e8690c6d458121120b0b3b7cd907aa92b2101b85f82f7e02d5ac2f
      status
      verified

      Affirmation couverte : Bouton icône : sémantique native normative, états, attributs et comportement du navigateur pour button.

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

      Affirmation couverte : Bouton icône : guide APG informatif pour le modèle bouton : rôles, états, relations et interactions au clavier.

    • 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 : Bouton icône : 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.

    • 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 : Bouton icône : guide WCAG informatif pour évaluer l'apparence visible du focus clavier.

    • 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 : Bouton icône : définitions normatives des rôles ARIA et contraintes du rôle accessible indiqué.