工具集合
工具目录用于放一些可直接使用的小工具和工具说明,例如日历、Emoji、取色器等。工具页既可以是交互组件,也可以补充使用场景和实现思路。
使用路线
mermaid
flowchart LR
A[工具集合] --> B[日历]
A --> C[Emoji]
A --> D[取色器]
B --> E[日期选择和农历展示]
C --> F[表情复制和分类]
D --> G[颜色选择和调色]建议
- 交互工具页面保持轻量,说明文档单独拆分。
- 如果工具依赖浏览器 API,要写清兼容性。
- 复杂工具要补充输入、输出、异常场景和使用示例。
工具页设计原则
| 原则 | 说明 |
|---|---|
| 即开即用 | 打开页面后核心功能应立即可用 |
| 输入明确 | 用户知道应该输入什么格式 |
| 输出可复制 | 结果要方便复制到代码或配置里 |
| 状态清晰 | 加载、错误、空结果要有明确反馈 |
| 文档分离 | 复杂原理和说明放到 guide 页面 |
从组件到工具页的流程
mermaid
flowchart TD
A[确定工具场景] --> B[设计输入和输出]
B --> C[开发交互组件]
C --> D[补充说明文档]
D --> E[接入侧边栏]
E --> F[构建验证]适合补充的内容
- 日历:日期选择、农历节气、范围选择、业务标记。
- 取色器:颜色格式转换、主题色保存、对比度检查。
- Emoji:分类检索、复制、常用表情收藏。
- 文本工具:JSON 格式化、URL 编解码、时间戳转换。
工具页的重点是“少解释、多可用”。如果说明内容变长,建议新建 xxx-guide.md,避免影响工具本身的操作体验。
