编辑 | blame | 历史 | 原始文档

---
title: Fab 悬浮按钮
description: 当功能使用图标即可表意清楚时,可使用纯图标悬浮按钮,例如:添加、发布。
spline: form

isComponent: true

该组件于 0.7.2 版本上线,请留意版本。

引入

全局引入,在 miniprogram 根目录下的app.json中配置,局部引入,在需要引入的页面或组件的index.json中配置。

"usingComponents": {
  "t-fab": "tdesign-miniprogram/fab/fab"
}

代码演示

在开发者工具中预览效果

Tips: 请确保开发者工具为打开状态。导入开发者工具后,依次执行:npm i > 构建npm包 > 勾选 "将JS编译成ES5"

基础使用

{{ base }}

进阶使用

{{ advance }}

可移动悬浮按钮

{{ draggable }}

API

Fab Props

名称 类型 默认值 描述 必传
style String right: 16px; bottom: 32px; 悬浮按钮的样式,常用于调整位置(即将废弃,建议使用 style N

custom-style | Object | - | 样式,一般用于开启虚拟化组件节点场景 | N
button-props | Object | - | 透传至 Button 组件。TS 类型:ButtonPropsButton API Documents详细类型定义 | N
draggable | Boolean / String | false | true / 'all'可拖动
'vertical'可垂直拖动
'horizontal'可水平拖动
false禁止拖动 | N
icon | String | - | 图标 | N
text | String | - | 文本内容 | N
using-custom-navbar | Boolean | false | 是否使用了自定义导航栏 | N

Fab Events

名称 参数 描述
click ({e: Event}) 悬浮按钮点击事件

CSS Variables

组件提供了下列 CSS 变量,可用于自定义样式。
名称 | 默认值 | 描述
-- | -- | --
--td-fab-shadow | @shadow-2 | -