Fork from react-native-svg

Fixed strokeDasharray failed to use animation with "useNativeDriver: true" attribute. look like:

<AnimatedCircle
  cx="15"
  cy="15"
  r="13"
  stroke={color}
  strokeWidth="2.5"
  strokeLinecap="round"
  strokeDasharray={this.animatedValue.interpolate({
    inputRange: [0, 50, 100],
    outputRange: [
      '8.1681408993,73.513268094',
      '40.8407044967,40.8407045967',
      '8.1681408993,73.513268094',
    ],
  })}
  fill="none"
/>

react-native-svg

react-native-svg provides SVG support to React Native on iOS and Android, and a compatibility layer for the web.

Check out the demo

Features

1. Supports most SVG elements and properties (Rect, Circle, Line, Polyline, Polygon, G ...).

2. Easy to convert SVG code to react-native-svg.

3. Installation

   • Automatically
   • Manually
     • Android
     • iOS
4. Troubleshooting
5. Opening issues
6. Usage
   • Use with content loaded from uri
   • Use with svg files
   • Use with xml strings
7. Common props
8. Supported elements
   • Svg
   • Rect
   • Circle
   • Ellipse
   • Line
   • Polygon
   • Polyline
   • Path
   • Text
   • TSpan
   • TextPath
   • G
   • Use
   • Symbol
   • Defs
   • Image
   • ClipPath
   • LinearGradient
   • RadialGradient
   • Mask
   • Pattern
   • Marker
   • ForeignObject
9. Touch Events
10. Serialize
11. Run example
12. TODO
13. Known issues

Installation

Automatically

With expo-cli

With Expo, you'll need to run expo install react-native-svg to install this library.

Please refer to Expo docs for more information or jump ahead to Usage.

With react-native-cli

1. Install library from npm

   yarn add react-native-svg

2. Link native code

   With autolinking (react-native 0.60+)

   cd ios && pod install

   Pre 0.60

   react-native link react-native-svg

NOTICE:

Due to breaking changes in react-native, the version given in the left column (and higher versions) of react-native-svg only supports the react-native version in the right column (and higher versions, if possible).

It is recommended to use the version of react given in the peer dependencies of the react-native version you are using.

The latest version of react-native-svg should always work in a clean react-native project.

Or, include this PR manually for v7+ stability on android for older RN ( included in 0.57-stable and newer).

The latest version of v6, v7, v8 and v9 should all work in the latest react-native version.

v7 and newer requires the patch for making android thread safe, to get native animation support.

Manually

Android pre RN 0.60

1. yarn add react-native-svg In RN 0.60+, this is all you should ever need to do get Android working. Before this, react-native link was responsible for the following steps:

2. Append the following lines to android/settings.gradle:

   include ':react-native-svg'
   project(':react-native-svg').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-svg/android')

3. Insert the following lines inside the dependencies block in android/app/build.gradle:

   implementation project(':react-native-svg')

4. Open up android/app/src/main/java/[...]/MainApplication.java

5. Add import com.horcrux.svg.SvgPackage; to the imports at the top of the file

6. Add new SvgPackage() to the list returned by the getPackages() method. Add a comma to the previous item if there's already something there.

iOS pre RN 0.60

Manual linking

To install react-native-svg on iOS visit the link referenced above or do the following (react-native link should do this for you):

1. Open your project in XCode and drag the RNSVG.xcodeproj file (located in .../node_modules/react-native-svg/ios) into the Libraries directory shown in XCode.
2. Expand the RNSVG.xcodeproj file you just added to XCode until you see: libRNSVG.a (located in RNSVG.xcodeproj > Products )
3. Drag libRNSVG.a into the Link Binary With Libraries section (located in Build Phases which may be found at the top of the XCode window)

CocoaPods

Alternatively, you can use CocoaPods to manage your native (Objective-C and Swift) dependencies:

1. Add RNSVG to your Podfile (with RN 0.60+ autolinking, this is not needed)

pod 'RNSVG', :path => '../node_modules/react-native-svg'

If cocoapods is used and if error RNSVGImage.m:12:9: 'React/RCTImageLoader.h' file not found occurs:

Add the following entry in Podfile:

    pod 'React', :path => '../node_modules/react-native', :subspecs => [
        [...]
        'RCTImage', # <-- Add RCTImage
    ]

and run pod install from ios folder

Troubleshooting

Problems with Proguard

When Proguard is enabled (which it is by default for Android release builds), it causes runtine error To avoid this, add an exception to android/app/proguard-rules.pro:

-keep public class com.horcrux.svg.** {*;}

If you have build errors, then it might be caused by caching issues, please try:

watchman watch-del-all
rm -fr $TMPDIR/react-*
react-native start --reset-cache

Or,

rm -rf node_modules
yarn
react-native start --reset-cache

Unexpected behavior

If you have unexpected behavior, please create a clean project with the latest versions of react-native and react-native-svg

react-native init CleanProject
cd CleanProject/
yarn add react-native-svg
cd ios && pod install && cd ..

Make a reproduction of the problem in App.js

react-native run-ios
react-native run-android

Opening issues

Verify that it is still an issue with the latest version as specified in the previous step. If so, open a new issue, include the entire App.js file, specify what platforms you've tested, and the results of running this command:

react-native info

If you suspect that you've found a spec conformance bug, then you can test using your component in a react-native-web project by forking this codesandbox, to see how different browsers render the same content: https://codesandbox.io/s/pypn6mn3y7 If any evergreen brower with significant userbase or other svg user agent renders some svg content better, or supports more of the svg and related specs, please open an issue asap.

Usage

Here's a simple example. To render output like this:

Use the following code:

import Svg, {
  Circle,
  Ellipse,
  G,
  Text,
  TSpan,
  TextPath,
  Path,
  Polygon,
  Polyline,
  Line,
  Rect,
  Use,
  Image,
  Symbol,
  Defs,
  LinearGradient,
  RadialGradient,
  Stop,
  ClipPath,
  Pattern,
  Mask,
} from 'react-native-svg';

