Toggle
Interaction
Engine\Native\Toggle est l'équivalent natif d'Engine\SwitchToggle : même meta.next et même gestionnaire partagé "toggle:" que Checkbox, mais une piste en forme de pilule avec un curseur (« knob ») décalé au lieu d'une coche. La position du curseur est dessinée directement à partir de la valeur courante $on — sans animation : un rendu frais reflète toujours l'état réel, le même contrat de peinture en un seul coup que tous les autres widgets natifs.
Exemple
php
<?php
use Engine\Native\Toggle;
$notifications = new Toggle(
name: 'push_notifications',
label: 'Notifications push',
on: true,
);Un interrupteur activé ; un tap envoie toggle:push_notifications avec meta.next = '' pour le désactiver.
Constructeur
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
| name | string | — | Nom du champ, utilisé dans l'action toggle:{name}. |
| label | string | — | Libellé affiché à droite de la piste. |
| on | bool | false | État actuel de l'interrupteur. |
| activeColor | ?Color | null (couleur d'encre du thème) | Couleur de la piste quand l'interrupteur est activé. |
| trackWidth | float | 44.0 | Largeur de la piste. |
| trackHeight | float | 26.0 | Hauteur de la piste (le curseur fait trackHeight - 4.0). |
À savoir. Comme pour
Checkbox, il n'y a aucun état intermédiaire animé côté client : le curseur saute directement à sa position finale au prochain rendu, sans transition glissée.