Поиск

SVG-спрайт для сайта

SVG-спрайт для сайта

SVG-спрайт хранит несколько пиктограмм в одном файле. Каждую иконку помещают в symbol с уникальным id, а в HTML подключают через use. Для тестовой панели можно отметить нужные рисунки в каталоге RPG Awesome и скачать спрайт. Если нужны отдельные векторы из Font Awesome, их можно объединить вручную тем же способом.

Скачайте спрайт или подготовьте отдельные иконки

В RPG Awesome отметьте несколько иконок, например круглый щит и кинжал, затем скачайте SVG-спрайт. Откройте файл в текстовом редакторе и посмотрите ID символов. Для щита это может быть ra-round-shield. Используйте точное значение из файла. Оно должно совпасть с частью адреса после знака #.

Для сайта можно взять отдельные SVG из «Иконок Font Awesome», например галочку, корзину и стрелку. Скачайте файлы в выбранных стилях. Если у проекта есть исходный комплект Font Awesome с готовыми спрайтами, проверьте его папку sprites и официальные примеры для этой версии. В спрайте своего проекта удобно собрать только те символы, которые реально используются.

Прежде чем объединять файлы, проверьте viewBox, цвет и внутренние ссылки каждого рисунка. Для разных символов можно сохранить разные координатные области. Браузер впишет их в заданную внешнюю ширину и высоту. У векторов с масками, градиентами и обрезкой проверьте, чтобы ID внутренних элементов также были уникальными. Две одинаковые маски по имени могут начать ссылаться на чужую геометрию.

Соберите файл с symbol

Создайте файл icons.svg с корневым svg. В примере два простых контура с разными именами. Атрибут viewBox хранится у каждого символа. Для одноцветной линии задан stroke='currentColor'. Так цвет можно получить от внешнего элемента.

<svg xmlns='http://www.w3.org/2000/svg'>
<symbol id='icon-check' viewBox='0 0 24 24'>
<path d='m5 12 4 4L19 6' fill='none'
stroke='currentColor' stroke-width='2'
stroke-linecap='round' stroke-linejoin='round'></path>
</symbol>
<symbol id='icon-arrow' viewBox='0 0 24 24'>
<path d='M5 12h14m-6-6 6 6-6 6' fill='none'
stroke='currentColor' stroke-width='2'
stroke-linecap='round' stroke-linejoin='round'></path>
</symbol>
</svg>

При переносе готовой иконки возьмите содержимое внутреннего svg и его viewBox. Оставьте инструкции цвета и геометрию, от которых зависит рисунок. Метаданные редактора и повторные объявления пространства имён обычно можно сократить. Посмотрите результат по одному символу после оптимизации. В материале о настройке SVGO есть примеры, где автоматическая обработка может удалить важные ID или координаты.

Подключите иконку через use

<button class='continue' type='button'>
Далее
<svg width='20' height='20' aria-hidden='true'>
<use href='/assets/icons.svg#icon-arrow'></use>
</svg>
</button>

Часть до # указывает файл. Часть после него указывает ID конкретного symbol. Для второго рисунка измените ID на icon-check. Если файл лежит рядом с документом, можно использовать относительный путь. Для CMS или сайта в подкаталоге сверьте фактический публичный адрес файла после сборки.

Внешний спрайт удобно положить на тот же origin, с теми же схемой, доменом и портом, что и у страницы. При ссылке на другой origin браузеры могут блокировать внешний use. Для собственного файла используют href. В старом коде встречается xlink:href, которое нужно учитывать только при поддержке окружений, где современная форма недоступна.

Если определения вставлены в тот же документ, можно оставить только href='#icon-arrow'. В таком варианте общий блок svg с символами ставят один раз в шаблон. Дайте символам префикс проекта, особенно если на странице уже есть иконки разных виджетов с короткими ID. У двух одинаковых ID браузер может выбрать первое совпадение в документе.

Проверьте цвет, размер и доступность

Задайте color кнопке или самому внешнему svg. Контуры из примера получат этот цвет через currentColor. Если часть пиктограммы сохранила исходный цвет, откройте символ и проверьте конкретные атрибуты fill и stroke. Многоцветные участки можно оставить с фиксированными цветами, когда они важны для рисунка.

У кнопки с текстом декоративный SVG можно скрыть от чтения с экрана. У одиночного значка дайте доступное имя кнопке, например «Открыть настройки». При проверке сравните фокус и контраст на разных темах. Если нужно всего одно изображение без динамического цвета, полезно сравнить сложность спрайта с обычным img по статье «SVG-иконки для сайта».

Почему подключённая пиктограмма пустая

  1. Откройте URL файла без фрагмента. У файла с одними символами пустой предпросмотр возможен, потому что symbol сам по себе не рисуется. Проверьте содержимое файла и тип image/svg+xml.
  2. Сверьте ID и регистр. Сравните href на странице со строкой id в опубликованном файле.
  3. Проверьте адрес на вложенной странице и отследите перенаправления. У файла с одинаковым именем в другом каталоге может быть другой набор символов.
  4. Проверьте размеры внешнего svg, координаты viewBox и фактический цвет. Для диагностики задайте контрастный цвет, увеличьте иконку и положите её на однотонный фон.

Если в редакторе Figma нужен отдельный вектор, откройте исходный SVG выбранной иконки. В браузере проверять удобнее маленькой HTML-страницей с двумя вызовами use. Сначала убедитесь, что оба символа отображаются, затем подключайте спрайт в общий шаблон сайта. При замене версии пока сохраните действующие ID либо обновите все места их использования.

Для обновления вынесите версию в имя файла, например icons.v2.svg, и смените адрес в шаблоне. Эта схема полезна, если сайт долго хранит статические ресурсы в кэше. При раскатке убедитесь, что новая страница ссылается на уже доступный файл. Успешное открытие спрайта с правильными ID полезнее одного снимка экрана из локальной сборки.

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

Что делать дальше

  1. Соберите тестовый спрайт из двух иконок и проверьте их в одной строке на светлом и тёмном фоне.
  2. Откройте страницу, где спрайт используется повторно. Сверьте путь, цвет и названия элементов с клавиатуры.
  3. Если для комплекта нужны отдельные иллюстрации поверх базовых пиктограмм, найдите подходящий сценарий в каталоге промтов для графики.
—
15:51
53
Нет комментариев. Ваш будет первым!