120k
New

复选框

PreviousNext

允许用户在选中和未选中状态之间切换的控件。

Base UIReact AriaRadix UI

By clicking this checkbox, you agree to the terms.

"use client"

import { Checkbox } from "@/components/ui/checkbox"

安装

pnpm dlx shadcn@latest add checkbox

用法

import { Checkbox } from "@/components/ui/checkbox"
<Checkbox />

选中状态

对于非受控复选框，请使用 defaultSelected；或者使用 isSelected 和 onChange 来控制状态。

import * as React from "react"
 
export function Example() {
  const [checked, setChecked] = React.useState(false)
 
  return <Checkbox isSelected={checked} onChange={setChecked} />
}

无效状态

在复选框上设置 isInvalid，并在字段包装器上设置 data-invalid， 以显示无效样式。

import { Checkbox } from "@/components/ui/checkbox"
import { Field, FieldGroup, FieldLabel } from "@/components/ui/field"

基础

将复选框与 Field 和 FieldLabel 配对，以实现正确的布局和标签。

import { Checkbox } from "@/components/ui/checkbox"
import { Field, FieldGroup, FieldLabel } from "@/components/ui/field"

描述

使用 FieldContent 和 FieldDescription 添加辅助文本。

By clicking this checkbox, you agree to the terms and conditions.

import { Checkbox } from "@/components/ui/checkbox"
import {
  Field,

已禁用

使用 isDisabled 属性来阻止交互，并将 data-disabled 属性添加到 <Field> 组件，以应用禁用样式。

import { Checkbox } from "@/components/ui/checkbox"
import { Field, FieldGroup, FieldLabel } from "@/components/ui/field"

组

使用多个字段创建复选框列表。

Show these items on the desktop:

Select the items you want to show on the desktop.

import { Checkbox } from "@/components/ui/checkbox"
import {
  Field,

表格

NameEmailRole
Sarah Chensarah.chen@example.comAdmin
Marcus Rodriguezmarcus.rodriguez@example.comUser
Priya Patelpriya.patel@example.comUser
David Kimdavid.kim@example.comEditor
"use client"

import * as React from "react"

RTL

要在 shadcn/ui 中启用 RTL 支持，请参阅 RTL 配置指南。

بالنقر على هذا المربع، فإنك توافق على الشروط.

"use client"

import * as React from "react"

API 参考

如需更多信息，请参阅 React Aria 文档。