Skip to content

Appbar 顶栏

顶部导航栏,分为左、中、右三个区域。使用 McAppbarButtonMcAppbarIcon 作为子组件。

基础用法

返回
html
<mc-appbar>
  <template #left>
    <mc-appbar-icon icon="mc-chevron-left" tip="返回" />
  </template>
  <template #right>
    <mc-appbar-button icon="mc-home">制作</mc-appbar-button>
    <mc-appbar-button icon="mc-world">世界</mc-appbar-button>
    <mc-appbar-button icon="mc-friends">社交</mc-appbar-button>
  </template>
</mc-appbar>

左中右分区

世界编辑
vue
<template>
  <mc-appbar>
    <template #left>
      <mc-appbar-button>返回</mc-appbar-button>
    </template>
    <span style="font-family:'Minecraft Seven'">世界编辑</span>
    <template #right>
      <mc-appbar-button>帮助</mc-appbar-button>
      <mc-appbar-button>完成</mc-appbar-button>
    </template>
  </mc-appbar>
</template>

带 Tooltip

为按钮添加提示文本 tip

社交
html
<mc-appbar>
  <template #right>
    <mc-appbar-button icon="mc-friends" tip="社交">社交</mc-appbar-button>
  </template>
</mc-appbar>

AppbarIcon 图标按钮

McAppbarIcon 是纯图标按钮,适合作为工具栏操作图标放置在左侧。

编辑器
返回
撤销
重做
html
<mc-appbar title="编辑器">
  <template #left>
    <mc-appbar-icon icon="mc-chevron-left" tip="返回" />
    <mc-appbar-icon icon="mc-undo" tip="撤销" />
    <mc-appbar-icon icon="mc-redo" tip="重做" />
  </template>
</mc-appbar>

详细用法见 AppbarIcon

AppbarButton 文字按钮

McAppbarButton 是带文字和可选图标的按钮,适合放在左右区域。

html
<mc-appbar>
  <template #right>
    <mc-appbar-button icon="mc-home">制作</mc-appbar-button>
    <mc-appbar-button icon="mc-world">世界</mc-appbar-button>
    <mc-appbar-button icon="mc-settings" bg-color="#4a90d9">自定义</mc-appbar-button>
  </template>
</mc-appbar>

详细用法见 AppbarButton

外观说明

  • 默认高度 100px
  • 背景色 #E6E8EB,Minecraft 浅色顶栏风格
  • 底部 3px #B1B2B5 实线 + 1px 黑色半透明内阴影,形成双层斜面底边
  • 左、右区域靠边对齐,中间区域占满剩余宽度、居中显示

按钮外观

按钮使用 box-shadow 内阴影实现立体边框效果,避免边框遮挡顶栏底部。

状态左边右边上边下边背景
正常#FFFFFF#A1A3A5跟随顶栏
按下#FFFFFF#E6E8EB#E6E8EB#EBEDEF#D0D1D4
  • 按钮高度自动占满顶栏内容区
  • 禁用时半透明显示,不可点击
  • 点击时播放 click 音效

自定义高度

高度 60px
html
<mc-appbar title="高度 60px" :height="60">
  <mc-appbar-button>保存</mc-appbar-button>
</mc-appbar>

Appbar Props

名称类型默认说明
titlestring''左侧标题文本,不传则隐藏
heightnumber | string100顶栏高度;数字为 px,字符串原样使用

子组件 Props 详见 AppbarButtonAppbarIcon

Events

事件参数说明
clickMouseEvent点击按钮(禁用时不触发)

Slots

名称说明
left左侧区域,与 title 同行;可放置按钮、图标等
default中间区域,默认插槽,内容居中显示
right右侧区域,可放置操作按钮
default(按钮插槽)按钮文字

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