Prepared Docs

Prepared Docs

⌘K

    Loading navigation…

User

  1. Blocks
  2. Page Header
  3. API and Development

Page Header

API and Development

View Source
Submit Issue

PageHeader from @prepared911/ui-blocks composes FlexBox and CoreText to show a title, optional Counter, optional ReadOnlyBadge, optional titleAdornment, optional description, optional breadcrumb slot above the title row, and optional trailing actions.

Props

NameTypeDefaultDescription
titlestringrequiredPrimary heading.
titleTypeTextTypeH3Typography token for the title (TextType.H3 maps to the subsection scale).
titleAdornmentReactNode—Inline content after title, count, and read-only badge.
descriptionstring—Muted supporting copy below the title row.
breadcrumbReactNode—Typically Breadcrumb from @prepared911/ui-core.
countnumber—Shown as small Counter beside the title.
readOnlyboolean | ReadOnlyConfig—Renders ReadOnlyBadge when truthy.
actionsReactNode—Trailing controls (e.g. Button group).
classNamestring—Root class.

Read-only badge

PageHeader renders ReadOnlyBadge when readOnly is set. The same ReadOnlyBadge component is exported from @prepared911/ui-blocks if you need it outside PageHeader.

ReadOnlyConfig

Used when readOnly is an object on PageHeader.

NameTypeDefaultDescription
labelstring"Read only" (localized)Badge label text.
descriptionstring—Tooltip body explaining why the page is read-only.
requiredPermissionsReactNode—Tooltip content listing permissions that would allow editing.

ReadOnlyBadge props

NameTypeDefaultDescription
configReadOnlyConfig—When omitted, shows the default read-only label with no tooltip.

Import

Title only

With description

With actions

With breadcrumb

With back-style breadcrumb

With count and actions

Read-only (detailed)

Fully loaded

Settings-style example

Previous

Page Header / Usage

Next

Page Header / Accessibility

On this page

Props
Read-only badge
ReadOnlyConfig
ReadOnlyBadge props
Import
Title only
With description
With actions
With breadcrumb
With back-style breadcrumb
With count and actions
Read-only (detailed)
Fully loaded
Settings-style example