018 年 12 月 16 号,Fusion 在 OSC 深圳源创会年终盛典上正式开源, 这个在阿里内部跑了三年的产品,终于对外了。
可能一些业界的同学已经在某些渠道听说过阿里的 Fusion Design
距离上次对外发声,Fusion 在阿里内部又走了两年,这两年内我们技术领域又有了一些突破。这次重点介绍我们的突破吧。不过介绍前还是要说下 Fusion 是做什么的,毕竟还是有很多同学是第一次听说的!
一般一个项目的上线流程基本都要经历,评审、设计、开发、测试 这几个阶段。
而各个阶段又可以再深入进去的拆分,大致如下:
这里重点说下流程中的两个问题。
这里面标黄了的部分表示可能是各个业务线间的重复工作:
协同遇到的问题,上面知乎链接里面周源的回答已经非常清楚了,我这里再大概总结下。
对阴影的理解不同
·设计师的理想和前端的现实问题之间的差别
同样 margin-top:12px 但是得到的间距不一致
·
去除重复流程,只关注业务
·
通过抽象骨架 DPL -> 通过平台定制产出定制好 UI 的组件、模板 -> 流入设计师的工具里面直接拖拽使用 -> 前端直接使用定制好的组件(不需关注组件 UI)
·
·
那未来在 Fusion 模块模板达到极度丰富后,使用可以方便的找到各个领域的模块模板来使用,不需要从 0 开始搭建。
一个平台,两个端
一个平台:fusion.design
两个工具:
https://fusion.design 可以定制自己的 Design System(以下简称 DS)
创建自己的 Design System
每个人或者团队都可以通过 https://fusion.design/sites/new 可以创建自己的站点
站点提供三种能力:文档编辑、主题管理、物料托管。
存储设计师文档和开发文档。
集成了可以管理、定制、发布组件的主题的能力(下文会简称为配置平台)。
可以使用开发好的区块、模板。
区块 - 代码片段
模板 - 脚手架
设计师工具 - FusionCool
主题发布完成后就到了 Sketch 的插件端 FusionCool,设计师可以在 FusionCool 里面搜索 iconfont 所有素材、使用配置好的组件、使用站点的模块模板。
开发者工具 - Iceworks
Iceworks 是淘宝飞冰团队开发的面向前端开发者的 GUI 工具,开发者无须关注环境的问题,并且有海量物料可用。目前已经和 Fusion 的物料体系打通,可以轻松使用 Fusion 站点的物料。
每个站点有自己的物料源
可直接在 Iceworks 配置物料源地址
项目开发
Fusion Next 是基于 React 实现的一套 PC 端的组件库,这套组件库已经在阿里内部服务了三年。
github 地址:https://github.com/alibaba-fusion/next
这次开源出来的版本是最近一年基于之前两年的使用经验、问题反馈进行重新整理和优化过。具备以下特性。
对比上一个版本 80 + 功能,进行 300+ 优化,组件整体代码体积却减小 30%
一共 50+ 组件,打包下来却只有 700 多 K,这个目前在业界比较少组件有能力做到这点。组件之间依赖关系清晰,复用度高也是体积小的原因。
组件单测覆盖率近 90%,提供服务以来没有产生过起线上事故。
国际化、RTL、无障碍能力全面支持。另外针对中后台表单大数据量场景做了大量性能优化,比如普通 table 随着数据不断增长 render 会越来越慢,大致如下:
Next 引入了 virtual-list ,目前用在了 table 和 select 这两个使用频率较高的组件。因为在大数据量 (测试过 1w 节点)下只渲染需要展示的节点(比如 20 个),所以可以将渲染时长永远的控制在 0.3s 之内。
突破 html2svg 的弊端,做到无损还原
早在一年前我们是把设计师在主题配置平台(直接在 web 页面配置组件的主题)的组件直接通过 html2svg 技术直接把组件直接转换为 svg 文件,从而让设计师可以直接在 sketch 里面使用。但是这种方案存在的弊端就是还原度不够(大概 95% 还原度)。
html2svg 的还原度问题
主要原因是 html 采用盒模型 和 svg 的转换并不是一一对应的,所以这里永远有修不完的 bug。虽然 95% 是好的,但是对于设计端来说是完全不能忍受的。
所以 Fusion 项目小组经过近半年的努力终于突破了还原度的问题,流程图如下:
从配置平台导出的不再是 html,而是 DesignToken (设计变量),FusionCool 底层使用 Airbnb 提供的 react-sketch 能力写成的一份 Next 组件,直接通过 DesignToken 覆盖默认变量,最终在 Sketch 端实时渲染。
组件的类型、大小、内容都可以直接在面板配置
图表配置可以直接唤起配置面板
sketch 端的任何点击都可以通过 Event 的方式在 FusionCool 产生配置面板。
Fusion 站点:https://fusion.design/
next github 仓库: https://github.com/alibaba-fusion/next
方案支持颜色自定义,高亮行数自定义,可高亮多行,可定义多个颜色,主要实现方式是css样式,代码简单易懂,下面看效果和代码吧:
当前效果:
预期效果:
代码:这是HTML代码 绑定这个属性:row-class-name=“tableRowClassName”
```
<el-table
:data="tableData"
style="width: 100%"
:row-class-name="tableRowClassName">
<el-table-column
prop="date"
label="日期"
width="180">
</el-table-column>
<el-table-column
prop="name"
label="姓名"
width="180">
</el-table-column>
<el-table-column
prop="address"
label="地址">
</el-table-column>
</el-table>
```
这是JS代码 注册这个方法tableRowClassName(),这里传的rowIndex就是需要高亮的数据在数组里面的下标,返回的class类名就是你自己定义的class类名。
```javascript
methods: {
tableRowClassName({row, rowIndex}) {
if (rowIndex === 1) {
return 'warning-row';
} else if (rowIndex === 3) {
return 'success-row';
}
return '';
}
},
格 Table 要展示统计行应该是个很常见的业务需求,本文将介绍一种实现此功能的方法。注意,此方法不兼容 IE 浏览器。
公司存量项目使用的 antd 版本为 3.x,此版本的 antd 并没有支持统计行功能,只有一个 footer 属性可以在表格底部增加一行内容,但是这个并不能满足统计行的要求(无论是单元格对齐还是横向滚动),所以需要想个其他方法去实现统计行。
同时对于公司内新项目来说,用的是 antd 5.x 的版本,此版本支持统计行功能,但是需要使用 Summary 组件去构造统计行,功能灵活但是使用上会麻烦些。
所以就思考有没有能在不同 antd 版本下都实现统计行的技术方案,同时使用上又比较简单。
首先来分析下统计行的特点:
对于第一点,如果 antd 的 Table 组件设置了分页功能,比如 pagination: { pageSize: 10 },此时就无法展示额外的统计行,所以我们不使用 Table 的分页功能,自己通过组合 Pagination 组件来实现分页,数据传参方面, Table 的 dataSource 除了当前页数据,在拼上统计行数据即可。
第二点,固定在尾部,对于现代 css 来说,直接使用 position: sticky 实现即可。
第三点的话,在第一点提到的方案中已经实现。
整体来说,就是实现以下两个功能点:
在 antd Table API 基础上,新增一个 summaryFixed API,代表统计行(即最后一行)固定在表格底部,默认为 false,不影响没有统计行的列表展示。
首先我们实现下统计行固定功能。
import React from "react";
import classNames from "classnames";
import { Table as AntdTable } from "antd";
import "./table.css";
export default function Table({
summaryFixed,
...restProp
}) {
return (
<div
className={classNames("my-enhance-table", {
"my-enhance-table-summary-fixed": summaryFixed,
})}
>
<AntdTable {...restProp} />
</div>
);
}
代码中使用到了 classnames 库,在 summaryFixed 为 true 的时候,就会加上对应类名,接着就根据 my-enhance-table-summary-fixed 类名设置对应 css。
.my-enhance-table.my-enhance-table-summary-fixed {
tr.ant-table-row:last-child {
background: #fff;
position: sticky; /* 设置为 sticky 布局 */
bottom: 0; /* 固定在底部 */
z-index: 2;
&:not(:first-child) > td {
border-top: 1px solid #f0f0f0;
}
}
tr.ant-table-row:nth-last-child(2) {
> td {
border-bottom: 0;
}
}
}
上述 css 中通过 tr.ant-table-row:last-child 选择器选中最后一行并设置为 sticky 布局,其他 css 代码是处理边框问题的。
固定统计行功能实现完成后,接着通过组合 Table 和 Pagination 组件的方式实现统计行的展示。
import React, { useRef, useEffect } from "react";
import isEmpty from "lodash/isEmpty";
import classNames from "classnames";
import { Table as AntdTable, Pagination } from "antd";
import "./table.css";
export default function Table({
dataSource,
columns,
pagination,
onChange,
summaryFixed,
...restProp
}) {
const onTableChange = (pagination, filters, sorter, extra) => {
// 处理排序和筛选之类功能
};
const onPaginationChange = (current, pageSize) => {
// 处理翻页功能
};
return (
<div
className={classNames("my-enhance-table", {
"my-enhance-table-summary-fixed": summaryFixed,
})}
>
<AntdTable
{...restProp}
pagination={false}
dataSource={dataSource}
columns={columns}
onChange={onTableChange}
/>
{pagination !== false && (
<Pagination {...pagination} onChange={onPaginationChange} />
)}
</div>
);
}
将 Table 的 pagination 设置为 false,并将外部的 pagination 参数传给传入到 Pagination 组件,我们就可以在 pageSize 为 10 的情况下,让 dataSource 内容全部展示(即使 dataSource 的数据量超过 10)。
最后我们需要处理下翻页和排序等相关操作:
...
const initPagination = { current: 1, pageSize: 10, total: 0 };
// 获取 columns 中排序参数,区分首次和后续更新
const getSorterParam = (columns, isInit = false) => {
const sorterParam = {};
for (let index = 0; index < columns.length; index++) {
const { sorter, defaultSortOrder, sortOrder, dataIndex, key } =
columns[index] || {};
const order = isInit
? sortOrder != null
? sortOrder
: defaultSortOrder
: sortOrder;
if (sorter && order) {
sorterParam.field = dataIndex || key;
sorterParam.columnKey = dataIndex || key;
sorterParam.order = order;
sorterParam.column = columns[index];
return sorterParam;
}
}
return sorterParam;
};
export default function Table({
dataSource,
columns,
pagination,
onChange,
summaryFixed,
...restProp
}) {
const sorterParam = useRef(getSorterParam(columns, true));
const filtersParam = useRef({});
const paginationParam = useRef(pagination || initPagination);
useEffect(() => {
paginationParam.current = pagination || initPagination;
}, [pagination]);
useEffect(() => {
// 排序可控模式下更新排序
if (columns.some((col) => !!col.sortOrder)) {
sorterParam.current = getSorterParam(columns);
}
}, [columns]);
const onTableChange = (pagination, filters, sorter, extra) => {
if (!isEmpty(sorter)) {
sorterParam.current = sorter;
}
if (!isEmpty(filters)) {
filtersParam.current = filters;
}
if (onChange) {
onChange(
isEmpty(pagination) ? paginationParam.current : pagination,
filtersParam.current,
sorterParam.current,
extra
);
}
};
const onPaginationChange = (current, pageSize) => {
paginationParam.current = { ...paginationParam.current, current, pageSize };
pagination?.onChange?.(current, pageSize);
onTableChange(paginationParam.current, undefined, undefined, {
currentDataSource: dataSource,
action: "paginate",
});
};
return (
...
)
}
无论是翻页还是排序或筛选,我们都需要记录下对应的值。因为翻页功能是单独的 Pagination 组件提供的,所以触发翻页时,我们需要用到之前的排序或筛选参数,通过 onChange 一起给到外部;触发排序或筛选的情况同理,需要用到最近一次的翻页参数。
最终完整代码可查看:https://codesandbox.io/p/sandbox/antd-table-tong-ji-xing-gu-ding-grlz88?file=%2FTable.js%3A19%2C27
通过组合 Pagination 组件来实现超过当前每页条数的数据量展示,同时配合现代 css 的 position: sticky 能力,我们实现了让 Table 表格支持统计行功能。当然,上述代码有需要优化的地方,比如翻页后回到表格顶部等等。
*请认真填写需求信息,我们会在24小时内与您取得联系。