/* Use this if you are using Expo
import * as Svg from 'react-native-svg';
const { Circle, Rect } = Svg;
*/

import React from 'react';
import { View, StyleSheet } from 'react-native';

export default class SvgExample extends React.Component {
  render() {
    return (
      <View
        style={[
          StyleSheet.absoluteFill,
          { alignItems: 'center', justifyContent: 'center' },
        ]}
      >
        <Svg height="50%" width="50%" viewBox="0 0 100 100">
          <Circle
            cx="50"
            cy="50"
            r="45"
            stroke="blue"
            strokeWidth="2.5"
            fill="green"
          />
          <Rect
            x="15"
            y="15"
            width="70"
            height="70"
            stroke="red"
            strokeWidth="2"
            fill="yellow"
          />
        </Svg>
      </View>
    );
  }
}

Try this on Snack

Use with content loaded from uri

import * as React from 'react';
import { SvgUri } from 'react-native-svg';

export default () => (
  <SvgUri
    width="100%"
    height="100%"
    uri="http://thenewcode.com/assets/images/thumbnails/homer-simpson.svg"
  />
);

CSS Support

If remote SVG file contains CSS in <style> element, use SvgCssUri:

import * as React from 'react';
import { SvgCssUri } from 'react-native-svg';

export default () => (
  <SvgCssUri
    width="100%"
    height="100%"
    uri="http://thenewcode.com/assets/svg/accessibility.svg"
  />
);

Use with svg files

Try react-native-svg-transformer to get compile time conversion and cached transformations. https://github.com/kristerkari/react-native-svg-transformer#installation-and-configuration https://github.com/kristerkari/react-native-svg-transformer#for-react-native-v057-or-newer--expo-sdk-v3100-or-newer

metro.config.js

const { getDefaultConfig } = require('metro-config');

module.exports = (async () => {
  const {
    resolver: { sourceExts, assetExts },
  } = await getDefaultConfig();
  return {
    transformer: {
      babelTransformerPath: require.resolve('react-native-svg-transformer'),
    },
    resolver: {
      assetExts: assetExts.filter(ext => ext !== 'svg'),
      sourceExts: [...sourceExts, 'svg'],
    },
  };
})();

Import your .svg file inside a React component:

import Logo from './logo.svg';

You can then use your image as a component:

<Logo width={120} height={40} />

Alternatively, you can use SvgXml with babel-plugin-inline-import, but with transforms done at run-time.

.babelrc

{
  "presets": ["module:metro-react-native-babel-preset"],
  "plugins": [
    [
      "babel-plugin-inline-import",
      {
        "extensions": [".svg"]
      }
    ]
  ]
}

App.js

import * as React from 'react';
import { SvgXml } from 'react-native-svg';
import testSvg from './test.svg';
export default () => <SvgXml width="200" height="200" xml={testSvg} />;

Use with xml strings

import * as React from 'react';
import { SvgXml } from 'react-native-svg';

const xml = `
  <svg width="32" height="32" viewBox="0 0 32 32">
    <path
      fill-rule="evenodd"
      clip-rule="evenodd"
      fill="url(#gradient)"
      d="M4 0C1.79086 0 0 1.79086 0 4V28C0 30.2091 1.79086 32 4 32H28C30.2091 32 32 30.2091 32 28V4C32 1.79086 30.2091 0 28 0H4ZM17 6C17 5.44772 17.4477 5 18 5H20C20.5523 5 21 5.44772 21 6V25C21 25.5523 20.5523 26 20 26H18C17.4477 26 17 25.5523 17 25V6ZM12 11C11.4477 11 11 11.4477 11 12V25C11 25.5523 11.4477 26 12 26H14C14.5523 26 15 25.5523 15 25V12C15 11.4477 14.5523 11 14 11H12ZM6 18C5.44772 18 5 18.4477 5 19V25C5 25.5523 5.44772 26 6 26H8C8.55228 26 9 25.5523 9 25V19C9 18.4477 8.55228 18 8 18H6ZM24 14C23.4477 14 23 14.4477 23 15V25C23 25.5523 23.4477 26 24 26H26C26.5523 26 27 25.5523 27 25V15C27 14.4477 26.5523 14 26 14H24Z"
    />
    <defs>
      <linearGradient
        id="gradient"
        x1="0"
        y1="0"
        x2="8.46631"
        y2="37.3364"
        gradient-units="userSpaceOnUse">
        <stop offset="0" stop-color="#FEA267" />
        <stop offset="1" stop-color="#E75A4C" />
      </linearGradient>
    </defs>
  </svg>
`;

export default () => <SvgXml xml={xml} width="100%" height="100%" />;

CSS support

If xml string contains CSS in <style> element, use SvgCss:

import * as React from 'react';
import { SvgCss } from 'react-native-svg';

const xml = `
  <svg width="32" height="32" viewBox="0 0 32 32">
    <style>
      .red {
        fill: #ff0000;
      }
    </style>
    <rect class="red" x="0" y="0" width="32" height="32" />
  </svg>
`;

export default () => <SvgCss xml={xml} width="100%" height="100%" />;

Common props:

Supported elements:

Svg

<Svg height="100" width="100">
  <Rect x="0" y="0" width="100" height="100" fill="black" />
  <Circle cx="50" cy="50" r="30" fill="yellow" />
  <Circle cx="40" cy="40" r="4" fill="black" />
  <Circle cx="60" cy="40" r="4" fill="black" />
  <Path d="M 40 60 A 10 10 0 0 0 60 60" stroke="black" />
</Svg>

Colors set in the Svg element are inherited by its children:

<Svg
  width="130"
  height="130"
  fill="blue"
  stroke="red"
  color="green"
  viewBox="-16 -16 544 544"
