整合营销服务商

电脑端+手机端+微信端=数据同步管理

免费咨询热线:

阿里重磅开源中后台 UI 解决方案 Fusion

018 年 12 月 16 号,Fusion 在 OSC 深圳源创会年终盛典上正式开源, 这个在阿里内部跑了三年的产品,终于对外了。

可能一些业界的同学已经在某些渠道听说过阿里的 Fusion Design

  • 比如这篇 16 年就传得很火的《阿里最新神器-fusion design》
  • 比如知乎上面 17 年讨论得很热烈的话题 《阿里巴巴的 Fusion Design 是如何运作的?》
  • 也有可能来自 16 年 d2 论坛上周源同学的对外分享

距离上次对外发声,Fusion 在阿里内部又走了两年,这两年内我们技术领域又有了一些突破。这次重点介绍我们的突破吧。不过介绍前还是要说下 Fusion 是做什么的,毕竟还是有很多同学是第一次听说的!

1. Fusion 是做什么的

1.1 解决设计师和前端工作协同的问题

一般一个项目的上线流程基本都要经历,评审、设计、开发、测试 这几个阶段。

而各个阶段又可以再深入进去的拆分,大致如下:

  • 评审: 业务交互(产品功能交互),业务逻辑的评审;
  • 设计:设计规范(设计师对整个产品在视觉规范上面的定义),视觉设计(绘制视觉稿),标注稿(产出标注搞给到前端)
  • 开发:前端一般都会有一套组件库;但是组件库可能和自己业务线的品牌并不是对应的(比如阿里橙、天空蓝,基本没类业务线都会有个自己的品牌),所以第一步需要在组件层面做 UI 的定制,然后是业务逻辑的开发。
  • 测试:最常见的就是设计师和前端坐在一起两天专门做 UI 还原度 review;业务逻辑测试是比做流程不多说。

这里重点说下流程中的两个问题。

重复工作

这里面标黄了的部分表示可能是各个业务线间的重复工作:

  • 比如中后台 UI 的交互都是确定的
  • 比如设计规范都可以在一个集成的规范上面做扩展
  • 比如标注可以通过插件统一解决,而视觉还原、还原度 review 可以交给设计师去关心

协同问题

协同遇到的问题,上面知乎链接里面周源的回答已经非常清楚了,我这里再大概总结下。

  • 因为使用的工具不同对概念的认知不同

对阴影的理解不同

·设计师的理想和前端的现实问题之间的差别

同样 margin-top:12px 但是得到的间距不一致

  • 每隔一段时间品牌就会升级一次,基础 UI 翻新,会有较大的工作量
  • 设计师间约定的规范没有很好的落实,已经设计好的设计稿大家共享不便
  • 已经开发好的组件没有形成很好的复用

·

1.2 Fusion 工作流

去除重复流程,只关注业务

  • 设计师更加方便的做设计
  • 而前端只需关注业务逻辑

·

通过抽象骨架 DPL -> 通过平台定制产出定制好 UI 的组件、模板 -> 流入设计师的工具里面直接拖拽使用 -> 前端直接使用定制好的组件(不需关注组件 UI)

  • 设计师使用的同一套规范的组件,产出的设计稿都是同一套规范。(这里使用 sketch 插件名字叫 FusionCool)
  • 前端不需要关注组件 UI 还原度。(还原度有问题 = 设计配置的问题)

·

1.3 不需要再做从 0~1 的事情

·

  • 设计端使用 sketch 插件(FusionCool)在 sketch 既能设计页面,又能沉淀已经设计完成的模板
  • 开发端使用 开发工具 (Iceworks)在项目中既能使用现成的模块,又能沉淀已经开发完成的模块

那未来在 Fusion 模块模板达到极度丰富后,使用可以方便的找到各个领域的模块模板来使用,不需要从 0 开始搭建。

2. Fusion 能力点

一个平台,两个端

一个平台:fusion.design

两个工具:

  • 开发者工具 Iceworks
  • 设计师工具 FusionCool

2.1 一个平台

https://fusion.design 可以定制自己的 Design System(以下简称 DS)

创建自己的 Design System

每个人或者团队都可以通过 https://fusion.design/sites/new 可以创建自己的站点

站点提供三种能力:文档编辑、主题管理、物料托管。

文档编辑

存储设计师文档和开发文档。

主题配置管理

集成了可以管理、定制、发布组件的主题的能力(下文会简称为配置平台)。

物料托管

可以使用开发好的区块、模板。

区块 - 代码片段

模板 - 脚手架

2.2 两个工具端

设计师工具 - FusionCool

