Button 组件是 uni-app 中用于创建按钮的内置组件,用于响应用户的点击事件,可以导致页面跳转或者触发某些逻辑。
API
Button 组件的 API 包括多种属性和事件,以下是一些常用的属性:
size
:按钮的大小,例如:default
,mini
。type
:按钮的样式类型,例如:primary
,default
,warn
。plain
:按钮是否镂空,背景色透明。disabled
:是否禁用按钮。loading
:名称前是否带 loading 图标。
属性
以下是 Button 组件的部分属性介绍:
size
定义了按钮的大小。有效值有 mini
, default
。
html
<button size="default">默认大小</button>
<button size="mini">迷你大小</button>
type
定义了按钮的样式类型,可以决定按钮的颜色和背景。有效值包括 primary
, default
, warn
等。
html
<button type="primary">主要按钮</button>
<button type="default">默认按钮</button>
<button type="warn">警告按钮</button>
plain
将按钮设置为镂空样式(背景色透明而字体非透明)。
html
<button plain="true">镂空按钮</button>
disabled
定义按钮是否被禁用,禁用状态下按钮不可点击。
html
<button disabled="true">禁用按钮</button>
loading
定义按钮名称前是否带有 loading 图标。
html
<button loading="true">加载中</button>
事件
Button 组件提供了多种事件,例如点击事件:
bind:tap
点击按钮时触发,可以在这个事件中执行相关的逻辑。
html
<button bind:tap="handleTap">点击我</button>
在 JavaScript 中处理点击事件:
javascript
export default {
methods: {
handleTap() {
console.log('按钮被点击');
}
}
}
示例
html
<template>
<view>
<button size="default" type="primary" bind:tap="handleTap">点击我</button>
</view>
</template>
<script>
export default {
methods: {
handleTap() {
// 处理按钮点击事件
console.log('按钮被点击');
}
}
}
</script>
以上是 button
组件的基本使用介绍,具体使用时还需要参考官方文档,以了解更多高级特性和最佳实践。