组件标识
在浏览 TechUI 组件文档时,您会在部分组件的标题旁看到特定的 徽章 (Badge) 标识。
TechUI 始终秉持坦诚与尊重的原则。为了明确组件的权利归属与设计来源,我们制定了以下标识规范。
标识含义
| 标识 (Type) | 含义说明 (Description) | 适用场景 / 属性说明 |
|---|---|---|
🏆 行业首创 ind | 颠覆性创新: 表示在整个前端行业内具有开创性意义, 打破了既有的技术边界或交互模式。(如前端许可证) | 主题: danger(高亮警示) |
👑 首创 1st | TechUI 独家发明: 表示概念或实现方式为业界首创, 且代码完全由 TechUI 团队自研。代表核心创新能力。 | 主题: warning(金牌品质) |
🏅 原创 ori | 代码自研: 虽行业已有类似功能,由 TechUI 独立 设计并编写,代码为 100% 自研。 | 主题: warning(品质保证) |
⭐ 明星组件 star | 高热度推荐: 指代社区反馈极佳、功能最为完善 或使用频率极高的核心标杆组件。 | 主题: danger(重点关注) |
💎 高级组件 adv | 高价值组件: 属于旗舰级组件或特定高级功能集合, 涉及核心业务逻辑或复杂底层技术。 | 主题: primary(专业授权) |
🧬 移植自 [库名] port | 致敬与复刻: 深度参考、移植自其他优秀开源库。 在移植时会保留原作者版权声明并进行适配优化。 | 主题: primary(开源兼容) |
🧊 增强封装 enh | 深度定制: 基于成熟第三方库进行深度二次开发,简 化繁琐配置并注入 TechUI 视觉基因,实现开箱即用。 | 主题: primary(易用增强) |
🧪 实验组件 exp | 实验组件: 首次发布,还在测试阶段的组件,随时可 能进行迭代修改,如外观,Props等内容,谨慎使用。 | 主题: success(可能随时变动) |
💛 由 [作者] 投稿 cont | 社区贡献: 表示该组件由社区开发者贡献。如为 贡献者自研,会标注为 由 [作者] 原创 投稿。 | 主题: important(荣誉贡献) |
⚡ WASM 驱动 wasm | 高性能核心: 表示该组件的核心计算逻辑由 Rust 编写并编译为 Wasm,拥有极致性能。 | 主题:info(硬核技术) |
🧊 WebGL/3D gl | 3D 渲染: 表示该组件依赖 Three.js 或原生 WebGL 上下文。通常对显卡有一定要求,属于重度可视化组件。 | 主题:info(视觉引擎) |
🎨 纯 CSS css | 轻量级: 表示该组件完全由 CSS/SVG 实现,无或者 极少 JS 逻辑。零依赖,渲染开销极低,适合静态装饰。 | 主题:success(轻量高效) |
🧠 逻辑组件 logic | 无 UI: 表示这是一个“无头”组件或 Hooks,仅提供 交互逻辑或数据处理能力,不包含具体 UI 样式。 | 主题:warning(底层能力) |
🆕 新增new | 近期发布: 表示该组件为最近 1-2 个小版本内新加入的 成员。用于在侧边栏或列表中快速吸引用户注意。 | 主题:danger(新鲜出炉) |
🔓 已开源os | 完全免费: 表示该组件已正式纳入 TechUI 开源库。无论个人学习还是商业项目,均可无限制免费使用。 | 主题:success(绿色/开放) |
⏳ 待废弃leg | 停止维护: 表示该组件已进入生命周期尾声,将在未来版本 中移除。建议不要在新功能中使用,并尽快迁移至替代方案。 | 主题:default(灰色/过时) |
⛔ 已废弃dep | 停止维护: 表示该组件已不再推荐使用,可能在未来 版本中移除。通常会提供替代方案或迁移指南。 | 主题:default(灰色/过时) |
无标识组件
您会发现 TechUI 组件库中绝大多数的基础组件(如 Button, Input, Layout 等)没有任何标识。
这并不代表拿来主义,而是源于设计模式的通用性。
在前端 UI 发展的长河中,许多基础组件的交互范式已经趋同,难以(也无必要)追溯最早的起源:
- Row+Col (栅格):最早普及于 Bootstrap,现已成为所有 UI 库的标配。
- Tree / Message:交互逻辑深受 Element UI 等先驱的影响。
- Button / Form:属于 Web 标准控件的封装。
对于这些高度通用化的组件,TechUI 均采用 “参考业界标准 + 独立实现代码” 的方式开发,因此不再单独添加来源标识。
未来与生态策略
TechUI 的愿景是构建一个全能的组件生态。
为了让 TechUI 基础库能够快速满足复杂的业务需求,在未来的迭代中,我们可能会采取 “拿来主义” 策略——直接移植部分经过市场验证的、优秀的开源组件(如复杂的日期选择器、富文本编辑器等)。
对于此类移植组件,我们将严格遵守开源协议,并在文档显著位置标注 移植自 [XXX],以向原作者致以最崇高的敬意。
我们相信,站在巨人的肩膀上,才能看得更远。