109k
新建

复选框

上一页下一页

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

Radix UIBase UI
Radix UI - shadcn/ui 组件库

点击此复选框，即表示您同意相关条款。

"use client"

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

安装

pnpm dlx shadcn@latest add checkbox

用法

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

选中状态

对于非受控复选框，请使用 defaultChecked；若要控制状态，请使用 checked 和 onCheckedChange。

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

无效状态

在复选框上设置 aria-invalid，并在字段包装器上设置 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 来添加辅助文本。

点击此复选框，即表示您同意条款与条件。

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

禁用

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

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

分组

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

在桌面上显示这些项目

选择您要在桌面上显示的项目。

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

表格

名称电子邮件角色
Sarah Chensarah.chen@example.com管理员
Marcus Rodriguezmarcus.rodriguez@example.com用户
Priya Patelpriya.patel@example.com用户
David Kimdavid.kim@example.com编辑
"use client"

import * as React from "react"

RTL (从右至左)

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

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

"use client"

import * as React from "react"

API 参考

更多信息请查阅 Radix UI 文档。