CSS-свойствоВ стандарте

CSS offset-distance — синтаксис и примеры

CSS-свойство offset-distance: назначение, рабочее значение, влияние на раскладку или отрисовку, ошибки и поддержка браузерами.

Суть темы

У темы «offset-distance» есть конкретная роль в области «движение и преобразования». Свойство offset-distance относится к области «движение и преобразования» и обычно работает после раскладки и требует учёта prefers-reduced-motion. Для «offset-distance» в форме, где часть полей становится недоступной используйте результат при отключённом JavaScript и не добавляйте новую обёртку до объяснения её роли.

Практическое правило для offset-distance

Рабочий критерий для «offset-distance»: проверьте вычисленное значение offset-distance, наследование и контекст родителя. Если результат «offset-distance» меняется вместе с посторонним условием, пример ещё не изолирован.

Синтаксис offset-distance

Пример «offset-distance» оставляет только контекст, необходимый для области «движение и преобразования». Измените одно значение и проследите результат в браузере.

css
.demo {
  offset-distance: translateY(-0.25rem);
}
Открыть в Playground

Как работает offset-distance

Механика «offset-distance» начинается с допустимого контекста и заканчивается наблюдаемым результатом. Свойство offset-distance относится к области «движение и преобразования» и обычно работает после раскладки и требует учёта prefers-reduced-motion; для «offset-distance» отдельно проверьте результат при отключённом JavaScript.

Проверка в проекте

  • Проверьте вычисленное значение offset-distance, наследование и контекст родителя; результат относится непосредственно к «offset-distance».
  • Замедлить загрузку ресурсов и проверить резервное содержимое при разборе «offset-distance».
  • Проверьте «offset-distance» в форме, где часть полей становится недоступной через результат при отключённом JavaScript и запишите наблюдаемое изменение.
Выбор конструкции

Используйте «offset-distance», когда требуется изменять визуальное положение или переход между состояниями интерфейса; подтвердите выбор предметной проверкой: проверьте вычисленное значение offset-distance, наследование и контекст родителя. Для «offset-distance» более простой вариант предпочтителен, если он сохраняет тот же смысл и поведение.

Практика с offset-distance

Соберите «offset-distance» в рабочем фрагменте интерфейса и проверьте предметное условие: проверьте вычисленное значение offset-distance, наследование и контекст родителя. Затем для «offset-distance» замените содержимое длинным и сузьте контейнер до 320 px.

движение и преобразованияoffset-distance

Сценарий: в форме, где часть полей становится недоступной.

Ошибки при работе с offset-distance

01

Контекст

Изолированная декларация offset-distance без связанных ограничений может дать другой результат в реальном компоненте — это предметный риск для «offset-distance».

02

Устойчивость

Подмена семантики визуально похожим div или span при использовании «offset-distance».

03

Доступность

Непредсказуемое наследование значения из внешнего компонента; для «offset-distance» проверьте это отдельно.

Поддержка offset-distance

Для «offset-distance» таблица собрана из закреплённой версии MDN Browser Compatibility Data. Указанная версия браузера показывает первое заявленное появление базовой поддержки «offset-distance»; окончательное решение принимайте по аудитории конкретного проекта.

Chromeс версии 55Edgeс версии 79Firefoxс версии 72Safariс версии 16

Спецификация: источник 1.

Вопросы о offset-distance

Как понять, что «offset-distance» выбрано правильно?

«offset-distance» выбрано правильно, когда оно решает задачу «изменять визуальное положение или переход между состояниями интерфейса», сохраняет результат в форме, где часть полей становится недоступной и проходит предметную проверку: проверьте вычисленное значение offset-distance, наследование и контекст родителя.

Нужен ли запасной вариант для «offset-distance»?

Запасной вариант для «offset-distance» нужен, если целевой браузер или режим не обеспечивает выбранное поведение. Без улучшения «offset-distance» должно сохранять смысл, содержимое и основное действие.

Спецификации и источники

Синтаксис и статус проверяются по HTML Living Standard, спецификациям CSS и MDN Browser Compatibility Data. Примеры и объяснения подготовлены для этого сервиса.