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

Fab 悬浮按钮

代码块: uFab

点击可展开一个图形按钮菜单

安装方式

本组件符合easycom规范,HBuilderX 2.5.5起,只需将本组件导入项目,在页面template中即可直接使用,无需在页面中import和注册components

如需通过npm方式使用uni-ui组件,另见文档:https://ext.dcloud.net.cn/plugin?id=55

为了避免错误使用,给大家带来不好的开发体验,请在使用组件前仔细阅读下面的注意事项,可以帮你避免一些错误。
- 不建议动态修改属性,可能会耗损部分性能。
- 展开菜单暂不支持字体图标,使用图片路径时建议使用绝对路径,相对路径可能会有问题。
- 选中状态要通过自己控制,如果不希望有选中状态,不处理 active 即可。
- 展开菜单建议最多显示四个,如果过多对于小屏手机可能会超出屏幕。

基本用法

template 中使用组件

<template>
	<view>
		<uni-fab
			:pattern="pattern"
			:content="content"
			:horizontal="horizontal"
			:vertical="vertical"
			:direction="direction"
			@trigger="trigger"
		></uni-fab>
	</view>
</template>

API

Fab Props

属性名 类型 默认值 说明

| pattern | Object | - | 可选样式配置项 |
| horizontal| String | 'left' | 水平对齐方式。left:左对齐,right:右对齐 |
| vertical | String | 'bottom' | 垂直对齐方式。bottom:下对齐,top:上对齐 |
| direction | String | 'horizontal' | 展开菜单显示方式。horizontal:水平显示,vertical:垂直显示 |
| popMenu | Boolean | true | 是否使用弹出菜单 |
| content | Array | - | 展开菜单内容配置项 |

pattern配置项:

参数 类型 默认值 说明
color String #3c3e49 文字默认颜色
selectedColor String #007AFF 文字选中时的颜色
backgroundColor String #ffffff 背景色
buttonColor String #3c3e49 按钮背景色

content配置项:

参数 类型 说明
iconPath String 图片路径
selectedIconPath String 选中后图片路径
text String 文字
active Boolean 是否选中当前

Fab Events

参数 类型 说明
@trigger Function 展开菜单点击事件,返回点击信息
@fabClick Function 悬浮按钮点击事件