>
  <Path
    d="M318.37,85.45L422.53,190.11,158.89,455,54.79,350.38ZM501.56,60.2L455.11,13.53a45.93,45.93,0,0,0-65.11,0L345.51,58.24,449.66,162.9l51.9-52.15A35.8,35.8,0,0,0,501.56,60.2ZM0.29,497.49a11.88,11.88,0,0,0,14.34,14.17l116.06-28.28L26.59,378.72Z"
    strokeWidth="32"
  />
  <Path d="M0,0L512,512" stroke="currentColor" strokeWidth="32" />
</Svg>

Code explanation:

• The fill prop defines the color inside the object.
• The stroke prop defines the color of the line drawn around the object.
• The color prop is a bit special in the sense that it won't color anything by itself, but define a kind of color variable that can be used by children elements. In this example we're defining a "green" color in the Svg element and using it in the second Path element via stroke="currentColor". The "currentColor" is what refers to that "green" value, and it can be used in other props that accept colors too, e.g. fill="currentColor".

Rect

The <Rect> element is used to create a rectangle and variations of a rectangle shape:

<Svg width="200" height="60">
  <Rect
    x="25"
    y="5"
    width="150"
    height="50"
    fill="rgb(0,0,255)"
    strokeWidth="3"
    stroke="rgb(0,0,0)"
  />
</Svg>

Code explanation:

• The width and height props of the <Rect> element define the height and the width of the rectangle.
• The x prop defines the left position of the rectangle (e.g. x="25" places the rectangle 25 px from the left margin).
• The y prop defines the top position of the rectangle (e.g. y="5" places the rectangle 5 px from the top margin).

Circle

The <Circle> element is used to create a circle:

<Svg height="100" width="100">
  <Circle cx="50" cy="50" r="50" fill="pink" />
</Svg>

Code explanation:

• The cx and cy props define the x and y coordinates of the center of the circle. If cx and cy are omitted, the circle's center is set to (0,0)
• The r prop defines the radius of the circle

Ellipse

The <Ellipse> element is used to create an ellipse.

An ellipse is closely related to a circle. The difference is that an ellipse has an x and a y radius that differs from each other, while a circle has equal x and y radius.

<Svg height="100" width="110">
  <Ellipse
    cx="55"
    cy="55"
    rx="50"
    ry="30"
    stroke="purple"
    strokeWidth="2"
    fill="yellow"
  />
</Svg>

Code explanation:

• The cx prop defines the x coordinate of the center of the ellipse
• The cy prop defines the y coordinate of the center of the ellipse
• The rx prop defines the horizontal radius
• The ry prop defines the vertical radius

Line

The <Line> element is an SVG basic shape, used to create a line connecting two points.

<Svg height="100" width="100">
  <Line x1="0" y1="0" x2="100" y2="100" stroke="red" strokeWidth="2" />
</Svg>

Code explanation:

• The x1 prop defines the start of the line on the x-axis.
• The y1 prop defines the start of the line on the y-axis.
• The x2 prop defines the end of the line on the x-axis.
• The y2 prop defines the end of the line on the y-axis.

Polygon

The <Polygon> element is used to create a graphic that contains at least three sides. Polygons are made of straight lines, and the shape is "closed" (all the lines connect up).

<Svg height="100" width="100">
  <Polygon
    points="40,5 70,80 25,95"
    fill="lime"
    stroke="purple"
    strokeWidth="1"
  />
</Svg>

Code explanation:

• The points prop defines the x and y coordinates for each corner of the polygon

Polyline

The <Polyline> element is used to create any shape that consists of only straight lines:

<Svg height="100" width="100">
  <Polyline
    points="10,10 20,12 30,20 40,60 60,70 95,90"
    fill="none"
    stroke="black"
    strokeWidth="3"
  />
</Svg>

Code explanation:

• The points prop defines the x and y coordinates for each point of the polyline

Path

The <Path> element is used to define a path.

The following commands are available for path data:

• M = moveto
• L = lineto
• H = horizontal lineto
• V = vertical lineto
• C = curveto
• S = smooth curveto
• Q = quadratic Bézier curve
• T = smooth quadratic Bézier curveto
• A = elliptical Arc
• Z = closepath

Note: All of the commands above can also be expressed with lower letters. Capital letters means absolutely positioned, lower cases means relatively positioned. See Path document of SVG to know parameters for each command.

<Svg height="100" width="100">
  <Path
    d="M25 10 L98 65 L70 25 L16 77 L11 30 L0 4 L90 50 L50 10 L11 22 L77 95 L20 25"
    fill="none"
    stroke="red"
  />
</Svg>

Text

The <Text> element is used to define text.

<Svg height="60" width="200">
  <Text
    fill="none"
    stroke="purple"
    fontSize="20"
    fontWeight="bold"
    x="100"
    y="20"
    textAnchor="middle"
  >
    STROKED TEXT
  </Text>
</Svg>

TSpan

The <TSpan> element is used to draw multiple lines of text in SVG. Rather than having to position each line of text absolutely, the <TSpan> element makes it possible to position a line of text relatively to the previous line of text.

<Svg height="160" width="200">
  <Text y="20" dx="5 5">
    <TSpan x="10">tspan line 1</TSpan>
    <TSpan x="10" dy="15">
      tspan line 2
    </TSpan>
    <TSpan x="10" dx="10" dy="15">
      tspan line 3
    </TSpan>
  </Text>
  <Text x="10" y="60" fill="red" fontSize="14">
    <TSpan dy="5 10 20">12345</TSpan>
    <TSpan fill="blue" dy="15" dx="0 5 5">
      <TSpan>6</TSpan>
      <TSpan>7</TSpan>
    </TSpan>
    <TSpan dx="0 10 20" dy="0 20" fontWeight="bold" fontSize="12">
      89a
    </TSpan>
  </Text>
  <Text y="140" dx="0 5 5" dy="0 -5 -5">
    delta on text
  </Text>
</Svg>

TextPath

In addition to text drawn in a straight line, SVG also includes the ability to place text along the shape of a <Path> element. To specify that a block of text is to be rendered along the shape of a <Path>, include the given text within a <TextPath> element which includes an href attribute with a reference to a <Path> element.

