实战为王,从零封装 Icon 组件

简介: 实战为王,从零封装 Icon 组件

在学习了 props 属性之后,结合一个实践案例,我们就能够扎实的掌握它。


在实践应用中,图标的使用无处不在。小到编辑器的功能按钮,大到 chrome 浏览器的任务栏,都有大量的图标需要处理。每个稍微大一点点的项目都必然需要一个图标组件。

image.png

在使用时,我们可以控制图标具体类型、颜色、大小。在 React 哲学之封装思想的指导下,这些控制项为组件的差异项,需要通过 props 传入。封装好之后,使用方式大概如下:

<Icon color="red" size="small" type="skip" />
<Icon color="#FFF" size="small" type="loading" />

那么我们应该如何实现呢?


字体图标


最初见到字体图标的应用,是在淘宝网站上。当时大家都还在使用雪碧图,而淘宝页面的图标居然可以像字体一样,随意的给它设置颜色大小等属性。到了现在,字体图标早已经不是什么黑科技了,它几乎被普及到了所有网站。


在 CSS3 中,有一个语法可以自定义字体 @font-face。如果字体库是由图标组成,那么我们就可以创建字体图标了。字体图标与文字具有相同的特性,我们可以把图标当成字体一样处理。例如修改它的font-size,color等。对应的css语法如下:

@font-face {
  font-family: 'custom name',   /* 自定义字体名字 */
  src: url('./fonts/custom.eot')  /* 下载到本地的字体库 */
}

通常情况下,字体库中,每一个图标都会对应一个唯一的标识码。现在我们要通过字体图标网站 iconfont 收集一个自己项目中会涉及到的图标。然后组成一个图标库。

image.png

可以使用线上图标库。点击查看在线链接并生成代码即可。

@font-face {
  font-family: 'iconfont';  /* Project id 3219669 */
  src: url('//at.alicdn.com/t/font_3219669_n8051p8dggi.woff2?t=1646884122827') format('woff2'),
       url('//at.alicdn.com/t/font_3219669_n8051p8dggi.woff?t=1646884122827') format('woff'),
       url('//at.alicdn.com/t/font_3219669_n8051p8dggi.ttf?t=1646884122827') format('truetype');
}

将这段代码贴到我们的css文件中,就已经自定义了一个 font-family 为iconfont的字体图标。我们也可以将字体图标库下载下来,把url中的路径都修改为对应的字体库文件就行。


可以看到,每一个图标除了有一个对应的名字之外,还有一个唯一的unicode码。&#x表示他们后面跟的是16进制数字。假设我们期望在 HTML 中放入一个代表图标的标签

<i class="icon-warn" />

那么,只要它对应的 CSS 这样写,就可以在页面上显示出字体库中的图标了

.icon-warn {
  font-family: "iconfont";
  color: red;
  font-size: 20px;
}
.icon-warn:before {
  content: '\e6cc';
}

content的值是一个斜杠加上图标对应的十六进制数字。运行之后我们就能在页面中看到一个红色的 warn 图标。


对应的 scss 写法为:

/* 对应的scss写法为 */
.icon-warn {
  font-family: "iconfont";
  color: red;
  font-size: 20px;
  &:before {
    content: '\e6cc';
  }
}

目前新版本的create-react-app创建的项目,只需新安装node-sass就可以支持 SCSS 语法,具体情况根据你使用的版本来定。


字体图标组件


很显然图标组件的封装不会涉及到太过于复杂的 JS 逻辑处理,更多的是对外部状态 props 的判断与处理。基础元素可以指定一个 i 标签。图标通过 before/after 伪类中的 content 显示。实现方法我们将每一个图标都对应写一个 class,然后根据传入的 type 类型,修改对应的 class 即可。


例如:

.icon {
  &-react::before {
    content: '\e712';
  }
  &-ercode::before {
    content: '\e600';
  }
}

JS 的逻辑的处理主要在于样式合并,例如判断有哪些 class 名应该存在。


先思考一下组件封装好后,我们会遇到哪些情况。


第一种情况:简单传入 type,得到对应的图标显示。

<Icon type="close" />

第二种情况:组件本身需要设置一些样式,因此可能会有通过添加 class 的方式自定义 CSS 样式。

<Icon className="close" type="close" />

第三种情况:直接修改图标的样式

