image-resolution

Свойство image-resolution задаёт собственное разрешение всех растровых изображений, используемых внутри элемента. image-resolution влияет на заменяемые изображения и генерируемое содержимое, а также на декоративные изображения вроде фоновых картинок. Не оказывает воздействие на векторные изображения в формате SVG.

Разрешение изображения определяется как количество пикселей изображения на единицу длины, например, число пикселей на дюйм (dot per inch, dpi). К примеру, значение 300dpi означает, что на один дюйм длины (2,54 см) приходится 300 точек.

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

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

Синтаксис

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

Значения

<разрешение>
Определяет разрешение изображения. Может быть указано в следующих единицах: dpi, dppx, dpcm.
from-image
Использует собственное разрешение изображения, которое определено графическим форматом. Если собственное разрешение не указано, применяется заданное разрешение. В противном случае по умолчанию используется значение 1dppx.
snap
Указанное разрешение округляется до ближайшего значения, при котором один пиксель изображения соответствует целому числу пикселей устройства.

Пример

<!DOCTYPE html> <html lang="ru"> <head> <meta charset="utf-8"> <title>image-resolution</title> <style> div { margin-bottom: 1rem; } .r300 { image-resolution: 300dpi; } .r200 { image-resolution: 200dpi; } .r100 { image-resolution: 100dpi; } </style> </head> <body> <div class="r300"> <h2>300dpi</h2> <img src="image/fish.webp" alt="Рыба" width="400"> </div> <div class="r200"> <h2>200dpi</h2> <img src="image/fish.webp" alt="Рыба" width="400"> </div> <div class="r100"> <h2>100dpi</h2> <img src="image/fish.webp" alt="Рыба" width="400"> </div> </body> </html>

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

Объект.style.imageResolution

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

Браузеры

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

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

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

См. также