Prezentare generală
ColorSample este o mostră de culoare neinteractivă. Folosiți-o lângă o etichetă, astfel încât semnificația să nu depindă doar de culoare. Selectarea aparține controlului înconjurător.
Utilizare
colorName selectează o intrare din paleta temei pentru umplere și contur. variant acceptă default sau circle. Omiterea sa utilizează forma implicită.
Culori personalizate
color personalizată înlocuiește umplerea; colorName rămâne obligatoriu și determină în continuare culoarea conturului. Proprietățile native, className, style și ref vizează div-ul eșantionului de culoare. render acceptă un element sau un callback prin compunerea Base UI, de exemplu un span în interiorul textului. Stilurile utilizatorului suprascriu umplerea, bordura sau geometria implicite. Eșantioanele de culoare decorative folosesc aria-hidden="true"; un eșantion de culoare semnificativ autonom folosește role="img" cu aria-label sau aria-labelledby. Pentru a oferi culori selectabile, compuneți mostra de culoare într-un ListItem etichetat.
Migrare
ColorSampleProps și ColorSampleVariant rămân disponibile din familia de afișare a datelor. Varianta pipeline neutilizată este eliminată. Indicatorii specifici produsului aparțin aplicației, folosind stiluri native sau compunere. Eșantioanele de culoare implicite și circulare își păstrează aspectul existent.
Proprietăți
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"
obligatoriu
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.