Aller au contenu
SkillCodex
Menu

Data grid

Grille de données

Un composite tabulaire interactif qui gère un seul point d’entrée clavier et le déplacement directionnel du focus entre les cellules, souvent avec édition ou sélection.

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

Tu as peut-être cherché : parcourir les cellules avec les flèchesmodifier des valeurs comme dans une feuille de calculsélectionner une ligne sans tabuler dans chaque cellule

Toutes les formulations
Enregistrer et partager

Reconnaître

Structurer et explorer des données

Essayer

Faut-il lire des données tabulaires, interagir cellule par cellule ou développer une hiérarchie ?

Grille de données

Contexte commun aux essais

Un espace de travail présente un grand ensemble d’informations dont la structure et le modèle d’interaction déterminent comment les personnes le parcourent, le modifient ou le développent.

Grille de données

Mission

Grille de données

Entre dans la grille avec Tab, atteins État avec les flèches, modifie la valeur, reviens à la navigation et sélectionne la ligne.

Nom
État
Responsable
Atlas
Prêt
Amina
Beacon
À vérifier
Léo

Tab entre une fois · Flèches déplacent le focus · Entrée édite État · Maj+Espace sélectionne la ligne

Résultat de l’essai

Le point d’entrée géré est Atlas ; aucune ligne n’est sélectionnée.

É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
Une seule cellule est active et aucune ligne n’est sélectionnée.
Cas limite
Un éditeur de cellule consomme temporairement les flèches, puis Échap restaure la navigation de grille sur la même cellule.

Ce que cet essai montre

La grille de données gère le déplacement du focus comme un widget composite ; le tableau laisse les cellules statiques dans l’ordre de lecture du document, tandis que la vue arborescente développe des relations parent-enfant plutôt que des lignes et colonnes.

Lequel convient à ton besoin ?

Grille de données

Un grand jeu tabulaire exige une navigation clavier efficace

Tableau

Il faut comparer des valeurs entre lignes et colonnes

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

