PickerTitle
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…
defaultRendering the live preview…
primary bgRendering the live preview…
success bgStructure
Anatomy
Visual breakdown of the component's internal structure with BEM class call-outs.
<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.
- titlestring
- Title text displayed in the strip. Also configurable via the default slot.
- idstring
- classstring | Array<string> | object
- stylestring | Array<string> | object | StyleValue
- tagstring'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.
- fontSizeTFontSize
- fontWeightTFontWeight
- letterSpacingTLetterSpacing
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
Colored title strip
Custom slot content