Blame view

uni_modules/uni-fab/readme.md 2.91 KB
290144e9   易尊强   第一次
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
  
  
  ## Fab 悬浮按钮
  > **组件名:uni-fab**
  > 代码块: `uFab`
  
  
  点击可展开一个图形按钮菜单
  
  ### 安装方式
  
  本组件符合[easycom](https://uniapp.dcloud.io/collocation/pages?id=easycom)规范,`HBuilderX 2.5.5`起,只需将本组件导入项目,在页面`template`中即可直接使用,无需在页面中`import`和注册`components`
  
  如需通过`npm`方式使用`uni-ui`组件,另见文档:[https://ext.dcloud.net.cn/plugin?id=55](https://ext.dcloud.net.cn/plugin?id=55)
  
  > **注意事项**
  > 为了避免错误使用,给大家带来不好的开发体验,请在使用组件前仔细阅读下面的注意事项,可以帮你避免一些错误。
  > - 不建议动态修改属性,可能会耗损部分性能。
  > - 展开菜单暂不支持字体图标,使用图片路径时建议使用绝对路径,相对路径可能会有问题。
  > - 选中状态要通过自己控制,如果不希望有选中状态,不处理 `active` 即可。 
  > - 展开菜单建议最多显示四个,如果过多对于小屏手机可能会超出屏幕。
  
  
  ### 基本用法
  
  `template` 中使用组件
  
  ```html
  <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	| 悬浮按钮点击事件				|
  
  
  
  
  
  
  ## 组件示例
  
  点击查看:[https://hellouniapp.dcloud.net.cn/pages/extUI/fab/fab](https://hellouniapp.dcloud.net.cn/pages/extUI/fab/fab)