主题发布完成后就到了 Sketch 的插件端 FusionCool,设计师可以在 FusionCool 里面搜索 iconfont 所有素材、使用配置好的组件、使用站点的模块模板。

开发者工具 - Iceworks

Iceworks 是淘宝飞冰团队开发的面向前端开发者的 GUI 工具,开发者无须关注环境的问题,并且有海量物料可用。目前已经和 Fusion 的物料体系打通,可以轻松使用 Fusion 站点的物料。

每个站点有自己的物料源

可直接在 Iceworks 配置物料源地址

项目开发

3. Fusion 的技术实现

Next 组件

Fusion Next 是基于 React 实现的一套 PC 端的组件库,这套组件库已经在阿里内部服务了三年。

github 地址:https://github.com/alibaba-fusion/next

这次开源出来的版本是最近一年基于之前两年的使用经验、问题反馈进行重新整理和优化过。具备以下特性。

易用性

对比上一个版本 80 + 功能,进行 300+ 优化,组件整体代码体积却减小 30%

  • next.min.js 910KB -> 702KB
  • next.min.css 428KB -> 337KB

一共 50+ 组件,打包下来却只有 700 多 K,这个目前在业界比较少组件有能力做到这点。组件之间依赖关系清晰,复用度高也是体积小的原因。

稳定性

组件单测覆盖率近 90%,提供服务以来没有产生过起线上事故。

能力增强

国际化、RTL、无障碍能力全面支持。另外针对中后台表单大数据量场景做了大量性能优化,比如普通 table 随着数据不断增长 render 会越来越慢,大致如下:

Next 引入了 virtual-list ,目前用在了 table 和 select 这两个使用频率较高的组件。因为在大数据量 (测试过 1w 节点)下只渲染需要展示的节点(比如 20 个),所以可以将渲染时长永远的控制在 0.3s 之内。

FusionCool

代码到视觉稿的无损还原

突破 html2svg 的弊端,做到无损还原

早在一年前我们是把设计师在主题配置平台(直接在 web 页面配置组件的主题)的组件直接通过 html2svg 技术直接把组件直接转换为 svg 文件,从而让设计师可以直接在 sketch 里面使用。但是这种方案存在的弊端就是还原度不够(大概 95% 还原度)。

html2svg 的还原度问题

主要原因是 html 采用盒模型 和 svg 的转换并不是一一对应的,所以这里永远有修不完的 bug。虽然 95% 是好的,但是对于设计端来说是完全不能忍受的。

所以 Fusion 项目小组经过近半年的努力终于突破了还原度的问题,流程图如下:

从配置平台导出的不再是 html,而是 DesignToken (设计变量),FusionCool 底层使用 Airbnb 提供的 react-sketch 能力写成的一份 Next 组件,直接通过 DesignToken 覆盖默认变量,最终在 Sketch 端实时渲染。

组件的类型、大小、内容都可以直接在面板配置

图表配置可以直接唤起配置面板

sketch 端的任何点击都可以通过 Event 的方式在 FusionCool 产生配置面板。

4. Fusion 未来

  • 我们会在这半年内让 Fusion 的物料仓库能够极度丰富,可以覆盖到各行业领域。让设计师和开发者都不需要再做 0-1 的事情。
  • 我们期望能够突破视觉稿转代码的技术难题,让视觉稿到可用代码成为可能。

相关链接

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 版本下都实现统计行的技术方案,同时使用上又比较简单。

实现方案

首先来分析下统计行的特点:

  • 统计行是独立的一行数据,会使当前页的数据量 +1,如一页 10 条数据的话,加上统计行则为 11 条。
  • 通常表格竖向滚动时,统计行会固定在表格尾部。
  • 样式和交互需要和表格为一个整体,包括单元格、横向滚动等等。

对于第一点,如果 antd 的 Table 组件设置了分页功能,比如 pagination: { pageSize: 10 },此时就无法展示额外的统计行,所以我们不使用 Table 的分页功能,自己通过组合 Pagination 组件来实现分页,数据传参方面, TabledataSource 除了当前页数据,在拼上统计行数据即可。

第二点,固定在尾部,对于现代 css 来说,直接使用 position: sticky 实现即可。

第三点的话,在第一点提到的方案中已经实现。

整体来说,就是实现以下两个功能点:

  • 不使用 Table 内置的分页,使用 TablePagination 组合来完成。
  • 使用 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 库,在 summaryFixedtrue 的时候,就会加上对应类名,接着就根据 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 代码是处理边框问题的。

固定统计行功能实现完成后,接着通过组合 TablePagination 组件的方式实现统计行的展示。

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>
  );
}

Tablepagination 设置为 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 表格支持统计行功能。当然,上述代码有需要优化的地方,比如翻页后回到表格顶部等等。