Aller au contenu
SkillCodex
Menu

Sidebar

Barre latérale

Une région persistante à côté du contenu principal, intégrée à la mise en page et généralement dédiée à la navigation ou à des outils complémentaires.

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 navigation qui reste à gaucheune colonne permanente à côté de la pagegarder les sections du projet visibles pendant le travail

Toutes les formulations
Enregistrer et partager

Reconnaître

Surfaces attachées à un bord

Essayer

La surface doit-elle rester persistante, entrer depuis un bord latéral ou monter depuis le bas ?

Barre latérale

Contexte commun aux essais

Un espace de travail place une navigation ou des contrôles complémentaires le long d'un bord de l'écran tout en gardant la tâche principale dans son contexte.

Barre latérale

Mission

Barre latérale - Sidebar

Choisir Chaises dans la navigation persistante des catégories, replier la barre latérale et vérifier que les résultats de mobilier s'adaptent sans perdre le focus.

Tout le mobilier

Tous les résultats de mobilier sont affichés.

12 résultats

Mobilier de bureau

  • Bureau compact

    En stock

  • Chaise réglable

    Sur commande

Résultat de l’essai

Les filtres latéraux sont développés à côté des résultats sans les bloquer. Tous les résultats de mobilier sont affichés.

É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 navigation persistante des catégories occupe une largeur stable près de la même liste de mobilier, marque la catégorie actuelle et ne rend jamais les résultats inertes.
Cas limite
Quand la mise en page définie par le produit manque de place, un menu nommé séparément peut ouvrir une navigation temporaire des catégories pour les mêmes résultats.

Ce que cet essai montre

Sidebar reste dans la mise en page et ne piège pas le focus ; Drawer et Bottom sheet sont des surfaces temporaires qui peuvent rendre la page inerte.

Lequel convient à ton besoin ?

Barre latérale

Naviguer entre les sections stables d'un espace de travail

Volet latéral

Modifier des filtres sans quitter les résultats

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