<Svg height="100" width="200">
  <Defs>
    <Path id="path" d={path} />
  </Defs>
  <G y="20">
    <Text fill="blue">
      <TextPath href="#path" startOffset="-10%">
        We go up and down,
        <TSpan fill="red" dy="5,5,5">
          then up again
        </TSpan>
      </TextPath>
    </Text>
    <Path d={path} fill="none" stroke="red" strokeWidth="1" />
  </G>
</Svg>

G

The <G> element is a container used to group other SVG elements. Transformations applied to the g element are performed on all of its child elements, and any of its props are inherited by its child elements. It can also group multiple elements to be referenced later with the <Use /> element.

<Svg height="100" width="200">
  <G rotation="50" origin="100, 50">
    <Line x1="60" y1="10" x2="140" y2="10" stroke="#060" />

    <Rect x="60" y="20" height="50" width="80" stroke="#060" fill="#060" />

    <Text x="100" y="75" stroke="#600" fill="#600" textAnchor="middle">
      Text grouped with shapes
    </Text>
  </G>
</Svg>

Use

The <Use> element can reuse an SVG shape from elsewhere in the SVG document, including <G> elements and <Symbol> elements. The reused shape can be defined inside the <Defs> element (which makes the shape invisible until used) or outside.

<Svg height="100" width="300">
  <Defs>
    <G id="shape">
      <G>
        <Circle cx="50" cy="50" r="50" />
        <Rect x="50" y="50" width="50" height="50" />
        <Circle cx="50" cy="50" r="5" fill="blue" />
      </G>
    </G>
  </Defs>
  <Use href="#shape" x="20" y="0" />
  <Use href="#shape" x="170" y="0" />
</Svg>

This example shows a <G> element defined inside a <Defs> element. This makes the <G> invisible unless referenced by a <Use> element.

Before the <G> element can be referenced, it must have an ID set on it via its id prop. The <Use> element references the <G> element via its href prop. Notice the # in front of the ID in the prop value.

The <Use> element specifies where to show the reused shapes via its x and y props. Notice that the shapes inside the <G> element are located at 0,0. That is done because their position is added to the position specified in the <Use> element.

Symbol

The SVG <Symbol> element is used to define reusable symbols. The shapes nested inside a <Symbol> are not displayed unless referenced by a <Use> element.

<Svg height="150" width="110">
  <Symbol id="symbol" viewBox="0 0 150 110" width="100" height="50">
    <Circle cx="50" cy="50" r="40" strokeWidth="8" stroke="red" fill="red" />
    <Circle
      cx="90"
      cy="60"
      r="40"
      strokeWidth="8"
      stroke="green"
      fill="white"
    />
  </Symbol>

  <Use href="#symbol" x="0" y="0" />
  <Use href="#symbol" x="0" y="50" width="75" height="38" />
  <Use href="#symbol" x="0" y="100" width="50" height="25" />
</Svg>

Defs

The <Defs> element is used to embed definitions that can be reused inside an SVG image. For instance, you can group SVG shapes together and reuse them as a single shape.

Image

The <Image> element allows a raster image to be included in an Svg component.

<Svg height="100" width="100">
  <Defs>
    <ClipPath id="clip">
      <Circle cx="50%" cy="50%" r="40%" />
    </ClipPath>
  </Defs>
  <Rect x="0" y="0" width="100%" height="100%" fill="red" />
  <Rect x="5%" y="5%" width="50%" height="90%" />

  <Image
    x="5%"
    y="5%"
    width="50%"
    height="90%"
    preserveAspectRatio="xMidYMid slice"
    opacity="0.5"
    href={require('../image.jpg')}
    clipPath="url(#clip)"
  />
  <Text
    x="50"
    y="50"
    textAnchor="middle"
    fontWeight="bold"
    fontSize="16"
    fill="blue"
  >
    HOGWARTS
  </Text>
</Svg>

ClipPath

The <ClipPath> SVG element defines a clipping path. A clipping path is used/referenced using the clipPath property

<Svg height="100" width="100">
  <Defs>
    <RadialGradient
      id="grad"
      cx="50%"
      cy="50%"
      rx="50%"
      ry="50%"
      fx="50%"
      fy="50%"
      gradientUnits="userSpaceOnUse"
    >
      <Stop offset="0%" stopColor="#ff0" stopOpacity="1" />
      <Stop offset="100%" stopColor="#00f" stopOpacity="1" />
    </RadialGradient>
    <ClipPath id="clip">
      <G scale="0.9" x="10">
        <Circle cx="30" cy="30" r="20" />
        <Ellipse cx="60" cy="70" rx="20" ry="10" />
        <Rect x="65" y="15" width="30" height="30" />
        <Polygon points="20,60 20,80 50,70" />
        <Text
          x="50"
          y="30"
          fontSize="32"
          fonWeight="bold"
          textAnchor="middle"
          scale="1.2"
        >
          Q
        </Text>
      </G>
    </ClipPath>
  </Defs>
  <Rect
    x="0"
    y="0"
    width="100"
    height="100"
    fill="url(#grad)"
    clipPath="url(#clip)"
  />
</Svg>

LinearGradient

The <LinearGradient> element is used to define a linear gradient. The <LinearGradient> element must be nested within a <Defs> tag. The <Defs> tag is short for definitions and contains definition of special elements (such as gradients).

Linear gradients can be defined as horizontal, vertical or angular gradients:

• Horizontal gradients are created when y1 and y2 are equal and x1 and x2 differ
• Vertical gradients are created when x1 and x2 are equal and y1 and y2 differ
• Angular gradients are created when x1 and x2 differ and y1 and y2 differ

<Svg height="150" width="300">
  <Defs>
    <LinearGradient id="grad" x1="0" y1="0" x2="1" y2="0">
      <Stop offset="0" stopColor="#FFD080" stopOpacity="1" />
      <Stop offset="1" stopColor="red" stopOpacity="1" />
    </LinearGradient>
  </Defs>
  <Ellipse cx="150" cy="75" rx="85" ry="55" fill="url(#grad)" />
