From d9559aee1d5e2eda59084caaecd1bdfdd99b612f Mon Sep 17 00:00:00 2001 From: HIsheR Date: Mon, 26 Oct 2026 15:21:23 +0800 Subject: [PATCH] =?UTF-8?q?iter(g131):=20=E6=96=B0=E5=A2=9E=E6=82=AC?= =?UTF-8?q?=E6=B5=AE=E6=93=8D=E4=BD=9C=E6=8C=89=E9=92=AE=20floatButton?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .ua/index.json | 59 +++++++++++++++++++- AGENTS.md | 2 +- ARCHITECTURE.md | 2 +- README.md | 8 +-- apps/demo/main.ts | 18 ++++++ llms-full.txt | 32 ++++++++++- llms.txt | 1 + packages/skin/ui/src/floatButton.ts | 22 ++++++++ packages/skin/ui/src/index.ts | 1 + packages/skin/ui/src/types.ts | 11 ++++ packages/skin/ui/ua.manifest.json | 57 ++++++++++++++++++- packages/skin/ui/ui.css | 85 +++++++++++++++++++++++++++++ 12 files changed, 288 insertions(+), 10 deletions(-) create mode 100644 packages/skin/ui/src/floatButton.ts diff --git a/.ua/index.json b/.ua/index.json index b733db5..428d029 100644 --- a/.ua/index.json +++ b/.ua/index.json @@ -1,6 +1,6 @@ { "$schema": "ui-arch-registry-index/0.1", - "generatedAt": "2026-10-26T07:19:51.268Z", + "generatedAt": "2026-10-26T07:21:05.139Z", "repoRoot": ".", "packages": [ { @@ -205,7 +205,8 @@ "popconfirm(props, trigger)：二次确认气泡，挂在任意触发器上，就地确认危险操作；确定后先收起再回调，取消 / 点外部 / Esc 走 onCancel，展开即聚焦「取消」", "calendar(props)：月历，整月网格内嵌页面（排期 / 值班 / 日程），每日可带 marker 标记文案，方向键漫游 + Enter 选中，翻月走 onMonthChange", "typography(props)：排版文本，variant 决定语义（标题出 h1-h5 / 段落出 p / 行内出 span），支持语义色、装饰位、对齐、多行截断与复制按钮", - "grid(props, ...children)：栅格容器，columns 固定列数或 min 走 auto-fit 自适应列宽，gutter 统一列间距，窄屏自动降为单列" + "grid(props, ...children)：栅格容器，columns 固定列数或 min 走 auto-fit 自适应列宽，gutter 统一列间距，窄屏自动降为单列", + "floatButton(props)：悬浮操作按钮，固定停靠左下 / 右下角，label 缺省为纯图标圆形，badge 走角标，tooltip 兼作 aria-label" ], "keyTypes": [ "ButtonProps", @@ -3207,6 +3208,60 @@ "子项必须是单个元素（card / div / 自定义块），grid 只负责排布且已对子项设 min-width: 0，长文本不会撑破列宽", "只要横向一排展示且元素不等宽，用 space 更轻；grid 面向二维对齐" ] + }, + { + "id": "floatButton", + "title": "悬浮操作按钮 FloatButton", + "demo": "sec-floatbutton", + "props": [ + { + "n": "icon", + "t": "string | Node", + "d": "图标：字符串按字符（emoji / 符号）渲染，传 DOM 原样插入" + }, + { + "n": "label", + "t": "string", + "d": "文字标签；给了就出「图标 + 文字」胶囊，缺省为纯图标圆形" + }, + { + "n": "badge", + "t": "string | number", + "d": "角标（数字或短文案，如 3 / '新'）；缺省不渲染" + }, + { + "n": "tooltip", + "t": "string", + "d": "悬停提示，同时用作 aria-label；纯图标时必传，否则读屏听到默认「快捷操作」" + }, + { + "n": "position", + "t": "'right-bottom' | 'left-bottom'", + "df": "right-bottom", + "d": "停靠角落；右下与 backTop 同侧，需同时出现时错开一左一右" + }, + { + "n": "offset", + "t": "number", + "df": "24", + "d": "距边距离（px）；同角落堆叠多个时按倍数递增" + }, + { + "n": "onClick", + "t": "() => void", + "k": 1, + "d": "点击回调" + } + ], + "example": "document.body.append(floatButton({ icon: '+', label: '新建工单', position: 'left-bottom', onClick: () => toast.success('已新建') })); document.body.append(floatButton({ icon: '?', tooltip: '帮助中心', badge: 3 }))", + "steps": [ + "把返回节点挂到 document.body（不是页面容器内）：它是 fixed 定位，挂在容器里会被 overflow: hidden 裁剪", + "只有图标时务必传 tooltip：它同时是 aria-label，读屏用户靠它知道按钮干什么；有 label 时 tooltip 可省", + "label 存在即「图标 + 文字」胶囊，只有图标即 44px 圆形；两种形态都保证触摸目标不小于 44px", + "同一角落要放多个按钮时递增 offset（如 24 / 80），或把它们并进同一个 flex 容器统一排布——组件自身不做堆叠计算", + "右下角已被 backTop 占用，页面同时有返回顶部时用 position: 'left-bottom'", + "纯展示 + 单回调，没有选中态与开合状态；需要多级操作请用 menu / popover 挂在 onClick 上" + ] } ] }, diff --git a/AGENTS.md b/AGENTS.md index 2ac15b7..3dfd445 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -21,7 +21,7 @@ - `packages/core/table-core`（@ui-arch/table-core）：Headless 表格逻辑内核 - `packages/core/frame`（@ui-arch/frame）：signal + hyperscript 微框架 -- `packages/skin/ui`（@ui-arch/ui）：62 个 DOM 组件（表单 / 反馈 / 浮层 / 导航 / 表格），样式只消费令牌 +- `packages/skin/ui`（@ui-arch/ui）：63 个 DOM 组件（表单 / 反馈 / 浮层 / 导航 / 表格），样式只消费令牌 - `packages/design/tokens`（@ui-arch/tokens）：设计令牌 - `packages/tools/cli`（@ui-arch/cli）：`ua` 命令行 + MCP 注册表服务（private） - `apps/demo`（@ui-arch/demo）：交互演示，产物 apps/demo/dist/demo.html diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md index 069d0da..63baa62 100644 --- a/ARCHITECTURE.md +++ b/ARCHITECTURE.md @@ -34,7 +34,7 @@ ui-arch-mvp/ │ │ ├── table-core/ # 表格状态内核 │ │ └── frame/ # 信号 + hyperscript 微框架 │ ├── skin/ # 皮肤层（DOM 组件，可发布） -│ │ └── ui/ # 62 个组件 + ui.css +│ │ └── ui/ # 63 个组件 + ui.css │ ├── design/ # 资产层（可发布） │ │ └── tokens/ # --ua-* 设计令牌 │ └── tools/ # 工程层（private，不发布） diff --git a/README.md b/README.md index 288859c..d46cf7e 100644 --- a/README.md +++ b/README.md @@ -12,13 +12,13 @@ npm run docs # 生成人类文档站 apps/docs/index.html + Agent 全 npm run changelog # 依据 git 提交史重写 CHANGELOG.md（发版前跑；changelog:check 可查漂移） ``` -## 组件（共 62 个） +## 组件（共 63 个） -accordion · affix · alert · anchor · autoComplete · avatar · backTop · badge · breadcrumb · button · calendar · carousel · card · cascader · checkbox · checkboxGroup · colorPicker · dataTable · datePicker · descriptions · divider · drawer · empty · form · grid · image · inputNumber · list · menu · modal · multiSelect · notification · pagination · popover · popconfirm · progress · radioGroup · rate · result · segmented · select · skeleton · slider · space · spinner · splitter · statistic · stepper · switchButton · tabs · tag · textField · textarea · timeline · toast · tooltip · tour · transfer · tree · typography · upload · watermark +accordion · affix · alert · anchor · autoComplete · avatar · backTop · badge · breadcrumb · button · calendar · carousel · card · cascader · checkbox · checkboxGroup · colorPicker · dataTable · datePicker · descriptions · divider · drawer · empty · floatButton · form · grid · image · inputNumber · list · menu · modal · multiSelect · notification · pagination · popover · popconfirm · progress · radioGroup · rate · result · segmented · select · skeleton · slider · space · spinner · splitter · statistic · stepper · switchButton · tabs · tag · textField · textarea · timeline · toast · tooltip · tour · transfer · tree · typography · upload · watermark -分组：表单（button / textField / inputNumber / textarea / checkbox / checkboxGroup / colorPicker / switchButton / select / multiSelect / radioGroup / slider / rate / autoComplete / datePicker / segmented / upload / form + formItem / transfer / cascader）、反馈（alert / toast / notification / result / spinner / progress / skeleton / badge / empty / statistic）、浮层（tooltip / popover / popconfirm / modal / drawer / menu）、导航（tabs / breadcrumb / pagination / accordion / stepper / tree / anchor）、数据展示（dataTable / descriptions / card / list / timeline / tag / avatar / image / carousel / calendar / typography）、其他（grid / space / divider / splitter / backTop / affix / tour / watermark）。 +分组：表单（button / textField / inputNumber / textarea / checkbox / checkboxGroup / colorPicker / switchButton / select / multiSelect / radioGroup / slider / rate / autoComplete / datePicker / segmented / upload / form + formItem / transfer / cascader）、反馈（alert / toast / notification / result / spinner / progress / skeleton / badge / empty / statistic）、浮层（tooltip / popover / popconfirm / modal / drawer / menu）、导航（tabs / breadcrumb / pagination / accordion / stepper / tree / anchor）、数据展示（dataTable / descriptions / card / list / timeline / tag / avatar / image / carousel / calendar / typography）、其他（floatButton / grid / space / divider / splitter / backTop / affix / tour / watermark）。 ## 可访问性约定 @@ -32,7 +32,7 @@ accordion · affix · alert · anchor · autoComplete · avatar · backTop · ba |---|---| | `packages/core/frame` | @ui-arch/frame：signal / computed / effect + hyperscript（无虚拟 DOM） | | `packages/core/table-core` | @ui-arch/table-core：headless 表格（filter → sort → paginate 派生管线） | -| `packages/skin/ui` | @ui-arch/ui：62 个 DOM 组件 + ui.css（只消费 `--ua-*` 令牌） | +| `packages/skin/ui` | @ui-arch/ui：63 个 DOM 组件 + ui.css（只消费 `--ua-*` 令牌） | | `packages/design/tokens` | @ui-arch/tokens：设计令牌（暗色只换值不换名） | | `packages/tools/cli` | @ui-arch/cli：`ua` 命令行与 stdio MCP server | | `apps/demo` | 交互演示（esbuild 打包成单文件） | diff --git a/apps/demo/main.ts b/apps/demo/main.ts index e1735f8..6e45a96 100644 --- a/apps/demo/main.ts +++ b/apps/demo/main.ts @@ -31,6 +31,7 @@ import { divider, drawer, empty, + floatButton, image, form, formItem, @@ -1305,6 +1306,23 @@ const content = h( card({ title: zone }, typography({ content: '健康检查通过', type: 'success', variant: 'paragraph' }))), ), ), + section( + 'sec-floatbutton', + '悬浮操作按钮', + 'floatButton 停靠左下 / 右下角：只给 icon 是圆形，配 label 变胶囊，badge 走角标，tooltip 兼作 aria-label。它返回的是 fixed 包裹层，挂到 body 才不会被容器 overflow 裁掉。', + grid({ min: '240px' }, + card({ title: '本页已挂两个' }, + typography({ variant: 'paragraph', type: 'secondary', content: '左下角「＋ 新建工单」是图标 + 文字胶囊，点击弹提示；右下角「?」是纯图标圆形并带角标 3，悬停看 title。' }), + typography({ variant: 'paragraph', content: h('span', null, '右下角同时有 backTop，所以这里改用 ', typography({ content: "position: 'left-bottom'", code: true }), ' 错开。') }), + ), + ), + ), +); + +// 悬浮按钮：fixed 定位，挂 body 不参与页面布局 +document.body.append( + floatButton({ icon: '+', label: '新建工单', tooltip: '新建工单', position: 'left-bottom', onClick: () => toast.success('已新建工单') }), + floatButton({ icon: '?', tooltip: '帮助中心（3 条待读）', badge: 3, onClick: () => toast.info('打开帮助中心') }), ); // 引导漫游实例：根节点需挂到 body（fixed 定位，不参与布局） diff --git a/llms-full.txt b/llms-full.txt index a83a057..8a79b8f 100644 --- a/llms-full.txt +++ b/llms-full.txt @@ -1,6 +1,6 @@ # @ui-arch 组件库 Agent 文档（无图形版） -> 自动生成于 2026-10-26T07:19:51.268Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。 +> 自动生成于 2026-10-26T07:21:05.139Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。 > 组件 = 普通函数，传 props 返回 DOM；状态用 signal 双向绑定：读 signal() 写 signal(v)。 ## 快速上手 @@ -1729,6 +1729,35 @@ grid({ columns: 3, gutter: 'md' }, card({ title: '实例数' }, statistic({ valu 现场演示：apps/docs/demo.html#sec-grid +### floatButton — 悬浮操作按钮 FloatButton + +参数： + +- icon：string | Node —— 图标：字符串按字符（emoji / 符号）渲染，传 DOM 原样插入 +- label：string —— 文字标签；给了就出「图标 + 文字」胶囊，缺省为纯图标圆形 +- badge：string | number —— 角标（数字或短文案，如 3 / '新'）；缺省不渲染 +- tooltip：string —— 悬停提示，同时用作 aria-label；纯图标时必传，否则读屏听到默认「快捷操作」 +- position（默认 right-bottom）：'right-bottom' | 'left-bottom' —— 停靠角落；右下与 backTop 同侧，需同时出现时错开一左一右 +- offset（默认 24）：number —— 距边距离（px）；同角落堆叠多个时按倍数递增 +- onClick（回调）：() => void —— 点击回调 + +示例： + +``` +document.body.append(floatButton({ icon: '+', label: '新建工单', position: 'left-bottom', onClick: () => toast.success('已新建') })); document.body.append(floatButton({ icon: '?', tooltip: '帮助中心', badge: 3 })) +``` + +手把手： + +1. 把返回节点挂到 document.body（不是页面容器内）：它是 fixed 定位，挂在容器里会被 overflow: hidden 裁剪 +2. 只有图标时务必传 tooltip：它同时是 aria-label，读屏用户靠它知道按钮干什么；有 label 时 tooltip 可省 +3. label 存在即「图标 + 文字」胶囊，只有图标即 44px 圆形；两种形态都保证触摸目标不小于 44px +4. 同一角落要放多个按钮时递增 offset（如 24 / 80），或把它们并进同一个 flex 容器统一排布——组件自身不做堆叠计算 +5. 右下角已被 backTop 占用，页面同时有返回顶部时用 position: 'left-bottom' +6. 纯展示 + 单回调，没有选中态与开合状态；需要多级操作请用 menu / popover 挂在 onClick 上 + +现场演示：apps/docs/demo.html#sec-floatbutton + API 速览： - button(props)：按钮，variant = primary | ghost | danger，disabled 支持布尔或信号禁用；type 缺省 button（表单内不隐式提交） @@ -1795,6 +1824,7 @@ API 速览： - calendar(props)：月历，整月网格内嵌页面（排期 / 值班 / 日程），每日可带 marker 标记文案，方向键漫游 + Enter 选中，翻月走 onMonthChange - typography(props)：排版文本，variant 决定语义（标题出 h1-h5 / 段落出 p / 行内出 span），支持语义色、装饰位、对齐、多行截断与复制按钮 - grid(props, ...children)：栅格容器，columns 固定列数或 min 走 auto-fit 自适应列宽，gutter 统一列间距，窄屏自动降为单列 +- floatButton(props)：悬浮操作按钮，固定停靠左下 / 右下角，label 缺省为纯图标圆形，badge 走角标，tooltip 兼作 aria-label 一行用法： diff --git a/llms.txt b/llms.txt index 8f18d08..1cd5bba 100644 --- a/llms.txt +++ b/llms.txt @@ -111,6 +111,7 @@ - calendar(props)：月历，整月网格内嵌页面（排期 / 值班 / 日程），每日可带 marker 标记文案，方向键漫游 + Enter 选中，翻月走 onMonthChange - typography(props)：排版文本，variant 决定语义（标题出 h1-h5 / 段落出 p / 行内出 span），支持语义色、装饰位、对齐、多行截断与复制按钮 - grid(props, ...children)：栅格容器，columns 固定列数或 min 走 auto-fit 自适应列宽，gutter 统一列间距，窄屏自动降为单列 + - floatButton(props)：悬浮操作按钮，固定停靠左下 / 右下角，label 缺省为纯图标圆形，badge 走角标，tooltip 兼作 aria-label - 用法: `const checked = signal(false); checkbox({ label: '同意', checked }); const open = signal(false); modal({ title: '确认', open }, '内容')` - 约定: 皮肤不持有业务状态，一律委托 headless 内核或调用方信号 - 约定: 表单类组件统一约定：*Props.value/checked/active 为 Signal 双向绑定，onChange/onInput 为回调 diff --git a/packages/skin/ui/src/floatButton.ts b/packages/skin/ui/src/floatButton.ts new file mode 100644 index 0000000..d89c31b --- /dev/null +++ b/packages/skin/ui/src/floatButton.ts @@ -0,0 +1,22 @@ +import { h } from '@ui-arch/frame'; +import type { FloatButtonProps } from './types.js'; + +/*** 悬浮操作按钮：固定停靠左下 / 右下角，label 缺省为纯图标圆形；返回 fixed 包裹层，挂 body 才不被父级 overflow 裁剪 ***/ +export function floatButton(props: FloatButtonProps): HTMLElement { + const cls = ['ua-fab', props.label ? 'has-label' : ''].filter(Boolean).join(' '); + const btn = h('button', { + class: cls, + type: 'button', + 'aria-label': props.tooltip ?? props.label ?? '快捷操作', // 纯图标时必须有可读名称 + title: props.tooltip ?? null, + }, + props.icon ? h('span', { class: 'ua-fab-icon', 'aria-hidden': 'true' }, props.icon) : null, + props.label ? h('span', { class: 'ua-fab-label' }, props.label) : null, + props.badge != null ? h('span', { class: 'ua-fab-badge' }, String(props.badge)) : null); + if (props.onClick) btn.addEventListener('click', props.onClick); + const offset = `${props.offset ?? 24}px`; // 缺省离边 24px，与常见浮动件手感一致 + return h('div', { + class: `ua-fab-wrap is-${props.position ?? 'right-bottom'}`, + style: `--ua-fab-offset:${offset}`, + }, btn); +} diff --git a/packages/skin/ui/src/index.ts b/packages/skin/ui/src/index.ts index 06b3e11..a32c991 100644 --- a/packages/skin/ui/src/index.ts +++ b/packages/skin/ui/src/index.ts @@ -62,3 +62,4 @@ export { popconfirm } from './popconfirm.js'; export { calendar } from './calendar.js'; export { typography } from './typography.js'; export { grid } from './grid.js'; +export { floatButton } from './floatButton.js'; diff --git a/packages/skin/ui/src/types.ts b/packages/skin/ui/src/types.ts index 57501ee..c627263 100644 --- a/packages/skin/ui/src/types.ts +++ b/packages/skin/ui/src/types.ts @@ -766,4 +766,15 @@ export interface GridProps { dense?: boolean; // 紧凑填充：小项回填空洞（瀑布式排布）；缺省 false } +/*** 悬浮操作按钮入参 ***/ +export interface FloatButtonProps { + icon?: string | Node; // 图标：字符串按字符（emoji / 符号）渲染，传 DOM 原样插入 + label?: string; // 文字标签；给了就出「图标 + 文字」胶囊，缺省纯图标圆形 + badge?: string | number; // 角标数字或短文案（如 3 / '新'）；缺省不渲染 + tooltip?: string; // 悬停提示，同时用作 aria-label；缺省取 label + position?: 'right-bottom' | 'left-bottom'; // 停靠角落；缺省右下 + offset?: number; // 距边距离（px）；缺省 24 + onClick?: () => void; // 点击回调 +} + export type { ColumnDef, RowKey }; // 再导出常用内核类型，方便调用方 diff --git a/packages/skin/ui/ua.manifest.json b/packages/skin/ui/ua.manifest.json index 1594c2b..5de257c 100644 --- a/packages/skin/ui/ua.manifest.json +++ b/packages/skin/ui/ua.manifest.json @@ -76,7 +76,8 @@ "popconfirm(props, trigger)：二次确认气泡，挂在任意触发器上，就地确认危险操作；确定后先收起再回调，取消 / 点外部 / Esc 走 onCancel，展开即聚焦「取消」", "calendar(props)：月历，整月网格内嵌页面（排期 / 值班 / 日程），每日可带 marker 标记文案，方向键漫游 + Enter 选中，翻月走 onMonthChange", "typography(props)：排版文本，variant 决定语义（标题出 h1-h5 / 段落出 p / 行内出 span），支持语义色、装饰位、对齐、多行截断与复制按钮", - "grid(props, ...children)：栅格容器，columns 固定列数或 min 走 auto-fit 自适应列宽，gutter 统一列间距，窄屏自动降为单列" + "grid(props, ...children)：栅格容器，columns 固定列数或 min 走 auto-fit 自适应列宽，gutter 统一列间距，窄屏自动降为单列", + "floatButton(props)：悬浮操作按钮，固定停靠左下 / 右下角，label 缺省为纯图标圆形，badge 走角标，tooltip 兼作 aria-label" ], "keyTypes": [ "ButtonProps", @@ -3078,6 +3079,60 @@ "子项必须是单个元素（card / div / 自定义块），grid 只负责排布且已对子项设 min-width: 0，长文本不会撑破列宽", "只要横向一排展示且元素不等宽，用 space 更轻；grid 面向二维对齐" ] + }, + { + "id": "floatButton", + "title": "悬浮操作按钮 FloatButton", + "demo": "sec-floatbutton", + "props": [ + { + "n": "icon", + "t": "string | Node", + "d": "图标：字符串按字符（emoji / 符号）渲染，传 DOM 原样插入" + }, + { + "n": "label", + "t": "string", + "d": "文字标签；给了就出「图标 + 文字」胶囊，缺省为纯图标圆形" + }, + { + "n": "badge", + "t": "string | number", + "d": "角标（数字或短文案，如 3 / '新'）；缺省不渲染" + }, + { + "n": "tooltip", + "t": "string", + "d": "悬停提示，同时用作 aria-label；纯图标时必传，否则读屏听到默认「快捷操作」" + }, + { + "n": "position", + "t": "'right-bottom' | 'left-bottom'", + "df": "right-bottom", + "d": "停靠角落；右下与 backTop 同侧，需同时出现时错开一左一右" + }, + { + "n": "offset", + "t": "number", + "df": "24", + "d": "距边距离（px）；同角落堆叠多个时按倍数递增" + }, + { + "n": "onClick", + "t": "() => void", + "k": 1, + "d": "点击回调" + } + ], + "example": "document.body.append(floatButton({ icon: '+', label: '新建工单', position: 'left-bottom', onClick: () => toast.success('已新建') })); document.body.append(floatButton({ icon: '?', tooltip: '帮助中心', badge: 3 }))", + "steps": [ + "把返回节点挂到 document.body（不是页面容器内）：它是 fixed 定位，挂在容器里会被 overflow: hidden 裁剪", + "只有图标时务必传 tooltip：它同时是 aria-label，读屏用户靠它知道按钮干什么；有 label 时 tooltip 可省", + "label 存在即「图标 + 文字」胶囊，只有图标即 44px 圆形；两种形态都保证触摸目标不小于 44px", + "同一角落要放多个按钮时递增 offset（如 24 / 80），或把它们并进同一个 flex 容器统一排布——组件自身不做堆叠计算", + "右下角已被 backTop 占用，页面同时有返回顶部时用 position: 'left-bottom'", + "纯展示 + 单回调，没有选中态与开合状态；需要多级操作请用 menu / popover 挂在 onClick 上" + ] } ] } diff --git a/packages/skin/ui/ui.css b/packages/skin/ui/ui.css index 320821e..8ae8e6c 100644 --- a/packages/skin/ui/ui.css +++ b/packages/skin/ui/ui.css @@ -4066,3 +4066,88 @@ h5.ua-type-title { font-size: var(--ua-font-size-md); } grid-template-columns: 1fr; } } + +/* —— 悬浮操作按钮：fixed 停靠角落，hover 上浮 + 按压回缩 —— */ +.ua-fab-wrap { + position: fixed; + z-index: 40; /* 低于弹层（60+），高于正文 */ + display: flex; + gap: var(--ua-space-2); +} +.ua-fab-wrap.is-right-bottom { + right: var(--ua-fab-offset, 24px); + bottom: var(--ua-fab-offset, 24px); +} +.ua-fab-wrap.is-left-bottom { + left: var(--ua-fab-offset, 24px); + bottom: var(--ua-fab-offset, 24px); +} +.ua-fab { + position: relative; + display: inline-flex; + align-items: center; + justify-content: center; + gap: var(--ua-space-1); + min-width: 44px; + min-height: 44px; /* 触摸目标不小于 44px */ + padding: 0; + border: 1px solid var(--ua-color-border); + border-radius: 50%; + background: var(--ua-color-surface); + color: var(--ua-color-text); + font: inherit; + font-size: var(--ua-font-size-md); + cursor: pointer; + box-shadow: 0 6px 20px color-mix(in srgb, var(--ua-color-text) 16%, transparent); + transition: transform 0.15s ease, box-shadow 0.15s ease, color 0.15s ease, border-color 0.15s ease; +} +.ua-fab.has-label { + padding: 0 var(--ua-space-3); + border-radius: 999px; +} +.ua-fab:hover { + color: var(--ua-color-accent); + border-color: var(--ua-color-accent); + transform: translateY(-2px); + box-shadow: 0 10px 26px color-mix(in srgb, var(--ua-color-text) 22%, transparent); +} +.ua-fab:active { + transform: translateY(0) scale(0.97); +} +.ua-fab:focus-visible { + outline: 2px solid var(--ua-color-accent); + outline-offset: 2px; +} +.ua-fab-icon { + display: inline-flex; + align-items: center; + line-height: 1; +} +.ua-fab-label { + font-size: var(--ua-font-size-sm); + white-space: nowrap; +} +.ua-fab-badge { + position: absolute; + top: -4px; + right: -4px; + min-width: 18px; + height: 18px; + padding: 0 4px; + border-radius: 999px; + background: var(--ua-color-danger); + color: var(--ua-color-accent-contrast); + font-size: 10px; + line-height: 18px; + text-align: center; + box-shadow: 0 0 0 2px var(--ua-color-bg); /* 与页面底色断开，避免和按钮边缘糊在一起 */ +} +@media (prefers-reduced-motion: reduce) { + .ua-fab { + transition: none; + } + .ua-fab:hover, + .ua-fab:active { + transform: none; + } +}