# Button 按钮

该组件内部实现以uni-appbutton组件为基础，进行二次封装，主要区别在于：

• 按钮type值有更多的主题颜色
• 按钮size值有更多的尺寸可选

# 平台差异说明

# 基本使用

文字内容通过text传入

<up-button text="月落"></up-button>

# 设置按钮的多种形态

• type值可选的有default(默认)、primary、success、info、warning、error
• 通过plain值设置是否镂空
• 通过hairline值设置是否细边
• 通过disabled值设置是否禁用
• 通过loading值设置是否开启加载图标，loadingText设置加载中文字
• 通过icon值设置是否显示图标
• 通过shape值设置按钮形状，circle为圆角
• 通过color值设置按钮渐变颜色
• 通过size值设置按钮的大小

<template>
	<view style="padding: 20px;">
		<up-button type="primary" text="确定"></up-button>
		<up-button type="primary" :plain="true" text="镂空"></up-button>
		<up-button type="primary" :plain="true" :hairline="true" text="细边"></up-button>
		<up-button type="primary" :disabled="disabled" text="禁用"></up-button>
		<up-button type="primary" loading loadingText="加载中"></up-button>
		<up-button type="primary" icon="map" text="图标按钮"></up-button>
		<up-button type="primary" shape="circle" text="按钮形状"></up-button>
		<up-button text="渐变色按钮" color="linear-gradient(to right, rgb(66, 83, 216), rgb(213, 51, 186))"></up-button>
		<up-button type="primary" size="small" text="大小尺寸"></up-button>
	</view>
</template>

<script setup>
import { ref } from 'vue';

const disabled = ref(true);
</script>

<script>
export default {
	data() {
		return {
			disabled: true
		};
	}
};
</script>

# 定义需要用到的外部样式

1. 针对非微信小程序平台，组件的根元素就是uni-appbutton组件，所以修改按钮的样式很容易，直接给组件定义类名或者嵌入内联样式即可。
2. 如果是微信小程序，编译后页面会有组件同名的元素存在，导致样式传递有问题。
3. 如果是为了修改按钮与其他元素之间的距离或者宽度等，可以给按钮外面套一个view元素，控制这个view与其他元素的距离或者宽度，即可达到同等效果。

所以：我们提供了一个custom-style参数，推荐用户可以用对象形式传递样式给组件内部，注意驼峰命名。

<template>
	<view style="padding: 20px;">
		 <!-- 以下形式在微信小程序会无效，APP和H5有效  -->
		<up-button class="custom-style" text="雪月夜"></up-button>
	</view>
</template>

<script setup>
import { ref, reactive } from 'vue';

const disabled = ref(true);
const customStyle = reactive({
  marginTop: '20px',
  color: 'red'
});
</script>

<style lang="scss" scoped>
	.custom-style {
		color: #ff0000;
		width: 400rpx;
	}
</style>

<template>
	<view style="padding: 20px;">
		 <!-- 以下形式在微信小程序会无效，APP和H5有效  -->
		<up-button class="custom-style" text="雪月夜"></up-button>
	</view>
</template>

<script>
export default {
	data() {
		return {
			disabled: true,
			customStyle: {
				marginTop: '20px', // 注意驼峰命名，并且值必须用引号包括，因为这是对象
				color: 'red'
			}
		};
	}
};
</script>

<style lang="scss" scoped>
	.custom-style {
		color: #ff0000;
		width: 400rpx;
	}
</style>

# 各家小程序开放能力的对接

uview-plus已对接uni-app档关于uni-app方button组件 (opens new window)的所有开放能力(截止2020-04-14)uni-app-app文档说明使用即可，如果有发现遗漏的地方，请加群反馈。

# 右侧演示页面源代码地址

点击以下链接以查看右侧演示页面的源码

 github  gitee

# API

# Props

# Events

说明：目前经测试(Hbuilder X 2.6.8)，在H5，APP，可以直接对组件监听tap事件，等同组件内部发出的click事件效果，某些HX版本上， 微信小程序对组件使用tap事件可能无效，故建议对按钮组件的点击事件监听统一使用组件内部发出的click事件。