FloatButton 设计文档
悬浮固定在视口的可操作按钮，用于承载全局快捷入口（AI 编辑、搜索、帮助等）。严格对齐 Semi：纯 div + onClick（非 button/a），href 靠 JS 跳转（target=_blank 用 window.open，否则 location.href），disabled 时不触发。可选包裹 Badge。形状 round(默认)/square、尺寸 small/default/large、colorful AI 渐变。默认 position:fixed 于右下角（bottom/right 24px），经 style 覆盖定位。FloatButtonGroup 将多项平铺成胶囊工具条，点击委托直接读 e.target.dataset.value 回传 value。
← API 文档使用建议
悬浮固定在视口的可操作按钮，用于承载全局快捷入口（AI 编辑、搜索、帮助等）。严格对齐 Semi：纯 div + onClick（非 button/a），href 靠 JS 跳转（target=_blank 用 window.open，否则 location.href），disabled 时不触发。可选包裹 Badge。形状 round(默认)/square、尺寸 small/default/large、colorful AI 渐变。默认 position:fixed 于右下角（bottom/right 24px），经 style 覆盖定位。FloatButtonGroup 将多项平铺成胶囊工具条，点击委托直接读 e.target.dataset.value 回传 value。
Accessibility
ARIA role：none
- 严格对齐 Semi：FloatButton 与 FloatButtonGroup 均为纯 div + onClick（非 button/a），无内置 ARIA 语义、无键盘可达、无 focus 环。href 经 JS 跳转而非原生链接。如需可访问性由消费方在业务层补充。
设计变量
| 变量 | 默认值 | 用法 |
|---|---|---|
--cd-floatbutton-bg | var(--cd-color-fill-0) | 按钮背景色 - 默认 |
--cd-floatbutton-bg-active | var(--cd-color-fill-2) | 按钮背景色 - 按下 |
--cd-floatbutton-bg-hover | var(--cd-color-fill-1) | 按钮背景色 - 悬浮 |
--cd-floatbutton-color | var(--cd-color-primary) | 按钮内图标 / 文字颜色（Semi=primary） |
--cd-floatbutton-colorful-bg | var(--cd-color-ai-general) | colorful 外观 AI 渐变背景 - 默认 |
--cd-floatbutton-colorful-bg-active | var(--cd-color-ai-general-active) | colorful 外观 AI 渐变背景 - 按下 |
--cd-floatbutton-colorful-bg-hover | var(--cd-color-ai-general-hover) | colorful 外观 AI 渐变背景 - 悬浮 |
--cd-floatbutton-colorful-text | var(--cd-color-white) | colorful 外观图标 / 文字颜色（白） |
--cd-floatbutton-disabled-bg | var(--cd-color-disabled-bg) | 禁用态背景色 |
--cd-floatbutton-disabled-text | var(--cd-color-disabled-text) | 禁用态图标 / 文字颜色 |