UniApp 组件 · 实验
UGButton 按钮
用于触发主要操作、次级操作与危险操作的按钮组件。
组件预览
以下画面来自同一组件源码的 H5 构建,用于检查内容、状态和主题;MP-WEIXIN 最终外观仍以开发者工具和真机为准。
使用方式
配置 easycom 后直接使用 <ug-button>,无需在页面脚本中导入组件。
vue
<script setup lang="ts">
function save() {
// 执行业务保存
}
</script>
<template>
<ug-space size="sm" wrap>
<ug-button @click="save">保存</ug-button>
<ug-button variant="outline">取消</ug-button>
<ug-button variant="ghost" tone="danger">删除</ug-button>
</ug-space>
</template>
easycom 公开入口:@ug666/ui-uniapp/components/ug-button/ug-button.vue
属性
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| variant | 'solid' | 'outline' | 'ghost' | 'solid' | 按钮的视觉层级。 |
| tone | 'primary' | 'neutral' | 'danger' | 'primary' | 按钮的语义色调。 |
| size | 'sm' | 'md' | 'lg' | Provider | 按钮尺寸,未传时读取 Provider。 |
| block | boolean | false | 是否占满父容器宽度。 |
| loading | boolean | false | 显示原生加载状态并阻止 click。 |
| loadingText | string | — | 加载时替换默认插槽的文字。 |
| disabled | boolean | Provider | 禁用按钮并阻止 click。 |
| formType | 'submit' | 'reset' | — | 透传 UniApp button 的表单行为。 |
事件
| 事件 | 参数 | 说明 |
|---|---|---|
| click | event | 按钮可用且非 loading 时触发。 |
注意事项
- 业务提交和请求状态由页面管理,组件只负责 UI 与事件。
- loading 或 disabled 时不会触发业务 click。
平台边界
总览中的画面来自同一组件源码的 H5 构建,只用于辅助浏览;小程序真实外观仍以 Demo 在微信开发者工具和真机中的结果为准。
MP-WEIXIN 已编译
开发者工具与真机待验证