iter(g131): 新增悬浮操作按钮 floatButton
This commit is contained in:
+57
-2
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"$schema": "ui-arch-registry-index/0.1",
|
"$schema": "ui-arch-registry-index/0.1",
|
||||||
"generatedAt": "2026-10-26T07:19:51.268Z",
|
"generatedAt": "2026-10-26T07:21:05.139Z",
|
||||||
"repoRoot": ".",
|
"repoRoot": ".",
|
||||||
"packages": [
|
"packages": [
|
||||||
{
|
{
|
||||||
@@ -205,7 +205,8 @@
|
|||||||
"popconfirm(props, trigger):二次确认气泡,挂在任意触发器上,就地确认危险操作;确定后先收起再回调,取消 / 点外部 / Esc 走 onCancel,展开即聚焦「取消」",
|
"popconfirm(props, trigger):二次确认气泡,挂在任意触发器上,就地确认危险操作;确定后先收起再回调,取消 / 点外部 / Esc 走 onCancel,展开即聚焦「取消」",
|
||||||
"calendar(props):月历,整月网格内嵌页面(排期 / 值班 / 日程),每日可带 marker 标记文案,方向键漫游 + Enter 选中,翻月走 onMonthChange",
|
"calendar(props):月历,整月网格内嵌页面(排期 / 值班 / 日程),每日可带 marker 标记文案,方向键漫游 + Enter 选中,翻月走 onMonthChange",
|
||||||
"typography(props):排版文本,variant 决定语义(标题出 h1-h5 / 段落出 p / 行内出 span),支持语义色、装饰位、对齐、多行截断与复制按钮",
|
"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": [
|
"keyTypes": [
|
||||||
"ButtonProps",
|
"ButtonProps",
|
||||||
@@ -3207,6 +3208,60 @@
|
|||||||
"子项必须是单个元素(card / div / 自定义块),grid 只负责排布且已对子项设 min-width: 0,长文本不会撑破列宽",
|
"子项必须是单个元素(card / div / 自定义块),grid 只负责排布且已对子项设 min-width: 0,长文本不会撑破列宽",
|
||||||
"只要横向一排展示且元素不等宽,用 space 更轻;grid 面向二维对齐"
|
"只要横向一排展示且元素不等宽,用 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 上"
|
||||||
|
]
|
||||||
}
|
}
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
|
|||||||
@@ -21,7 +21,7 @@
|
|||||||
|
|
||||||
- `packages/core/table-core`(@ui-arch/table-core):Headless 表格逻辑内核
|
- `packages/core/table-core`(@ui-arch/table-core):Headless 表格逻辑内核
|
||||||
- `packages/core/frame`(@ui-arch/frame):signal + hyperscript 微框架
|
- `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/design/tokens`(@ui-arch/tokens):设计令牌
|
||||||
- `packages/tools/cli`(@ui-arch/cli):`ua` 命令行 + MCP 注册表服务(private)
|
- `packages/tools/cli`(@ui-arch/cli):`ua` 命令行 + MCP 注册表服务(private)
|
||||||
- `apps/demo`(@ui-arch/demo):交互演示,产物 apps/demo/dist/demo.html
|
- `apps/demo`(@ui-arch/demo):交互演示,产物 apps/demo/dist/demo.html
|
||||||
|
|||||||
+1
-1
@@ -34,7 +34,7 @@ ui-arch-mvp/
|
|||||||
│ │ ├── table-core/ # 表格状态内核
|
│ │ ├── table-core/ # 表格状态内核
|
||||||
│ │ └── frame/ # 信号 + hyperscript 微框架
|
│ │ └── frame/ # 信号 + hyperscript 微框架
|
||||||
│ ├── skin/ # 皮肤层(DOM 组件,可发布)
|
│ ├── skin/ # 皮肤层(DOM 组件,可发布)
|
||||||
│ │ └── ui/ # 62 个组件 + ui.css
|
│ │ └── ui/ # 63 个组件 + ui.css
|
||||||
│ ├── design/ # 资产层(可发布)
|
│ ├── design/ # 资产层(可发布)
|
||||||
│ │ └── tokens/ # --ua-* 设计令牌
|
│ │ └── tokens/ # --ua-* 设计令牌
|
||||||
│ └── tools/ # 工程层(private,不发布)
|
│ └── tools/ # 工程层(private,不发布)
|
||||||
|
|||||||
@@ -12,13 +12,13 @@ npm run docs # 生成人类文档站 apps/docs/index.html + Agent 全
|
|||||||
npm run changelog # 依据 git 提交史重写 CHANGELOG.md(发版前跑;changelog:check 可查漂移)
|
npm run changelog # 依据 git 提交史重写 CHANGELOG.md(发版前跑;changelog:check 可查漂移)
|
||||||
```
|
```
|
||||||
|
|
||||||
## 组件(共 62 个)
|
## 组件(共 63 个)
|
||||||
|
|
||||||
<!-- ua:components -->
|
<!-- ua:components -->
|
||||||
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
|
||||||
<!-- /ua:components -->
|
<!-- /ua:components -->
|
||||||
|
|
||||||
分组:表单(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/frame` | @ui-arch/frame:signal / computed / effect + hyperscript(无虚拟 DOM) |
|
||||||
| `packages/core/table-core` | @ui-arch/table-core:headless 表格(filter → sort → paginate 派生管线) |
|
| `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/design/tokens` | @ui-arch/tokens:设计令牌(暗色只换值不换名) |
|
||||||
| `packages/tools/cli` | @ui-arch/cli:`ua` 命令行与 stdio MCP server |
|
| `packages/tools/cli` | @ui-arch/cli:`ua` 命令行与 stdio MCP server |
|
||||||
| `apps/demo` | 交互演示(esbuild 打包成单文件) |
|
| `apps/demo` | 交互演示(esbuild 打包成单文件) |
|
||||||
|
|||||||
@@ -31,6 +31,7 @@ import {
|
|||||||
divider,
|
divider,
|
||||||
drawer,
|
drawer,
|
||||||
empty,
|
empty,
|
||||||
|
floatButton,
|
||||||
image,
|
image,
|
||||||
form,
|
form,
|
||||||
formItem,
|
formItem,
|
||||||
@@ -1305,6 +1306,23 @@ const content = h(
|
|||||||
card({ title: zone }, typography({ content: '健康检查通过', type: 'success', variant: 'paragraph' }))),
|
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 定位,不参与布局)
|
// 引导漫游实例:根节点需挂到 body(fixed 定位,不参与布局)
|
||||||
|
|||||||
+31
-1
@@ -1,6 +1,6 @@
|
|||||||
# @ui-arch 组件库 Agent 文档(无图形版)
|
# @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)。
|
> 组件 = 普通函数,传 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
|
现场演示: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 速览:
|
API 速览:
|
||||||
|
|
||||||
- button(props):按钮,variant = primary | ghost | danger,disabled 支持布尔或信号禁用;type 缺省 button(表单内不隐式提交)
|
- button(props):按钮,variant = primary | ghost | danger,disabled 支持布尔或信号禁用;type 缺省 button(表单内不隐式提交)
|
||||||
@@ -1795,6 +1824,7 @@ API 速览:
|
|||||||
- calendar(props):月历,整月网格内嵌页面(排期 / 值班 / 日程),每日可带 marker 标记文案,方向键漫游 + Enter 选中,翻月走 onMonthChange
|
- calendar(props):月历,整月网格内嵌页面(排期 / 值班 / 日程),每日可带 marker 标记文案,方向键漫游 + Enter 选中,翻月走 onMonthChange
|
||||||
- typography(props):排版文本,variant 决定语义(标题出 h1-h5 / 段落出 p / 行内出 span),支持语义色、装饰位、对齐、多行截断与复制按钮
|
- 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
|
||||||
|
|
||||||
一行用法:
|
一行用法:
|
||||||
|
|
||||||
|
|||||||
@@ -111,6 +111,7 @@
|
|||||||
- calendar(props):月历,整月网格内嵌页面(排期 / 值班 / 日程),每日可带 marker 标记文案,方向键漫游 + Enter 选中,翻月走 onMonthChange
|
- calendar(props):月历,整月网格内嵌页面(排期 / 值班 / 日程),每日可带 marker 标记文案,方向键漫游 + Enter 选中,翻月走 onMonthChange
|
||||||
- typography(props):排版文本,variant 决定语义(标题出 h1-h5 / 段落出 p / 行内出 span),支持语义色、装饰位、对齐、多行截断与复制按钮
|
- 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
|
||||||
- 用法: `const checked = signal(false); checkbox({ label: '同意', checked }); const open = signal(false); modal({ title: '确认', open }, '内容')`
|
- 用法: `const checked = signal(false); checkbox({ label: '同意', checked }); const open = signal(false); modal({ title: '确认', open }, '内容')`
|
||||||
- 约定: 皮肤不持有业务状态,一律委托 headless 内核或调用方信号
|
- 约定: 皮肤不持有业务状态,一律委托 headless 内核或调用方信号
|
||||||
- 约定: 表单类组件统一约定:*Props.value/checked/active 为 Signal 双向绑定,onChange/onInput 为回调
|
- 约定: 表单类组件统一约定:*Props.value/checked/active 为 Signal 双向绑定,onChange/onInput 为回调
|
||||||
|
|||||||
@@ -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);
|
||||||
|
}
|
||||||
@@ -62,3 +62,4 @@ export { popconfirm } from './popconfirm.js';
|
|||||||
export { calendar } from './calendar.js';
|
export { calendar } from './calendar.js';
|
||||||
export { typography } from './typography.js';
|
export { typography } from './typography.js';
|
||||||
export { grid } from './grid.js';
|
export { grid } from './grid.js';
|
||||||
|
export { floatButton } from './floatButton.js';
|
||||||
|
|||||||
@@ -766,4 +766,15 @@ export interface GridProps {
|
|||||||
dense?: boolean; // 紧凑填充:小项回填空洞(瀑布式排布);缺省 false
|
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 }; // 再导出常用内核类型,方便调用方
|
export type { ColumnDef, RowKey }; // 再导出常用内核类型,方便调用方
|
||||||
|
|||||||
@@ -76,7 +76,8 @@
|
|||||||
"popconfirm(props, trigger):二次确认气泡,挂在任意触发器上,就地确认危险操作;确定后先收起再回调,取消 / 点外部 / Esc 走 onCancel,展开即聚焦「取消」",
|
"popconfirm(props, trigger):二次确认气泡,挂在任意触发器上,就地确认危险操作;确定后先收起再回调,取消 / 点外部 / Esc 走 onCancel,展开即聚焦「取消」",
|
||||||
"calendar(props):月历,整月网格内嵌页面(排期 / 值班 / 日程),每日可带 marker 标记文案,方向键漫游 + Enter 选中,翻月走 onMonthChange",
|
"calendar(props):月历,整月网格内嵌页面(排期 / 值班 / 日程),每日可带 marker 标记文案,方向键漫游 + Enter 选中,翻月走 onMonthChange",
|
||||||
"typography(props):排版文本,variant 决定语义(标题出 h1-h5 / 段落出 p / 行内出 span),支持语义色、装饰位、对齐、多行截断与复制按钮",
|
"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": [
|
"keyTypes": [
|
||||||
"ButtonProps",
|
"ButtonProps",
|
||||||
@@ -3078,6 +3079,60 @@
|
|||||||
"子项必须是单个元素(card / div / 自定义块),grid 只负责排布且已对子项设 min-width: 0,长文本不会撑破列宽",
|
"子项必须是单个元素(card / div / 自定义块),grid 只负责排布且已对子项设 min-width: 0,长文本不会撑破列宽",
|
||||||
"只要横向一排展示且元素不等宽,用 space 更轻;grid 面向二维对齐"
|
"只要横向一排展示且元素不等宽,用 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 上"
|
||||||
|
]
|
||||||
}
|
}
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -4066,3 +4066,88 @@ h5.ua-type-title { font-size: var(--ua-font-size-md); }
|
|||||||
grid-template-columns: 1fr;
|
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;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|||||||
Reference in New Issue
Block a user