一、概述
参看地址:https://pro.ant.design/docs/new-component-cn
对于一些可能被多处引用的功能模块,建议提炼成业务组件统一管理。这些组件一般有以下特征:
-
-
只负责一块相对独立,稳定的功能;
-
没有单独的路由配置;
-
可能是纯静态的,也可能包含自己的 state,但不涉及 dva 的数据流,仅受父组件(通常是一个页面)传递的参数控制。
-
下面以一个简单的静态组件为例进行介绍。假设你的应用中经常需要展现图片,这些图片宽度固定,有一个灰色的背景和一定的内边距,有文字介绍,就像下图这样:
你可以用一个组件来实现这一功能,它有默认的样式,同时可以接收父组件传递的参数进行展示。
二、开发过程
2.1、组件开发
在 src/components
下新建一个以组件名命名的文件夹,注意首字母大写,命名尽量体现组件的功能,这里就叫 ImageWrapper
。在此文件夹下新增 js 文件及样式文件(如果需要),命名为 index.js
和 index.less
。
在使用组件时,默认会在 index.js
中寻找 export 的对象,如果你的组件比较复杂,可以分为多个文件,最后在 index.js
中统一 export,就像这样:
// MainComponent.js export default ({ ... }) => (...); // SubComponent1.js export default ({ ... }) => (...); // SubComponent2.js export default ({ ... }) => (...); // index.js import MainComponent from './MainComponent'; import SubComponent1 from './SubComponent1'; import SubComponent2 from './SubComponent2'; MainComponent.SubComponent1 = SubComponent1; MainComponent.SubComponent2 = SubComponent2; export default MainComponent;
其中index.js内容
// index.js import React from 'react'; import styles from './index.less'; // 按照 CSS Modules 的方式引入样式文件。 export default ({ src, desc, style }) => ( <div style={style} className={styles.imageWrapper}> <img className={styles.img} src={src} alt={desc} /> {desc && <div className={styles.desc}>{desc}</div>} </div> );
其中index.less内容
// index.less .imageWrapper { padding: 0 20px 8px; background: #f2f4f5; 400px; margin: 0 auto; text-align: center; } .img { vertical-align: middle; max- calc(100% - 32px); margin: 2.4em 1em; box-shadow: 0 8px 20px rgba(143, 168, 191, 0.35); }
组件开发完毕
2.2、使用组件
在要使用这个组件的地方,按照组件定义的 API 传入参数,直接使用就好,不过别忘了先引入:
import React from 'react'; import ImageWrapper from '../../components/ImageWrapper'; // 注意保证引用路径的正确 export default () => ( <ImageWrapper src="https://os.alipayobjects.com/rmsportal/mgesTPFxodmIwpi.png" desc="示意图" /> );
如果放在上一节内容中
import React, {Component} from 'react'; import {Link} from 'dva/router'; import ImageWrapper from '../components/ImageWrapper'; // 注意保证引用路径的正确 export default class NewPage extends Component { render() { return ( <div> 页面内容 </div>, <ImageWrapper src="https://os.alipayobjects.com/rmsportal/mgesTPFxodmIwpi.png" desc="示意图" /> ); } }
.