在 UniApp 中,button 组件是常用的交互元素,用于触发操作。以下是基本使用方法和关键属性:
基本用法
在 .vue 文件的 <template> 中直接使用:
<template>
<view>
<button type="primary" @click="handleClick">主要按钮</button>
</view>
</template>
<script>
export default {
methods: {
handleClick() {
uni.showToast({ title: '按钮被点击' });
}
}
}
</script>
关键属性说明
-
type:按钮样式类型
- 可选值:
primary(默认,蓝色)、default(白色)、warn(红色)
- 示例:
<button type="warn">警告按钮</button>
-
size:按钮尺寸
- 可选值:
default(默认)、mini(小尺寸)
- 示例:
<button size="mini">小按钮</button>
-
disabled:禁用状态
- 布尔值,设置为
true 时按钮不可点击
- 示例:
<button disabled>禁用按钮</button>
-
loading:加载状态
- 布尔值,显示加载图标,适用于异步操作
- 示例:
<button :loading="isLoading">提交</button>
-
open-type:微信开放能力
- 用于唤起微信特定功能,如
getUserInfo(获取用户信息)、share(分享)
- 示例:
<button open-type="share">分享</button>
注意事项
- 按钮默认宽度为 100%,可通过 CSS 样式(如
width)调整。
- 在微信小程序中使用
open-type 时,需遵循平台规范。
- 事件处理使用
@click(Vue 语法),也可用 @tap(兼容小程序原生事件)。
通过灵活组合属性和事件,可满足大部分交互需求。