Skip to content

Button 按钮

Minecraft 风格立体按钮:深色描边 + inset 高光厚度,按下整体下沉。

三种语义

html
<mc-button variant="primary" @click="onStart">主操作</mc-button>
<mc-button variant="normal">次要</mc-button>
<mc-button variant="error">危险</mc-button>
<mc-button variant="normal" disabled>禁用</mc-button>

尺寸

html
<mc-button size="extra_small">特小</mc-button>
<mc-button size="small">小</mc-button>
<mc-button size="middle">中</mc-button>
<mc-button size="large">大</mc-button>

图标

icon 属性接收内置图标名称,按钮会在文字左侧显示图标。

html
<mc-button icon="mc-save" variant="primary">保存</mc-button>
<mc-button icon="mc-delete" variant="error">删除</mc-button>
<mc-button icon="mc-key-enter">确认</mc-button>

带 Tooltip

tip 属性非空时按钮下方会显示 Tooltip,样式与 McTooltip 一致,均为 Minecraft 像素风格(白边框 + 黑色阴影 + Mojang 字体)。

这是提示文本
html
<mc-button variant="primary" tip="这是提示文本">悬停查看</mc-button>

自定义颜色

bgcolor prop 可以覆盖按钮背景色,同时保留 Minecraft 风格的立体阴影效果。

html
<mc-button bgcolor="#ff6b35">橙色</mc-button>
<mc-button bgcolor="#8e44ad" icon="mc-star">紫色 + 图标</mc-button>
<mc-button bgcolor="#2ecc71">绿色</mc-button>
<mc-button bgcolor="#e84393">粉色</mc-button>

Props

名称类型默认说明
variant'normal' | 'primary' | 'error'normal颜色/语义
size'extra_small' | 'small' | 'middle' | 'large'middle尺寸
disabledbooleanfalse是否禁用(禁用时不触发 click、不播音效)
iconstring''左侧图标名称,如 mc-savemc-key-entermc-x-creative
tipstring''非空则显示 Tooltip,样式与 McTooltip 一致
bgcolorstring''自定义背景色(如 #ff6b35),覆盖 variant 预设

Events

事件参数说明
clickMouseEvent点击(禁用时不触发);主操作按钮播 button 音,其余播 click

按钮文字通过默认插槽传入。

MIT Licensed · 设计语言移植自 Spectrollay-McUI