Panoramica
ColorSample è un campione di colore non interattivo. Usalo accanto a un’etichetta affinché il significato non dipenda solo dal colore. La selezione appartiene al controllo circostante.
Utilizzo
colorName seleziona una voce della tavolozza del tema per il riempimento e il bordo. variant accetta default o circle. Omettendolo, viene utilizzata la forma predefinita.
Colori personalizzati
color personalizzato sovrascrive il riempimento; colorName rimane obbligatorio e determina comunque il colore del bordo. Le props native, className, style e ref si applicano al div del campione. render accetta un elemento o una callback tramite la composizione di Base UI, ad esempio uno span all’interno del testo. Gli stili del consumer sovrascrivono il riempimento, il bordo o la geometria predefiniti. I campioni decorativi usano aria-hidden="true"; un campione autonomo significativo usa role="img" con aria-label o aria-labelledby. Per offrire colori selezionabili, inserisci il campione all’interno di un ListItem con etichetta.
Migrazione
ColorSampleProps e ColorSampleVariant restano disponibili nella famiglia data-display. La variante pipeline inutilizzata viene rimossa. Gli indicatori specifici del prodotto appartengono all’applicazione e utilizzano stili nativi o la composizione. I campioni predefinito e circolare mantengono il loro aspetto esistente.
Props
Mark decorative swatches as hidden from assistive technology.
string
Accessible name when the caller supplies role=“img”.
string
CSS class merged with the swatch class.
string
CSS color that overrides the background; the border still uses
colorName."amber" | "blue" | "bronze" | "brown" | "crimson" | "cyan" | "gold" | "grass" | "gray" | "green" | "iris" | "jade" | "lime" | "mint" | "orange" | "pink" | "plum" | "purple" | "red" | "ruby" | "sky" | "tomato" | "turquoise" | "violet" | "yellow"
obbligatorio
Theme color used for the background and border. Required even when
color overrides the background.Ref<HTMLDivElement>
Ref to the swatch div, or the element supplied through render.
ReactElement<unknown, string | JSXElementConstructor<any>> | ComponentRenderFn<HTMLProps, {}>
Element or render callback composed through Base UI useRender.
CSSProperties
Native styles merged with the swatch color defaults. Explicit styles win.
"circle" | "default"
Generic swatch shape:
default or circle. Omitting it uses the default shape.