svgo (1.3.2)

Published 2026-02-24 14:05:59 +00:00 by atheaadmin

Installation

registry=
npm install svgo@1.3.2
"svgo": "1.3.2"

About this package

english | русский


logo

SVGO NPM version Build Status Coverage Status

SVG Optimizer – это инструмент для оптимизации векторной графики в формате SVG, написанный на Node.js.

Зачем?

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

Возможности

SVGO имеет расширяемую архитектуру, в которой почти каждая оптимизация является отдельным расширением.

Что у нас есть:

Plugin Description Default
cleanupAttrs удаление переносов строк и лишних пробелов включен
inlineStyles перенос стилей из элементов <style> в атрибуты style включен
removeDoctype удаление doctype включен
removeXMLProcInst удаление XML-инструкций включен
removeComments удаление комментариев включен
removeMetadata удаление <metadata> включен
removeTitle удаление <title> включен
removeDesc удаление <desc> включен
removeUselessDefs удаление элементов в <defs> без id включен
removeXMLNS удаление атрибута xmlns (для заинлайненных svg) выключено
removeEditorsNSData удаление пространств имён различных редакторов, их элементов и атрибутов включен
removeEmptyAttrs удаление пустых атрибутов включен
removeHiddenElems удаление скрытых элементов включен
removeEmptyText удаление пустых текстовых элементов включен
removeEmptyContainers удаление пустых элементов-контейнеров включен
removeViewBox удаление атрибута viewBox, когда это возможно включен
cleanupEnableBackground удаление или оптимизация атрибута enable-background, когда это возможно включен
minifyStyles уменьшает содержимое элементов <style> с помощью CSSO. включен
convertStyleToAttrs конвертирование стилей в атрибуте style в отдельные svg-атрибуты включен
convertColors конвертирование цветовых значений: из rgb() в #rrggbb, из #rrggbb в #rgb включен
convertPathData конвертирование данных Path в относительные или абсолютные координаты, смотря что |короче; конвертирование одних типов сегментов в другие; удаление ненужных разделителей; умное округление и тому подобное включен
convertTransform схлопывание нескольких трансформаций в одну, конвертирование матриц в короткие алиасы |и многое другое включен
removeUnknownsAndDefaults удаление неизвестных элементов, контента и атрибутов включен
removeNonInheritableGroupAttrs удаление ненаследуемых "презентационных" атрибутов групп включен
removeUselessStrokeAndFill удаление неиспользуемых атрибутов stroke-* и fill-* включен
removeUnusedNS удаление деклараций неиспользуемых пространств имён включен
prefixIds добавляет префикс в ID или классы в виде имени файла или произвольной строки выключено
cleanupIDs удаление неиспользуемых и сокращение используемых ID включен
cleanupNumericValues округление дробных чисел до заданной точности, удаление px как единицы |измерения по-умолчанию включен
cleanupListOfValues округление числовых значений в атрибутах со списком чисел, таких как viewBox |или enableBackground выключено
moveElemsAttrsToGroup перемещение совпадающих атрибутов у всех элементов внутри группы <g> включен
moveGroupAttrsToElems перемещение некоторых атрибутов группы на элементы внутри включен
collapseGroups схлопывание бесполезных групп <g> включен
removeRasterImages удаление растровых изображений выключено
mergePaths склеивание нескольких Path в одну кривую включен
convertShapeToPath конвертирование простых форм в Path включен
convertEllipseToCircle конвертирование вырожденного эллипса <ellipse> в круг <circle> включен
sortAttrs сортировка атрибутов элементов для удобочитаемости выключено
sortDefsChildren сортировка детей <defs> для лучшей компрессии включен
removeDimensions удаляет атрибуты width/height при наличии viewBox (противоречит removeViewBox — плагин должен быть выключен) выключено
removeAttrs удаляет атрибуты по указанному паттерну выключено
removeAttributesBySelector удаляет атрибуты по CSS-селектору выключено
removeElementsByAttr удаляет элементы по указанным ID или классам выключено
addClassesToSVGElement добавляет имена классов корневому элементу <svg> выключено
addAttributesToSVGElement добавляет атрибуты корневому элементу <svg> выключено
removeOffCanvasPaths удаляет элементы вне отрисовываемой области выключено
removeStyleElement удаляет элементы <style> выключено
removeScriptElement удаляет элементы <script> выключено
reusePaths Заменяет дублирующиеся элементы ссылками выключено

