（幾乎）完美實現(xiàn) el-table 列寬自適應

背景

Element UI 是 PC 端比較流行的 Vue.js UI 框架，它的組件庫基本能滿足大部分常見的業(yè)務(wù)需求。但有時候會有一些定制性比較高的需求鸥拧，組件本身可能沒辦法滿足茉稠。最近在項目里就碰到了。

很多頁面都需要用到表格組件el-table卿吐。如果沒有給el-table-column指定寬度旁舰，默認情況下會平均分配給剩余的列。在列數(shù)比較多的情況嗡官，如果el-table寬度限定在容器內(nèi)箭窜，單元格里的內(nèi)容就會換行。強制不換行衍腥，內(nèi)容要么在單元格內(nèi)滾動磺樱，要么就會溢出或被截斷纳猫。

產(chǎn)品想要的效果是：內(nèi)容保持單行顯示，列間距保持一致竹捉，表格超出容器允許水平滾動芜辕。el-table-column是支持設(shè)置固定寬度的，在內(nèi)容寬度可預知的情況下块差，也能滿足這個需求侵续。問題就在于如何讓列寬動態(tài)適應內(nèi)容的寬度。在官方文檔也沒找到這樣的選項憨闰，應該是組件本身不支持状蜗。

技術(shù)方案

于是想到了動態(tài)計算內(nèi)容寬度的方案。網(wǎng)上也有人提過這個思路鹉动，做法是根據(jù)內(nèi)容字符數(shù)來計算寬度轧坎。這種方法有幾個局限：

內(nèi)容必須是文本
不同字符寬度不一，結(jié)算結(jié)果不夠準確
需要在渲染前操作數(shù)據(jù)训裆，不利于解耦

我采用了另一種思路眶根，還是動態(tài)計算內(nèi)容寬度，但是根據(jù)實際渲染后的 DOM 元素寬度边琉，這樣就能解決上面三個問題属百。

具體怎么做呢？通過查看渲染后的 DOM 元素發(fā)現(xiàn)变姨，el-table 的表頭和內(nèi)容分別用了一個原生table族扰，通過colgroup設(shè)置每列的寬度。就從這里入手定欧，col的name屬性值和對應的 td的class值是一致的渔呵，這樣就可以遍歷對應列的所有單元格，找出寬度最大的單元格砍鸠，用它的內(nèi)容寬度加上一個邊距作為該列的寬度扩氢。

image

具體實現(xiàn)

怎么計算內(nèi)容寬度呢？這是個比較關(guān)鍵的步驟爷辱。渲染后的每個單元格有個.cell類录豺，用white-space: nowrap; overflow: auto;設(shè)置為不允許換行，內(nèi)容超出后可滾動饭弓，同時設(shè)置display: inline-block;以便計算實際內(nèi)容寬度双饥。這樣，最終的寬度可通過.cell元素的scrollWidth屬性得到弟断。

function adjustColumnWidth(table) {
  const colgroup = table.querySelector("colgroup");
  const colDefs = [...colgroup.querySelectorAll("col")];
  colDefs.forEach((col) => {
    const clsName = col.getAttribute("name");
    const cells = [
      ...table.querySelectorAll(`td.${clsName}`),
      ...table.querySelectorAll(`th.${clsName}`),
    ];
    // 忽略加了"leave-alone"類的列
    if (cells[0]?.classList?.contains?.("leave-alone")) {
      return;
    }
    const widthList = cells.map((el) => {
      return el.querySelector(".cell")?.scrollWidth || 0;
    });
    const max = Math.max(...widthList);
    const padding = 32;
    table.querySelectorAll(`col[name=${clsName}]`).forEach((el) => {
      el.setAttribute("width", max + padding);
    });
  });
}

中間的探索過程比較繁瑣咏花，但最終的代碼實現(xiàn)卻非常簡潔。在什么時候觸發(fā)列寬計算呢阀趴？自然是組件渲染完成后昏翰。為了方便重用苍匆，我采用了 Vue 自定義指令的方式。

Vue.directive("fit-columns", {
  update() {},
  bind() {},
  inserted(el) {
    setTimeout(() => {
      adjustColumnWidth(el);
    }, 300);
  },
  componentUpdated(el) {
    el.classList.add("r-table");
    setTimeout(() => {
      adjustColumnWidth(el);
    }, 300);
  },
  unbind() {},
});

更進一步棚菊，我封裝了一個 Vue 插件叫v-fit-columns锉桑，已經(jīng)發(fā)布到 npm 倉庫，直接安裝即可使用窍株。
安裝：

npm install v-fit-columns --save

引入：

import Vue from 'vue';
import Plugin from 'v-fit-columns';
Vue.use(Plugin);

使用：

<el-table v-fit-columns>
  <el-table-column label="No." type="index" class-name="leave-alone"></el-table-column>
  <el-table-column label="Name" prop="name"></el-table-column>
  <el-table-column label="Age" prop="age"></el-table-column>
</el-table>

源碼倉庫在這：https://github.com/kaysonli/v-fit-columns ，歡迎各位不吝賜教和 Star攻柠！

總結(jié)

這個方案多少有點 Hack 的意味球订，只顧實現(xiàn)需求，可能在其他方面還有點瑕疵瑰钮，比如渲染完后會稍微閃一下（因為要重新調(diào)整寬度冒滩，會出現(xiàn) reflow）。不過從最終實現(xiàn)的效果來看浪谴，還算令人滿意开睡，至少產(chǎn)品經(jīng)理提著他的兩米大刀走了……他可是為了這個效果，蹲守在我電腦前半個下午苟耻，非要我實現(xiàn)不可篇恒！在手摸手的脅迫下，總算完事交差了……

公眾號原文