PageHeader 页头
uni-appH5微信小程序App
uni-app 跨端页头。左侧返回箭头 + 标题/副标题,右侧操作区插槽,底部 1px 分隔线,可挂下方内容区。
何时使用
二级页/详情页顶部,需要返回、标题与页面级操作的场景。
何时不使用
应用全局顶栏(用 NavBar)或不需要返回语义的首页。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
title | string | "\"\"" | 标题(可被 title 插槽覆盖) |
subtitle | string | "\"\"" | 副标题,显示在标题右侧 |
showBack | boolean | true | 是否显示返回箭头 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
back | Event | 点击返回箭头时触发;页面返回导航请在此回调中调用 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>