摘要：加這兩個屬性的原因很容易想到，因為我們在寫表格相關業務時，樣式里面寫的最多的就是單元格的寬度和對齊方式。然而，寫的表格后粘貼在中，整行的內容都在一個單元格里面，用寫的表格則能夠幾乎保持原本的格式，所以我們這次用了原生的來寫表格。

Table 是最常用展示數據的方式之一，可是一個產品中往往很多非常類似的 Table，但是我們碰到的情況往往是 Table A 要排序，Table B 不需要排序，等等這種看起來非常類似，但是又不完全相同的表格。這種情況下，到底要不要抽取一個公共的 Table 組件呢？對于這個問題，我們團隊也糾結了很久，先后開發了多個版本的 Table 組件，在最近的一個項目中，產出了第三版 Table 組件，能夠較好的解決靈活性和公共邏輯抽取的問題。本文將會詳細的講述這種 Table 組件解決方案產出的過程和一些思考。

首先我們看到的是不使用任何組件實現一個業務表格的代碼：

import React, { Component } from "react";

const columnOpts = [
  { key: "a", name: "col-a" },
  { key: "b", name: "col-b" },
];

function SomeTable(props) {
  const { data } = props;

  return (
    

      

        {
          columnOpts.map((opt, colIndex) => (
            
{opt.name}
          ))
        }
      
      

        {
          data.map((entry, rowIndex) => (
            

              {
                columnOpts.map((opt, colIndex) => (
                  {entry[opt.key]}
                ))
              }
            
          ))
        }
      
    
  );
}

這種實現方法帶來的問題是：

每次寫表格需要寫很多布局類的樣式

重復代碼很多，而且項目成員之間很難達到統一，A 可能喜歡用表格來布局，B 可能喜歡用 ul 來布局

相似但是不完全相同的表格很難復用

組件是對數據和方法的一種封裝，在封裝之前，我們總結了一下表格型的展示的特點：

輸入數據源較統一，一般為對象數組

thead 中的單元格大部分只是展示一些名稱，也有一些個性化的內容，如帶有排序 icon 的單元格

tbody 中的部分單元格只是簡單的讀取一些值，很多單元格的都有自己的邏輯，但是在一個產品中通常很多類似的單元格

列是有順序的，更適合以列為單位來添加布局樣式

基于以上特點，我們希望 Table 組件能夠滿足以下條件：

接收一個 對象數組 和 所有列的配置 為參數，自動創建基礎的表格內容

thead 和 tbody 中的單元格都能夠定制化，以滿足不同的需求

至此，我們首先想到 Table 組件應該長成這樣的：

const columnOpts =  [
  { key: "a", name: "col-a", onRenderTd: () => {} },
  { key: "b", name: "col-b", onRenderTh: () => {}, onRenderTd: () => {} },
];

其中 onRenderTd 和 onRenderTh 分別是渲染 td 和 th 時的回調函數。
到這里我們發現對于稍微復雜一點的 table，columnOpts 將會是一個非常大的配置數組，我們有沒有辦法不使用數組來維護這些配置呢？這里我們想到的一個辦法是創建一個 Column 的組件，讓大家可以這么來寫這個 table:

  

這樣大家就可以像寫HTML一樣把一個簡單的表格給搭建出來了。

有了 Table 的雛形，再聯系下寫表格的常見需求，我們給 Column 添加了 width 和 align 屬性。加這兩個屬性的原因很容易想到，因為我們在寫表格相關業務時，樣式里面寫的最多的就是單元格的寬度和對齊方式。我們來看一下 Column 的實現：

import React, { PropTypes, Component } from "react";

const propTypes = {
  name: PropTypes.string,
  dataKey: PropTypes.string.isRequired,
  align: PropTypes.oneOf(["left", "center", "right"]),
  width: PropTypes.oneOfType([PropTypes.number, PropTypes.string]),
  th: PropTypes.oneOfType([PropTypes.element, PropTypes.func]),
  td: PropTypes.oneOfType([
    PropTypes.element, PropTypes.func, PropTypes.oneOf([
      "int", "float", "percent", "changeRate"
    ])
  ]),
};

const defaultProps = {
  align: "left",
};

function Column() {
  return null;
}

Column.propTypes = propTypes;
Column.defaultProps = defaultProps;

export default Column;

代碼中可以發現 th 可以接收兩種格式，一種是 function，一種是 ReactElement。這里提供 ReactElement 類型的 th 主要讓大家能夠設置一些額外的 props，后面我們會給出一個例子。

