Skip to content

工具集合

工具目录用于放一些可直接使用的小工具和工具说明,例如日历、Emoji、取色器等。工具页既可以是交互组件,也可以补充使用场景和实现思路。

使用路线

mermaid
flowchart LR
    A[工具集合] --> B[日历]
    A --> C[Emoji]
    A --> D[取色器]
    B --> E[日期选择和农历展示]
    C --> F[表情复制和分类]
    D --> G[颜色选择和调色]

建议

  1. 交互工具页面保持轻量,说明文档单独拆分。
  2. 如果工具依赖浏览器 API,要写清兼容性。
  3. 复杂工具要补充输入、输出、异常场景和使用示例。

工具页设计原则

原则说明
即开即用打开页面后核心功能应立即可用
输入明确用户知道应该输入什么格式
输出可复制结果要方便复制到代码或配置里
状态清晰加载、错误、空结果要有明确反馈
文档分离复杂原理和说明放到 guide 页面

从组件到工具页的流程

mermaid
flowchart TD
    A[确定工具场景] --> B[设计输入和输出]
    B --> C[开发交互组件]
    C --> D[补充说明文档]
    D --> E[接入侧边栏]
    E --> F[构建验证]

适合补充的内容

  1. 日历:日期选择、农历节气、范围选择、业务标记。
  2. 取色器:颜色格式转换、主题色保存、对比度检查。
  3. Emoji:分类检索、复制、常用表情收藏。
  4. 文本工具:JSON 格式化、URL 编解码、时间戳转换。

工具页的重点是“少解释、多可用”。如果说明内容变长,建议新建 xxx-guide.md,避免影响工具本身的操作体验。