Sidebar reste dans la mise en page et ne piège pas le focus ; Drawer et Bottom sheet sont des surfaces temporaires qui peuvent rendre la page inerte.

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.

    Surface

    Le conteneur visible qui accueille le contenu du composant.

    Position dans l’atlas

    Carte relationnelle

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

    • Chapitre

      Surfaces attachées à un bord

      Barre latérale appartient à ce groupe de concepts comparés.

    • Ne pas confondre

      Volet latéral

      Choisis Barre latérale si la région doit rester en place pour naviguer ou garder des outils à portée. Choisis Volet latéral si le panneau s’ouvre pour une tâche ciblée puis se ferme, comme des filtres ou un détail.

      Comparer cette paire
    • Ne pas confondre

      Feuille basse

      Choisis Barre latérale si la navigation doit rester visible et persistante dans l’espace de travail. Choisis Feuille basse si la surface apparaît pour une tâche ponctuelle, surtout sur mobile, puis disparaît.

      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 : navigation latérale, rail de navigation, colonne latérale, panneau latéral

    • une navigation qui reste à gauche
    • une colonne permanente à côté de la page
    • garder les sections du projet visibles pendant le travail
    • un menu latéral qui décale le contenu au lieu de le couvrir
    • une navigation de bureau dans un rail étroit à gauche
    • une zone fixe pour les dossiers et raccourcis

    Choisir

    À utiliser quand

    • Naviguer entre les sections stables d'un espace de travail
    • Garder dossiers ou filtres visibles pendant un travail répété

    À éviter quand

    • La surface n'est utile que brièvement
    • Le contenu restant devient trop étroit ou défile horizontalement

    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

      Choisis une autre rubrique dans la barre latérale, puis lis la zone principale.

      Résultat attendu

      La rubrique sélectionnée est identifiable, le contenu principal lui correspond et la barre latérale reste dans la mise en page.

    2. 2. À faire

      Passe de la barre latérale au contenu principal avec Tab, puis replie-la si cette option existe.

      Résultat attendu

      Le focus peut quitter normalement la barre latérale ; la replier conserve une navigation utilisable sans enfermer le focus.

    3. 3. À faire

      Réduis la fenêtre à la largeur d’un téléphone et ouvre la navigation disponible.

      Résultat attendu

      La rubrique active reste claire. Si la navigation devient un volet temporaire, son ouverture et sa fermeture sont explicites.

    Contrat complet
    1. 1La barre occupe de l'espace au lieu de recouvrir le contenu
    2. 2Sa région de navigation possède un nom unique
    3. 3La position actuelle et l'état replié sont exposés
    4. 4Le remplacement sur petit écran est un pattern distinct explicite

    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 Barre latérale sans casser son comportement

    # Implémenter Barre latérale dans ton agent
    
    ## Objectif
    Implémente Barre latérale pour ce comportement vérifié : Une région persistante à côté du contenu principal, intégrée à la mise en page et généralement dédiée à la navigation ou à des outils complémentaires.
    
    ## 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 Barre latérale répond au besoin avant de coder.
    
    ## Comportement requis
    - La région occupe une place dans la mise en page au lieu de recouvrir temporairement le contenu principal.
    - Si le produit remplace la région persistante quand l’espace manque, ce remplacement est un contrôle de navigation temporaire nommé séparément.
    
    ## États à couvrir
    - Barre latérale développée
    - Barre latérale compacte
    
    ## Accessibilité
    - Rôle ARIA : aside > nav[aria-label]
    - Le contrôle principal ou la région nommée pour Barre latérale 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.
    - Le focus circule normalement entre la barre et le contenu principal ; le repli conserve un contrôle logique focalisé.
    - Une barre persistante se replie, elle ne se ferme pas ; son équivalent mobile temporaire suit son propre contrat Drawer.
    - La région de navigation possède un nom unique et la destination actuelle utilise aria-current lorsque pertinent.
    - Tab suit l’ordre normal du document
    - Entrée active liens et contrôle de repli
    - Aucun piège de focus n’est créé
    
    ## Quand ne pas utiliser
    - La surface n’est utile que brièvement
    - Le contenu restant devient trop étroit ou défile horizontalement
    
    ## Critères d’acceptation
    - La barre occupe de l’espace au lieu de recouvrir le contenu
    - Sa région de navigation possède un nom unique
    - La position actuelle et l’état replié sont exposés
    - Le remplacement sur petit écran est un pattern distinct explicite
    
    ## 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 Barre latérale sur un parcours réel

    # Vérifier Barre latérale après l’implémentation
    
    ## Objectif
    Audite l’implémentation de Barre latérale 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:cdd9e3dd8f49c09ccd42808561f4e7927f1dcca3300ac446119675fb3397b138

    Diagnostiquer un problème

    Trouve et corrige le défaut de Barre latérale

    # Déboguer Barre latérale 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 Barre latérale.
    - 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 barre occupe de l’espace au lieu de recouvrir le contenu
    - Sa région de navigation possède un nom unique
    - La position actuelle et l’état replié sont exposés
    - Le remplacement sur petit écran est un pattern distinct explicite
    
    ## 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 Barre latérale

    # Empêcher la régression de Barre latérale
    
    ## Objectif
    Transforme la cause reproduite en test de non-régression ciblé et compare Barre latérale 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:dd935b8e092b91cbbdf81648dc36a46960aef4f8ae74a2ab0015fed08547b8de

    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:8d6e0e25b8236cc40a14eb37f299c6ba345dbfed6d79ae5e745a6774c519dead

    Dans le code

    TechnologiePrimitiveVersionLimite
    Web platform

    aside with nav

    NatifUne barre latérale persistante relève de la mise en page et de la navigation, pas d’un dialogue modal. Sa version mobile temporaire exige un comportement de tiroir distinct.

    Détails techniques

    Comportements

    • Rester dans la mise en page

      La région occupe une place dans la mise en page au lieu de recouvrir temporairement le contenu principal.

    • S'adapter aux petites largeurs

      Si le produit remplace la région persistante quand l’espace manque, ce remplacement est un contrôle de navigation temporaire nommé séparément.

    États

    • Barre latérale développée

      Barre latérale développée

    • Barre latérale compacte

      Barre latérale compacte

    Transitions d’état

    • Barre latérale développée → Barre latérale compacte

      Le contrôle de repli est activé pendant que la barre persistante est développée.

    • Barre latérale compacte → Barre latérale développée

      Le contrôle de développement est activé pendant que la barre persistante est compacte.

    Scénarios de test

    Contexte
    Une page de résultats de mobilier de bureau affiche la même liste Bureau compact et Chaise réglable pendant que les utilisateurs filtrent la disponibilité et parcourent les catégories sans quitter les résultats.
    Mission
    Choisir Chaises dans la navigation persistante des catégories, replier la barre latérale et vérifier que les résultats de mobilier s'adaptent sans perdre le focus.
    État principal
    La navigation persistante des catégories occupe une largeur stable près de la même liste de mobilier, marque la catégorie actuelle et ne rend jamais les résultats inertes.
    Cas limite
    Quand la mise en page définie par le produit manque de place, un menu nommé séparément peut ouvrir une navigation temporaire des catégories pour les mêmes résultats.

    Signaux visuels

    • Région verticale à côté du contenu principal
    • Occupe une largeur dans la mise en page
    • Éléments de navigation visibles entre les vues liées

    Signaux comportementaux

    • Ne crée pas de voile modal
    • Le contenu principal s'adapte autour
    • Le produit peut la remplacer par un modèle temporaire nommé séparément quand l’espace manque

    Accessibilité

    Rôle
    aside > nav[aria-label]
    Nom accessible
    Le contrôle principal ou la région nommée pour Barre latérale 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
    Le focus circule normalement entre la barre et le contenu principal ; le repli conserve un contrôle logique focalisé.
    Fermeture
    Une barre persistante se replie, elle ne se ferme pas ; son équivalent mobile temporaire suit son propre contrat Drawer.
    Défilement
    Le document et la barre latérale conservent des débordements indépendants et prévisibles. Le contenu fixe ne masque jamais le focus clavier pendant le défilement.
    Annonce
    La région de navigation possède un nom unique et la destination actuelle utilise aria-current lorsque pertinent.
    Clavier
    • Tab suit l'ordre normal du document
    • Entrée active liens et contrôle de repli
    • Aucun piège de focus n'est créé

    Implémentations

    Ouvrir la matrice HTML, ARIA, Radix et shadcn
    • aside with nav

      implementationKind
      custom
      nativeElement
      aside with nav
      ariaPattern
      complementary or navigation region
      radixPrimitive
      Non applicable
      shadcnRecipe
      Non applicable
      runtimeDependency
      Non applicable
      packageName
      Non applicable
      exportName
      Non applicable
      exactVersion
      Non applicable
      status
      exception
      sourceId
      source-ui-wai-aria-roles
      deprecationStatus
      active
      replacement
      Non applicable
      validFrom
      Non applicable
      validUntil
      Non applicable

      Limite d’équivalence : Une barre latérale persistante relève de la mise en page et de la navigation, pas d’un dialogue modal. Sa version mobile temporaire exige un comportement de tiroir distinct.

      Vérifier la source du binding

    Sources

    • shadcn/ui: Sidebar
      sourceId
      source-ui-shadcn-sidebar
      kind
      documentation
      canonicalUrl
      https://ui.shadcn.com/docs/components/radix/sidebar
      publisher
      shadcn/ui
      sourceRevision
      http-etag:W/"hu4xjc7khaqc8u"
      consultedAt
      2026-07-19
      license
      Non indiquée
      contentDigest
      sha256:ea7f64d071a7663c9e4203506b341ff1a0f1b6ce869e767af29920dd8911337c
      status
      verified

      Affirmation couverte : Barre latérale : parties, API d'état, interactions et limites d'implémentation documentées pour shadcn Sidebar.

    • 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 : Barre latérale : 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 : Barre latérale : guide WCAG informatif pour évaluer l'apparence visible du focus clavier.

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

      Affirmation couverte : Barre latérale : sémantique native normative, états, attributs et comportement du navigateur pour a[href].

    • 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 : Barre latérale : sémantique native normative, états, attributs et comportement du navigateur pour button.