Skip to content
Technical

Использование SVG в React и Next.js: Полное Руководство по Интеграции

Освойте интеграцию SVG в приложениях React и Next.js. Узнайте методы импорта, паттерны компонентов, оптимизацию и лучшие практики для современной веб-разработки.

Robin Monteiro25 января 2026 г.10 октября 2026 г.9 min

Попробуйте на своём файле: бесплатный предпросмотр, без регистрации.

Use this article with an AI assistant:
.md
Использование SVG в React и Next.js: Полное Руководство по Интеграции
R
Robin Monteiro

Founder and developer of VectoSolve

Self-taught developer who founded VectoSolve in 2024. He builds the conversion engine and the cutting, embroidery and 3D printing exports, working with the VectoSolve team of graphic designers.

How this article was made: drafted with AI assistance, then edited and fact-checked before publication. About the author

Image vectorizationCutting machine filesEmbroidery filesSVG
Free previewNo signupFull-quality output

Key Takeaways

  • React предлагает четыре основных метода импорта SVG: импорт изображения, inline SVG, компоненты SVGR и динамические импорты
  • SVGR с конфигурацией webpack Next.js даёт лучший баланс между удобством разработки и контролем во время выполнения
  • Переиспользуемые компоненты иконок с TypeScript-пропсами (size, color, className) поддерживают ваш код DRY
  • Framer Motion нативно интегрируется с SVG-элементами для spring-анимаций путей и форм
  • Всегда добавляйте aria-label или aria-hidden к SVG-иконкам для доступности скринридеров

SVG в Современной React-Разработке

SVG незаменимы для современных React-приложений, обеспечивая чёткую графику при любом масштабе. Это руководство охватывает все методы использования SVG в проектах React и Next.js.

Использование SVG-компонентов в приложениях React и Next.js
SVG в React: от простых импортов до полностью анимированных, доступных систем иконок

Методы Импорта

1. Стандартный Импорт Изображения

Простейший подход:

jsx
import logo from './logo.svg';

function Header() {
  return <img src={logo} alt="Логотип" className="logo" />;
}

Плюсы: Просто, привычно
Минусы: Нет доступа к стилям/манипуляции

2. Inline SVG-Компоненты

Полный контроль:

jsx
function Icon() {
  return (
    <svg viewBox="0 0 24 24" className="icon">
      <path d="M12 2L2 7l10 5 10-5-10-5zM2 17l10 5 10-5"/>
    </svg>
  );
}

Плюсы: Полный доступ к CSS/JS
Минусы: Многословно, сложно менять исходник

3. SVGR (React-Компонент)

Импорт как компонент:

jsx
import { ReactComponent as Logo } from './logo.svg';

function Header() {
  return <Logo className="logo" fill="currentColor" />;
}

Плюсы: Лучшее из обоих миров
Минусы: Требует настройки

4. Динамический Импорт

Для code splitting:

jsx
import dynamic from 'next/dynamic';

const DynamicIcon = dynamic(() => import('./icons/chart.svg'));

function Dashboard() {
  return <DynamicIcon />;
}

Pro Tip: Для большинства React-проектов SVGR — рекомендуемый подход. Он позволяет импортировать SVG как React-компоненты с полной поддержкой пропсов, сохраняя SVG-файлы отдельными для удобного редактирования в дизайн-инструментах.


Настройка SVGR

Настройка Next.js

javascript
// next.config.js
module.exports = {
  webpack(config) {
    config.module.rules.push({
      test: /\.svg$/,
      use: ['@svgr/webpack'],
    });
    return config;
  },
};

С URL-Fallback

javascript
// next.config.js
module.exports = {
  webpack(config) {
    config.module.rules.push({
      test: /\.svg$/,
      issuer: /\.[jt]sx?$/,
      use: [
        {
          loader: '@svgr/webpack',
          options: {
            svgoConfig: {
              plugins: [{
                name: 'removeViewBox',
                active: false
              }]
            }
          }
        },
        'url-loader'
      ],
    });
    return config;
  },
};

A Full Year of Conversions for $49

Starter Annual: 25 conversions every month, $49 for the whole year. That is about $4.08 a month · Cancel anytime

Get the Annual Deal

Паттерны Компонентов

Переиспользуемый Компонент Иконки

jsx
interface IconProps {
  name: string;
  size?: number;
  color?: string;
  className?: string;
}

export function Icon({ name, size = 24, color = 'currentColor', className }: IconProps) {
  return (
    <svg
      width={size}
      height={size}
      fill={color}
      className={className}
    >
      <use href={`/sprites.svg#${name}`} />
    </svg>
  );
}

// Использование
<Icon name="search" size={20} color="#333" />

Компонент Библиотеки Иконок

jsx
// icons/index.tsx
import { FC, SVGProps } from 'react';

interface IconComponentProps extends SVGProps<SVGSVGElement> {
  size?: number;
}

const createIcon = (path: string): FC<IconComponentProps> => {
  return function IconComponent({ size = 24, ...props }) {
    return (
      <svg
        viewBox="0 0 24 24"
        width={size}
        height={size}
        fill="currentColor"
        {...props}
      >
        <path d={path} />
      </svg>
    );
  };
};

export const SearchIcon = createIcon('M15.5 14h-.79l-.28-.27...');
export const HomeIcon = createIcon('M10 20v-6h4v6h5v-8h3L12...');
SVG-иконки, оптимизированные для веб-приложений и дизайн-систем
Построение масштабируемой системы SVG-иконок в React с TypeScript

Стилизация SVG в React

CSS-Стили

css
/* styles.css */
.icon {
  width: 24px;
  height: 24px;
  fill: currentColor;
  transition: fill 0.2s;
}

