Обзор
ColorSample — неинтерактивный образец цвета. Используйте его рядом с меткой, чтобы значение не зависело только от цвета. Выбор относится к окружающему элементу управления.
Использование
colorName выбирает запись палитры темы для заливки и границы. variant принимает default или circle. Если не указывать его, используется форма по умолчанию.
Пользовательские цвета
color переопределяет заливку; colorName остается обязательным и по-прежнему определяет цвет границы. Нативные свойства, className, style и ref применяются к div-элементу образца. render принимает элемент или обратный вызов через композицию Base UI, например элемент span внутри текста. Пользовательские стили переопределяют заливку, границу или геометрию по умолчанию. Декоративные образцы используют aria-hidden="true"; отдельный значимый образец использует role="img" с aria-label или aria-labelledby. Чтобы предложить выбираемые цвета, разместите образец внутри ListItem с меткой.
Миграция
ColorSampleProps и ColorSampleVariant по-прежнему доступны из семейства data-display. Неиспользуемый вариант pipeline удалён. Индикаторы, специфичные для продукта, должны находиться в приложении с использованием нативных стилей или композиции. Образцы default и circle сохраняют существующий внешний вид.
Свойства
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"
обязательно
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.