<!--第一种可以直接传入对应的属性-->
<Icon type="close" color="red" />
<!--另外一种是利用jsx支持的style语法,传入css样式-->
const style = {
  color: 'red',
  fontSize: '20px'
}
<Icon type="close" style={style} />

第四种情况:我们要考虑特殊的类型,例如 loading 图标需要一直旋转。例如 refresh 刷新图标,点击时才旋转,刷新完成就停止旋转。因此我们要专门针对这种情况做特殊处理。添加一个是否旋转的控制属性。

<!--通过对spin的修改,来控制图标是否旋转-->
<Icon type="refresh" spin={true} />

其余的我们可能在实践中还会添加新的需求,到时候再根据需求做改进即可。


OK,带着这些基础知识和需求,我们开始动手来完成我们的第一个正式的 React 组件。


在 src 目录下,创建一个专门用来存放组件的文件夹:components。然后在 components 目录下创建 Icon 目录。并分别创建 index.tsx 与 index.scss。我们将字体图标下载下来,存放于Icon目录的fonts目录中。


最终的文件结构大致如下:

+ Icon
  + fonts
  - index.jsx
  - style.scss

图标库也可以使用在线地址


通过上面的分析我们知道,基础元素的 class 可能会涉及到很多个,如果通过 if/else 来判断的话,可能我们的代码可读性会非常的低。因此这里我们借助一个专门处理 class 名的工具方法来完成逻辑的判断。这个工具库叫做 classnames。


我们先安装这个库,然后重启项目

> yarn add classnames

该工具方法的使用比较简单,它的目的在于拼接 class 名

import classnames from 'classnames';
// 拼接所有参数
classnames('foo', 'bar');  // 'foo bar'
// 拼接值为true的参数
classnames({
  foo: true,
  bar: false
})  //  'foo'
// 也可以比较随意的混合使用
classnames('foo', {
  bar: true,
  tag: true,
  mm: false
}) // 'foo bar tag'

更具体的用法可以查看其 npm 上的文档


现在我们先来实现index.tsx中的代码编写


首先引入必要的模块

import classnames from 'classnames'
import './index.scss'

然后定义相关的 TS 类型声明

export type IconType = 'react' | 'ercode' | 'search' | 'warn' |
  'warn2' | 'back' | 'setting' | 'html' | 'html2' | 'like' |
  'home' | 'profile' | 'project' | 'css' | 'css2' | 'css3' | 'css4' | 'wxgzhao' |
  'wxgzhao2' | 'hot' | 'js' | 'menu' | 'wxs' | 'arrow-right' | 'arrow-left' |
  'arrow-up' | 'arrow-down' | 'webpack' | 'vue' | 'redux' | 'event' |
  'antd' | 'loading' | 'fed'
type IconProps = {
  type: IconType,
  spin?: boolean,
  className?: string,
  color?: string,
  style?: Object,
  [key: string]: any
}

然后给 props 设定一个默认值

const defaultProps: IconProps = {
  type: 'loading',
  spin: false
}

创建函数组件,主要逻辑是根据外部传入的 props 整合最终的样式

export default function Icon(props = defaultProps) {
  const {type, className, spin, color, style, ...other} = props
  const cls = classnames({
    'icon': true,
    'icon-spin': !!spin || type === 'loading',
    [`icon-${type}`]: true
  }, className)
  const _style = {...style, color}
  return (
    <i className={cls} {...other} style={_style} />
  )
}

CSS 的样式

