AccueilComponentsButton

Button

Boutons de type Pressable (React Native) avec différentes tailles et variants.
ui
Figma
Ouvrir Figma
(s'ouvre dans un nouvel onglet)
Variants
Les quatre variants, du plus au moins appuyé. •primary : l'action principale. Une seule par zone. •secondary : les actions courantes, celles qu'on pose à côté de la principale. •tertiary : les actions discrètes, dans une barre d'outils ou une ligne de tableau. •danger : une action destructrice, réservée à la confirmation finale. Il n'y a pas de variante link. Un lien navigue, un bouton agit : c'est le partage que posent les trois références, et aucune n'offre de variante de lien sur son bouton. Primer en garde bien une dans son type, mais sans une ligne de documentation ni un exemple, là où ses quatre autres variantes ont chacune leur guidance ; sa consigne écrite est l'inverse (« Do not use links for triggering an action. Instead, use Buttons »). Atlassian n'a aucune apparence de ce nom, et son LinkButton fait le trajet inverse : un <a> habillé en bouton. Base n'a que primary, secondary, tertiary et leurs trois pendants danger. Pour ce qui navigue, prendre A. Pour l'action discrète sans cadre, c'est tertiary.
tsx
export const Variants = () => (
<Box display="flex" flexDirection="row" flexWrap={'wrap'} gap="3W">
<Button variant="primary" title="Primary" />
<Button variant="secondary" title="Secondary" />
<Button variant="tertiary" title="Tertiary" />
<Button variant="danger" title="Danger" />
</Box>
);
Sizes
md par défaut. sm pour les zones denses, lg pour une action qu'on veut mettre en avant.
tsx
export const Sizes = () => (
<Box display="flex" flexDirection="row" flexWrap={'wrap'} style={{ alignItems: 'center' }} gap="3W">
<Button variant="secondary" size="sm" title="Sm" />
<Button variant="secondary" size="md" title="Md" />
<Button variant="secondary" size="lg" title="Lg" />
</Box>
);
States
•disabled : l'action n'est pas disponible. Le bouton ne répond plus ni au clic ni au clavier. •selected : le bouton fait partie d'un groupe et c'est lui qui est choisi. •expanded : le bouton commande un menu ou un panneau actuellement déplié. Il pose aussi l'état accessible correspondant, ce que selected ne fait pas.
tsx
export const States = () => (
<Box display="flex" flexDirection="row" flexWrap={'wrap'} gap="3W">
<Button variant="secondary" title="Default" />
<Button variant="secondary" title="Disabled" disabled />
<Button variant="secondary" title="Selected" selected />
<Button variant="secondary" title="Expanded" expanded />
</Box>
);
Loading
Le spinner n'apparaît qu'après un délai, réglé par loadingDelay : mêmes valeurs que la prop delay de Spinner (false / true / 'short' (300 ms) / 'long' / number). Il vaut 'long' (1 000 ms) par défaut. Ce délai évite un clignotement visuel quand l'opération se termine rapidement : si le serveur répond en moins d'une seconde, l'utilisateur ne voit jamais le spinner. Au-delà, le spinner s'affiche pour signaler que l'attente va durer. Le spinner prend la place de quelque chose, il ne s'ajoute jamais : le bouton garde donc exactement sa largeur. S'il porte une icône, c'est elle que le spinner remplace, et le libellé reste lisible. Sinon le spinner se centre et le libellé devient invisible sans quitter le flux, pour continuer d'imposer sa largeur. Pendant toute l'attente - y compris avant que le spinner ne paraisse - le bouton cesse de répondre : il sort du parcours au clavier et se déclare aria-disabled, pour qu'un second appui ne relance pas l'opération. Son apparence, elle, reste celle du repos. Appuyez sur un bouton pour simuler une opération de 3 secondes. Le troisième bouton, avec loadingDelay="short", montre son spinner dès 300 ms - avant les deux premiers, qui attendent le délai par défaut d'une seconde.
tsx
export const Loading = () => {
const [isLoading, setIsLoading] = React.useState(false);
const handlePress = () => {
setIsLoading(true);
setTimeout(() => setIsLoading(false), 3000);
};
return (
<Box display="flex" flexDirection="row" flexWrap={'wrap'} gap="3W">
<Button variant="primary" title="Enregistrer" isLoading={isLoading} onPress={handlePress} />
<Button variant="secondary" title="Exporter" leading="Download" isLoading={isLoading} onPress={handlePress} />
OnPressAsynchrone
Un onPress qui rend une promesse verrouille le bouton jusqu'à sa fin, résolue ou rejetée : c'est la protection contre la double soumission d'un formulaire. Le verrou est posé dès le premier clic, avant même le rafraîchissement : le second clic d'un double clic est ignoré. Pas besoin de gérer isLoading : le bouton charge seul, avec le même loadingDelay. Avec react-hook-form, onPress={handleSubmit(...)} suffit, handleSubmit rendant une promesse. Un onPress synchrone n'est pas verrouillé. Double-cliquez sur le bouton : l'envoi de 3 secondes n'est compté qu'une fois.
Envois : 0tsx
export const OnPressAsynchrone = () => {
const [envois, setEnvois] = React.useState(0);
const envoyer = async () => {
setEnvois(n => n + 1);
await new Promise(resolve => setTimeout(resolve, 3000));
};
return (
<Box display="flex" flexDirection="row" flexWrap={'wrap'} gap="3W" style={{ alignItems: 'center' }}>
<Button variant="primary" title="Envoyer" loadingDelay="short" onPress={envoyer} />
<Typography>Envois : {envois}</Typography>
Icons
leading place l’icône avant le libellé, trailing après. Les deux peuvent coexister.
tsx
export const Icons = () => (
<Box display="flex" flexDirection="row" flexWrap={'wrap'} gap="3W">
<Button variant="secondary" title="Leading" leading="Plus" />
<Button variant="secondary" title="Trailing" trailing="Download" />
<Button variant="secondary" title="Filtres" leading="Plus" trailing="ChevronDown" />
</Box>
);
TertiaireAvecAvatar
leading et trailing acceptent aussi un élément : un avatar, un logo de réseau social. Il est posé dans un emplacement de la taille de l'icône, sans recevoir de couleur, si bien que le bouton garde sa hauteur et son alignement.
tsx
export const TertiaireAvecAvatar = () => (
<Box display="flex" flexDirection="row" flexWrap={'wrap'} gap="3W" style={{ alignItems: 'center' }}>
<Button variant="tertiary" title="Marie Curie" leading={<Avatar size="xs" fallbackText="Marie Curie" />} />
<Button variant="tertiary" title="Marie Curie" leading="User" />
</Box>
);
IconOnly
ButtonIcon est la seule façon d'obtenir un bouton carré. Button exige un title : il ne bascule plus en mode icône seule quand on le lui retire. C'est la règle des trois références. Atlassian rend les children de son bouton par défaut obligatoires, si bien qu'un bouton-icône ne peut y être écrit qu'avec IconButton. Primer a deux composants, et la géométrie carrée n'existe que sur la classe que pose IconButton. Base n'a qu'un composant, mais la forme s'y demande (shape="square"), jamais ne se déduit. La raison est mesurable : tant que l'absence de title suffisait, rien ne signalait un bouton muet. Deux des quatre appels de ce genre écrits dans les applications n'avaient aucun accessibilityLabel. ButtonIcon le rend obligatoire, et le compilateur fait le reste. Il accepte primary, secondary et tertiary, et iconSize pour dissocier la taille de l'icône de celle du bouton.
tsx
export const IconOnly = () => (
<Box display="flex" flexDirection="row" flexWrap={'wrap'} gap="3W" style={{ alignItems: 'center' }}>
<ButtonIcon variant="tertiary" size="sm" icon="MoreHorizontal" accessibilityLabel="Plus d'actions" />
<ButtonIcon variant="tertiary" size="md" icon="MoreHorizontal" accessibilityLabel="Plus d'actions" />
<ButtonIcon variant="tertiary" size="lg" icon="MoreHorizontal" accessibilityLabel="Plus d'actions" />
<ButtonIcon variant="secondary" size="md" icon="Trash" accessibilityLabel="Supprimer" />
<ButtonIcon variant="primary" size="md" icon="Plus" accessibilityLabel="Ajouter" />
<ButtonIcon variant="tertiary" size="md" icon="CircleUser" iconSize="xs" accessibilityLabel="Voir le profil" />
</Box>
);
FullWidth
Le bouton remplit la largeur de son parent, au lieu de s'ajuster à son contenu.
tsx
export const FullWidth = () => <Button variant="primary" title="Full Width" fullWidth />;
Alveole UI Kit — v2.0.0-alpha.30