</Svg>

Code explanation:

• The id prop of the <LinearGradient> tag defines a unique name for the gradient
• The x1, x2, y1,y2 props of the <LinearGradient> tag define the start and end position of the gradient
• The color range for a gradient can be composed of two or more colors. Each color is specified with a <Stop> tag. The offset prop is used to define where the gradient color begin and end
• The fill prop links the ellipse element to the gradient

NOTICE: LinearGradient also supports percentage as prop:

<LinearGradient id="grad" x1="0%" y1="0%" x2="100%" y2="0%">
  <Stop offset="0%" stopColor="rgb(255,255,0)" stopOpacity="0" />
  <Stop offset="100%" stopColor="red" stopOpacity="1" />
</LinearGradient>

This result is same as the example before. But it's recommend to use exact number instead; it has performance advantages over using percentages.

RadialGradient

The <RadialGradient> element is used to define a radial gradient. The <RadialGradient> element must be nested within a <Defs> tag. The <Defs> tag is short for definitions and contains definition of special elements (such as gradients).

<Svg height="150" width="300">
  <Defs>
    <RadialGradient
      id="grad"
      cx="150"
      cy="75"
      rx="85"
      ry="55"
      fx="150"
      fy="75"
      gradientUnits="userSpaceOnUse"
    >
      <Stop offset="0" stopColor="#ff0" stopOpacity="1" />
      <Stop offset="1" stopColor="#83a" stopOpacity="1" />
    </RadialGradient>
  </Defs>
  <Ellipse cx="150" cy="75" rx="85" ry="55" fill="url(#grad)" />
</Svg>

Code explanation:

• The id prop of the <radialGradient> tag defines a unique name for the gradient
• The cx, cy and r props define the outermost circle and the fx and fy define the innermost circle
• The color range for a gradient can be composed of two or more colors. Each color is specified with a <stop> tag. The offset prop is used to define where the gradient color begin and end
• The fill prop links the ellipse element to the gradient

Mask

In SVG, you can specify that any other graphics object or ‘G’ element can be used as an alpha mask for compositing the current object into the background.

A mask is defined with a ‘Mask’ element. A mask is used/referenced using the ‘mask’ property.

A ‘Mask’ can contain any graphical elements or container elements such as a ‘G’.

The <Mask> element must be nested within a <Defs> tag. The <Defs> tag is short for definitions and contains definition of special elements (such as gradients).

https://www.w3.org/TR/SVG11/images/masking/mask01.svg

<Svg width="100%" height="100%" viewBox="0 0 800 300">
  <Defs>
    <LinearGradient
      id="Gradient"
      gradientUnits="userSpaceOnUse"
      x1="0"
      y1="0"
      x2="800"
      y2="0"
    >
      <Stop offset="0" stopColor="white" stopOpacity="0" />
      <Stop offset="1" stopColor="white" stopOpacity="1" />
    </LinearGradient>
    <Mask
      id="Mask"
      maskUnits="userSpaceOnUse"
      x="0"
      y="0"
      width="800"
      height="300"
    >
      <Rect x="0" y="0" width="800" height="300" fill="url(#Gradient)" />
    </Mask>
    <Text
      id="Text"
      x="400"
      y="200"
      fontFamily="Verdana"
      fontSize="100"
      textAnchor="middle"
    >
      Masked text
    </Text>
  </Defs>
  <Rect x="0" y="0" width="800" height="300" fill="#FF8080" />
  <Use href="#Text" fill="blue" mask="url(#Mask)" />
  <Use href="#Text" fill="none" stroke="black" stroke-width="2" />
</Svg>

Code explanation: https://www.w3.org/TR/SVG11/masking.html#MaskElement

v10 adds experimental support for using masks together with native elements. If you had native elements inside any Svg root before (which was unsupported), Then your content might change appearance when upgrading, as e.g. transforms and masks now take effect.

Pattern

A pattern is used to fill or stroke an object using a pre-defined graphic object which can be replicated ("tiled") at fixed intervals in x and y to cover the areas to be painted. Patterns are defined using a ‘pattern’ element and then referenced by properties ‘fill’ and ‘stroke’ on a given graphics element to indicate that the given element shall be filled or stroked with the referenced pattern. The <Pattern> element must be nested within a <Defs> tag. The <Defs> tag is short for definitions and contains definition of special elements (such as gradients).

https://www.w3.org/TR/SVG11/images/pservers/pattern01.svg

<Svg width="100%" height="100%" viewBox="0 0 800 400">
  <Defs>
    <Pattern
      id="TrianglePattern"
      patternUnits="userSpaceOnUse"
      x="0"
      y="0"
      width="100"
      height="100"
      viewBox="0 0 10 10"
    >
      <Path d="M 0 0 L 7 0 L 3.5 7 z" fill="red" stroke="blue" />
    </Pattern>
  </Defs>
  <Rect fill="none" stroke="blue" x="1" y="1" width="798" height="398" />
  <Ellipse
    fill="url(#TrianglePattern)"
    stroke="black"
    strokeWidth="5"
    cx="400"
    cy="200"
    rx="350"
    ry="150"
  />
</Svg>

Code explanation: https://www.w3.org/TR/SVG11/pservers.html#PatternElement

Marker

A marker is a symbol which is attached to one or more vertices of ‘path’, ‘line’, ‘polyline’ and ‘polygon’ elements. Typically, markers are used to make arrowheads or polymarkers. Arrowheads can be defined by attaching a marker to the start or end vertices of ‘path’, ‘line’ or ‘polyline’ elements. Polymarkers can be defined by attaching a marker to all vertices of a ‘path’, ‘line’, ‘polyline’ or ‘polygon’ element.

The graphics for a marker are defined by a ‘marker’ element. To indicate that a particular ‘marker’ element should be rendered at the vertices of a particular ‘path’, ‘line’, ‘polyline’ or ‘polygon’ element, set one or more marker properties (‘marker’, ‘marker-start’, ‘marker-mid’ or ‘marker-end’) to reference the given ‘marker’ element.

