@ gentleduck/ 原始内容
未被风格化,可访问性第一UI原始作"回放".
麻省理工学院 - 说吧 更改日志 - 说吧 捐款 - 说吧 文档
未被风格化,可访问性第一UI原始作"回放".
为什么原始人
- 比拉迪克斯小50-92% - 提醒对话框: 1.6 KB vs 18.6 KB. 波波弗: 2.4 KB vs 19.6 KB. Dialog: 3.1 KB vs 10.6 KB. 共享内装(槽,存在,波波,焦点范围)一次而不再被每包复制.
- 完全键盘导航 + ARIA 合规出框 - 每一个有正确角色,状态,键盘相互作用的组件船,所以你不必自己给它们接线.
- 化合物组件模式 - 写作
Root, (中文(简体) ),Trigger, (中文(简体) ),Content朋友们来建造你需要的UI. - 与 Radix API 兼容 - 同一个名字,同一个
asChild模式,不变data-state属性。 从 Radix 迁移是您进口的命名空间变化 .
构成部分
| 初级 | 说明 |
|---|---|
alert-dialog | 需要用户识别的模块对话框 |
arrow | 为浮动元素定位箭头 |
avatar | 有图像和倒置支持的用户外观 |
calendar | 有键盘导航和多视图支持的日期网格 |
checkers | 复选框和切换到原始 |
command | 带有搜索过滤器的命令调色板 |
context-menu | 右键单击带有子菜单的上下文菜单 |
dialog | 模块和非模式对话框窗口 |
direction | RTL/LTR 方向提供者 |
dismissable-layer | 在外部互动上忽略的层 |
dropdown-menu | 带有子菜单、复选框和收音机项目的下放菜单 |
focus-scope | 在边界内陷阱并管理焦点 |
hover-card | 由悬空/ 关闭延迟触发的牌 |
input-otp | 有插槽和分隔器的一次性密码输入 |
menu | 下拉、上下文和菜单栏所用的原始基本菜单 |
menubar | 带键盘导航的横向菜单栏 |
mount | 推迟装入周期回调 |
navigation-menu | 有动画指示器和取景口的站点导航 |
pagination | 页面导航控制 |
popover | 浮动内容锁定触发器 |
popper | 通过浮动 UI 定位低等浮式元素 |
portal | 将儿童送入DOM门户网站 |
presence | 动态挂载/卸载过渡 |
primitive-elements | 基础 Primitive 部件厂(asChild 支助) |
progress | 确定和不确定进度指标 |
radio-group | 具有巡回焦点的无线电按钮组 |
roving-focus | 移动各组的标签索引焦点管理 |
select | Listbox 样式选择, 并按字头和滚动按钮 |
sheet | 滑出面板(再导出对话框内部) |
slider | 带单指或多指拇指的区域滑动器 |
slot | 将道具和校正合并到儿童元素上(asChild 发动机) |
toggle | 二态切换按钮 |
toggle-group | 单个或多选择的切换组 |
tooltip | 可访问的工具提示, 提供者级别延迟 |
visibility-hidden | 屏幕阅读器可视隐藏元素 |
快速启动
npm install @gentleduck/primitives
import * as Dialog from '@gentleduck/primitives/dialog'
function Demo() {
return (
<Dialog.Root>
<Dialog.Trigger>Open</Dialog.Trigger>
<Dialog.Portal>
<Dialog.Overlay />
<Dialog.Content>
<Dialog.Title>Heading</Dialog.Title>
<Dialog.Description>Body text here.</Dialog.Description>
<Dialog.Close>Close</Dialog.Close>
</Dialog.Content>
</Dialog.Portal>
</Dialog.Root>
)
}
特征
asChild/ 间隙 - 使任何原始元素成为你自己的元素asChild道具,电源Slot函数.createContextScope- 防止交叉内幕泄漏的反相上下文工厂.forwardRef到处都是 - 每一个组成部分都向后推移,以证明必须进入和组成.data-slot属性 - 每个元件根都发出adata-slot用于没有类名的样式目标.- 存在动画 - 那个
Presence原始的允许您在卸载前进行动画的出/入过渡 . - 焦点陷阱 - 说吧
FocusScope锁在模式、对话框和可配置循环行为的弹出器内. - 解除层 - 说吧
DismissableLayer手柄外部点击、 逃逸键和嵌入层堆放.
文档
温和duck.org/docs/packages/duck-primitives (英语)