• /
  • EnglishEspañolFrançais日本語한국어Português
  • Se connecterDémarrer

Cette traduction automatique est fournie pour votre commodité.

En cas d'incohérence entre la version anglaise et la version traduite, la version anglaise prévaudra. Veuillez visiter cette page pour plus d'informations.

Créer un problème

Checkbox

Lorsqu'un utilisateur choisit une ou plusieurs options proposées

L'état de la case à cocher peut être contrôlé via les propriétés checked et indeterminate. Si aucun de ces éléments n'est fourni, la case à cocher gérera son propre état.

Vous pouvez écouter les changements d'état de la case à cocher via la propriété onChange.

Remarque: le paramètre checked remplacera defaultChecked car il place le composant dans un état contrôlé. defaultChecked ne doit être utilisé que pour les cases à cocher non contrôlées.

Usage

import { Checkbox } from 'nr1'

Exemples

Basique

<div className="nr1-Docs-prettify">
<Checkbox onChange={(event) => alert('Foo')} label="Foo" />
<Checkbox indeterminate label="Bar" />
<Checkbox checked disabled label="Baz" />
</div>

Avec info

<Checkbox onChange={(event) => alert('Foo')} info="Info value" label="Foo" />

Avec description

<Checkbox
onChange={(event) => alert('Foo')}
description="Description value"
label="Foo"
/>

Avec un message invalide

<Checkbox
onChange={(event) => alert('Foo')}
invalid="Invalid message value"
label="Foo"
/>

Composant contrôlé

class MyNerdlet extends React.PureComponent {
constructor(props) {
super(props);
this.state = {
isChecked: false,
};
this.onChange = this.onChange.bind(this);
}
onChange(event) {
console.log(event);
const isChecked = event.target.checked;
this.setState({ isChecked });
}
render() {
return (
<Checkbox
checked={this.state.isChecked}
onChange={this.onChange}
label="Foo"
/>
);
}
}

Accessoires

checked

booléen

Si true, la case à cocher est cochée. Si elle est définie, elle transforme le composant en composant contrôlé.

className

chaîne

Ajoute les noms de classe au composant. Doit être utilisé uniquement à des fins de positionnement et d'espacement.

defaultChecked

booléen

Si true, l'état initial de la case à cocher est checked. Utile lorsque vous ne souhaitez pas utiliser un composant contrôlé.

description

chaîne

Message avec des instructions sur la façon de remplir le champ du formulaire.

disabled

booléen

Si true, la case à cocher n'est pas disponible pour l'interaction.

indeterminate

booléen

Si true, la case à cocher est dans un état indéterminé. Si les accessoires checked et indeterminate sont tous deux fournis, l'accessoire indeterminate prévaudra.

info

chaîne

Des informations supplémentaires peuvent être affichées dans une info-bulle à côté de l'étiquette.

invalid

booléen|chaîne

Lorsque cette option est vraie, elle définit le champ dans un état non valide, afin d'avertir l'utilisateur qu'une attention particulière est nécessaire sur ce champ particulier. Cette propriété peut être un champ boolean ou un string. Lorsqu'il s'agit d'un string, ainsi que de l'état invalide affiché, le texte sera affiché ci-dessous.

label

chaîne

Texte à afficher comme étiquette.

onChange

fonction

Rappel déclenché à chaque fois que l'état sélectionné de la case à cocher change.function (

event: React.ChangeEvent

The event source of the callback. You can access the new value with event.target.checked.

)

spacingType

énumération[]

Propriété d'espacement. L'espacement est défini comme un uplet de zéro à quatre valeurs, qui suivent les mêmes conventions que les propriétés CSS comme margin ou padding. Pour omettre une valeur, utilisez SPACING_TYPE.OMIT.

<Array of
<One of

Checkbox.SPACING_TYPE.EXTRA_LARGE, Checkbox.SPACING_TYPE.LARGE, Checkbox.SPACING_TYPE.MEDIUM, Checkbox.SPACING_TYPE.NONE, Checkbox.SPACING_TYPE.OMIT, Checkbox.SPACING_TYPE.SMALL

>
>

style

objet

Style en ligne pour un style personnalisé. Doit être utilisé uniquement à des fins de positionnement et d'espacement.

testId

chaîne

Ajoute un attribut data-test-id. Utilisez-le pour cibler le composant dans les tests unitaires et E2E. Pour qu'un identifiant de test soit valide, préfixez-le avec votre identifiant nerdpack, suivi d'un point. Par exemple, my-nerdpack.some-element.Remarque : vous ne verrez peut-être pas l'attribut data-test-id car ils sont supprimés du DOM. Pour les déboguer, transmettez un paramètre de requête e2e-test à l'URL.

value

chaîne

La valeur du composant. Cela va dans l'entrée de la case à cocher interne, pas dans le composant lui-même, et est renvoyé dans le cadre de l'élément cible de l'événement onChange.

Droits d'auteur © 2025 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.