element-pivot v0.0.5

Element Pivot

中文说明

Brief

Element Plus does not provide a pivot table, so here it is. It is based on Element Plus Table.

Installation

First vue3 and Element Plus should be installed.el-table and el-table-column should be registered.

Then install Element Pivot (The exmple below is using npm, please change properly if other package manager is used)

npm i element-pivot -save

How to use

First import pivot

import { Pivot } from 'element-pivot'

Then use directly,attributes are described at next chapter

 <Pivot
    :data="data"
    :dimensionCol="dimensionCol"
    :dimensionRow="dimensionRow"
    :metric="metric"
    :option="option"
  ></Pivot>

Attributes

data

Same as element table. It is an Array, a sample item is as below

{
    category: 'Electronic',
    goods: 'Mouse',
    province: 'An hui',
    city: 'An qing',
    district: 'Tai hu',
    quantity: 222,
    amount: 2220
  }

dimensionCol

Any array to describe the columns at horizontal direction.

Each array item has the following fields. |Field|Description| |---|---| |key|Uniquely identify this dimension,it is also the field name in tableData| |label|Label to shown in table header|

An array item sample

{ key: 'city', label: 'City'}

dimensionRow

Any array to describe the row at vertical direction.

Each array item has the following fields. |Field|Description| |---|---| |key|Uniquely identify this dimension,it is also the field name in tableData| |label|Label to shown in row| |option|Normally used to control the column width,refer to ExtendTableColumn|

An array item sample

  { key: 'goods', label: 'Goods', option: { widthPerChar: 10, widthBase: 32 } }

metric

Any array to describe the value to shown at the cross of dimension row and dimension column.

Each array item has the following fields. |Field|Description| |---|---| |key|Uniquely identify this metric,it is also the field name in tableData| |label|Label to shown in row| |option|Normally used to control the column width,refer to ExtendTableColumn| |formatter|Same as element table column formatter|

Array item sample

  {
    key: 'amount',
    label: 'Amount',
    option: { widthPerChar: 10, widthBase: 24 },
    formatter: (row: any, column: any, cellValue: any, index: number) => {
      if (cellValue != undefined) {
        return '$' + cellValue.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ',')
      } else {
        return '-'
      }
    }
  }

option

An object to customize the pivot.

ExtendTableColumn

Element plus table column can not be configured by MTTK vue wrap if there is grouping table head .

And ExtendTableColumn also implements the below features

• align

  If the column value is number, align to right;otherwise align to left.

• min-width

  Automatically calculate column min width from column label and column value.

Attribute

Element plus table column attributes can be set directly, an additional attribute named option is defined with follwing fields. And please also note min-width and align can be set directly to override the result evaluated by ExtendTableColumn.

min width evaluation

It is hard to calculate the width of an text to displayed in screen. Below is an estimation.

1.For each column calcuate the length of column label and all the values of this column , and get the maximized value.

2. Calcuate the text length.

Length1=str.length
Length2=new TextEncoder().encode(str)
TextLength=(Length1+Length2)/2

This is a compromise since some characters such as Chinese character may consume more space than English character

3. Calcuate min width

min length=widthPerChar*TextLength+widthBase+'px'

Performance

It is NOT recommanded to tranfer a big data into tableData. Below is a simple performance test. The performance looks good.

Limitaion and Next step

1. Row/Col collapse support
2. Filter the row/col dimension values,for example only some city's data are shown

Licence

MIT