background-position-y

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

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

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

Синтаксис

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

Значения

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

Песочница

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

Пример

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

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

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

Объект.style.backgroundPositionY

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

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

Браузеры

6124153.149
2.149373.2

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

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

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