【开发】3.7-新增业务组件

最新推荐文章于 2023-11-09 14:01:18 发布

LuCh1Monster

最新推荐文章于 2023-11-09 14:01:18 发布

阅读量208

点赞数

分类专栏： Ant Design Pro

原文链接：https://pro.ant.design/docs/new-component-cn

版权

Ant Design Pro 专栏收录该内容

16 篇文章 2 订阅

订阅专栏

文章目录

1. 新建文件
2. 使用

对于一些可能被多处引用的功能模块，建议提炼成业务组件统一管理。这些组件一般有以下特征：

只负责一块相对独立，稳定的功能；
没有单独的路由配置；
可能是纯静态的，也可能包含自己的 state，但不涉及 dva 的数据流，仅受父组件（通常是一个页面）传递的参数控制。

下面以一个简单的静态组件为例进行介绍。假设你的应用中经常需要展现图片，这些图片宽度固定，有一个灰色的背景和一定的内边距，有文字介绍，就像下图这样：

在这里插入图片描述

你可以用一个组件来实现这一功能，它有默认的样式，同时可以接收父组件传递的参数进行展示。

1. 新建文件

在 src/components 下新建一个以组件名命名的文件夹，注意首字母大写，命名尽量体现组件的功能，这里就叫 ImageWrapper。在此文件夹下新增 js 文件及样式文件（如果需要），命名为 index.ts 和 index.less。

在使用组件时，默认会在 index.ts 中寻找 export 的对象，如果你的组件比较复杂，可以分为多个文件，最后在 index.ts 中统一 export，就像这样：

// MainComponent.ts
export default ({ ... }) => (...);

// SubComponent1.ts
export default ({ ... }) => (...);

// SubComponent2.ts
export default ({ ... }) => (...);

// index.ts
import MainComponent from './MainComponent';
import SubComponent1 from './SubComponent1';
import SubComponent2 from './SubComponent2';

MainComponent.SubComponent1 = SubComponent1;
MainComponent.SubComponent2 = SubComponent2;
export default MainComponent;

你的代码大概是这个样子：

// index.ts
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
.imageWrapper {
  padding: 0 20px 8px;
  background: #f2f4f5;
  width: 400px;
  margin: 0 auto;
  text-align: center;
}

.img {
  vertical-align: middle;
  max-width: calc(100% - 32px);
  margin: 2.4em 1em;
  box-shadow: 0 8px 20px rgba(143, 168, 191, 0.35);
}

到这儿组件就建好了。

2. 使用

在要使用这个组件的地方，按照组件定义的 API 传入参数，直接使用就好，不过别忘了先引入：

import React from 'react';
import ImageWrapper from '@/components/ImageWrapper'; // @ 表示相对于源文件根目录

export default () => (
  <ImageWrapper src="https://os.alipayobjects.com/rmsportal/mgesTPFxodmIwpi.png" desc="示意图" />
);