background-position-x

Задаёт положение фонового изображения внутри элемента по горизонтали. Если для элемента установлено несколько фоновых изображений, то можно изменять положение каждого изображения, перечисляя значения через запятую.

Краткая информация

Значение по умолчанию left
Наследуется Нет
Применяется Ко всем элементам
Анимируется Да

Синтаксис

background-position-x: [ left | center | right | <проценты> | <размер> ]#
Описание Пример
<тип> Указывает тип значения. <размер>
A && B Значения должны выводиться в указанном порядке. <размер> && <цвет>
A | B Указывает, что надо выбрать только одно значение из предложенных (A или B). normal | small-caps
A || B Каждое значение может использоваться самостоятельно или совместно с другими в произвольном порядке. width || count
[ ] Группирует значения. [ crop || cross ]
* Повторять ноль или больше раз. [,<время>]*
+ Повторять один или больше раз. <число>+
? Указанный тип, слово или группа не является обязательным. inset?
{A, B} Повторять не менее A, но не более B раз. <радиус>{1,4}
# Повторять один или больше раз через запятую. <время>#

Значения

left
Выравнивает фон по левому краю. Эквивалент записи 0 или 0%.
center
Выравнивает фон по центру горизонтали. Эквивалент записи 50%.
right
Выравнивает фон по правому краю. Эквивалент записи 100%.
<проценты>
Задаёт положение фона в процентах от ширины элемента. Значение 0% или 0 выравнивает левый край фонового изображения по левому краю элемента. Значение 100% выравнивает правый край рисунка по правому краю элемента.
<размер>
Задаёт положение фона в любых доступных для CSS единицах — пиксели (px), сантиметры (cm), em и др. относительно левого края элемента.

Песочница

div {
  background-position-x: {{ playgroundValue }};
}

Пример

<!doctype html> <html> <head> <meta charset="utf-8"> <title>background-position-x</title> <style> .clock { background: url(/example/image/clock-sprite.png) no-repeat; width: 128px; height: 128px; } .clock:hover { background-position-x: 100%; } </style> </head> <body> <div class="clock"></div> </body> </html>

В данном примере при наведении курсора мыши на рисунок, фоновая картинка смещается по горизонтали, показывая цветной рисунок вместо чёрно-белого.

Объектная модель

Объект.style.backgroundPositionX

Спецификация

Спецификация Статус
CSS Backgrounds and Borders Module Level 4 Редакторский черновик

Браузеры

6 12 4 15 3.1 49
2.1 49 37 3.2

В таблице браузеров применяются следующие обозначения.

  • — элемент полностью поддерживается браузером;
  • — элемент браузером не воспринимается и игнорируется;
  • — при работе возможно появление различных ошибок, либо элемент поддерживается с оговорками.

Число указывает версию браузреа, начиная с которой элемент поддерживается.