适用于固定在底部的按钮组场景,支持一个按钮、两个按钮、图标+按钮、自定义+按钮等样式。
示例图






基础用法
页面 .json 文件 usingComponents 中引入组件
// json
{
"usingComponents": {
"mx-foot-btns": "/components/mxwui/foot-btns/index"
}
}页面 .wxml 文件中使用组件
<mx-foot-btns />更多用法示例
样式类型 styleType
属性:styleType,可选 single 单按钮、double 双按钮、combination 图标按钮组合、custom 左侧自定义,默认 single,默认是单按钮样式。
- 单按钮
独占一行的主按钮。
<mx-foot-btns styleType="single" mainBtnText="单按钮" />- 双按钮
辅助按钮在左侧,主按钮在右侧,主按钮比辅助按钮宽。
<mx-foot-btns styleType="double" mainBtnText="主按钮" minorBtnText="次按钮" />- 图标 + 按钮组合
左侧是1-3个图标,超出3个图标则只使用前3个图标。
右侧是主按钮或者次按钮+主按钮。
<mx-foot-btns styleType="combination" mainBtnText="主按钮" leftIcons="{{leftIcons}}" />- 左侧自定义 + 按钮
左侧是自定义区域,通过 <slot></slot> 方式插入。
右侧是主按钮。
<mx-foot-btns styleType="custom" mainBtnText="主按钮">
// 自定义内容
</mx-foot-btns>主按钮文案 mainBtnText
属性:mainBtnText,按钮上的文案。
<mx-foot-btns mainBtnText="主按钮" />主按钮类型 mainBtnType
属性:mainBtnType,可选 primary、default、ghost,默认 primary。
<mx-foot-btns mainBtnType="default" />主按钮颜色 mainBtnColor
属性:mainBtnColor,默认 #CA0E2D,只支持十六进制颜色值。
<mx-foot-btns mainBtnColor="#1677FF" />主按钮是否禁用 mainBtnDisabled
属性:mainBtnDisabled,默认 false 不禁用。
- 禁用
<mx-foot-btns mainBtnDisabled />
<mx-foot-btns mainBtnDisabled="{{true}}" />- 不禁用
<mx-foot-btns />
<mx-foot-btns mainBtnDisabled="{{false}}" />辅助按钮文案 minorBtnText
属性:minorBtnText,按钮上的文案。
<mx-foot-btns minorBtnText="次按钮" />辅助按钮类型 minorBtnType
属性:minorBtnType,可选 primary、default、ghost,默认 ghost。
<mx-foot-btns minorBtnType="primary" />辅助按钮颜色 minorBtnColor
属性:minorBtnColor,默认 #9AA0B1,只支持十六进制颜色值。
<mx-foot-btns minorBtnColor="#1677FF" />辅助按钮是否禁用 minorBtnDisabled
属性:minorBtnDisabled,默认 false 不禁用。
- 禁用
<mx-foot-btns minorBtnDisabled />
<mx-foot-btns minorBtnDisabled="{{true}}" />- 不禁用
<mx-foot-btns />
<mx-foot-btns minorBtnDisabled="{{false}}" />左侧图标组 leftIcons
属性:leftIcons,左侧图标组配置。
参数:iconName,图标名称,只支持图标库中图标。
参数:iconColor,图标颜色,默认#040A23,支持任何合法的颜色值。
参数:iconUrl,图标图片地址,传入则 iconName、iconColor 无效。
参数:iconSize,图标大小,默认48,不带单位,默认rpx。
参数:text,文本,4个字以内。
参数:textColor,文本颜色,默认#040A23,支持任何合法的颜色值。
事件:bind:foot_btns_icon,图标点击事件,返回字段 event.detail.item 和 event.detail.index。
当样式类型为 styleType="combination" 有效
<mx-foot-btns leftIcons="{{leftIcons}}" />层级 zIndex
属性:zIndex,数字。
<mx-foot-btns zIndex="2" />自定义事件
事件:bind:foot_btns_main,主按钮点击事件。
事件:bind:foot_btns_minor,辅助按钮点击事件。
事件:bind:foot_btns_icon,图标点击事件,返回字段 event.detail.item 和 event.detail.index。
<mx-foot-btns
bind:foot_btns_main="handleMain"
bind:foot_btns_minor="handleMinor"
bind:foot_btns_icon="handleIcon"
/>参数
| 参数 | 类型 | 必填 | 可选值 | 默认值 | 参数描述 |
|---|---|---|---|---|---|
| styleType | String | 是 | single 单按钮、double 双按钮、combination 组合按钮、custom 左侧自定义 |
xxx |
样式类型 |
| mainBtnText | String | 是 | 主按钮文案 | ||
| mainBtnType | String | primary、default、ghost |
primary |
主按钮类型 | |
| mainBtnColor | String | 颜色值 | #CA0E2D |
主按钮颜色,只支持十六进制颜色值 | |
| mainBtnDisabled | Boolean | true、false |
false |
主按钮是否禁用 | |
| minorBtnText | String | 辅助按钮文案 | |||
| minorBtnType | String | primary、default、ghost |
primary |
辅助按钮类型 | |
| minorBtnColor | String | 颜色值 | #9AA0B1 |
辅助按钮颜色,只支持十六进制颜色值 | |
| minorBtnDisabled | Boolean | true、false |
false |
辅助按钮是否禁用 | |
| leftIcons | Array | 左侧图标组,最多配置3个,超出只使用前3个图标配置 | |||
| zIndex | Number | 数字 | 1 |
层级 |
leftIcons 左侧图标组配置
| 参数 | 类型 | 默认值 | 参数描述 |
|---|---|---|---|
| iconName | String | 图标名称,只支持图标库中图标 | |
| iconColor | String | #040A23 |
图标颜色,支持任何合法的颜色值 |
| iconUrl | String | 图标图片地址,传入则 iconName、iconColor 无效 |
|
| iconSize | Number | 48 | 图标大小,不带单位,默认rpx |
| text | String | 是 | 文本 |
| textColor | String | #040A23 |
文本颜色,支持任何合法的颜色值 |
事件
| 事件名称 | 类型 | 返回值 | 事件说明 |
|---|---|---|---|
| bind:foot_btns_main | Click | 主按钮点击事件 | |
| bind:foot_btns_minor | Click | 辅助按钮点击事件 | |
| bind:foot_btns_icon | Click | event |
图标点击事件,返回字段 event.detail.item 和 event.detail.index |
其他说明
无