https://www.w3.org/TR/SVG11/images/painting/marker.svg

<Svg width="400" height="200" viewBox="0 0 4000 2000">
  <Defs>
    <Marker
      id="Triangle"
      viewBox="0 0 10 10"
      refX="0"
      refY="5"
      markerUnits="strokeWidth"
      markerWidth="4"
      markerHeight="3"
      orient="auto"
    >
      <Path d="M 0 0 L 10 5 L 0 10 z" />
    </Marker>
  </Defs>
  <Rect
    x="10"
    y="10"
    width="3980"
    height="1980"
    fill="none"
    stroke="blue"
    strokeWidth="10"
  />
  <Path
    d="M 1000 750 L 2000 750 L 2500 1250"
    fill="none"
    stroke="black"
    strokeWidth="100"
    markerEnd="url(#Triangle)"
  />
</Svg>

Code explanation: https://www.w3.org/TR/SVG11/painting.html#Markers

import React from 'react';
import { StyleSheet, View } from 'react-native';
import { SvgXml } from 'react-native-svg';

const markerRendering = `<svg xmlns="http://www.w3.org/2000/svg"
     width="275" height="200" viewBox="0 0 100 30">
  <defs>
    <marker id="m1" viewBox="0 0 10 10" refX="5" refY="5"
     markerWidth="8" markerHeight="8">
      <circle cx="5" cy="5" r="5" fill="green"/>
    </marker>
    <marker id="m2" viewBox="0 0 10 10" refX="5" refY="5"
     markerWidth="6.5" markerHeight="6.5">
      <circle cx="5" cy="5" r="5" fill="skyblue" opacity="0.9"/>
    </marker>
    <marker id="m3" viewBox="0 0 10 10" refX="5" refY="5"
     markerWidth="5" markerHeight="5">
      <circle cx="5" cy="5" r="5" fill="maroon" opacity="0.85"/>
    </marker>
  </defs>

  <path d="M10,10 h10 v10 z m20,0 h10 v10 z m20,0 h10 v10 z"
  fill="none" stroke="black"
  marker-start="url(#m1)"
  marker-mid="url(#m2)"
  marker-end="url(#m3)"
  />
</svg>`;

export default class App extends React.Component {
  render() {
    return (
      <View style={styles.container}>
        <SvgXml xml={markerRendering} />
      </View>
    );
  }
}

const styles = StyleSheet.create({
  container: {
    backgroundColor: 'white',
    justifyContent: 'center',
    alignItems: 'center',
    flex: 1,
  },
});

import React from 'react';
import { StyleSheet, View } from 'react-native';
import { SvgXml } from 'react-native-svg';

const markerRendering = `<svg xmlns="http://www.w3.org/2000/svg"
     width="275" height="200" viewBox="0 0 275 200">
  <defs>
    <marker id="Triangle" viewBox="0 0 10 10" refX="1" refY="5"
            markerUnits="strokeWidth" markerWidth="4" markerHeight="3"
            orient="auto">
      <path d="M 0 0 L 10 5 L 0 10 z" fill="context-stroke" />
    </marker>
  </defs>

  <g fill="none" stroke-width="10" marker-end="url(#Triangle)">
    <path stroke="crimson" d="M 100,75 C 125,50 150,50 175,75" marker-end="url(#Triangle)"/>
    <path stroke="olivedrab" d="M 175,125 C 150,150 125,150 100,125" marker-end="url(#Triangle)"/>
  </g>
</svg>`;

export default class App extends React.Component {
  render() {
    return (
      <View style={styles.container}>
        <SvgXml xml={markerRendering} />
      </View>
    );
  }
}

const styles = StyleSheet.create({
  container: {
    backgroundColor: 'white',
    justifyContent: 'center',
    alignItems: 'center',
    flex: 1,
  },
});

Code explanation: https://www.w3.org/TR/SVG2/painting.html#VertexMarkerProperties

ForeignObject

SVG is designed to be compatible with other XML languages for describing and rendering other types of content. The ‘foreignObject’ element allows for inclusion of elements in a non-SVG namespace which is rendered within a region of the SVG graphic using other user agent processes. The included foreign graphical content is subject to SVG transformations, filters, clipping, masking and compositing.

One goal for SVG is to provide a mechanism by which other XML language processors can render into an area within an SVG drawing, with those renderings subject to the various transformations and compositing parameters that are currently active at a given point within the SVG content tree. One particular example of this is to provide a frame for XML content styled with CSS or XSL so that dynamically reflowing text (subject to SVG transformations and compositing) could be inserted into the middle of some SVG content.

https://svgwg.org/svg2-draft/embedded.html#ForeignObjectElement https://www.w3.org/TR/SVG11/extend.html#ForeignObjectElement

import React, { Component } from 'react';
import { Text, View, Image } from 'react-native';
import {
  Svg,
  Defs,
  LinearGradient,
  Stop,
  Mask,
  Rect,
  G,
  Circle,
  ForeignObject,
} from 'react-native-svg';

export default class App extends Component {
  render() {
    return (
      <View style={{ flex: 1, justifyContent: 'center' }}>
        <Svg height="50%">
          <Defs>
            <LinearGradient
              id="Gradient"
              gradientUnits="userSpaceOnUse"
              x1="0"
              y1="0"
              x2="800"
              y2="0"
            >
              <Stop offset="0" stopColor="white" stopOpacity="0.2" />
              <Stop offset="1" stopColor="white" stopOpacity="1" />
            </LinearGradient>
            <Mask
              id="Mask"
              maskUnits="userSpaceOnUse"
              x="0"
              y="0"
              width="800"
              height="300"
            >
              <Rect
                x="0"
                y="0"
                width="800"
                height="300"
                fill="url(#Gradient)"
              />
            </Mask>
          </Defs>
          <G mask="url(#Mask)">
            <Circle cx={50} cy={70} r={65} />
            <ForeignObject x={50} y={0} width={100} height={100}>
              <View style={{ width: 200, height: 400, transform: [] }}>
                <Image
                  style={{ width: 200, height: 200 }}
                  source={{
                    uri: 'https://picsum.photos/200/200',
                  }}
                />
              </View>
            </ForeignObject>
            <ForeignObject x={55} y={5} width={100} height={100}>
              <View style={{ width: 200, height: 400, transform: [] }}>
                <Text style={{ color: 'blue' }}>Testing</Text>
                <Text style={{ color: 'green' }}>Testing2</Text>
              </View>
            </ForeignObject>
          </G>
        </Svg>
      </View>
    );
  }
}

