Sur cette page

Référence API

#Lien direct vers cette section

Import

#Lien direct vers cette section

Si vous utilisez l'autoloader, les composants détectés dans la pages sont chargés automatiquement, donc pas besoin de les importer individuellement.
Pour un import manuel, voici comment vous y prendre.

CDNnpm

Importez ce composant depuis le CDN.

<script type="module" src="https://unpkg.com/@ariane-ui/core/dist/components/tab/index.js"></script>

Après avoir installé le paquet via npm, vous pouvez importer le composant ainsi :

import '@ariane-ui/core/dist/components/tab/index.js';

Configuration

#Lien direct vers cette section
Attributs et propriétés 3Slots 1

Attributs et propriétés

1 sur 3
panelreflète

Nom du ar-tab-panel associé. Requis.

Type stringDéfaut ''

2 sur 3
disabledreflète

Désactive l'onglet — non sélectionnable, ignoré au clavier.

Type booleanDéfaut false

3 sur 3
activereflète

Vrai quand l'onglet est actif (sélectionné).

Type booleanDéfaut false

Slots

1 sur 1(default)

Libellé de l'onglet.

Personnalisation

#Lien direct vers cette section
CSS Parts 2CSS Custom States 2CSS Custom Properties 5

CSS Parts

Utilisez ::part(name) pour styler ces éléments depuis l'extérieur.
Certaines parts indiquent un rôle transverse, partagé avec d'autres composants — voir Personnalisation avancée.
Certaines parts portent un modificateur d'état (--) — voir Personnalisation avancée.

1 sur 2tab

Racine du composant.

2 sur 2tab--selected

Wrapper du slot quand l'onglet est actif (variante d'état de `tab`, propriété `active` pilotée par ar-tab-group).

CSS Custom States

Utilisez le sélecteur :state(name) sur le tag pour styler ce composant en fonction de son état.
Composable avec ::part() pour cibler un élément interne (ar-tab:state(name)::part(x)).
Sous Chrome et Edge 125, l'état est exposé avec le préfixe -- (:--name) : voir Compatibilité.

1 sur 2:state(disabled)

L'onglet est désactivé.

2 sur 2:state(active)

L'onglet est actif (sélectionné).

CSS Custom Properties

1 sur 5--ar-tab-padding-x

Padding horizontal.

2 sur 5--ar-tab-padding-y

Padding vertical.

3 sur 5--ar-tab-active-shadow

box-shadow complet sur part="tab--selected" quand actif. Repli `inset 0 -2px 0 Highlight` si aucun thème n'est chargé — sans lui, l'onglet actif est visuellement indiscernable des autres.

4 sur 5--ar-tab-focus-ring-offset

Décalage de la bague de focus. Valeur négative = inset (non coupée par le conteneur overflow du tab-group). Repli `-2px` si aucun thème n'est chargé — sans lui, l'anneau de focus peut être rogné par le conteneur `overflow-x: auto` du tab-group. Surcharge le token global --ar-focus-ring-offset pour ce composant.

5 sur 5--ar-tab-focus-ring-color

Couleur de la bague de focus de l'onglet (cascade vers --ar-focus-ring-color). Repli `ButtonText` si aucun thème n'est chargé (WCAG 2.4.7).