// 图标库地址
// https://www.iconfont.cn/manage/index?spm=a313x.7781069.1998910419.11&manage_type=myprojects&projectId=3219669&keyword=&project_type=&page=
@font-face {
  font-family: 'iconfont';  /* Project id 3219669 */
  src: url('//at.alicdn.com/t/font_3219669_n8051p8dggi.woff2?t=1646884122827') format('woff2'),
       url('//at.alicdn.com/t/font_3219669_n8051p8dggi.woff?t=1646884122827') format('woff'),
       url('//at.alicdn.com/t/font_3219669_n8051p8dggi.ttf?t=1646884122827') format('truetype');
}
.icon {
  font-family: 'iconfont';
  font-size: 16px;
  font-style: normal;
  display: block;
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
}
.icon {
  &-react::before {
    content: '\e712';
  }
  &-ercode::before {
    content: '\e600';
  }
  &-search::before {
    content: '\e6ac';
  }
  &-warn::before {
    content: '\e6cc';
  }
  &-warn2::before {
    content: '\e66f';
  }
  &-back::before {
    content: '\e60f';
  }
  &-setting::before {
    content: '\e606';
  }
  &-html::before {
    content: '\e6a0';
  }
  &-html2::before {
    content: '\e632';
  }
  &-like::before {
    content: '\e60a';
  }
  &-home::before {
    content: '\e671';
  }
  &-profile::before {
    content: '\e607';
  }
  &-project::before {
    content: '\e714';
  }
  &-css::before {
    content: '\e605';
  }
  &-css2::before {
    content: '\ec3a';
  }
  &-css3::before {
    content: '\e601';
  }
  &-css4::before {
    content: '\e618';
  }
  &-wxgzhao::before {
    content: '\e612';
  }
  &-wxgzhao2::before {
    content: '\e705';
  }
  &-hot::before {
    content: '\e7a5';
  }
  &-js::before {
    content: '\e810';
  }
  &-menu::before {
    content: '\e666';
  }
  &-wxs::before {
    content: '\e608';
  }
  &-arrow-right::before {
    content: '\e743';
  }
  &-arrow-left::before {
    content: '\e744';
  }
  &-arrow-up::before {
    content: '\e745';
  }
  &-arrow-down::before {
    content: '\e7b2';
  }
  &-webpack::before {
    content: '\e6ae';
  }
  &-vue::before {
    content: '\e69a';
  }
  &-redux::before {
    content: '\ec7d';
  }
  &-event::before {
    content: '\e609';
  }
  &-antd::before {
    content: '\eaa1';
  }
  &-fed::before {
    content: '\e60b';
  }
}
.icon-spin {
  animation-name: rotate;
  animation-duration: 1s;
  animation-timing-function: linear;
  animation-iteration-count: infinite;
}
@keyframes rotate {
  from {
    transform: rotate(0)
  }
  to {
    transform: rotate(360deg)
  }
}

OK,一个简单且非常专业的 Icon 组件就这样完成啦。


把我准备的图标库里所有图标遍历渲染到页面上结果如下

image.png

相关文章
|
前端开发
前端项目实战陆拾壹react-admin+material ui-踩坑-List需要Datagrid中children写法
前端项目实战陆拾壹react-admin+material ui-踩坑-List需要Datagrid中children写法
61 0
|
前端开发
前端项目实战陆拾玖react-admin+material ui-踩坑-List需要Datagrid中header写法
前端项目实战陆拾玖react-admin+material ui-踩坑-List需要Datagrid中header写法
45 0
|
前端开发
前端项目实战捌拾玖react-admin+material ui-踩坑-List路由写错一直展示不出来
前端项目实战捌拾玖react-admin+material ui-踩坑-List路由写错一直展示不出来
46 0
|
前端开发
前端项目实战玖拾伍react-admin+material ui-踩坑-List的用法之disableSyncWithLocation查询字符串同步
前端项目实战玖拾伍react-admin+material ui-踩坑-List的用法之disableSyncWithLocation查询字符串同步
67 0
|
7月前
|
前端开发
【零基础入门前端系列】—表格的属性(十三)
【零基础入门前端系列】—表格的属性(十三)
|
7月前
|
前端开发
【零基础入门前端系列】—关系选择器(十一)
【零基础入门前端系列】—关系选择器(十一)
|
前端开发
前端项目实战柒拾壹react-admin+material ui-踩坑-List需要Datagrid中isRowExpandable设置写法
前端项目实战柒拾壹react-admin+material ui-踩坑-List需要Datagrid中isRowExpandable设置写法
70 0
|
前端开发
前端项目实战陆拾捌react-admin+material ui-踩坑-List需要Datagrid中expand expandSingle可以展开单行
前端项目实战陆拾捌react-admin+material ui-踩坑-List需要Datagrid中expand expandSingle可以展开单行
59 0
|
前端开发
前端项目实战玖拾react-admin+material ui-踩坑-List的用法之children用法之WithListContext
前端项目实战玖拾react-admin+material ui-踩坑-List的用法之children用法之WithListContext
61 0
|
前端开发
前端项目实战陆拾陆react-admin+material ui-踩坑-List需要Datagrid中expand写法
前端项目实战陆拾陆react-admin+material ui-踩坑-List需要Datagrid中expand写法
55 0