Настройки›Адаптация
Адаптация
Адаптация tint, контраста текста и матовости к сцене под стеклом.
Попробовать режимы
Загрузи фото через кнопку примера. Оно остаётся локальным и используется в других примерах. Анализируется предоставленный фон, а не произвольные пиксели страницы.
Что изменяется
| Режим | Поведение |
|---|---|
off | По умолчанию: анализ выключен, материал ручной. |
tint | Автоматический светлый или тёмный tint; цвет текста задаёт приложение. |
contrast | Адаптируются автоматический tint, цвет текста и прозрачность. |
full | На сложном фоне дополнительно повышается матовость. |
Сцена и локальные переопределения
import { setSceneMaterial, getSceneMaterial } from "@edinstvo/glass";
setSceneMaterial({ adaptation: "full", adaptationStrength: 1 });
console.log(getSceneMaterial());
setSceneMaterial(null); // Сбросить настройки материала сцены.Настройки сцены объединяются со светом сцены, CSS-токенами и локальными слоями материала. Каждое свойство наследуется отдельно. Локальное значение имеет приоритет; inherit сохраняет родительское, default возвращает стандарт движка.
<edinstvo-glass adaptation="contrast">Автоматический текст</edinstvo-glass>
<edinstvo-glass adaptation="off" tint="#fff">Ручной материал</edinstvo-glass>Ручное управление
adaptationStrength — от 0 до 1, по умолчанию 1. При 0 анализа нет. Явно заданные tint и foreground сохраняются. Автоматический текст — чёрный или белый; веб-компонент применяет его к содержимому. С attachGlass укажи тексту color: var(--glass-foreground, inherit).
Входные CSS-токены: --glass-adaptation, --glass-adaptation-strength и --glass-text-color. Меняются итоговые значения отрисовки; исходные настройки материала сохраняются.
Плавные изменения
adaptationDuration — от 0 до 1000 мс, по умолчанию 300. Tint, цвет текста, прозрачность и матовость плавно переходят к целевым значениям, в том числе при возврате к ручному материалу. Для мгновенного изменения укажи adaptation-duration="0". Системное уменьшение движения отключает интерполяцию. После завершения перехода отрисовка останавливается.
В обычных условиях full меняет заданные прозрачность и матовость не более чем на 0.18, сохраняя характер стекла. Выбери contrast, если оценка контраста важнее прозрачности. Повышенный контраст или уменьшение прозрачности в системных настройках могут отменить визуальное ограничение full. data-glass-adapting отмечает переход; оценка контраста относится к цели, а не каждому промежуточному кадру.
Доступность и ограничения выборки
Локальная область 12×12 анализируется не чаще одного раза в 150 мс на поверхность. Режимы контраста стремятся к 4.5:1 для выборки, либо 7:1 при повышенном системном контрасте. Уменьшение прозрачности снижает её предел; в принудительных цветах оптический canvas скрывается и используются системные цвета.
Оценка делается до окончательной оптики и текста и не гарантирует соответствие WCAG. Ручные цвета, неполная сила, мелкие детали и движение могут помешать цели. data-glass-contrast содержит оценку. Проверяй конечный интерфейс отдельно.