api-design

用途：在设计和修改组件 API 时遵循 Elements 约定。使用前必须先查阅相关的 API 设计指南。\n\n适用工作：为新组件设计属性和特性；创建用于主题化的 CSS 自定义属性；避免组件 API 出现不可能状态；在属性、特性与插槽之间做选择；设计自定义事件；规划组件组合模式；设置包导出与依赖。\n\n按主题查阅的指南：无状态组件——新建可能包含用户状态的组件或功能时查阅；属性与特性——处理 JavaScript 属性与 HTML 特性时查阅；样式与 CSS 自定义属性——涉及 CSS、CSS 自定义属性或设计令牌时查阅；组件组合——新建 API 或确定父子组件 API 设计时查阅；插槽——处理用户提供内容或容器类组件时查阅；自定义事件——新建或监听事件时查阅；组件注册——新建组件或将组件作为依赖使用时查阅；打包与导出——新建组件或包时查阅。\n\n限制：资料仅列出各指南主题与引用要求，未提供具体规则内容、代码示例、版本要求或支持平台信息，这些暂未提供。