使用 gatsby-plugin-react-svg 导入 svgs 时收到“InvalidCharacterError: String contains an invalid character”

Question

I was using font-awesome svg icons, but I realized that they might be having a significant effect on the LCP of my website, so I'm trying to replace them. I went into my html and copied the svg code, and put these svg components into svg files. They open as images in my photoshop knockoff so I figured they should be good.

When I try to include them in on my page using

import FacebookIcon from '../images/svg/facebookF.svg'
import Email from '../images/svg/email.svg'

      <FacebookIcon />
      <Email /> 

And adding the following to my gatsby-config.js (after installing gatsby-plugin-react-svg

{
  resolve: 'gatsby-plugin-react-svg',
  options: {
    rule: {
      include: "/src/images/svg/"
    }
  }
}

I receive the error

InvalidCharacterError: String contains an invalid character

---

This error is happening in my MRE, which you can view on this Github repo . In my actual program the svgs were just not showing up, but the web page loaded fine.

Answer 1

From the create-react-app docs for adding SVG images as react components

Note: this feature is available with react-scripts@2.0.0 and higher, and react@16.3.0 and higher.

https://create-react-app.dev/docs/adding-images-fonts-and-files/

Try

import { ReactComponent as FacebookIcon } from '../images/svg/facebookF.svg';
import { ReactComponent as Email } from '../images/svg/email.svg';

...

  <FacebookIcon />
  <Email /> 

Answer 2

The included folder is a regular expression so, it must only contain a single path, /svg/ in your case. In addition, you need to remove the double quotes (what is causing your error since it's an invalid character):

{
  resolve: 'gatsby-plugin-react-svg',
  options: {
    rule: {
      include: /svg/
    }
  }
}

The rest of the code looks good.

Keep in mind that if the SVG shares any ID inside, it may cause severe issues since they will be replaced for the following inlined SVG. The ID s inside the SVG shapes must be different for each vector.

Answer 3

With react-scripts 5.0.1 + React 18.2.0 + TypeScript, I'm having to do this:

// custom.d.ts (in project root)
declare module "*.svg" {
  const content: string;
  export default content;
}

// MyComponent.tsx
import image from "./image.svg";

const MyComponent = () => {
  return <Image src={image} />;
};

Contrary to the docs , so can't promise this is the perfect way to do it. Looks elegant enough to me though.

For background info about custom.d.ts , see this StackOverflow answer .