Touch Events

Touch events are supported in react-native-svg. These include:

• disabled
• onPress
• onPressIn
• onPressOut
• onLongPress
• delayPressIn
• delayPressOut
• delayLongPress

You can use these events to provide interactivity to your react-native-svg components.

<Circle
  cx="50%"
  cy="50%"
  r="38%"
  fill="red"
  onPress={() => alert('Press on Circle')}
/>

For more examples of touch in action, checkout the TouchEvents.js examples.

Serialize

import * as React from 'react';
import { Platform, StyleSheet, TouchableOpacity } from 'react-native';
import { Svg, Rect } from 'react-native-svg';
import ReactDOMServer from 'react-dom/server';

const isWeb = Platform.OS === 'web';

const childToWeb = child => {
  const { type, props } = child;
  const name = type && type.displayName;
  const webName = name && name[0].toLowerCase() + name.slice(1);
  const Tag = webName ? webName : type;
  return <Tag {...props}>{toWeb(props.children)}</Tag>;
};

const toWeb = children => React.Children.map(children, childToWeb);

export default class App extends React.Component {
  renderSvg() {
    return (
      <Svg height="100%" width="100%" style={{ backgroundColor: '#33AAFF' }}>
        <Rect
          x="50"
          y="50"
          width="50"
          height="50"
          fill="#3399ff"
          strokeWidth="3"
          stroke="rgb(0,0,0)"
        />
      </Svg>
    );
  }
  serialize = () => {
    const element = this.renderSvg();
    const webJsx = isWeb ? element : toWeb(element);
    const svgString = ReactDOMServer.renderToStaticMarkup(webJsx);
    console.log(svgString);
  };
  render() {
    return (
      <TouchableOpacity style={styles.container} onPress={this.serialize}>
        {this.renderSvg()}
      </TouchableOpacity>
    );
  }
}

const styles = StyleSheet.create({
  container: {
    flex: 1,
    justifyContent: 'center',
    backgroundColor: '#ecf0f1',
    padding: 8,
  },
});

Run example:

git clone https://github.com/magicismight/react-native-svg-example.git
cd react-native-svg-example
yarn

# run Android: react-native run-android
# run iOS: react-native run-ios

TODO:

1. Filters

Known issues:

1. Unable to apply focus point of RadialGradient on Android.

12.1.1 (2021-01-07)

Bug Fixes

• strokeDasharray failed to use animation with "useNativeDriver: true" attribute. (4cc51ce)

12.1.0 (2020-04-09)

Bug Fixes

• web: improve react-native-web version compatibility (88953c3)

Features

• implement WithLocalSvg (e66e87a)
• Support local .svg files, fixes #1306 (4e9e8b5)
• svgUri: add onError prop to SvgUri/Xml/Ast (3c32a6f)

12.0.3 (2020-03-08)

Bug Fixes

• android: default cap, join and handling of null matrix (df4ff9c)
• ios: #1290 pointerEvents="none" gesture handling (11d14fd)
• #1290 pointerEvents="none" (bd78998)

12.0.2 (2020-03-05)

Bug Fixes

• #1262 support single dimension + aspectRatio syntax (b2f7605)

12.0.1 (2020-03-05)

Bug Fixes

• #1262 allow setting width and height using stylesheet (c5374b2)
• react-native 0.59 compat (c4dba22)

12.0.0 (2020-03-04)

• fix!: #1262 default width and height on svg (1d6798b), closes #1262
• fix!: #1247 Animated view translation inside Svg tag (0288d95), closes #1247 #1258

Bug Fixes

• ios: handle gradient and pattern transform when null (715e9b8)
• ios: pod install error (675df92)
• web: #1274 Unable to build using babel-plugin-react-native-web (80b5064)
• removed missing unnecessary React headers import error caused by non-framework style import (f795029)

Performance Improvements

• optimize extraction of fill, stroke, responder, matrix & display (279c3fc)
• optimize handling of font properties in G elements (0fa4177)
• optimize handling of inherited styles (363c1b4)
• optimize svg root prop handling, simplify element development (f0cd11d)

BREAKING CHANGES

• default size might change if width or height is missing
• Behavior of native elements is reverted to pre v10

11.0.1 (2020-01-18)

Bug Fixes

• snapshot (a37afcb)

Performance Improvements

• optimize passing of colors to native (f138c9b)

11.0.0 (2020-01-18)

Bug Fixes

