CSS: wrapper ​

body[class~="instui-display-flex"] — Ligne de l'app-shell : navigation latérale, conteneur avec en-tête et panneau optionnel.

✅ Utiliser Wrapper lorsque :

  • Construction d'une page produit Canvas complète nécessitant une structure d'habillage cohérente

  • La page utilise GlobalNav comme ancre de navigation principale

  • La page nécessite des panneaux latéraux : ContentTabList, TrailingContentArea ou un UtilityPanel

  • Besoin d'un espacement de conteneur cohérent et d'une largeur maximale de contenu uniforme sur toute la page 🚫 Ne pas utiliser Wrapper lorsque :

  • Construction d'une Modal, d'un Tray ou d'un Drawer — ceux-ci ont leurs propres conteneurs de mise en page

  • Enveloppement d'une sous-section de page — Wrapper contient la page entière, pas une région

Accessibilité ​

  • Mapper la zone de contenu principale sur un repère <main> avec un lien skip-nav afin que les utilisateurs au clavier puissent contourner GlobalNav
  • Donner à ContentTabList role="navigation" avec un aria-label distinct, par exemple "Navigation de la page" — séparé du repère de GlobalNav
  • Donner à TrailingContentArea role="complementary" avec un aria-label descriptif reflétant son contenu, par exemple "Détails de l'étudiant"
  • Donner à chaque UtilityPanel un aria-label distinct : "Assistant IA", "Notifications" ou "Filtres"
  • Quand un UtilityPanel s'ouvre, déplacer le focus dans le panneau ; quand il se ferme, renvoyer le focus vers le déclencheur qui l'a ouvert

Utilisation ​

css
@import "@pantoken/plugin-layouts/layouts.css";

Structure ​

text
body[class~="instui-display-flex"]
  side-nav-bar (component)
  .container
    modal.header (component)
      .top
        breadcrumb (component)
        .utilities (0..1)
          button + button (component, 1..n)
      .info
        .title
        .description (0..1)
      ‹content: header› (0..1)
      .actions (0..1)
        button + button (component, 1..n)
      tabs (component, 0..1)
        tabs (component)
      .filters (0..1)
        ‹content: filters›
    drawer-layout.content (component)
      list + card (component, 0..1)
      slot[name="content"].main
      slot[name="trailing"].trailing + card (component, 0..1)
  tabs.panel (component)
    card | agent-shell (component, 0..1)
flowchart TD n0["body[class~=&quot;instui-display-flex&quot;]"]:::cssdoc-root n1(["side-nav-bar"]):::cssdoc-component n2(".container"):::cssdoc-part n3(["modal.header"]):::cssdoc-component n4(".top"):::cssdoc-part n5(["breadcrumb"]):::cssdoc-component n6(".utilities"):::cssdoc-part n7(["button + button"]):::cssdoc-component n8(".info"):::cssdoc-part n9(".title"):::cssdoc-part n10(".description"):::cssdoc-part n11[/"‹content: header›"/]:::cssdoc-slot n12(".actions"):::cssdoc-part n13(["button + button"]):::cssdoc-component n14(["tabs"]):::cssdoc-component n15(["tabs"]):::cssdoc-component n16(".filters"):::cssdoc-part n17[/"‹content: filters›"/]:::cssdoc-slot n18(["drawer-layout.content"]):::cssdoc-component n19([".list + card"]):::cssdoc-component n20("slot[name=&quot;content&quot;].main"):::cssdoc-part n21(["slot[name=&quot;trailing&quot;].trailing + card"]):::cssdoc-component n22(["tabs.panel"]):::cssdoc-component n23(["card | agent-shell"]):::cssdoc-component n0 --> n1 n4 --> n5 n6 -->|1..n| n7 n4 -.->|0..1| n6 n3 --> n4 n8 --> n9 n8 -.->|0..1| n10 n3 --> n8 n3 -.->|0..1| n11 n12 -->|1..n| n13 n3 -.->|0..1| n12 n14 --> n15 n3 -.->|0..1| n14 n16 --> n17 n3 -.->|0..1| n16 n2 --> n3 n18 -.->|0..1| n19 n18 --> n20 n18 -.->|0..1| n21 n2 --> n18 n0 --> n2 n22 -.->|0..1| n23 n0 --> n22 click n1 "/api/css/side-nav-bar.md" click n3 "/api/css/modal.header.md" click n5 "/api/css/breadcrumb.md" click n7 "/api/css/button.md" click n13 "/api/css/button.md" click n14 "/api/css/tabs.md" click n15 "/api/css/tabs.md" click n18 "/api/css/drawer-layout.content.md" click n19 "/api/css/card.md" click n21 "/api/css/card.md" click n22 "/api/css/tabs.panel.md" classDef cssdoc-root stroke-width:1px; classDef cssdoc-part stroke-width:1px; classDef cssdoc-slot stroke-width:1px; classDef cssdoc-component stroke-width:1px;

Emplacements ​

EmplacementDescription
contentContenu principal de la page.
filtersContenu optionnel des filtres à l'intérieur de l'en-tête.
headerEmplacement d'en-tête optionnel sous la description de la page.
panelContenu du panneau utilitaire.
trailingContenu complémentaire en fin de zone.

Parties ​

PartieDescription
.actionsBoutons d'en-tête optionnels à la fin de la rangée supérieure.
.containerColonne principale de la page contenant l'en-tête et le contenu.
.contentRégion de contenu primaire à l'intérieur de la colonne conteneur.
.descriptionDescription de page optionnelle sous le titre.
.filtersRégion de filtres optionnelle à l'intérieur de l'en-tête.
.headerRégion d'en-tête à l'intérieur de la colonne conteneur.
.infoConteneur pour le titre de la page et la description optionnelle.
.listColonne de navigation optionnelle à l'intérieur du contenu.
.mainColonne de contenu principale à l'intérieur du contenu.
.panelRégion du panneau utilitaire qui s'ouvre du côté droit de la page.
.tabsOnglets de navigation optionnels au début de la rangée de contenu.
.titleTitre de la page sous la rangée supérieure.
.topLigne de grille contenant le fil d'Ariane et les utilitaires.
.trailingColonne complémentaire optionnelle à l'intérieur du contenu.
.utilitiesActions utilitaires à la fin de la rangée supérieure.

États ​

ÉtatDescription
:optional—

Tokens consommés ​

TokenTypeValeur
--instui-background-color-page——

Sous-composants ​

Connexe ​