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

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
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.
Методы Импорта
1. Стандартный Импорт Изображения
Простейший подход:
import logo from './logo.svg';
function Header() {
return <img src={logo} alt="Логотип" className="logo" />;
}
Плюсы: Просто, привычно
Минусы: Нет доступа к стилям/манипуляции
2. Inline SVG-Компоненты
Полный контроль:
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-Компонент)
Импорт как компонент:
import { ReactComponent as Logo } from './logo.svg';
function Header() {
return <Logo className="logo" fill="currentColor" />;
}
Плюсы: Лучшее из обоих миров
Минусы: Требует настройки
4. Динамический Импорт
Для code splitting:
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
// next.config.js
module.exports = {
webpack(config) {
config.module.rules.push({
test: /\.svg$/,
use: ['@svgr/webpack'],
});
return config;
},
};
С URL-Fallback
// 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Паттерны Компонентов
Переиспользуемый Компонент Иконки
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" />
Компонент Библиотеки Иконок
// 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 в React
CSS-Стили
/* styles.css */
.icon {
width: 24px;
height: 24px;
fill: currentColor;
transition: fill 0.2s;
}
.icon:hover {
fill: #0066cc;
}
Styled Components
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
<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-Анимация
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
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Стратегии Оптимизации
Оптимизация на Этапе Сборки
// svgo.config.js
module.exports = {
plugins: [
'preset-default',
'removeDimensions',
{ name: 'removeViewBox', active: false },
{ name: 'prefixIds', params: { prefix: 'svg-' } }
]
};
Code Splitting
// Ленивая загрузка тяжёлых иконок
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
Паттерн Доступной Иконки
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>
Кнопка с Иконкой
function IconButton({ icon: Icon, label, onClick }) {
return (
<button
onClick={onClick}
aria-label={label}
className="icon-button"
>
<Icon aria-hidden="true" />
</button>
);
}
Интеграция с VectoSolve
Рабочий Процесс
Использование VectoSolve с React:
- Конвертация изображений в SVG
- Скачивание оптимизированного результата
- Импорт в ваш React-проект
- Использование предпочтительного метода выше
Преимущества Оптимизированных Файлов
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 | Runtime-Контроль | Влияние на Бандл | Идеально Для |
|---|---|---|---|
| <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-компонентов