Skip to content

PageHeader 页头 ​

页面头部信息区,支持标题、副标题、返回按钮、面包屑、正文区与底部操作区,常用于详情页、编辑页顶部。

基础用法 ​

标题与副标题

带返回按钮 ​

返回按钮

头像 ​

avatar 具名插槽渲染在返回按钮之后、标题块之前(「返回 + 头像 + 标题」通行布局),组合 oas-avatar 原组件使用;无内容时区块不渲染。

avatar 插槽

张

面包屑 ​

面包屑通过 slot="breadcrumb" 放入头部独立行,组合 oas-breadcrumb 原组件使用。

breadcrumb 插槽

标题与副标题插槽 ​

标题 / 副标题可用属性提供纯文本,也可用 slot="title" / slot="subtitle" 承载富内容(图标、徽标、链接等)——插槽有内容时覆盖属性文案。

title / subtitle 插槽

项目概览 进行中最后更新:2026-08-30 14:00

右侧操作区 ​

extra 插槽

导出新建项目

主体内容区 ​

正文通过默认插槽放入标题行下方;无内容时区块不渲染。

content 默认插槽

项目进入冲刺阶段:前端进度 80%,接口联调中,预计本周五发布 beta 版本。

底部操作区 ​

footer 插槽

取消保存

自定义返回图标 ​

back-icon 插槽

完整组合 ​

面包屑 + 标题行 + 正文 + 底部操作全区块组合。

全区块组合

打印审核通过
订单包含 3 件商品,合计 ¥1,299.00,预计 2026-09-02 送达。收货人:张三,138****5678。
驳回发货

事件反馈 ​

返回事件

透明背景变体(ghost) ​

ghost:页头透明背景(背景规则置 none,标题/文字色保持主题前景 token),footer 分隔线一并去除。适合叠加在有色背景容器/页面上,让底色透出。下面对比容器给了中性底色示意:默认形态保留 footer 分隔线,ghost 无分隔线、纯底色。

ghost 透明背景(有色底容器对比)

保存
保存

响应式紧凑(responsive) ​

responsive 布尔属性:组件宽度 <768px 时自动紧凑布局——标题字号降档(xl→lg)、副标题字号降档(sm)、副标题与 extra 换行(.row 允许 flex-wrap,标题独占一行不被挤压);ResizeObserver 观察宿主宽度变化,恢复宽度自动还原。缩窄浏览器窗口或移动端设备上自动生效。

responsive 紧凑布局

打印审核通过

缩窄窗口到 768px 以下:标题字号降档、副标题与操作区换行;恢复宽度自动还原。

API ​

oas-page-header ​

属性 ​

属性说明类型默认值
back是否显示返回按钮boolean—
ghost透明背景变体:页头背景规则置 none(强制透明,让所在容器/页面底色透出),footer 分隔线一并去除;标题/文字色保持主题前景 token;其余布局不变boolean—
responsive响应式紧凑:组件宽 <768px 时标题字号降档(xl→lg)、副标题字号降档(sm)、副标题与 extra 换行(.row flex-wrap);ResizeObserver 观察宿主宽度,onCleanup 清理boolean—
subtitle副标题文案string—
title标题文案(渲染进可见标题区;读取后即从宿主移除,不残留原生悬浮提示;清空传空串)string—

事件 ​

事件说明
oas-back点击返回按钮

插槽 ​

名称说明
默认正文内容(标题行下方正文区,默认插槽;无内容时区块不渲染)
avatar头像(返回按钮之后、标题块之前;组合 oas-avatar 原组件,无内容时不渲染)
back-icon返回按钮图标插槽,有内容时替换内置 chevron(空注释节点按无内容处理)
breadcrumb面包屑(头部独立行,组合 oas-breadcrumb 原组件,无内容时不渲染)
extra右侧操作区
footer底部操作区(无内容时不渲染)
subtitle副标题富内容插槽,有内容时覆盖 subtitle 属性文案
title标题富内容插槽,有内容时覆盖 title 属性文案

插槽:正文走默认插槽;breadcrumb / footer / content 区块无内容时不渲染;title / subtitle / back-icon 插槽有内容时覆盖属性/内置图标。返回按钮渲染为原生 <button aria-label="返回">。

基于 MIT OR Apache-2.0 双许可发布