La grille de données gère le déplacement du focus comme un widget composite ; le tableau laisse les cellules statiques dans l’ordre de lecture du document, tandis que la vue arborescente développe des relations parent-enfant plutôt que des lignes et colonnes.

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.

    Tableau

    Le conteneur tabulaire qui préserve les relations entre lignes et colonnes.

    Position dans l’atlas

    Carte relationnelle

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

    • Chapitre

      Structurer et explorer des données

      Grille de données appartient à ce groupe de concepts comparés.

    • Ne pas confondre

      Tableau

      Choisis Grille de données si l’utilisateur édite, sélectionne ou parcourt beaucoup de cellules au clavier. Choisis Tableau si les données se lisent et se comparent sans interaction dans les cellules.

      Comparer cette paire
    • Ne pas confondre

      Vue arborescente

      Choisis Grille de données si les données sont tabulaires et que l’utilisateur édite ou parcourt beaucoup de cellules efficacement. Choisis Vue arborescente si la structure est une vraie hiérarchie, comme des dossiers, que l’utilisateur développe niveau par niveau.

      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 : tableau interactif, grille éditable, tableau type feuille de calcul

    • parcourir les cellules avec les flèches
    • modifier des valeurs comme dans une feuille de calcul
    • sélectionner une ligne sans tabuler dans chaque cellule
    • trier et filtrer un jeu de données interactif
    • garder une seule cellule de la grille dans l’ordre de tabulation
    • naviguer dans un grand tableau comme dans un seul widget

    Choisir

    À utiliser quand

    • Un grand jeu tabulaire exige une navigation clavier efficace
    • Les cellules ou lignes permettent édition, sélection ou de nombreuses actions

    À éviter quand

    • Les données sont statiques et en lecture seule
    • L’équipe ne peut pas implémenter et tester entièrement le focus composite

    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

      Entre dans la grille avec Tab, puis déplace-toi entre les cellules avec les flèches.

      Résultat attendu

      La grille forme un seul arrêt au clavier, la cellule active reste visible et les flèches déplacent le focus dans la grille.

    2. 2. À faire

      Sur une cellule modifiable, commence la modification avec Entrée ou F2, change sa valeur avec les commandes du champ, puis appuie sur Échap.

      Résultat attendu

      Les touches de modification agissent dans le champ ; Échap quitte la saisie et rétablit la navigation sur la même cellule.

    3. 3. À faire

      Utilise la commande de sélection annoncée si elle existe, puis quitte le mode navigation avec Tab.

      Résultat attendu

      La sélection se distingue de la cellule active, et Tab atteint la commande suivante sans t’enfermer dans la grille.

    Contrat complet
    1. 1Une cellule ou un descendant est tabulable
    2. 2Chaque destination des flèches est focalisable et libellée
    3. 3Le mode édition possède une entrée et une sortie claires
    4. 4Focus et sélection ont des apparences différentes
    5. 5Les indices et comptes virtualisés sont exposés

    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 Grille de données sans casser son comportement

    # Implémenter Grille de données dans ton agent
    
    ## Objectif
    Implémente Grille de données pour ce comportement vérifié : Un composite tabulaire interactif qui gère un seul point d’entrée clavier et le déplacement directionnel du focus entre les cellules, souvent avec édition ou sélection.
    
    ## 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 Grille de données répond au besoin avant de coder.
    
    ## Comportement requis
    - Les flèches, Début et Fin déplacent un point de focus géré dans la grille bidimensionnelle.
    - L’activation ou une commande d’édition documentée entre dans le contrôle d’une cellule puis revient à la navigation de grille de façon prévisible.
    
    ## États à couvrir
    - Grille prête
    - Cellule active
    - Cellule en édition
    - Ligne sélectionnée
    
    ## Accessibilité
    - Rôle ARIA : grid > row > (columnheader | rowheader | gridcell)
    - Le contrôle principal ou la région nommée pour Grille de données 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.
    - Utilise une seule stratégie cohérente de roving tabindex ou aria-activedescendant, garde la cellule active visible et ne place jamais toutes les cellules dans l’ordre de tabulation.
    - La grille ne se ferme pas ; Échap quitte l’interaction de cellule et restaure la navigation de grille.
    - La grille possède un nom ; le focus expose le contexte de ligne et colonne, l’état sélectionné ou en édition et les comptes et indices virtualisés exacts.
    - Tab entre par une cellule gérée puis un Tab ultérieur quitte la grille
    - Les flèches parcourent les cellules ; Début et Fin parcourent une ligne
    - Contrôle+Début et Contrôle+Fin atteignent les limites de la grille
    - Entrée ou F2 entre dans la cellule et Échap revient à la navigation
    - Les raccourcis de sélection n’existent que pour le modèle déclaré
    
    ## Quand ne pas utiliser
    - Les données sont statiques et en lecture seule
    - L’équipe ne peut pas implémenter et tester entièrement le focus composite
    
    ## Critères d’acceptation
    - Une cellule ou un descendant est tabulable
    - Chaque destination des flèches est focalisable et libellée
    - Le mode édition possède une entrée et une sortie claires
    - Focus et sélection ont des apparences différentes
    - Les indices et comptes virtualisés sont exposés
    
    ## 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 Grille de données sur un parcours réel

    # Vérifier Grille de données après l’implémentation
    
    ## Objectif
    Audite l’implémentation de Grille de données 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:56833a5d9c26e4b38a0b089aa2d72d511913deb6d9593aacddc105207aac9aa5

    Diagnostiquer un problème

    Trouve et corrige le défaut de Grille de données

    # Déboguer Grille de données 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 Grille de données.
    - 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
    - Une cellule ou un descendant est tabulable
    - Chaque destination des flèches est focalisable et libellée
    - Le mode édition possède une entrée et une sortie claires
    - Focus et sélection ont des apparences différentes
    - Les indices et comptes virtualisés sont exposés
    
    ## 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 Grille de données

    # Empêcher la régression de Grille de données
    
    ## Objectif
    Transforme la cause reproduite en test de non-régression ciblé et compare Grille de données 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:cb5d0f457c4ded52b6e31d1525ee0bda5c553872e890c9b2e130c2b4cd19ba7d

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

    Dans le code

    TechnologiePrimitiveVersionLimite
    Web platform

    div or table with managed cell focus

    NatifLa grille ARIA est une obligation d’implémentation, pas une décoration : fournir un arrêt Tab, un focus directionnel complet, l’usage des cellules et une sélection testée.

    Détails techniques

    Comportements

    • Parcourir les cellules

      Les flèches, Début et Fin déplacent un point de focus géré dans la grille bidimensionnelle.

    • Manipuler la cellule active

      L’activation ou une commande d’édition documentée entre dans le contrôle d’une cellule puis revient à la navigation de grille de façon prévisible.

    États

    • Grille prête

      Grille prête

    • Cellule active

      Cellule active

    • Cellule en édition

      Cellule en édition

    • Ligne sélectionnée

      Ligne sélectionnée

    Transitions d’état

    • Grille prête → Cellule active

      Tab entre par l’unique cellule dans l’ordre de tabulation.

    • Cellule active → Cellule en édition

      Entrée ou F2 lance l’édition sans perdre le contexte de ligne et colonne.

    • Cellule en édition → Cellule active

      Entrée valide la valeur et revient à la navigation de grille ; Échap annule avec le même retour de focus.

    • Cellule active → Ligne sélectionnée

      Maj+Espace sélectionne la ligne focalisée lorsque le modèle déclaré l’autorise.

    • Ligne sélectionnée → Cellule active

      Une flèche déplace le focus sans effacer ni suivre silencieusement la sélection.

    Scénarios de test

    Contexte
    Une grille d’inventaire expose Nom, État et Responsable, avec État modifiable sur place.
    Mission
    Entre dans la grille avec Tab, atteins État avec les flèches, modifie la valeur, reviens à la navigation et sélectionne la ligne.
    État principal
    Une seule cellule est active et aucune ligne n’est sélectionnée.
    Cas limite
    Un éditeur de cellule consomme temporairement les flèches, puis Échap restaure la navigation de grille sur la même cellule.

    Signaux visuels

    • Lignes, colonnes et en-têtes tabulaires
    • Focus visible sur une cellule active
    • Repères d’édition et de sélection distincts du focus

    Signaux comportementaux

    • Un point d’entrée géré réduit l’ordre de tabulation
    • Les touches directionnelles déplacent le focus des cellules
    • Des commandes explicites entrent et sortent de l’interaction dans la cellule

    Accessibilité

    Rôle
    grid > row > (columnheader | rowheader | gridcell)
    Nom accessible
    Le contrôle principal ou la région nommée pour Grille de données 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
    Utilise une seule stratégie cohérente de roving tabindex ou aria-activedescendant, garde la cellule active visible et ne place jamais toutes les cellules dans l’ordre de tabulation.
    Fermeture
    La grille ne se ferme pas ; Échap quitte l’interaction de cellule et restaure la navigation de grille.
    Défilement
    Les débordements horizontal et vertical préservent les relations avec les en-têtes, la position de lecture active et le focus clavier visible sans réordonner les données.
    Annonce
    La grille possède un nom ; le focus expose le contexte de ligne et colonne, l’état sélectionné ou en édition et les comptes et indices virtualisés exacts.
    Clavier
    • Tab entre par une cellule gérée puis un Tab ultérieur quitte la grille
    • Les flèches parcourent les cellules ; Début et Fin parcourent une ligne
    • Contrôle+Début et Contrôle+Fin atteignent les limites de la grille
    • Entrée ou F2 entre dans la cellule et Échap revient à la navigation
    • Les raccourcis de sélection n’existent que pour le modèle déclaré

    Implémentations

    Ouvrir la matrice HTML, ARIA, Radix et shadcn
    • div or table with managed cell focus

      implementationKind
      custom
      nativeElement
      div or table with managed cell focus
      ariaPattern
      grid with row, columnheader, rowheader, and gridcell
      radixPrimitive
      Non applicable
      shadcnRecipe
      Non applicable
      runtimeDependency
      Non applicable
      packageName
      Non applicable
      exportName
      Non applicable
      exactVersion
      Non applicable
      status
      exception
      sourceId
      source-ui-aria-grid
      deprecationStatus
      active
      replacement
      Non applicable
      validFrom
      Non applicable
      validUntil
      Non applicable

      Limite d’équivalence : La grille ARIA est une obligation d’implémentation, pas une décoration : fournir un arrêt Tab, un focus directionnel complet, l’usage des cellules et une sélection testée.

      Vérifier la source du binding

    Sources

    • WAI-ARIA APG: Grid Pattern
      sourceId
      source-ui-aria-grid
      kind
      documentation
      canonicalUrl
      https://www.w3.org/WAI/ARIA/apg/patterns/grid/
      publisher
      W3C WAI
      sourceRevision
      http-last-modified:2026-08-07T07:06:02Z
      consultedAt
      2026-08-10
      license
      Non indiquée
      contentDigest
      sha256:01ffcad0d09b46665aa78b83a9b57177fdaba3db35771dacc2ee1dbb56285453
      status
      verified

      Affirmation couverte : Grille de données : guide APG informatif pour le modèle grille de données interactive : rôles, états, relations et interactions au 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 : Grille de données : 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 : Grille de données : guide WCAG informatif pour évaluer l'apparence visible du focus clavier.

    • WAI-ARIA 1.2: Live Region Attributes
      sourceId
      source-ui-wai-aria-live-regions
      kind
      standard
      canonicalUrl
      https://www.w3.org/TR/wai-aria-1.2/#attrs_liveregions
      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 : Grille de données : propriétés normatives des régions live pour le comportement d'annonce d'état.

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

      Affirmation couverte : Grille de données : guide WCAG informatif sur les messages d'état annoncés sans déplacer le focus.