5.11.1. Коллекции изображений#

Сервер предоставляет возможность формировать коллекции изображений, которые можно использовать внутри сервера (например: создавая какой-либо компонент - имеется возможность использовать изображения из любой коллекции), а также в любых прикладных проектах.

5.11.1.1. Работа с коллекциями изображений#

Changed in version 1.23.0-ms15: Добавлена возможность использования SVG-коллекций.

Коллекции изображений находятся в view/imagecollection/.

Каждая коллекция изображений получает своё имя в зависимости от её тематики (например, коллекция flags содержит флаги стран) или от места её использования (например, toolbarprimary и toolbarsecondary — это коллекции, используемые в панели инструментов).

Note

Если для одной коллеции имеются файлы с разным размером изображений, то рекомендуется разделить коллекцию на две отдельные коллекции с указанием соответствующего размера изображений. Пример: btk_license16 и btk_license24, btk_scheduler16 и btk_scheduler24.

Коллекции изображений работают с файлами форматов .svg и .png. На основе изображений из коллекции создаётся спрайт, который объединяет все изображения.

Если коллекция состоит из SVG-изображений, создаётся SVG-спрайт.
Если коллекция состоит из PNG-изображений, создаётся PNG-спрайт.

Attention

Важно использовать файлы с одинаковым расширением в одной коллекции. Если коллекция будет содержать как .svg, так и .png файлы, то будут использоваться .svg файлы, так как они обладают большим приоритетом, нежели .png файлы.

Спрайт для коллекции изображений создаётся при первом обращении к данной коллекции и сохраняется в кэш сервера. При последующих запросах будет использоваться спрайт из кэша.

Warning

Если удалить/добавить файлы в коллекцию, которая уже запрашивались раннее в рамках работающего сервера, то спрайт коллекций не будут пересоздан. Для того, чтобы применились измененения - необходимо перезапустить сервер.

Поддерживаемые размеры изображений 16px и 24px. Мы принимаем соглашение, что все изображения в коллекции должны иметь одинаковые размеры.

Attention

Указание свойств высоты (height) и ширины (width) в аттрибутах иконки в .svg файле является обязательным, иначе этот файл не попадет в спрайт коллекции.

Пример указания свойств высоты и ширины в .svg файле#

<svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
    <path d="M8 4.95117C6.99219 4.95117 6.37109 6.04102 6.37109 7.8457V8.15625C6.37109 9.9668 6.99805 11.0508 8 11.0508C9.00195 11.0508 9.62305 9.96094 9.62305 8.15625V7.8457C9.62305 6.04688 9.00195 4.95117 8 4.95117Z" fill="black"/>
    <path d="M16 8C16 12.4183 12.4183 16 8 16C3.58172 16 0 12.4183 0 8C0 3.58172 3.58172 0 8 0C12.4183 0 16 3.58172 16 8ZM7.98828 12.1582C9.8457 12.1582 10.9473 10.5762 10.9473 8.16797V7.83984C10.9473 5.41406 9.86914 3.84375 8.01172 3.84375C6.14844 3.84375 5.04688 5.43164 5.04688 7.83984V8.16797C5.04688 10.5879 6.13672 12.1582 7.98828 12.1582Z" fill="black"/>
</svg>