复合组件

Tailwind v4 包提供了一个复合组件 API,让您可以完全控制每个选择器的内部结构和渲染。您不再使用单个整体式组件,而是由各个部分组合成选择器。

工作原理

每个选择器(例如 DatePicker)既是一个简单组件,也是一个复合部件的命名空间:

import { DatePicker } from "react-date-range-picker-tailwind4";
// 简单用法 -- 渲染默认布局
<DatePicker value={value} onChange={setValue} />
// 复合用法 -- 完全控制结构
<DatePicker.Root value={value} onChange={setValue}>
<DatePicker.Trigger />
<DatePicker.Content>
<DatePicker.Header>
<DatePicker.PrevButton />
<DatePicker.Title />
<DatePicker.NextButton />
</DatePicker.Header>
<DatePicker.Grid />
<DatePicker.Footer>
<DatePicker.ClearButton />
<DatePicker.CancelButton />
<DatePicker.ConfirmButton />
</DatePicker.Footer>
</DatePicker.Content>
</DatePicker.Root>

通过复合组件,您可以:

  • 替换 任何部分为您自己的渲染(例如自定义触发器、自定义日期单元格)
  • 重新排列 布局(例如移动页脚按钮、添加“今天”按钮)
  • 省略