组件 API 设计

组件 API 设计

这篇笔记还在编辑中,内容可能会继续补充、调整或重写。

核心认识

组件 API 通过属性、事件、插槽和实例方法定义使用契约。好的 API 命名一致、默认行为合理、组合能力清晰,并尽量避免把内部实现泄露给调用方。

学习重点

  • 从使用者视角设计稳定、可组合且可发现的组件能力
  • 把视觉规范、交互状态、无障碍和测试作为同一套契约
  • 建立从开发、文档、验证到版本发布的完整维护流程

实践检查

  • 能用自己的话解释“组件 API 设计”
  • 能在最小项目中完成一次与“组件 API 设计”相关的验证
  • 能记录常见问题、取舍依据和排查方法