S2

简介

透视表也叫做交叉表或多维表，显示多变量之间相互关系的一种表格，可以帮助用户发现它们之间的相互作用，帮助业务进行交叉探索分析，是目前商业 BI 分析领域中使用频率最高的图表之一。

使用

<div id="container" />

import { PivotSheet } from "@antv/s2";

// 准备数据
const data = [
  {
    province: "浙江",
    city: "杭州",
    type: "家具",
    sub_type: "桌子",
    price: "1",
  },
  {
    province: "浙江",
    city: "杭州",
    type: "家具",
    sub_type: "沙发",
    price: "2",
  },
  {
    province: "浙江",
    city: "杭州",
    type: "办公用品",
    sub_type: "笔",
    price: "3",
  },
  {
    province: "浙江",
    city: "杭州",
    type: "办公用品",
    sub_type: "纸张",
    price: "4",
  },
];

// 配置数据
const s2DataConfig = {
  fields: {
    rows: ["province", "city"],
    columns: ["type", "sub_type"],
    values: ["price"]
  },
  data,
};

// 添加配置
const s2Options = {
  width: 600,
  height: 600,
};

// 渲染
async function bootstrap() {
  const container = document.getElementById('container');
  const s2 = new PivotSheet(container, dataCfg, options);

  await s2.render();
}

bootstrap()

查看示例和 API 文档。

在 React 中使用

使用 `@antv/s2`

import React from "react";
import { PivotSheet } from '@antv/s2';

const s2Options = {
  width: 400,
  height: 200,
};

const App = () => {
  const containerRef = React.useRef<HTMLDivElement | null>(null);
  const shouldInit = React.useRef(true);
  const isDevMode = React.useMemo(() => {
    try {
      return process.env['NODE_ENV'] !== 'production';
    } catch {
      return false;
    }
  }, []);

  React.useEffect(() => {
    // 兼容 React 18 StrictMode 开发环境下渲染两次
    if (isDevMode && !shouldInit.current) {
      return;
    }

    const s2 = new PivotSheet(container, dataCfg, s2Options);
    shouldInit.current = false;

    return () => {
      s2?.destroy?.();
    };
  }, []);

  return <div id="container" ref={containerRef} />
}

使用 `@antv/s2-react` 推荐

import React from "react";
import { SheetComponent } from '@antv/s2-react';
import '@antv/s2-react/dist/s2-react.min.css';

const s2Options = {
  width: 400,
  height: 200,
};

const App = () => {
  return (
    <SheetComponent
      sheetType="pivot"
      dataCfg={s2DataConfig}
      options={s2Options}
    />
  )
}

查看示例和 API 文档。

特性

序号

在 s2Options 中传入 seriesNumber 即可展示内置的序号，可以自定义序号列标题。查看示例

const s2Options = {
  seriesNumber: {
    enable: true,
    text: '自定义序号标题' // 默认 "序号"
  }
}

展示形态

默认支持平铺模式和树状模式两种展示形态。

数据汇总

支持小计/总计的透视能力。

冻结行头区域

当行头区域固定时，行头会有一个独立的可滚动区域，如果关闭冻结行头，则滚动区域为整个表格。

const s2Options = {
  frozen: {
    rowHeader: false, // 默认开启
  }
}

默认最大冻结宽度为表格区域的 1/2, 支持自定义：

const s2Options = {
  frozen: {
    rowHeader: 0.2, // 默认 0.5 （可选范围 0 - 1)
  }
}

冻结行、列头单元格

注意

和明细表行列冻结不同，透视表由于带有分组的特性，布局比较复杂，目前有以下限制：

开启序号列场景，且进行了自定义序号列布局时，暂不支持行头单元格冻结，因为此时，我们无法得知用户序号列和行头单元格的对应关系

行列冻结通过在 s2Options 中传入这些属性控制：

const s2Options = {
  frozen: {
    rowCount: number; // 冻结行的叶子节点数量，从顶部开始计数
    trailingRowCount: number; // 冻结行的叶子节点数量，从底部开始计数
    colCount: number; // 冻结列的叶子节点数量，从左侧开始计数
    trailingColCount: number; // 冻结列的叶子节点数量，从右侧开始计数
  }
}

树状模式

const s2Options = {
  hierarchyType: 'tree',
  frozen: {
    rowCount: 1,
  },
}

平铺模式

const s2Options = {
  hierarchyType: 'grid',
  frozen: {
    rowCount: 1,
  },
  totals: {
    row: {
      showGrandTotals: true,
      reverseLayout: true,
    },
  },
}

行列头自定义分组

行列头结构默认根据传入的维值进行分组，同时支持自定义分组。了解更多

透视表

简介

使用