Switch
Un interrupteur on/off qu'on peut toucher, presser ou faire glisser, avec un curseur qui s'étire sous le doigt et un état d'attente facultatif pour les enregistrements.
- Form components
- 1 parties
- 9 exemples
- vs shadcn/ui
@base-ui/react@tabler/icons-reactclass-variance-authority
Voyez-le dans un vrai produit : Integrations, Memory, Model Compare et 13 autres
Voir le blocpnpm dlx shadcn@latest add https://hextaui.com/r/switch.jsonAjoute le composant, les tokens de thème HextaUI et les composants HextaUI dont il dépend.
Ajoutez les tokens de thème à votre CSS global, si ce n’est pas déjà fait.
Installez les dépendances.
pnpm add @base-ui/react @tabler/icons-react class-variance-authority cnCopiez et collez le code suivant dans votre projet.
components/ui/switch.tsx components/ui/spinner.tsx lib/motion.ts Mettez à jour les chemins d’import selon la configuration de votre projet.
À l'appui, le curseur s'étire vers l'autre côté avant de rebondir de l'autre côté, pour que vous sentiez l'appui. Vous pouvez aussi saisir le curseur et le faire glisser : au-delà du milieu il bascule, en deçà il revient.
variant="ios" utilise une piste plus haute, un curseur en capsule et du vert quand il est activé. L'appui, le glissement et l'enregistrement fonctionnent de la même façon.
Renvoyez une promesse depuis onCheckedChange et le switch bascule aussitôt, même contrôlé. Un spinner n'apparaît dans le curseur que si l'enregistrement dépasse 400ms. En cas de rejet, le switch rebascule et tremble.
icons ajoute une coche et un anneau à la piste, pour que l'état ne repose pas sur la couleur.
sm, default et lg.
Avec Field, le label et la description sont liés au switch.
readOnly garde la valeur visible et focalisable mais ne la modifie pas.
Passez checked et onCheckedChange.
Le curseur part de la droite et glisse vers la gauche, et le glissement suit.
| Touche | Action |
|---|---|
| SpaceEnter | Active ou désactive le switch qui a le focus. |
- Le switch a le rôle
switch, nommé par son label. Entourez-le d'un<label>ou utilisezField. - Pendant l'enregistrement, il est
aria-busyet ignore les nouveaux appuis. - La zone de clic est plus grande que le switch, et plus grande encore au toucher.
- Avec la réduction des animations, le curseur se déplace instantanément et rien ne tremble.
| Prop | Type | Par défaut |
|---|---|---|
checked | boolean | – |
defaultChecked | boolean | false |
onCheckedChangeRenvoyez une promesse pour afficher l'état d'enregistrement. En cas de rejet, un switch non contrôlé rebascule. | (checked, details) => void | Promise | – |
variant | "default" | "ios" | "default" |
size | "sm" | "default" | "lg" | "default" |
iconsAffiche des marques on et off dans la piste. | boolean | false |
name | string | – |
value | string | – |
disabled | boolean | false |
readOnly | boolean | false |
required | boolean | false |
render | ReactElement | (props, state) => ReactElement | <span> |
| Attribut | Description |
|---|---|
data-slot="switch" | La piste, avec data-size et data-variant. |
data-slot="switch-thumb" | Le curseur. |
data-checked / data-unchecked | Indique si le switch est activé. |
data-dragging | Présent pendant que le curseur est déplacé. |
data-pending | Présent tant qu'une promesse renvoyée est en attente. |
--switch-w / --switch-h / --switch-thumb / --switch-thumb-w | Tailles de la piste et du curseur, définies par size. |
- MotionLes courbes d’easing, les durées et la vérification de réduction des animations utilisées par chaque composant, ainsi que des hooks pour les morphs de taille et les surlignages glissants.
- SpinnerUn indicateur de chargement avec des graduations façon Apple ou un anneau qui respire, pouvant attendre avant de s’afficher et rester assez longtemps pour ne pas clignoter.
- CalendarUne grille de dates pour la sélection simple, de plage et multiple, avec des mois qui défilent, des aperçus de plage et des jours à taille tactile.
- CheckboxUne case à cocher dont la coche se dessine, avec des parents indéterminés, des groupes et des libellés qui partagent son survol.
- ComboboxUn select filtrable avec chips, groupes et résultats asynchrones, dans un popup qui se redimensionne pendant la saisie.
- Date pickerUn bouton qui ouvre un calendrier dans un popover, ou une bottom sheet sur mobile, pour des dates simples et des plages.
Utilisé dans les blocs Pro
Des blocks qui s’appuient sur Switch.
Chaque bloc fait partie de HextaUI Pro, et Prompt Input est gratuit.