Easy UI

Table 表格 ​

引入 ​

js

js
<script type='module'>
  import "./node_modules/easy-component-ui/components/ea-table/index.js";
</script>

css

TIP

需要注意的是, 如果需要使用到带有图标的 属性/组件, 需要提前使用 link 标签引入图标文件

html
<link
  rel="stylesheet"
  href="./node_modules/easy-component-ui/components/ea-icon/index.css"
/>

自定义样式 ​

移步到 CSS Part。

基础表格 ​

基础的表格展示用法。

WARNING

注意: 在 VUE 环境下, data 的设置推荐在 Table 定义后触发时设置，否则可能会导致表格数据不渲染。此后示例同此情况。

同理, 若原生环境出现该问题, 也可使用该方法。

js
await customElements.whenDefined("ea-table");
html
<div class="demo">
  <ea-table id="basicTable">
    <ea-table-column label="Date" prop="date" width="180px"></ea-table-column>
    <ea-table-column label="Name" prop="name" width="180px"></ea-table-column>
    <ea-table-column label="Address" prop="address"></ea-table-column>
  </ea-table>
</div>
js
const data = [
  {
    date: "2016-05-03",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-02",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-04",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-01",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
];

const basicTable = document.querySelector("#basicTable");
basicTable.setData(data);

带斑马纹表格 ​

使用带斑马纹的表格，可以更容易区分出不同行的数据。

html
<div class="demo">
  <ea-table id="stripeTable" stripe>
    <ea-table-column label="Date" prop="date" width="180px"></ea-table-column>
    <ea-table-column label="Name" prop="name" width="180px"></ea-table-column>
    <ea-table-column label="Address" prop="address"></ea-table-column>
  </ea-table>
</div>
js
const data = [
  {
    date: "2016-05-03",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-02",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-04",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-01",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
];

const stripeTable = document.querySelector("#stripeTable");
stripeTable.setData(data);

带边框表格 ​

html
<div class="demo">
  <ea-table id="borderTable" border>
    <ea-table-column label="Date" prop="date" width="180px"></ea-table-column>
    <ea-table-column label="Name" prop="name" width="180px"></ea-table-column>
    <ea-table-column label="Address" prop="address"></ea-table-column>
  </ea-table>
</div>
js
const data = [
  {
    date: "2016-05-03",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-02",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-04",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-01",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
];

const borderTable = document.querySelector("#borderTable");
borderTable.setData(data);

带状态表格 ​

html
<div class="demo">
  <ea-table id="statusTable">
    <ea-table-column label="Date" prop="date" width="180px"></ea-table-column>
    <ea-table-column label="Name" prop="name" width="180px"></ea-table-column>
    <ea-table-column label="Address" prop="address"></ea-table-column>
  </ea-table>
</div>
css
#statusTable::part(warning-row) {
  --ea-table-bg-color: rgb(253, 246, 236);
}

#statusTable::part(success-row) {
  --ea-table-bg-color: rgb(240, 249, 235);
}
js
const data = [
  {
    date: "2016-05-03",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-02",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-04",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-01",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
];

const statusTable = document.querySelector("#statusTable");
statusTable.setData(data);

statusTable.setRowStylePart(
  /**
   * @param {object} param0
   * @param {User} param0.row
   * @param {number} param0.rowIndex
   */
  ({ row, rowIndex }) => {
    if (rowIndex === 1) {
      return "warning-row";
    } else if (rowIndex === 3) {
      return "success-row";
    }

    return "";
  }
);

固定表头 ​

纵向内容过多时，可选择固定表头。

html
<div class="demo">
  <ea-table id="fixedHeaderTable" height="200px">
    <ea-table-column label="Date" prop="date" width="180px"></ea-table-column>
    <ea-table-column label="Name" prop="name" width="180px"></ea-table-column>
    <ea-table-column label="Address" prop="address"></ea-table-column>
  </ea-table>
</div>
js
const moreData = [
  {
    date: "2016-05-03",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-02",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-04",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-01",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-08",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-06",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-07",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
];

const fixedHeaderExample = {
  table: document.querySelector("#fixedHeaderTable"),
  init() {
    this.table.setData(moreData);
  },
};
fixedHeaderExample.init();

固定列 ​

横向内容过多时，可选择固定列。

Detail Edit
html
<div class="demo">
  <ea-table id="fixedColumnTable">
    <ea-table-column
      prop="date"
      label="Date"
      width="150px"
      fixed
    ></ea-table-column>
    <ea-table-column prop="name" label="Name" width="120px"></ea-table-column>
    <ea-table-column prop="state" label="State" width="120px"></ea-table-column>
    <ea-table-column prop="city" label="City" width="120px"></ea-table-column>
    <ea-table-column
      prop="address"
      label="Address"
      width="600px"
    ></ea-table-column>
    <ea-table-column prop="zip" label="Zip" width="120px"></ea-table-column>
    <ea-table-column prop="action" fixed="right" label="Operations">
      <ea-button
        link
        type="primary"
        size="small"
        style="margin-right: 0.5rem"
        onclick="getRowData(document.querySelector('#fixedColumnTable'))"
      >
        Detail
      </ea-button>
      <ea-button
        link
        type="primary"
        size="small"
        onclick="console.log('click')"
      >
        Edit
      </ea-button>
    </ea-table-column>
  </ea-table>
</div>
js
const moreData = [
  {
    date: "2016-05-03",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-02",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-04",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-01",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-08",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-06",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-07",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
];

window.handleSearch = keywords => {
  const res = searchData.filter(item => {
    return item.name.toLowerCase().includes(keywords.toLowerCase());
  });

  customHeaderTableExample.table.setData(res);
};

const fixedHeaderExample = {
  table: document.querySelector("#fixedHeaderTable"),
  init() {
    this.table.setData(moreData);
  },
};
fixedHeaderExample.init();

固定列和表头 ​

当您有大量数据块放入表中，您可以同时固定表头和列。

固定列和表头可以同时使用，只需要将上述两个属性分别设置好即可。

html
<div class="demo">
  <ea-table id="fixedColumnAndHeaderTable" style="width: 100%" height="200px">
    <ea-table-column
      fixed
      prop="date"
      label="Date"
      width="150px"
    ></ea-table-column>
    <ea-table-column prop="name" label="Name" width="120px"></ea-table-column>
    <ea-table-column prop="state" label="State" width="120px"></ea-table-column>
    <ea-table-column prop="city" label="City" width="320px"></ea-table-column>
    <ea-table-column
      prop="address"
      label="Address"
      width="600px"
    ></ea-table-column>
    <ea-table-column prop="zip" label="Zip"></ea-table-column>
  </ea-table>
</div>
js
const detailsData = [
  {
    date: "2016-05-03",
    name: "Tom",
    state: "California",
    city: "Los Angeles",
    address: "No. 189, Grove St, Los Angeles",
    zip: "CA 90036",
  },
  {
    date: "2016-05-02",
    name: "Tom",
    state: "California",
    city: "Los Angeles",
    address: "No. 189, Grove St, Los Angeles",
    zip: "CA 90036",
  },
  {
    date: "2016-05-04",
    name: "Tom",
    state: "California",
    city: "Los Angeles",
    address: "No. 189, Grove St, Los Angeles",
    zip: "CA 90036",
  },
  {
    date: "2016-05-01",
    name: "Tom",
    state: "California",
    city: "Los Angeles",
    address: "No. 189, Grove St, Los Angeles",
    zip: "CA 90036",
  },
  {
    date: "2016-05-08",
    name: "Tom",
    state: "California",
    city: "Los Angeles",
    address: "No. 189, Grove St, Los Angeles",
    zip: "CA 90036",
  },
  {
    date: "2016-05-06",
    name: "Tom",
    state: "California",
    city: "Los Angeles",
    address: "No. 189, Grove St, Los Angeles",
    zip: "CA 90036",
  },
  {
    date: "2016-05-07",
    name: "Tom",
    state: "California",
    city: "Los Angeles",
    address: "No. 189, Grove St, Los Angeles",
    zip: "CA 90036",
  },
];

const fixedColumnAndHeaderExample = {
  table: document.querySelector("#fixedColumnAndHeaderTable"),
  init() {
    this.table.setData(detailsData);
  },
};
fixedColumnAndHeaderExample.init();

多级表头 ​

数据结构比较复杂的时候，可使用多级表头来展现数据的层次关系。

只需要将 ea-table-column 放置于 ea-table-column 中，你可以实现组头。

html
<div class="demo">
  <ea-table id="groupingHeadTable" border style="width: 100%">
    <ea-table-column prop="date" label="Date" width="150px"></ea-table-column>
    <ea-table-column label="Delivery Info">
      <ea-table-column prop="name" label="Name" width="120px"></ea-table-column>
      <ea-table-column label="Address Info">
        <ea-table-column
          prop="state"
          label="State"
          width="120px"
        ></ea-table-column>
        <ea-table-column
          prop="city"
          label="City"
          width="120px"
        ></ea-table-column>
        <ea-table-column prop="address" label="Address"></ea-table-column>
        <ea-table-column prop="zip" label="Zip" width="120px"></ea-table-column>
      </ea-table-column>
    </ea-table-column>
  </ea-table>
</div>
js
const detailsData = [
  {
    date: "2016-05-03",
    name: "Tom",
    state: "California",
    city: "Los Angeles",
    address: "No. 189, Grove St, Los Angeles",
    zip: "CA 90036",
  },
  {
    date: "2016-05-02",
    name: "Tom",
    state: "California",
    city: "Los Angeles",
    address: "No. 189, Grove St, Los Angeles",
    zip: "CA 90036",
  },
  {
    date: "2016-05-04",
    name: "Tom",
    state: "California",
    city: "Los Angeles",
    address: "No. 189, Grove St, Los Angeles",
    zip: "CA 90036",
  },
  {
    date: "2016-05-01",
    name: "Tom",
    state: "California",
    city: "Los Angeles",
    address: "No. 189, Grove St, Los Angeles",
    zip: "CA 90036",
  },
  {
    date: "2016-05-08",
    name: "Tom",
    state: "California",
    city: "Los Angeles",
    address: "No. 189, Grove St, Los Angeles",
    zip: "CA 90036",
  },
  {
    date: "2016-05-06",
    name: "Tom",
    state: "California",
    city: "Los Angeles",
    address: "No. 189, Grove St, Los Angeles",
    zip: "CA 90036",
  },
  {
    date: "2016-05-07",
    name: "Tom",
    state: "California",
    city: "Los Angeles",
    address: "No. 189, Grove St, Los Angeles",
    zip: "CA 90036",
  },
];

const groupingHeadTable = document.querySelector("#groupingHeadTable");
groupingHeadTable.setData(detailsData);

单选 ​

选择单行数据时使用色块表示。

Select second rowClear selection
html
<div class="demo">
  <ea-table id="radioTable" border highlight-current-row>
    <ea-table-column label="Date" prop="date" width="180px"></ea-table-column>
    <ea-table-column label="Name" prop="name" width="180px"></ea-table-column>
    <ea-table-column label="Address" prop="address"></ea-table-column>
  </ea-table>
  <div style="margin-top: 20px">
    <ea-button id="radioTableSelectBtn">Select second row</ea-button>
    <ea-button id="radioTableClearBtn">Clear selection</ea-button>
  </div>
</div>
js
const data = [
  {
    date: "2016-05-03",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-02",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-04",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-01",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
];

const radioTable = {
  table: document.querySelector("#radioTable"),

  selectBtn: document.querySelector("#radioTableSelectBtn"),
  clearBtn: document.querySelector("#radioTableClearBtn"),

  init() {
    this.table.setData(data);

    this.table.addEventListener("current-change", e => {
      console.log(e.detail.row);
    });

    this.selectBtn.addEventListener("click", () => {
      this.table.setCurrentRow(data[1]);
    });

    this.clearBtn.addEventListener("click", () => {
      this.table.setCurrentRow();
    });
  },
};
radioTable.init();

多选 ​

选择多行数据时使用 Checkbox。

Toggle selection status of second and third rows Toggle selection status based on selectable Clear selection
html
<div class="demo">
  <ea-table id="selectionTable" border>
    <ea-table-column type="selection" width="55px"></ea-table-column>
    <ea-table-column label="Date" prop="date" width="180px"></ea-table-column>
    <ea-table-column label="Name" prop="name" width="180px"></ea-table-column>
    <ea-table-column label="Address" prop="address"></ea-table-column>
  </ea-table>
  <div style="margin-top: 20px">
    <ea-button id="selectionTableToggleSelection1">
      Toggle selection status of second and third rows
    </ea-button>
    <ea-button id="selectionTableToggleSelection2">
      Toggle selection status based on selectable
    </ea-button>
    <ea-button id="selectionTableClearSelection"> Clear selection </ea-button>
  </div>
</div>
js
const data = [
  {
    id: 1,
    date: "2016-05-03",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    id: 2,
    date: "2016-05-02",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    id: 3,
    date: "2016-05-04",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    id: 4,
    date: "2016-05-01",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
];

const selectionTable = {
  table: document.querySelector("#selectionTable"),
  secondAndThirdBtn: document.querySelector("#selectionTableToggleSelection1"),
  thirdBtn: document.querySelector("#selectionTableToggleSelection2"),
  clearBtn: document.querySelector("#selectionTableClearSelection"),

  toggleSelection(rows, ignoreSelectable) {
    if (rows) {
      rows.forEach(row => {
        this.table.toggleRowSelection(row, undefined, ignoreSelectable);
      });
    } else {
      this.table.clearSelection();
    }
  },

  init() {
    this.table.selectable = row => ![1, 2].includes(row.id);
    this.table.setData(data);

    this.secondAndThirdBtn.addEventListener("click", () => {
      this.toggleSelection([data[1], data[2]]);
    });

    this.thirdBtn.addEventListener("click", () => {
      this.toggleSelection([data[1], data[2]], false);
    });

    this.clearBtn.addEventListener("click", () => {
      this.toggleSelection();
    });
  },
};
selectionTable.init();

自定义索引 ​

自定义 type=index 列的行号。

html
<div class="demo">
  <ea-table id="increaseliyTable" style="width: 100%">
    <ea-table-column type="index"></ea-table-column>
    <ea-table-column prop="date" label="Date" width="180px"></ea-table-column>
    <ea-table-column prop="name" label="Name" width="180px"></ea-table-column>
    <ea-table-column prop="address" label="Address"></ea-table-column>
  </ea-table>
</div>
js
const data = [
  {
    id: 1,
    date: "2016-05-03",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    id: 2,
    date: "2016-05-02",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    id: 3,
    date: "2016-05-04",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    id: 4,
    date: "2016-05-01",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
];

const increaseliyTable = {
  table: document.querySelector("#increaseliyTable"),

  init() {
    this.table.indexMethod = index => index * 2;

    this.table.setData(data);
  },
};
increaseliyTable.init();

排序 ​

对表格进行排序，可快速查找或对比数据。

html
<div class="demo">
  <ea-table id="sortableTable" border>
    <ea-table-column
      label="Date"
      prop="date"
      width="180px"
      sortable
    ></ea-table-column>
    <ea-table-column label="Name" prop="name" width="180px"></ea-table-column>
    <ea-table-column label="Address" prop="address"></ea-table-column>
  </ea-table>
</div>
js
const data = [
  {
    id: 1,
    date: "2016-05-03",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    id: 2,
    date: "2016-05-02",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    id: 3,
    date: "2016-05-04",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    id: 4,
    date: "2016-05-01",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
];

const sortableTable = {
  table: document.querySelector("#sortableTable"),

  init() {
    this.table.setData(data);

    this.table.addEventListener("sort-change", e => {
      console.log(e.detail);
    });
  },
};
sortableTable.init();

自定义列模板 ​

自定义某列的显示内容，可组合其他组件使用。通过设置 data-scope="dataKey" 来指定数据源字段。

Detail Edit
html
<div class="demo">
  <ea-table id="customColumnTable">
    <ea-table-column prop="date" label="Date" width="180px">
      <ea-icon icon="icon-clock"></ea-icon>
      <span data-scope="date"></span>
    </ea-table-column>
    <ea-table-column prop="name" label="Info" width="180px">
      <ea-tag data-scope="city"></ea-tag>
      <span data-scope="name"></span>
    </ea-table-column>
    <ea-table-column prop="action" fixed="right" label="Operations">
      <ea-button
        size="small"
        style="margin-right: 0.5rem"
        onclick="getRowData(document.querySelector('#customColumnTable'))"
      >
        Detail
      </ea-button>
      <ea-button
        type="danger"
        size="small"
        onclick="getRowData(document.querySelector('#customColumnTable'))"
      >
        Edit
      </ea-button>
    </ea-table-column>
  </ea-table>
</div>
js
const detailsData = [
  {
    date: "2016-05-03",
    name: "Tom",
    state: "California",
    city: "Los Angeles",
    address: "No. 189, Grove St, Los Angeles",
    zip: "CA 90036",
  },
  {
    date: "2016-05-02",
    name: "Tom",
    state: "California",
    city: "Los Angeles",
    address: "No. 189, Grove St, Los Angeles",
    zip: "CA 90036",
  },
  {
    date: "2016-05-04",
    name: "Tom",
    state: "California",
    city: "Los Angeles",
    address: "No. 189, Grove St, Los Angeles",
    zip: "CA 90036",
  },
  {
    date: "2016-05-01",
    name: "Tom",
    state: "California",
    city: "Los Angeles",
    address: "No. 189, Grove St, Los Angeles",
    zip: "CA 90036",
  },
  {
    date: "2016-05-08",
    name: "Tom",
    state: "California",
    city: "Los Angeles",
    address: "No. 189, Grove St, Los Angeles",
    zip: "CA 90036",
  },
  {
    date: "2016-05-06",
    name: "Tom",
    state: "California",
    city: "Los Angeles",
    address: "No. 189, Grove St, Los Angeles",
    zip: "CA 90036",
  },
  {
    date: "2016-05-07",
    name: "Tom",
    state: "California",
    city: "Los Angeles",
    address: "No. 189, Grove St, Los Angeles",
    zip: "CA 90036",
  },
];

window.getRowData = table => {
  /** @type {{target: HTMLTableRowElement, value: any}} */
  const res = table.getCurrentRow();
  console.log(res.value);
};

const customColumnExample = {
  table: document.querySelector("#customColumnTable"),
  init() {
    this.table.setData(detailsData);
  },
};
customColumnExample.init();

自定义表头 ​

表头支持自定义。

Detail Delete
html
<div class="demo">
  <ea-table id="customHeaderTable">
    <ea-table-column label="Date" prop="date" width="180px"></ea-table-column>
    <ea-table-column prop="name" label="Name" width="180px"></ea-table-column>
    <ea-table-column prop="action" label="Operations" align="right">
      <ea-input
        id="customHeaderTableSearch"
        slot="header"
        size="small"
        placeholder="Type to search"
        oninput="handleSearch(this.value)"
      ></ea-input>
      <ea-button
        style="margin-right: 0.5rem"
        onclick="getRowData(document.querySelector('#customHeaderTable'))"
      >
        Detail
      </ea-button>
      <ea-button
        type="danger"
        onclick="getRowData(document.querySelector('#customHeaderTable'))"
      >
        Delete
      </ea-button>
    </ea-table-column>
  </ea-table>
</div>
js
const searchData = [
  {
    date: "2016-05-03",
    name: "Tom",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-02",
    name: "John",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-04",
    name: "Morgan",
    address: "No. 189, Grove St, Los Angeles",
  },
  {
    date: "2016-05-01",
    name: "Jessy",
    address: "No. 189, Grove St, Los Angeles",
  },
];

window.getRowData = table => {
  /** @type {{target: HTMLTableRowElement, value: any}} */
  const res = table.getCurrentRow();
  console.log(res.value);
};

const customColumnExample = {
  table: document.querySelector("#customColumnTable"),
  init() {
    this.table.setData(detailsData);
  },
};
customColumnExample.init();

表尾合计行​ ​

若表格展示的是各类数字，可以在表尾显示各列的合计。


html
<div class="demo">
  <ea-table id="summaryTable" border show-summary>
    <ea-table-column label="ID" prop="id" width="180px"></ea-table-column>
    <ea-table-column label="Name" prop="name"></ea-table-column>
    <ea-table-column label="Amount 1" prop="amount1"></ea-table-column>
    <ea-table-column label="Amount 2" prop="amount2"></ea-table-column>
    <ea-table-column label="Amount 3" prop="amount3"></ea-table-column>
  </ea-table>
  <br />
  <ea-table id="summaryMethodsTable" border show-summary>
    <ea-table-column label="ID" prop="id" width="180px"></ea-table-column>
    <ea-table-column label="Name" prop="name"></ea-table-column>
    <ea-table-column label="Amount 1" prop="amount1"></ea-table-column>
    <ea-table-column label="Amount 2" prop="amount2"></ea-table-column>
    <ea-table-column label="Amount 3" prop="amount3"></ea-table-column>
  </ea-table>
</div>
js
const summaryData = [
  {
    id: "12987122",
    name: "Tom",
    amount1: "234",
    amount2: "3.2",
    amount3: 10,
  },
  {
    id: "12987123",
    name: "Tom",
    amount1: "165",
    amount2: "4.43",
    amount3: 12,
  },
  {
    id: "12987124",
    name: "Tom",
    amount1: "324",
    amount2: "1.9",
    amount3: 9,
  },
  {
    id: "12987125",
    name: "Tom",
    amount1: "621",
    amount2: "2.2",
    amount3: 17,
  },
  {
    id: "12987126",
    name: "Tom",
    amount1: "539",
    amount2: "4.1",
    amount3: 15,
  },
];

const summaryExample = {
  table: document.querySelector("#summaryTable"),
  summaryMethodsTable: document.querySelector("#summaryMethodsTable"),

  init() {
    this.summaryMethodsTable.summaryMethod = /**
     * @param {{columns: ColumnOption, data: any[]}} param
     */ param => {
      const { columns, data } = param;
      const sums = [];

      columns.forEach((column, index) => {
        if (index === 0) {
          sums[index] = "Total Cost";
          return;
        }
        const values = data.map(item => Number(item[column.prop]));
        if (!values.every(value => Number.isNaN(value))) {
          sums[index] = `$ ${values.reduce((prev, curr) => {
            const value = Number(curr);
            if (!Number.isNaN(value)) {
              return prev + curr;
            } else {
              return prev;
            }
          }, 0)}`;
        } else {
          sums[index] = "N/A";
        }
      });

      return sums;
    };

    this.table.setData(summaryData);
    this.summaryMethodsTable.setData(summaryData);
  },
};
summaryExample.init();

Table API ​

Table Attributes ​

参数说明类型可选值默认值
data表格数据 ( 等同于 setData )Array-[]
stripe是否显示斑马纹Boolean-false
border是否显示边框Boolean-false
height表格高度String--
max-height表格最大高度String--
highlight-current-row是否高亮当前行Boolean-false
show-summary是否显示合计行Boolean-false

Table Methods ​

方法名说明参数
setData设置表格数据(dataSource: any[]) => void
sort对指定列进行排序(prop: string, order?: 'asc' | 'desc') => void
setRowStylePart设置行样式(handler: Function | string) => void
getCurrentRow获取当前行数据() => any
setCurrentRow设置当前行数据(row: any) => void
toggleRowSelection切换行选中状态(row: any, selected?: boolean, ignoreSelectable?: boolean) => void
clearSelection清空选择() => void

Table Events ​

事件名说明参数
ea-select选择某一行时触发event.detail: { selection: any[], row: any }
ea-select-all全选时触发event.detail: { selection: any[] }
ea-selection-change多选发生变化时触发event.detail: { newSelection: any[] }
ea-cell-mouse-enter单元格鼠标进入时触发event.detail: { row: any, column: string, cell: HTMLTableCellElement }
ea-cell-mouse-leave单元格鼠标离开时触发event.detail: { row: any, column: string, cell: HTMLTableCellElement }
ea-cell-click点击单元格时触发event.detail: { cell: HTMLTableCellElement, column: string, row: any }
ea-cell-dblclick双击单元格时触发event.detail: { cell: HTMLTableCellElement, column: string, row: any }
ea-cell-contextmenu右键点击单元格时触发event.detail: { cell: HTMLTableCellElement, column: string, row: any }
ea-row-click点击行时触发event.detail: { target: HTMLTableRowElement, column: string, row: any }
ea-row-dblclick双击行时触发event.detail: { target: HTMLTableRowElement, column: string, row: any }
ea-row-contextmenu右键点击行时触发event.detail: { target: HTMLTableRowElement, column: string, row: any }
ea-header-click点击表头时触发event.detail: { cell: HTMLTableCellElement, column: string }
ea-header-contextmenu右键点击表头时触发event.detail: { cell: HTMLTableCellElement, column: string }
ea-sort-change排序变化时触发event.detail: { prop: string, order: 'ascend' | 'descend' }
ea-current-change当前行变化时触发event.detail: { target: HTMLTableRowElement, column: string, row: any }
ea-table-data-rendered表格在数据渲染完成后触发-

Table CSS Part ​

用法可参考 MDN ::part()伪类

名称说明
container外层容器，即整个表格容器
colgroup表格列（colgroup）部分
col表格列（col）部分
thead表格头部（thead）部分
thead-tr表格头部行（tr）部分
thead-th表格头部列（th）部分
checkbox表格复选框（checkbox）当存在 type="selection" 的列时有效
asc-icon表格排序图标（asc-icon）当存在 sortable="true" 的列时有效
desc-icon表格排序图标（desc-icon）当存在 sortable="true" 的列时有效
tbody表格主体（tbody）部分
tbody-tr表格行（tr）部分
tbody-td表格单元格（td）部分
tfoot表格尾部（tfoot）部分
tfoot-tr表格行（tr）部分
tfoot-td表格单元格（td）部分

Table Slot ​

名称说明
-表格列定义插槽，仅支持 ea-table-column
header表格外头部插槽
empty表格无数据时显示插槽

TableColumn API ​

TableColumn Attributes ​

参数说明类型可选值默认值
label表头标题String--
prop表头对应的数据的键值String--
type列类型Stringselection | index-
align对齐方式Stringleft | center | rightleft
width列宽String--
sortable是否可排序Boolean-false
fixed是否固定列Stringleft | right-

TableColumn Slot ​

名称说明
-默认插槽，用于自定义列内容
header表头插槽，用于自定义表头内容