iter(g131): 新增悬浮操作按钮 floatButton

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 上"
+        ]
       }
     ]
   }