.icon:hover {
  fill: #0066cc;
}

Styled Components

jsx
import styled from 'styled-components';

const StyledSvg = styled.svg`
  width: ${props => props.size || 24}px;
  height: ${props => props.size || 24}px;
  fill: ${props => props.color || 'currentColor'};
  transition: fill 0.2s;

  &:hover {
    fill: ${props => props.hoverColor || props.color};
  }
`;

Tailwind CSS

jsx
<svg
  className="w-6 h-6 fill-current text-gray-600 hover:text-blue-500 transition-colors"
  viewBox="0 0 24 24"
>
  <path d="..."/>
</svg>

«Лучший SVG-воркфлоу в React — тот, где дизайнеры экспортируют чистые векторы, а разработчики импортируют их как полноценные компоненты — без ручных шагов конвертации между ними.» — Kent C. Dodds, React-преподаватель


Анимация в React

CSS-Анимация

jsx
function LoadingSpinner() {
  return (
    <svg className="animate-spin" viewBox="0 0 24 24">
      <circle
        className="opacity-25"
        cx="12" cy="12" r="10"
        stroke="currentColor" strokeWidth="4"
      />
      <path
        className="opacity-75"
        fill="currentColor"
        d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4z"
      />
    </svg>
  );
}

Framer Motion

jsx
import { motion } from 'framer-motion';

function AnimatedIcon() {
  return (
    <motion.svg
      viewBox="0 0 24 24"
      initial={{ scale: 0 }}
      animate={{ scale: 1 }}
      transition={{ type: 'spring' }}
    >
      <motion.path
        d="M12 2L2 22h20L12 2z"
        initial={{ pathLength: 0 }}
        animate={{ pathLength: 1 }}
      />
    </motion.svg>
  );
}

Free SVG Tools for Crafters

Design Checker · Color Separator · Mat Preview · Offset Generator · Text to SVG

Check Your SVG Free

Стратегии Оптимизации

Оптимизация на Этапе Сборки

javascript
// svgo.config.js
module.exports = {
  plugins: [
    'preset-default',
    'removeDimensions',
    { name: 'removeViewBox', active: false },
    { name: 'prefixIds', params: { prefix: 'svg-' } }
  ]
};

Code Splitting

jsx
// Ленивая загрузка тяжёлых иконок
const ChartIcon = lazy(() => import('./icons/Chart'));

function Dashboard() {
  return (
    <Suspense fallback={<div className="icon-placeholder" />}>
      <ChartIcon />
    </Suspense>
  );
}

Никогда не удаляйте viewBox при оптимизации SVGO. Без viewBox SVG теряют способность адаптивно масштабироваться. Всегда устанавливайте removeViewBox: false в конфигурации SVGO.


Доступность в React

Паттерн Доступной Иконки

jsx
interface AccessibleIconProps {
  label: string;
  children: React.ReactNode;
}

function AccessibleIcon({ label, children }: AccessibleIconProps) {
  return (
    <span role="img" aria-label={label}>
      {children}
    </span>
  );
}

// Использование
<AccessibleIcon label="Поиск">
  <SearchIcon />
</AccessibleIcon>

Кнопка с Иконкой

jsx
function IconButton({ icon: Icon, label, onClick }) {
  return (
    <button
      onClick={onClick}
      aria-label={label}
      className="icon-button"
    >
      <Icon aria-hidden="true" />
    </button>
  );
}

Интеграция с VectoSolve

Рабочий Процесс

Использование VectoSolve с React:

  1. Конвертация изображений в SVG
  2. Скачивание оптимизированного результата
  3. Импорт в ваш React-проект
  4. Использование предпочтительного метода выше

Преимущества Оптимизированных Файлов

SVG от VectoSolve:

  • Оптимизированы для веба
  • Готовы для SVGR-импорта
  • Чистые данные путей
  • Легко стилизуются

A Full Year of Conversions for $49

Starter Annual: 25 conversions every month, $49 for the whole year. That is about $4.08 a month · Cancel anytime

Get the Annual Deal

Заключение

React предлагает множество способов работы с SVG, каждый со своими компромиссами. Выберите подход, подходящий вашим потребностям: простые импорты изображений для базового использования, SVGR для полного контроля или паттерны компонентов для систем иконок. Начните с чистых, оптимизированных SVG от VectoSolve для лучших результатов.

Получите SVG для React


Метод Импорта SVGRuntime-КонтрольВлияние на БандлИдеально Для
<img src> importНетОтдельный HTTP-запросСтатические декоративные изображения
Inline JSX SVGПолный (пропсы, события, CSS)Увеличивает размер компонентаИнтерактивные иконки, анимации
SVGR-компонентПолный (типизированные пропсы, tree-shaking)Чанк на компонентБиблиотеки иконок, дизайн-системы
Динамический importПолный (после загрузки)Code-split, ленивая загрузкаSVG ниже сгиба или условные

Источники и Дополнительное Чтение

  • MDN Web Docs: SVG in HTML — Справочник по встраиванию SVG в JSX и пониманию взаимодействия SVG-DOM
  • web.dev: Code Splitting — Руководство Google по ленивой загрузке и динамическим импортам для оптимального размера бандла
  • CSS-Tricks: SVG in React — Практические паттерны использования SVG-компонентов в проектах React и Next.js
  • Smashing Magazine: React Components — Лучшие практики создания переиспользуемых, доступных библиотек SVG-компонентов
Tags:
React
Next.js
SVG
компоненты
веб-разработка
Share:

Try VectoSolve Now

Convert your images to high-quality SVG vectors with AI

AI-Powered Vectorization

Ready to vectorize your images?

Convert your PNG, JPG, and other images to high-quality, scalable SVG vectors in seconds.