PickerTitle
Title strip rendered at the top of a Picker panel. Displays uppercase text with configurable color and background color theming.
Aperçu
Rendu de l’aperçu en cours…
defaultRendu de l’aperçu en cours…
primary bgRendu de l’aperçu en cours…
success bgStructure
Anatomie
Décomposition visuelle de la structure interne du composant avec les appels de classes BEM.
<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
Toutes les props acceptées par ce composant, avec leur type, valeur par défaut et 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
Emplacements de contenu exposés par ce composant.
- #default
- Custom title content. Replaces the title prop text when provided.
API
Membres exposés
Propriétés et méthodes accessibles via ref template (defineExpose). Utilisés pour le contrôle programmatique.
- <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.
Personnalisation
Variables CSS
Propriétés CSS personnalisées exposées par ce composant. Surchargez-les pour personnaliser sans perdre la compatibilité avec le thème.
- 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
Accessibilité
Rôles ARIA, navigation clavier et gestion du focus. Sourcé depuis le template réel du composant.
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.
Interactif
Playground
Modifiez les props en direct et observez le composant se mettre à jour. Le snippet de code généré suit vos changements.
Rendu de l’aperçu en cours…
Usage
Exemples
Extraits de code prêts à coller dans vos templates.
Basic usage
Colored title strip
Custom slot content