Хотите узнать принципы работы и как написать свой плагин? Конечно же, да!

Как использовать

$ [sudo] npm install -g svgo

Выполнение:

Командная строка

Запуск:
  svgo [OPTIONS] [ARGS]

Параметры:
  -h, --help : Помощь
  -v, --version : Версия программы
  -i INPUT, --input=INPUT : Входной файл, "-" для STDIN
  -s STRING, --string=STRING : Входная строка SVG
  -f FOLDER, --folder=FOLDER : Входная папка, оптимизирует и перезаписывает все файлы *.svg
  -o OUTPUT, --output=OUTPUT : Выходной файл или папка (совпадает с входным по умолчанию), "-" для STDOUT
  -p PRECISION, --precision=PRECISION : Число цифр после запятой, переопределяет параметры плагинов
  --config=CONFIG : Файл конфигурации (или строка JSON) для расширения и замены настроек
  --disable=PLUGIN : Выключение плагина по имени, "--disable=PLUGIN1,PLUGIN2" для отключения нескольких плагинов
  --enable=PLUGIN : Включение плагина по имени, "--enable=PLUGIN3,PLUGIN4" для отключения нескольких плагинов
  --datauri=DATAURI : Результат в виде строки Data URI (base64, URI encoded или unencoded)
  --multipass : Оптимизация в несколько проходов для применения всех возможных оптимизаций
  --pretty : Удобочитаемое форматирование SVG
  --indent=INDENT : Размер отступа для удобочитаемого форматирования
  -r, --recursive : Совместно с '-f'. Рекурсивно обрабатывать *.svg файлы в папках.
  -q, --quiet : Подавляет вывод информации, выводятся только сообщения об ошибках
  --show-plugins : Доступные плагины

Аргументы:
  INPUT : Аналогично --input
  • с файлами:

    $ svgo test.svg
    

    или:

    $ svgo *.svg
    
    $ svgo test.svg -o test.min.svg
    
    $ svgo test.svg other.svg third.svg
    
    $ svgo test.svg other.svg third.svg -o test.min.svg -o other.min.svg -o third.min.svg
    
  • со STDIN / STDOUT:

    $ cat test.svg | svgo -i - -o - > test.min.svg
    
  • с папками

    $ svgo -f ../path/to/folder/with/svg/files
    

    или:

    $ svgo -f ../path/to/folder/with/svg/files -o ../path/to/folder/with/svg/output
    
    $ svgo *.svg -o ../path/to/folder/with/svg/output
    
  • со строками:

    $ svgo -s '<svg version="1.1">test</svg>' -o test.min.svg
    

    или даже с Data URI base64:

    $ svgo -s 'data:image/svg+xml;base64,…' -o test.min.svg
    
  • с SVGZ:

    из .svgz в .svg:

    $ gunzip -c test.svgz | svgo -i - -o test.min.svg
    

    из .svg в .svgz:

    $ svgo test.svg -o - | gzip -cfq9 > test.svgz
    

Другие способы использования SVGO

Лицензия и копирайты

Данное программное обеспечение выпускается под лицензией MIT.

Логотип – Егор Большаков.

Dependencies

Dependencies

ID Version
chalk ^2.4.1
coa ^2.0.2
css-select ^2.0.0
css-select-base-adapter ^0.1.1
css-tree 1.0.0-alpha.37
csso ^4.0.2
js-yaml ^3.13.1
mkdirp ~0.5.1
object.values ^1.1.0
sax ~1.2.4
stable ^0.1.8
unquote ~1.1.1
util.promisify ~1.0.0

Development Dependencies

ID Version
coveralls ^3.0.7
fs-extra ~8.1.0
istanbul ~0.4.5
jshint ~2.10.2
mocha ~6.2.2
mocha-istanbul ~0.3.0
mock-stdin ~0.3.1
should ~13.2.3

Keywords

svgo svg optimize minify
Details
npm
2026-02-24 14:05:59 +00:00
0
Kir Belevich
MIT
92 KiB
Assets (1)
Versions (2) View all
2.8.0 2026-02-24
1.3.2 2026-02-24