更新记录
1.0.0(2025-08-19) 下载此版本
上传插件
平台兼容性
uni-app(4.07)
Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
---|---|---|---|---|---|---|---|---|
- | √ | √ | √ | √ | - | - | - | - |
微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 快应用-华为 | 快应用-联盟 |
---|---|---|---|---|---|---|---|---|---|---|
- | - | - | - | - | - | - | - | - | - | - |
其他
多语言 | 暗黑模式 | 宽屏模式 |
---|---|---|
× | × | √ |
n-float-button 悬浮按钮组件
介绍
n-float-button 是一个可展开的悬浮按钮组件,点击主按钮后会展开一系列自定义按钮,常用于页面快捷操作入口。
基本用法
在页面中引入组件并传入相应的参数:
Props
参数名 | 说明 | 类型 | 默认值 | 可选值 |
---|---|---|---|---|
size | 按钮大小,单位 px | Number | 50 | - |
list | 按钮列表数据 | Array | [] | - |
list 数据项属性
属性名 | 说明 | 类型 | 默认值 |
---|---|---|---|
icon | 按钮图标地址(可选) | String | - |
label | 按钮标签(可选) | String | - |
id | 按钮唯一标识 | String/Number | - |
其他自定义属性 | 可根据需要添加其他属性 | Any | - |
Slots
插槽名 | 说明 | 作用域参数 |
---|---|---|
btnItem | 自定义按钮项内容 | data: 当前按钮数据项 |
使用示例
``vue
样式变量
可以通过 CSS 变量自定义组件样式:
变量名 说明 默认值
--btn-bg 主按钮背景色 $uni-color-primary
--item-size 按钮尺寸 由 size 属性决定
--item-width 展开项宽度 自动计算
使用示例
基础用法
```vue
<template>
<nFloatButtonVue :list="btns" />
</template>
<script>
export default {
data() {
return {
btns: [
{ icon: '/static/icon1.png', id: 1 },
{ icon: '/static/icon2.png', id: 2 },
{ icon: '/static/icon3.png', id: 3 }
]
}
}
}
</script>
自定义按钮大小
<nFloatButtonVue :list="btns" :size="60" />
使用插槽自定义按钮内容
<nFloatButtonVue :list="btns">
<template v-slot:btnItem="{data}">
<text>{{ data.label }}</text>
</template>
</nFloatButtonVue>