PickerTitle

Overlay & Surface
stable

Title strip rendered at the top of a Picker panel. Displays uppercase text with configurable color and background color theming.

Preview

Rendering the live preview…

default

Rendering the live preview…

primary bg

Rendering the live preview…

success bg

Structure

Anatomy

Visual breakdown of the component's internal structure with BEM class call-outs.

Anatomy of OrigamPickerTitleSchematic of the PickerTitle component with 2 numbered internal parts. SELECT A DATE 1 2 slot / title prop
Anatomy of <origam-picker-title> — 2 parts: ① the root strip element, ② the title text (default slot or title prop).
1.origam-picker-title
Root element. Renders as the tag prop value (default: div). Applies uppercase, font-size, padding-inline, padding-block, letter-spacing and font-weight from CSS custom properties.
2#default slot / title prop
Title text. Renders the title prop when the default slot is empty. Styled via text-transform: uppercase and letter-spacing: 0.1666em.

API

Props

All props accepted by this component, with their type, default value and description.

title
string
Title text displayed in the strip. Also configurable via the default slot.
id
string
class
string | Array<string> | object
style
string | Array<string> | object | StyleValue
tag
string
'div'
Root HTML element tag.
color
Text color applied to the title strip. Accepts semantic intents (primary, success…) or any CSS color.
bgColor
Background color of the title strip. Independent of the text color.
fontSize
TFontSize
fontWeight
TFontWeight
letterSpacing
TLetterSpacing

API

Slots

Content slots exposed by this component.

#default
Custom title content. Replaces the title prop text when provided.

API

Exposed members

Properties and methods accessible via template ref (defineExpose). Use them for programmatic control.

<T extends object>(props: T, exclude?: string[]) => Partial<T>
Utility to forward a filtered subset of props to a child component.
Ref<string>
Reactive CSS string generated by useStyle from the computed pickerTitleStyles.
string
Unique style-sheet ID for this instance.
() => void
Injects the computed style sheet. Called automatically on mount.
() => void
Removes the injected style sheet. Called automatically on unmount.
Ref<boolean>
True once the style sheet has been injected into the DOM.

Customisation

CSS variables

CSS custom properties exposed by this component. Override them to customise the component without losing theme compatibility.

CSS text-transform applied to the title strip content.
Font size of the title text.
Inline (left/right) padding of the title strip.
Block (top/bottom) padding of the title strip.
Font weight of the title text.
Letter spacing applied to the uppercase title text.
Text color. Falls back to --origam-picker--title---color then inherit. Overridden by the color prop via useBothColor.

Inclusion

Accessibility

ARIA roles, keyboard navigation and focus management. Sourced from the real component template.

Notes

  • PickerTitle renders as a generic div by default. For improved semantics, pass tag="h2" (or the appropriate heading level) so screen readers announce it as a section heading inside the picker dialog.
  • This component is purely presentational — it has no interactive elements and no ARIA role by default.

Interactive

Playground

Edit props live and see the component update in real time. The generated code snippet updates as you change values.

Rendering the live preview…

Usage

Examples

Ready-to-paste code snippets for your templates.

Basic usage

vue

Colored title strip

vue

Custom slot content

vue