# Процесс разработки веб иконок

# Работа с .SVG иконками

Не смотря на то, что icons плагин оптимизирует все .svg файлы, для более корректной генерации веб иконок, все файлы следует предварительно подготовить! Советы по подготовке .svg иконок:

  • Каждый файл должен содержать исключительно одну иконку
  • Преобразовать обводку в кривые (избавиться от stroke)
  • Навести порядок в слоях и удалить не нужны элементы

TIP

Важно помнить! Чем более точный и оптимизированный исходный .SVG файл, тем лучше сгенерированный результат!

# Режим генерации иконок

SVG иконки могут быть сгенерированы в веб шрифты или в svg sprite. В режиме разработки, генерация .svg иконок осуществляется относительно активного режима указанного в svgIconsMode (opens new window) параметре конфигурации icons плагина.

TIP

В режиме разработки .svg иконки генерируются относительно "активного режима генерации иконок", переключение данного режима осуществляется путем конфигурирования svgIconsMode параметра в конфигурационном файле проекта. Доступные значения для данного параметра:

  • svgSprite
  • fonts

Моментальное переключение режима генерации SVG иконок в режиме разработки осуществляется посредством svgmode команды в icons меню.

# Использование иконок в SASS фреймворке

# Web fonts иконки

При генерации иконок в виде веб шрифтов, icons плагин генерирует ungic.ficons sass модуль, который может быть использован при написании sass компонентов:

@use "ungic.ficons" as ficons;

.my-star-icon {
    @include ficons.icon(star);
}

# Image sprite

В режиме разработки, все растровые иконки (.png/.jpg формата) из рабочей директории source/icons плагина будут сгруппированы и собраны в единый спрайт. При генерации спрайта, icons плагин генерирует ungic.sprites SASS модуль, который может быть использован при написании sass компонентов:

@use "ungic.sprites" as sprites;

.my-star-icon {
    @include sprites.icon(star_png);
}

# Использование иконок в HTML

Для генерации HTML разметки определенной иконки используется icon инструмент, а для получения информации о всех иконках проекта, используется include инструмент

{{{icon "star"}}}

<!-- Передали в шаблон данные из icons плагина -->
{{{include "icons.hbs" icons=true}}}

Подробнее об использовании иконок в html.

# Экспортирование и импортирование иконок

Все svg иконки, могут быть экспортированы из ungic проекта в .JSON файле. Данный экспортируемый файл, может быть использовал для импорта иконок в любой из ungic проектов.

Для экспорта иконок из проекта следует перейти в меню icons плагина и воспользоваться export [path] командой. А для импорта используется команда import [path].