跳到主要内容

PageHeader 页头 ​

uni-appH5微信小程序App

uni-app 跨端页头。左侧返回箭头 + 标题/副标题,右侧操作区插槽,底部 1px 分隔线,可挂下方内容区。

何时使用 ​

二级页/详情页顶部,需要返回、标题与页面级操作的场景。

何时不使用 ​

应用全局顶栏(用 NavBar)或不需要返回语义的首页。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
PageHeader 页头 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
titlestring"\"\""标题(可被 title 插槽覆盖)
subtitlestring"\"\""副标题,显示在标题右侧
showBackbooleantrue是否显示返回箭头

Events ​

名称载荷说明
backEvent点击返回箭头时触发;页面返回导航请在此回调中调用 uni.navigateBack()

Slots ​

名称说明
title自定义标题内容,覆盖 title prop
extra右侧操作区,如按钮
default下方内容区,如 Tabs

示例 ​

基础用法 ​

vue
<PageHeader title="组件库" subtitle="v1.0.0" />

带扩展区 ​

vue
<PageHeader title="数据看板" subtitle="更新于 5 分钟前">
  <template #extra><Button size="sm" variant="primary">刷新</Button></template>
</PageHeader>

自定义标题插槽 ​

vue
<PageHeader subtitle="灰度中">
  <template #title><view class="row"><Text weight="bold">实验功能</Text><Tag variant="warning">beta</Tag></view></template>
  <template #extra><Icon name="settings" :size="18" /></template>
</PageHeader>