使用组件

Provider、种子、密度和动态效果。

Wobko 组件的 props 与对应的 shadcn/ui 组件相同。如果你用过 shadcn/ui 的 Button、Dialog 或 Tabs,这些就已经会用了。每个组件页面都列出了它的部件和 props。

这一页只讲不一样的地方。

绘制是一层图形,不是组件本身

Wobko 组件先渲染真实的 DOM:一个 <button>、一个 <input>、一个 Radix 对话框。绘制是内容背后的一层 SVG,对辅助技术隐藏,不能获得焦点,也不响应点击。

所以给组件加边框或圆角的 class 不会改变绘制效果。请使用组件提供的 props,例如 variant 和 size。

种子

每个图形都由种子生成,所以同一个组件每次渲染的抖动都一样。默认的种子来自 React 的 useId。传入 seed 可以固定形状:

tsx
<Button seed="save-button">保存修改</Button>

种子相同、尺寸相同的两个组件会画出相同的线条。如果一排完全一样的形状显得太整齐,就给它们各自不同的种子。

密度

一共三种密度。comfortable 是默认值,compact 更紧凑一档,calm 最轻:线条更细,填色只涂一遍。

在 Provider 上为整个应用设置:

tsx
<InkProvider density="compact">{children}</InkProvider>

或者用属性为某个区域单独设置:

tsx
<section data-density="calm">
  <SettingsForm />
</section>

动态效果

有些组件会有绘入动画,或在悬停时轻微抖动。它们会遵循访问者的"减少动态效果"设置。要为所有人关闭动态效果:

tsx
<InkProvider motion="reduced">{children}</InkProvider>

纸张与桌面

大多数布局由两种表面承载。Desk 是东西摆放其上的绿色桌面。Paper 是一张纸:它有 paper、card、kraft 以及各色便利贴等纸张类型,还可以贴胶带或带撕边。

tsx
import { Desk } from "@/components/ui/desk"
import { Paper } from "@/components/ui/paper"

export function Page() {
  return (
    <Desk>
      <Paper stock="paper" tape="top" className="mx-auto max-w-3xl p-10">
        <h1>笔记</h1>
      </Paper>
    </Desk>
  )
}

使用默认配色时,纸张和桌面上的文字都满足 WCAG AA 对比度。