介绍

通过柔和的表面和清晰的交互状态,构建一致的 React 界面。

Neumorphism UI 是一组通过光影表达深度的 React 组件。使用 shadcn CLI 将所需源码安装到项目中,然后直接查看和修改。

从这里开始

  1. 按照安装指南添加共享样式和一个 Button。
  2. 确认第一个按钮在应用中正确显示。
  3. 浏览组件目录,只添加需要的组件。

开始使用组件之前,无需先掌握所有设计令牌或 Registry 内部结构。

试用完整界面

打开本地 CMS,选择草稿,修改标题和正文,再尝试预览与保存。查看选择、输入和反馈如何在同一界面协作。

打开 CMS 示例

演示更改仅保存在内存中,刷新后重置。在应用中,将 initialPosts 和 onSave 连接到数据,并处理认证、持久化和发布权限。

界面构建原则

让深度承担明确作用

凸起的表面表示操作;内凹的表面表示输入或按下状态。将相关内容放在同一表面上,避免为每层容器添加阴影。

持续显示选中状态

选中的标签页或筛选项在指针离开后仍应清晰可辨。用颜色和形状表达选择,并保留独立的键盘焦点指示。

统一光源与形状

同一界面应共享光源方向和表面圆角。使用 Theme Studio 一起调整颜色、深度、光源和形状,保持组件一致。

保持输入与反馈清晰

保持字段标签可见,在对应输入附近解释错误。说明保存状态;减少动画时,也应保留选择、焦点和错误反馈。

包含的内容

  • 根据需要使用 Base UI 键盘与焦点行为的 React 19 组件
  • 管理明暗颜色、深度、光源方向和形状的 Tailwind CSS v4 令牌
  • 直接安装到应用中、可编辑的组件源码
  • 展示实用组合的图表和界面模板

安装与定制

shadcn CLI 将所选源码与必要依赖添加到项目。安装后的文件属于应用代码,不会自动更新。之后应用更新前,请比较已有定制。

完成安装后,使用设计令牌调整界面。需要时再查看 Registry 结构和验证范围。