React Native Icon方案:react-native-svg

7,426 阅读4分钟

原文地址:github.com/HuJiaoHJ/bl…

网上 React Native 的 icon 实现大都是使用iconfont方案,即:react-native-vector-icons

此方案存在一个问题:强依赖客户端打包,即每新增图标,就需要客户端重新打包,资源管理上不能做到 RN 与客户端解耦

为了避免这个问题,使用了SVG方案:react-native-svg 来实现Icon

接下来将从三个方面进行分享:

  • react-native-svg 使用
  • Icon组件实现及2Web
  • Icon组件使用

此文会涉及部分 React Native 转 web 的知识,使用的是 react-native-web 方案,可以看看我之前写的文章:react native转web方案:react-native-web

react-native-svg 使用

安装

npm install react-native-svg --save

Link native code

react-native link react-native-svg

以上操作,其实就是将 react-native-svg 的依赖安装到客户端中,进行了上面的操作,基本已自动完成安装依赖,但是在部分IOS上会存在问题,如遇到问题可以去 react-native-svg 查看解决方案

react-native-svg-uri

react-native-svg-uri 支持在RN中通过一个URL或者静态文件渲染svg,同时也支持传入svg字符串,将其渲染

使用如下:

// 安装
npm install react-native-svg-uri --save
// 确保已在客户端中安装了 react-native-svg 依赖,若未安装依赖,执行:
react-native link react-native-svg

下面将使用 react-native-svg-uri 来实现Icon组件,这个库源码只有两个js文件,有兴趣的小伙伴可以自行了解~

Icon组件实现及2web

实现

上面我们有提到,react-native-svg-uri 支持传入svg字符串来渲染svg,所以可以将多个svg文件通过脚本的形式转换成一个js对象或者一个json文件,其格式如下:

svg.js

export default {
    "arrow-left": "<svg t=\"1533091848499\" class=\"icon\" style=\"\" viewBox=\"0 0 1024 1024\" version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" p-id=\"579\" xmlns:xlink=\"http://www.w3.org/1999/xlink\" width=\"32\" height=\"32\"><defs><style type=\"text/css\"></style></defs><path d=\"M769.405 977.483a68.544 68.544 0 0 1-98.121 0L254.693 553.679c-27.173-27.568-27.173-72.231 0-99.899L671.185 29.976c13.537-13.734 31.324-20.652 49.109-20.652s35.572 6.917 49.109 20.652c27.173 27.568 27.173 72.331 0 99.899L401.921 503.681l367.482 373.904c27.074 27.568 27.074 72.231 0 99.899z\" fill=\"\" p-id=\"580\"></path></svg>"
}

在使用时,可以通过获取对应 key 的 value 传给 react-native-svg-uri 渲染

上面的转换脚本可以参考:svg2json,代码:github.com/HuJiaoHJ/sv…

做好文件转换之后,我们可以开发Icon组件啦

index.js

import createIconSet from './create-icon-set';
// 即上面转换得到的 svg.js
import svg from './svg';

const Icon = createIconSet(svg, 'rn_components');

export default Icon;

export { createIconSet };

creact-icon-set.native.js

import React, { Component } from 'react';
import SvgUri from 'react-native-svg-uri';

export default function createIconSet(svg, fontName) {
    return class Icon extends Component {
        render () {
            const { icon, color, size, style } = this.props;
            let svgXmlData = svg[icon];

            if (!svgXmlData) {
                let err_msg = `no "${icon}"`;
                throw new Error(err_msg);
            }
            return (
                <SvgUri width={size} height={size} svgXmlData={svgXmlData} fill={color} style={style} />
            );
        }
    };
}

以上就是Icon组件的实现

2web

对RN2web感兴趣的小伙伴可以看看:react native转web方案:react-native-web

在此基础上,我们需要对我们Icon组件支持2web,由于没有对应的web组件,所以需要我们自行实现对应web的组件

web端我们使用iconfont来做Icon组件(注意:iconfont不支持多色icon,多色的icon只能选择svg或者img)

还是svg文件转换的问题,我们需要先将svg文件转换成iconfont,即

这样我们就能向常规web一样使用iconfont啦

上面的转换工具可以参考:svg2iconfont,代码:github.com/HuJiaoHJ/sv…

当然,要注意记得将生成的iconfont.css文件引入页面html中,接下来看看2web的Icon组件实现,不需要额外新建文件夹,只需在相同文件夹下新增 creact-icon-set.js 文件(注意到上面RN的文件是 creact-icon-set.native.js),这在实际使用过程中,会自动识别这两个文件

creact-icon-set.js

import React, { Component } from 'react'
import { createElement, StyleSheet } from 'react-native'

export default function createIconSet(svgs, fontName) {
  return class Icon extends Component {
    render() {
      const { icon, color, size, style } = this.props
      const styles = StyleSheet.create({
        iconStyle: {
          color,
          fontSize: size,
        },
      })
      const props = {
        className: `${fontName ? fontName + '-' : 'icon-'}${icon}`,
        style: StyleSheet.compose(
          style,
          styles.iconStyle
        ),
      }
      return createElement('i', props)
    }
  }
}

如果看了 react native转web方案:react-native-web ,应该就能知道 import { createElement, StyleSheet } from 'react-native' 实际上是 import { createElement, StyleSheet } from 'react-native-web',没错,就是直接使用的 react-native-web 的 API 来开发转web之后的组件

以上就完成了Icon组件的2web支持

Icon组件使用

我们怎么使用呢?有两种情况:

使用Icon组件自带icon

Icon组件会自带一些常用的icon,在使用这些icon时,使用较为简单,直接引入,如下使用:

// 引入
import Icon from 'Icon';

// 使用
<Icon icon={'arrow-left'} size={30}/>

注意:如果需要支持2web,需要将对应的 iconfont.css 引入到页面html中

使用业务icon

如果需要添加业务icon,有如下两步:

1、将svg转换成js文件(如需要支持2web,还需生成iconfont)

这部分就不详细讲了,可以参考上面的内容

2、调用 createIconSet 新建 CIcon组件

代码如下:

import React from 'react'
// 引入Icon组件的 createIconSet 方法
import { createIconSet } from 'Icon'
// 包含业务svg的js文件
import svgs from './svgs'

// 传入业务svg的js对象,生成CIcon组件
const CIcon = createIconSet(svgs)

export default function () {
  return Object.keys(svgs).map((item, index) => (
    // 使用
    <CIcon icon={item} color={'#000'} size={50} key={index} />
  ))
}

以上所有代码可在个人开发的RN组件库的项目中查看到:rn_components,组件库现在才刚开始建设,后续会不断完善

写在最后

以上就是我对 React Native Icon方案:react-native-svg 的分享,希望能对有需要的小伙伴有帮助~~~

喜欢我的文章小伙伴可以去 我的个人博客 点star ⭐️