package
An SVG loader for React
npm install react-inlinesvgGitHub-flavored package documentation.
Across all versions.
Download trend unavailable.
Runtime metadata.
Tagged topics.
Estimated unpacked size across 2 packages.
287.3 kB
Includes dependencies.
Load inline, local, or remote SVGs in your React components.
View the demo
srcnpm i react-inlinesvgAnd import it into your code:
import SVG from 'react-inlinesvg';
export default function App() {
return (
<main>
<SVG src="https://cdn.svglogos.dev/logos/react.svg" width={128} height="auto" title="React" />
</main>
);
}src {string} - required.
The SVG to load. It accepts:
baseURL {string}
A URL to prepend to url() references inside the SVG when using uniquifyIDs. Required if your page uses an HTML <base> tag.
children {ReactNode}
The fallback content in case of a fetch error or unsupported browser.
<SVG src="...">
<img src="..." alt="fallback" />
</SVG>cacheElements {boolean} ▶︎ false
Reuse the converted React element across mounts of the same SVG instead of parsing it every time. Use it for SVGs that mount often, like icons in virtualized lists. With uniquifyIDs, only instances that have a uniqueHash when they mount are cached.
The cache is shared by all instances (independent of the CacheProvider) and holds the 100 most recently used elements. Call clearElementCache() (exported from react-inlinesvg) to empty it, for example between tests.
cacheRequests {boolean} ▶︎ true
Cache remote SVGs in memory. When used with the CacheProvider, requests are also persisted in the browser cache.
description {string}
A description for your SVG. It will override an existing <desc> tag.
fetchOptions {RequestInit}
Custom options for the request.
innerRef {React.Ref<SVGElement | null>}
Set a ref on the SVG element.
The SVG is processed and parsed so the ref won't be set on the initial render.
You can use theonLoadcallback to get and use the ref instead.
loader {node}
A component to be shown while the SVG is loading.
onError {function}
A callback to be invoked if loading the SVG fails.
This will receive a single argument with:
FetchError with:{
message: string;
type: string;
errno: string;
code: string;
}Error for issues like missing src, unsupported browser, or invalid SVG content.onLoad {function}
A callback to be invoked upon successful load.
This will receive 2 arguments: the src prop and an isCached boolean
preProcessor {function}
A function to pre-process the SVG string before parsing. Receives the SVG string and must return a string.
title {string | null}
A title for your SVG. It will override an existing <title> tag.
If null is passed, the <title> tag will be removed.
uniqueHash {string} ▶︎ a random 8 characters string [A-Za-z0-9]
A string to use with uniquifyIDs.
uniquifyIDs {boolean} ▶︎ false
Create unique IDs for each icon.
Any additional props will be passed down to the SVG element.
<SVG
baseURL="/home"
cacheElements={false}
cacheRequests={true}
description="The React logo"
loader={<span>Loading...</span>}
onError={error => console.log(error.message)}
onLoad={(src, isCached) => console.log(src, isCached)}
preProcessor={code => code.replace(/fill=".*?"/g, 'fill="currentColor"')}
src="https://cdn.svglogos.dev/logos/react.svg"
title="React"
uniqueHash="a1f8d1"
uniquifyIDs={true}
You can use the browser's cache to store the SVGs permanently.
To set it up, wrap your app with the cache provider:
import { createRoot } from 'react-dom/client';
import CacheProvider from 'react-inlinesvg/provider';
import App from './App';
createRoot(document.getElementById('root')!).render(
<CacheProvider>
<App />
</CacheProvider>,
);The CacheProvider accepts an optional name prop to customize the cache storage name.
Be aware of the limitations of the Cache API.
Any browser that supports inlining SVGs and fetch will work.
If you need to support legacy browsers, include a polyfill for fetch in your app.
If you are loading remote SVGs, you must ensure they have CORS headers.
One reason SVGs are awesome is that you can style them with CSS.
Unfortunately, this is not useful in practice because the style element has to be in the same document. This leaves you with three bad options:
But there's an alternative that sidesteps these issues: load the SVG with a GET request and then embed it in the document. This is what this component does.
The SVG <use> element can be used to achieve something similar to this component. See this article for more information and this table for browser support and caveats.
Thanks to @matthewwithanm for creating this component and so kindly transferring it to me.
I'll definitely keep up the good work! ❤️