td 的類型就更復雜了，不僅能夠接收 function 和 ReactElement 這兩種類型，還有 int, float, percent, changeRate 這三種類型是最常用的數據類型，這樣方便我們可以在 Table 里面根據類型對數據做格式化，省去了項目成員中很多重復的代碼。

下面我們看一下 Table 的實現：

const getDisplayName = (el) => {
  return el && el.type && (el.type.displayName || el.type.name);
};

const renderChangeRate = (changeRate) => { ... };

const renderThs = (columns) => {
  return columns.map((col, index) => {
    const { name, dataKey, th } = col.props;
    const props = { name, dataKey, colIndex: index };
    let content;
    let className;

    if (React.isValidElement(th)) {
      content = React.cloneElement(th, props);
      className = getDisplayName(th);
    } else if (_.isFunction(th)) {
      content = th(props);
    } else {
      content = name || "";
    }

    return (
      
        {content}
      
    );
  });
};

const renderTds = (data, entry, columns, rowIndex) => {
  return columns.map((col, index) => {
    const { dataKey, td } = col.props;
    const value = getValueOfTd(entry, dataKey);
    const props = { data, rowData: entry, tdValue: value, dataKey, rowIndex, colIndex: index };

    let content;
    let className;
    if (React.isValidElement(td)) {
      content = React.cloneElement(td, props);
      className = getDisplayName(td);
    } else if (td === "changeRate") {
      content = renderChangeRate(value || "");
    } else if (_.isFunction(td)) {
      content = td(props);
    } else {
      content = formatIndex(parseValueOfTd(value), dataKey, td);
    }

    return (
      
        {content}
      
    );
  });
};

const renderRows = (data, columns) => {
  if (!data || !data.length) {return null;}

  return data.map((entry, index) => {
    return (
      
        {renderTds(data, entry, columns, index)}
      
    );
  });
};

function Table(props) {
  const { children, data, className } = props;
  const columns = findChildrenByType(children, Column);

  return (
    

      
        {hasNames(columns) && (
          
              {renderThs(columns)}
            
        )}
        {renderRows(data, columns)}
    
  );
}

代碼說明了一切，就不再詳細說了。當然，在業務組件里，還可以加上公共的錯誤處理邏輯。

前面提到我們的 td 和 th 還可以接收 ReactElement 格式的 props，大家可能還有會有點疑惑，下面我們看一個 SortableTh 的例子：

class SortableTh extends Component {
 static displayName = "SortableTh";

 static propTypes = {
    ...,
    initialOrder: PropTypes.oneOf(["asc", "desc"]),
    order: PropTypes.oneOf(["asc", "desc", "none"]).isRequired,
    onChange: PropTypes.func.isRequired,
 };

 static defaultProps = {
   order: "none",
   initialOrder: "desc",
 };

 onClick = () => {
   const { onChange, initialOrder, order, dataKey } = this.props;

   if (dataKey) {
     let nextOrder = "none";

     if (order === "none") {
       nextOrder = initialOrder;
     } else if (order === "desc") {
       nextOrder = "asc";
     } else if (order === "asc") {
       nextOrder = "desc";
     }

     onChange({ orderBy: dataKey, order: nextOrder });
   }
 };

 render() {
   const { name, order, hasRate, rateType } = this.props;

   return (
     

       {name}
       
     
   );
 }
}

通過這個例子可以看到，th 和 td 接收 ReactElement 類型的 props 能夠讓外部很好的控制單元格的內容，每個單元格不只是接收 data 數據的封閉單元。

總結一些自己的感想：

前端工程師也需要往前走一步，了解用戶習慣。在寫這個組件之前，我一直是用 ul 來寫表格的，用 ul 寫的表格調整樣式比較便利，后來發現用戶很多時候喜歡把整個表格里面的內容 copy 下來用于存檔。然而，ul 寫的表格 copy 后粘貼在 excel 中，整行的內容都在一個單元格里面，用 table 寫的表格則能夠幾乎保持原本的格式，所以我們這次用了原生的 table 來寫表格。

業務代碼中組件抽取的粒度一直是一個比較糾結的問題。粒度太粗，項目成員之間需要寫很多重復的代碼。粒度太細，后續可擴展性又很低，所以只能是大家根據業務特點來評估了。像 Table 這樣的組件非常通用，而且后續肯定有新的類型冒出來，所以粒度不宜太細。當然，我們這樣寫 Table 組件后，大家可以抽取常用的一些 XXXTh 和 XXXTd。

最終，我把這次 Table 組件的經驗抽離出來，開源到 https://github.com/recharts/react-smart-table，希望開發者們可以參考。