software-mansion/react-native-svg
React Native Svg
This project is a graphics library for React Native that provides a cross-platform vector rendering engine. It maps SVG XML elements to native graphics APIs, allowing for the creation of scalable shapes and custom illustrations that maintain visual consistency across mobile and web environments.
The library functions as a mapper that converts standard SVG markup into declarative component structures. It enables the creation of interactive vector interfaces by providing components that can detect and respond to user touch events.
Its capability surface includes drawing basic geometric primitives and complex paths, rendering vector text, and creating color gradients and patterns. It supports advanced visual effects through the use of alpha masks, clipping paths, and filters. Additionally, the system can load and render graphics dynamically from remote URIs or raw XML strings.
Features
- SVG to React Component Mappings - Maps SVG XML elements to platform-specific view hierarchies using a React component tree.
- Vector Graphics Rendering - Implements a rendering engine for scalable vector graphics to ensure high-fidelity visual output across platforms.
- Shape Drawing - Provides tools for defining and rendering basic geometric primitives like rectangles, circles, and polygons.
- Composite Path Construction - Constructs complex vector paths using a combination of linear segments, Bézier curves, and elliptical arcs.
- Coordinate and Viewport Transformations - Provides mathematical systems for mapping SVG document spaces and view-boxes to the display viewport.
- Cross-Platform Component Libraries - Provides a standardized component library for rendering consistent vector graphics across mobile and web platforms.
- Interactive SVG Elements - Creates SVG graphics that respond to user inputs to trigger interface updates and interactions.
- Cross-Platform Rendering Engines - Serves as a cross-platform rendering engine that maps SVG XML to native graphics APIs.
- Vector Graphics Renderers - Utilizes vector graphics renderers to dynamically update visual elements in response to attribute changes.
- React Native Libraries - Acts as a comprehensive React Native library for rendering scalable vector graphics and custom illustrations.
- Cross-Platform View Projections - Renders vector data through different host implementations for mobile and web to ensure consistent visual output.
- Multi-Touch Interaction Handling - Detects and processes touch interactions, including presses and long-presses, directly on vector components.
- Vector UI Interactivity - Enables the creation of vector-based interface elements that respond to touch events.
- Interactive UI Frameworks - Provides a framework for building complex, pointer-responsive vector user interfaces.
- Native Rendering Bridges - Provides the bridge mechanism that maps high-level SVG component definitions to native mobile graphics widgets.
- JSON Message Bus Bridges - Implements a bridge that serializes UI updates as JSON messages to a native host for vector rendering.
- SVG XML Renderers - Renders vector graphics directly from raw XML strings and files with internal styling.
- Gradient Renderers - Implements rendering logic for linear and radial gradients to fill or stroke vector shapes.
- Dynamic Vector Graphics - Allows for the programmatic loading and updating of vector graphics from external sources without redeployment.
- Raster Image Rendering - Displays bitmap raster image data within a vector coordinate system.
- Graphic Element Grouping - Provides grouping of vector elements to apply collective transformations and inherited styles.
- Text Rendering - Supports rendering text strings onto a graphics canvas with style and path support.
- Alpha Compositing - Implements alpha compositing to blend foreground images and background layers using transparency masks.
- Visual Effects - Implements advanced visual enhancements for SVG elements, including masks, clipping paths, and filters.
- SVG Fill Patterns - Uses SVG definitions to create custom patterns and textures for filling vector shapes.
- Visual Filter Manipulators - Applies visual filter manipulators like blurring, color matrix transforms, and shadows to vector elements.
- Clipping Path Applications - Provides tools for restricting the visible region of a graphic using vector-defined clipping paths.
- Vector Image Loaders - Enables loading and displaying vector graphics from remote URIs with fallback support.
- Interaction Tracking - Calculates spatial coordinates and boundaries to determine user interaction points within vector graphics.
- Vector Interaction Events - Tracks touch coordinates against vector hit-boxes to trigger events on specific nested graphic elements.
- SVG Component Transformations - Transforms standard SVG markup into functional React component structures for use in a declarative UI.
- React Native Converters - Transforms SVG markup into compatible React Native components for seamless integration.