• compatibility with reanimated color, fixes #1241 (4983766)
• android: NullPointerException when calling getBBox #1215 (3eb82a9)
• android: support animating stroke color (c5dd62f)
• android: support setting path null (2d34734)
• ios: iOS 10.3 renders opaque background when drawRect is defined (61bc9bd), closes #1252
• web: Allow createElement & unstable_createElement usage (#1240) (7a23968)

• fix(android)!: pivot point for RN transform array syntax (db682f8)

BREAKING CHANGES

• Makes android specific transform origin adjustments unnecessary / broken. Renders exactly the same as web and ios instead.

10.1.0 (2020-01-12)

Bug Fixes

• android: improve handling of native ancestors (89f4432)
• ios: compile warning (e59c0fb)
• ios: initial render foreignObject / re-render on mount of sub views (d549698)
• ios: invalidate G / foreignObject on change in native children (65cee78)
• foreignObject clipping and transform (85e7943)

Features

• ForeignObject documentation (529b3bf)

10.0.0 (2020-01-04)

• feat!: Masks now support native elements (966881a)

BREAKING CHANGES

• If you had native elements inside any Svg root before, Then your content might change appearance when upgrading, as e.g. transforms and masks now take effect.

9.14.0 (2020-01-04)

Bug Fixes

• android: correct values for measureInWindow, fixes #1231 (3bf07f8)
• android: elements not touchable if below opacity limit (ebc7220), closes #1200
• android: fix radial gradient vertical center offset scaling (d5bddd5)
• ios: crash when offset is outside range #1201 (a2ef51f)
• web: fix gesture responder dimensions measurement (36c20b3)
• extraction of clip rule, fixes #1233 (f93bdde)
• Text color doesn't work with inlineSize #1225 (027b8c1)

Features

• android: support using other native views in e.g. masks (15b4ac6)
• ios: support using other native views in e.g. masks (518a3b1)
• web: Implement support for event, touch & responder handlers (60561ec)
• web: Optimize: only set responders if press handler exists (23250ad)
• Implement display="none" (3e3ad13), closes #1220

9.13.6 (2019-12-10)

Bug Fixes

• android: better npm ignores (7bc717b)

9.13.5 (2019-12-09)

Bug Fixes

• android: deprecation warning in TSpanView (6035d2d)

9.13.4 (2019-12-09)

Bug Fixes

• initialize PathView with empty path (45192bd)
• ios: Fix image size when calling getDataURL with bounds. fixes #855 (45b0859)

9.13.3 (2019-10-25)

Bug Fixes

• android: Image onPress #1170 (5c967b7)

9.13.2 (2019-10-23)

Bug Fixes

• make css-select and css-tree dependencies instead of peers (957914d), closes #1166

9.13.1 (2019-10-23)

Bug Fixes

• update flow types (a50a856)

9.13.0 (2019-10-23)

Bug Fixes

• camelCase css from style elements (9ee5a28)
• don't overwrite inline styles when inlining style elements (6e1d825)
• handle basic css media query selectors (168ee25)
• handle style elements with CDATA (b3fca84)
• improve style element inlining, support more selectors and optimize (8c9de72)
• improve types for extractTransform (a37ebbb)
• only compute selector specificity once per selector (9f53e31)
• types for css support (c969159)
• use correct import in test (a57963e)

Features

• implement experiment to inline css from style elements (5f3852b)
• implement SvgWithCss and SvgWithCssUri with Animated support (6fb8dd5)

9.12.0 (2019-10-19)

Bug Fixes

• handle setting transform attribute on clipPath, fixes #1152 (73b21d1)
• improve handling of transform attribute on clipPath, fixes #1152 (3aa126e)
• ios: backwards compatible RCTImageLoader.h handling fixes #1141 (3c22c97)
• ios: clipPath rendering, fixes #1131 (2534537)
• ios: deprecation of RCTImageLoader fixes #1141 (5452144)
• ios: fix changes in color/currentColor/tintColor, fixes #1151 (0c7e94d)
• ios: image viewBox opposite handling of y alignment, fixes #1138 (c69e9e2)
• js: allow setting stopColor/Opacity/Offset using styles, fix #1153 (5984e06)
• getPointAtLength signature (2c57af2)
• getScreenCTM calculation (5c5072d)
• improve native method spec conformance (c63f9e2)
• improve types for getBBox (cecde7d)
• prepare script (9a3dc4e)
• ios: memory leak in tspan, fixes #1073 (974f3a8)
• fix native methods spec conformance (ecedb21)
• Make native methods synchronous (8ce7611)
• refine types for matrix helpers (409af91)
• refine types for matrix helpers (7a3f867)
• android: defineMarker/getDefinedMarker storage (e6eda84)
• android: native method scaling and getScreenCTM offset (f3e0b19)
• native method signatures web compatibility / spec conformance (8687a3d)
• ios: optimize extractPathData, clear PathMeasure when no textPath (df69c26)

Features

• flow: add flowgen to generate flow types from typescript, #1125 (fcd66fb)
• implement getBBox, getCTM, getScreenCTM (f13d54a)
• implement isPointInStroke (2ba64df)
• initial implementation of isPointInFill (203e53b)
• support using native methods using promises instead of callbacks (c28499b)
• android: implement getTotalLength and getPointAtLength (cd667d0)
• ios: implement getTotalLength and getPointAtLength (78c4f20)

9.11.1 (2019-10-03)

Bug Fixes

• marker onPress & gestures (bff92f0)

9.11.0 (2019-10-03)

Features

• implement support for context-fill and context-stroke color (f9a7238)

9.10.2 (2019-10-02)

Bug Fixes

• marker viewBox translation (b111028)

9.10.1 (2019-10-01)

Bug Fixes

• project.pbxproj for non cocoapods builds (cd70134), closes #1130

9.10.0 (2019-10-01)

Features

• improve marker rendering (9628830)
• improve marker rendering (2e3069d)
• android: implement marker rendering (ceee5ff)
• ios: implement marker rendering (589363d)
• define marker attributes (61533c6)
• define marker element (e7b5978)

9.9.9 (2019-09-28)

Bug Fixes

• handling of numeric id (2fb39f5), closes #1077

9.9.8 (2019-09-28)

Bug Fixes

• android: mask height and vertical position calculation (74b42a7), closes #1097

9.9.7 (2019-09-28)

Bug Fixes

• add gradientTransform to d.ts (3f08c46), closes #1069
• handling of gradients without stops (18828c0), closes #1099
• handling of rounded rect (c12d66e), closes #1112
• units in linear and radial gradients (70c54e6), closes #1110 #1118

9.9.6 (2019-09-27)

Bug Fixes

• ios: animation of clipPath contents, fixes #1119 (8bb5b22)
• handling of focusable, fixes #1117 (bd7e492)

9.9.5 (2019-09-25)

Bug Fixes

• handling of color/tintColor, fixes #1088 and #1115 (1eaf3a6)

9.9.4 (2019-09-16)

Bug Fixes

• release process (79bbaf1)