Skip to content

Commit

Permalink
docs: 完善 2.0 版本文档 (#2492)
Browse files Browse the repository at this point in the history
* docs: 完善 2.0 版本文档

* docs: 所有 demo 替换成 React 18

* docs: 增加多行文本 & 自定义行列头 的文档

* docs: 增加多行文本 demo

* docs: 完善 G 插件和绘制 G2 图表文档和示例

* docs: 完善分析组件相关文档

* docs: 增加暗黑主题文档

* docs: 增加复制导出文档和示例

* docs: 完善基础类 API 文档

* docs: 完善组件 API 文档

* docs: 完善绘图属性文档

* docs: 完善 tooltip 示例

* docs: 更新贡献指南

* docs: 增加 wip 迁移指南

* docs: 修复 React Demo 无法运行

* docs: 修复所有无法允许的 React 和 自定义单元格 Demo

* docs: 增加 目录 tag, 顶部公告, 首页新闻

* fix: 自定义排序错误

* feat(docs): 更新排序文档

* docs: 更新排序组件说明

* docs: 修复排序demo

* chore: 解决冲突

* docs: 更新自定义单元格章节

* docs: 完善表形态相关文档, 剥离行列冻结 demo

* docs: 更新 README 错误的图片和示例

* docs: 更新序号文档

* refactor: 细化 condition 类型

* docs: 更新 condition  文档

* docs: 更新所有 API 文档

* docs: 新增自定义数据集文档

* docs: 更新自定义 icon 文档

* docs: 更新对齐方式文档

* docs: 完善获取数据和交互的文档示例

* docs: 增加自定义数据集文档

* refactor: drawObjectText => drawCustomContent

* refactor: 迁移 type util 位置

* refactor: 多行文本配置从 theme 移动端到 s2Option.style

* feat: 完善交互文档和示例, 调整 selectedCellHighlight 默认值

* refactor: 重构复制导出 API & 默认开启

* build: 修复打包错误

* refactor: 重构 seriesNumber 配置,收敛到 seriesNumber 命名空间下

* docs: 更新 seriesNumber 文档

* test: 快照更新

* docs: 更新 performance 数据

* docs: layout 文档位置迁移

* docs: 完善表头, 自定义 icon 文档 & 修复在线体验打不开

* docs: 优化文档

* docs: 更新数据流程文档

* docs: 更新布局文档插图

* docs: 更改交互文档 demo 链接

* docs: 更新数据流和布局文档

* docs: 更新 faq

* docs: 完善分析组件 & 行列宽高拖拽 & 迁移指南文档

* docs: 完善文档

* docs: 完善宽高拖拽文档

* docs: 修复导航栏样式错误

* docs: 更新组内排序文档

* docs: 更新数据流迁移文档

* docs: 更新版本发布时间说明

* docs: 修复无法运行和展示错误的示例

* docs: 修复文档示例错误和单测

* build: 修复打包错误

* build: 修复 size-limit 找不到

* docs: 更新冻结行头文档

---------

Co-authored-by: 沫君 <[email protected]>
Co-authored-by: wjgogogo <[email protected]>
  • Loading branch information
3 people authored Feb 5, 2024
1 parent ddc1283 commit 2df2032
Show file tree
Hide file tree
Showing 575 changed files with 14,798 additions and 7,939 deletions.
1 change: 1 addition & 0 deletions .markdownlint.json
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@
"link-fragments": false,
"code-block-style": false,
"no-bare-urls": false,
"ol-prefix": false,
"MD003": {
"style": "atx"
},
Expand Down
2 changes: 1 addition & 1 deletion CONTRIBUTING.en-US.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ a cool [pull request](https://github.com/antvis/S2/pulls), or a DingTalk group d

## Branch Management

Currently, we are developing based on the `master` branch. Please check out a branch based on `master,` and Pull Request if you have any modifications. We will review your `PR` for the first time and give you feedback.
Currently, we are developing based on the `next` branch. Please check out a branch based on `next,` and Pull Request if you have any modifications. We will review your `PR` for the first time and give you feedback.

## Report bugs

Expand Down
55 changes: 31 additions & 24 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,57 +7,64 @@

"我代码水平不行", "会不会受到鄙视?", "会不会不太好?", 放心,不存在的!

我们欢迎任何形式的贡献,不管是一个错别字的修改,还是一次友好的建议,不管是通过 提交 [Issue](https://github.com/antvis/S2/issues/new/choose)
还是一个帅气 [pull request](https://github.com/antvis/S2/pulls), 亦或是一次钉钉群的讨论,参与 [discussions](https://github.com/antvis/S2/discussions) 的讨论,期待在 [贡献者列表](https://github.com/antvis/S2/graphs/contributors) 里看见你的头像。
我们欢迎任何形式的贡献,不管是一个**错别字的修改**,还是**一次友好的建议**,不管是通过提交 [Issue](https://github.com/antvis/S2/issues/new/choose), 还是一个帅气 [pull request](https://github.com/antvis/S2/pulls), 亦或是一次钉钉群的讨论,参与 [discussions](https://github.com/antvis/S2/discussions) 的讨论,期待在 [贡献者列表](https://github.com/antvis/S2/graphs/contributors) 里看见你的头像。

## 分支管理

目前,我们基于 `master` 分支开发,有任何修改,请基于 `master` 拉一个分支,然后通过 `PR` 的形式,我们集成了钉钉机器人,会第一次时间 review 你的 PR, 给与反馈
目前我们主要基于 `master` `next` 分支开发,有任何修改,请基于 `master` `next` 拉一个分支,然后通过 `PR` 的形式提交,我们集成了钉钉机器人,会第一次时间 `review` 你的 `PR`, 给与反馈

## 提交 Bug
- `master`: `1.x` 版本
- `next`: `2.x` 版本
- `alpha`: `1.x-alpha.x` 版本
- `beta`: `1.x-beta.x` 版本

很抱歉又写了一些 bug, 对于没一个 bug report 我们都会非常感激。为了提高沟通效率,请尽量多一些细节描述。
## 🐛 提交 Bug 反馈

### 错误示范
很抱歉又写了一些 bug, 但求友好的提交一个有意义的 bug 反馈,谁也不希望反馈的 bug 是这样:

![preview](https://gw.alipayobjects.com/zos/antfincdn/j0jUvKwT%26/dd59fe64-7108-4ad7-a544-e19d79eea890.png)

### 推荐步骤
没有版本信息,没有复现步骤,没有问题描述,没有代码片段,开局一句话,内容全靠猜。

1. 首先选择 [Bug report]
首先选择 [Bug report](https://github.com/antvis/S2/issues/new?assignees=&labels=&projects=&template=bug-report.md&title=%F0%9F%90%9B)

![preview](https://gw.alipayobjects.com/zos/antfincdn/oAnzfiVl2/9d83b3e8-b05c-4475-b736-92c45448546a.png)
![preview](https://gw.alipayobjects.com/zos/antfincdn/oAnzfiVl2/9d83b3e8-b05c-4475-b736-92c45448546a.png)

2. 按照 Issue 模板 填写相关的信息,是的,这些步骤稍微一些繁琐,但确实必须的,每个用户使用的场景都不同,系统环境,软件版本,又或是需要一些特定的步骤才能复现 bug, 这个时候说清楚,可以节省大家的时间呢~
按照 [Issue 模板](https://github.com/antvis/S2/tree/next/.github/ISSUE_TEMPLATE) 填写相关信息。
是的,这些步骤稍微有一些繁琐,但的确是有效且必须的,每个用户使用的场景都不同,系统环境,软件版本,又或是需要一些特定的步骤才能复现 bug, 这个时候说清楚,可以节省大家的时间!

![preview](https://gw.alipayobjects.com/zos/antfincdn/05O3p5nE5/d0d4b120-e5aa-4b51-918b-8a573f8fb794.png)
![preview](https://gw.alipayobjects.com/zos/antfincdn/05O3p5nE5/d0d4b120-e5aa-4b51-918b-8a573f8fb794.png)

## Pull Request
## 🙋‍♂️ Pull Request

1. fork 项目 并 clone 下来 (或者使用 GitHub 的 Codespace 功能,非常方便)
2. 安装依赖:`pnpm install`
3. 提交你的改动,commit 请遵守 [AngularJS Git Commit Message Conventions](https://docs.google.com/document/d/1QrDFcIiPjSLDn3EL15IJygNPiHORgU1_OOAqWjiDU5Y/edit#heading=h.uyo6cb12dt6w)
4. 如果你的改动是修复 bug, 还可以在提交信息后面加上 `close #issue 号`, 这样可以在 pr 合并后,可以自动关闭对应的 issue, 比如 `fix: render bug close #123`
5. 确保加上了对应的单元测试和文档 (如果有 `Snapshot` UI 快照 (.snap 文件)更新, 可以运行 `yarn core:test -- -u``yarn react:test -- -u` 自动更新, 并一起提交上来, 请勿手动编辑)
> 示例 [PR](https://github.com/antvis/S2/pull/1652) (pr 描述参考)
1. fork 项目 并 clone 下来 (或者使用 GitHub 的 Codespaces 功能,非常方便).
2. 安装依赖:`pnpm install` 或者 `pnpm bootstrap` 然后本地启动项目。
3. 提交你的改动,commit 请遵守 [AngularJS Git Commit Message Conventions](https://docs.google.com/document/d/1QrDFcIiPjSLDn3EL15IJygNPiHORgU1_OOAqWjiDU5Y/edit#heading=h.uyo6cb12dt6w).
4. 如果你的改动是修复 bug, 还可以在提交信息后面加上 `close #issue 号`, 这样可以在 pr 合并后,可以自动关闭对应的 issue, 比如 `fix: render bug close #123`.
5. 确保加上了对应的单元测试和文档 (如果有 `Snapshot` UI 快照 (.snap 文件)更新,可以运行 `pnpm core:test -- -u``pnpm react:test -- -u` 自动更新,并一起提交上来,请勿手动编辑)
6. 所有 Lint 和 Test 检查通过后,并且 review 通过,我们会合并你的 pr.

![preview](https://gw.alipayobjects.com/zos/antfincdn/ssOxFrycD/86339514-5f9a-4101-8690-e47c97cd8af5.png)

## 开发流程

我们使用 `pnpm@v7` 作为包管理
我们使用 `pnpm` 作为包管理

```bash
npm i -g pnpm
```

推荐本地运行 `pnpm react:playground` 来调试 `@antv/s2``@antv/s2-react`

1. `pnpm install` 安装依赖
2. `pnpm site:bootstrap` 安装网站相关依赖
3. `pnpm site:start` 启动本地的 `S2` 网站
4. `pnpm core:start` 可视化的方式调试核心层 `@antv/s2` (基于 jest-electron)
5. `pnpm react:start` 可视化的方式调试组件层 `@antv/s2-react` (基于 jest-electron)
6. `pnpm vue:start` 可视化的方式调试组件层 `@antv/s2-vue` (基于 jest-electron)
7. `pnpm react:playground` 启动本地的组件层 `@antv/s2-react` demo (基于 vite)
8. `pnpm vue:playground` 启动本地的组件层 `@antv/s2-vue` demo (基于 vite)
9. `pnpm build` 构建 `@antv/s2``@antv/s2-react``@antv/s2-vue` 三个包, 分别输出 `umd`, `esm``lib` 目录
4. `pnpm core:start` 可视化的方式调试核心层 `@antv/s2` 基于 jest-electron)
5. `pnpm react:start` 可视化的方式调试组件层 `@antv/s2-react` 基于 jest-electron)
6. `pnpm vue:start` 可视化的方式调试组件层 `@antv/s2-vue` 基于 jest-electron)
7. `pnpm react:playground` 启动本地的组件层 `@antv/s2-react` demo 基于 vite)
8. `pnpm vue:playground` 启动本地的组件层 `@antv/s2-vue` demo 基于 vite)
9. `pnpm build` 构建 `@antv/s2``@antv/s2-react``@antv/s2-vue` 三个包分别输出 `umd`, `esm``lib` 目录
10. `pnpm test` 运行单元格测试
83 changes: 63 additions & 20 deletions README.en-US.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,35 +12,44 @@ A practical visualization library for tabular analysis.
<img src="https://img.shields.io/npm/dm/@antv/s2.svg" alt="npm"/>
</a>
<a href="https://www.npmjs.com/package/@antv/s2" target="_blank">
<img alt="Version" src="https://img.shields.io/npm/v/@antv/s2/latest.svg" alt="version">
<img src="https://img.shields.io/npm/v/@antv/s2/latest.svg?logo=npm" alt="latest version">
</a>
<a href="https://www.npmjs.com/package/@antv/s2" target="_blank">
<img alt="Version" src="https://img.shields.io/npm/v/@antv/s2/beta.svg" alt="version">
<img src="https://img.shields.io/npm/v/@antv/s2/next.svg?logo=npm" alt="next version">
</a>
<a href="https://github.com/antvis/S2/actions/workflows/test.yml" target="_blank">
<img src="https://github.com/antvis/S2/actions/workflows/test.yml/badge.svg" alt="ci test status"/>
</a>
<a href="https://codecov.io/gh/antvis/S2" target="_blank">
<img src="https://codecov.io/gh/antvis/S2/branch/master/graph/badge.svg" alt="Coverage"/>
<img src="https://codecov.io/gh/antvis/S2/branch/next/graph/badge.svg" alt="test coverage"/>
</a>
<a href="https://github.com/antvis/S2/releases" target="_blank">
<img src="https://img.shields.io/github/release-date/antvis/S2" alt="release-date"/>
<img src="https://img.shields.io/github/release-date/antvis/S2" alt="release date"/>
</a>
</p>

<p>
<a href="https://www.npmjs.com/package/@antv/s2" target="_blank">
<img alt="npm bundle size" src="https://img.badgesize.io/https:/unpkg.com/@antv/s2@latest/dist/index.min.js?label=gzip%20size&compression=gzip" alt="bundle size"/>
<img src="https://img.badgesize.io/https:/unpkg.com/@antv/s2@next/dist/index.min.js?label=gzip%20size&compression=gzip" alt="npm bundle size" />
</a>
<a href="https://github.com/antvis/S2/discussions" target="_blank">
<img src="https://img.shields.io/badge/discussions-on%20github-blue" alt="Discussions"/>
<img src="https://img.shields.io/badge/discussions-on%20github-blue" alt="GitHub discussions"/>
</a>
<a href="https://github.com/actions-cool/issues-helper" target="_blank">
<img src="https://img.shields.io/badge/using-issues--helper-blueviolet" alt="issues-helper"/>
<img src="https://img.shields.io/badge/using-issues--helper-blueviolet" alt="issues helper"/>
</a>
<a href="https://github.com/antvis/S2/blob/master/LICENSE" target="_blank" target="_blank">
<img alt="License: MIT@AntV" src="https://img.shields.io/badge/[email protected]" alt="license"/>
<a href="https://github.com/antvis/S2/blob/next/LICENSE" target="_blank">
<img src="https://img.shields.io/badge/[email protected]" alt="License: MIT@AntV" />
</a>
<a href="https://github.com/antvis/S2/graphs/contributors" target="_blank">
<img src="https://img.shields.io/github/contributors/antvis/S2" alt="contributors"/>
<a/>
<a href="https://github.com/antvis/S2/issues?q=is%3Aissue+sort%3Aupdated-desc+is%3Aclosed" >
<img src="https://img.shields.io/github/issues-closed/antvis/S2" alt="issues closed"/>
<a/>
<a href="https://github.com/antvis/S2/pulls" target="_blank">
<img src="https://img.shields.io/badge/PRs-Welcome-brightgreen.svg" alt="pr welcome"/>
<a/>
</p>

</div>
Expand Down Expand Up @@ -68,9 +77,9 @@ demo components and expansion capabilities, it allows developers to use it quick
## 📦 Installation

```bash
$ npm install @antv/s2 --save
# yarn add @antv/s2 --save
# pnpm install @antv/s2 --save
$ npm install @antv/s2@next --save
# yarn add @antv/s2@next
# pnpm add @antv/s2@next
```

## 🔨 Getting Started
Expand Down Expand Up @@ -137,6 +146,28 @@ const s2DataConfig = {
price: '1',
},
],
meta: [
{
field: 'price',
name: '价格',
},
{
field: 'province',
name: '省份',
},
{
field: 'city',
name: '城市',
},
{
field: 'type',
name: '类别',
},
{
field: 'sub_type',
name: '子类别',
},
],
};
```

Expand All @@ -154,30 +185,42 @@ const s2Options = {
### 3. Component Rendering

```html
<div id="container"></div>
<div id="container" />
```

```ts
import { PivotSheet } from '@antv/s2';

const container = document.getElementById('container');
async function bootstrap() {
const container = document.getElementById('container');

const s2 = new PivotSheet(container, s2DataConfig, s2Options);

const s2 = new PivotSheet(container, s2DataCfg, s2Options);
await s2.render();
}

s2.render();
bootstrap()
```

### 4. Preview

![result](https://gw.alipayobjects.com/zos/antfincdn/vCukbtVNvl/616f7ef1-e626-4225-99f8-dc8f6ca630dd.png)
![result](https://mdn.alipayobjects.com/huamei_qa8qxu/afts/img/A*aTPcT4aKOq4AAAAAAAAAAAAADmJ7AQ/original)

### 📦 Packages

| Package | Latest | Beta | Alpha | Next | Size | Download |
| - | - | - | - | - | - | - |
| [@antv/s2](https://github.com/antvis/S2/tree/master/packages/s2-core) | ![latest](https://img.shields.io/npm/v/@antv/s2/latest.svg) | ![beta](https://img.shields.io/npm/v/@antv/s2/beta.svg) | ![alpha](https://img.shields.io/npm/v/@antv/s2/alpha.svg) | ![next](https://img.shields.io/npm/v/@antv/s2/next.svg) | ![size](https://img.badgesize.io/https:/unpkg.com/@antv/s2@latest/dist/index.min.js?label=gzip%20size&compression=gzip) | ![download](https://img.shields.io/npm/dm/@antv/s2.svg) |
| [@antv/s2-react](https://github.com/antvis/S2/tree/master/packages/s2-react) | ![latest](https://img.shields.io/npm/v/@antv/s2-react/latest.svg) | ![beta](https://img.shields.io/npm/v/@antv/s2-react/beta.svg) | ![alpha](https://img.shields.io/npm/v/@antv/s2-react/alpha.svg) | ![next](https://img.shields.io/npm/v/@antv/s2-react/next.svg)| ![size](https://img.badgesize.io/https:/unpkg.com/@antv/s2-react@latest/dist/index.min.js?label=gzip%20size&compression=gzip) | ![download](https://img.shields.io/npm/dm/@antv/s2-react.svg) |
| [@antv/s2-vue](https://github.com/antvis/S2/tree/master/packages/s2-vue) | ![latest](https://img.shields.io/npm/v/@antv/s2-vue/latest.svg) | ![beta](https://img.shields.io/npm/v/@antv/s2-vue/beta.svg) | ![alpha](https://img.shields.io/npm/v/@antv/s2-vue/alpha.svg) | ![next](https://img.shields.io/npm/v/@antv/s2-vue/next.svg) | ![size](https://img.badgesize.io/https:/unpkg.com/@antv/s2-vue@latest/dist/index.min.js?label=gzip%20size&compression=gzip) | ![download](https://img.shields.io/npm/dm/@antv/s2-vue.svg) |
| [@antv/s2](https://github.com/antvis/S2/tree/next/packages/s2-core) | ![latest](https://img.shields.io/npm/v/@antv/s2/latest.svg) | ![beta](https://img.shields.io/npm/v/@antv/s2/beta.svg) | ![alpha](https://img.shields.io/npm/v/@antv/s2/alpha.svg) | ![next](https://img.shields.io/npm/v/@antv/s2/next.svg) | ![size](https://img.badgesize.io/https:/unpkg.com/@antv/s2@latest/dist/index.min.js?label=gzip%20size&compression=gzip) | ![download](https://img.shields.io/npm/dm/@antv/s2.svg) |
| [@antv/s2-react](https://github.com/antvis/S2/tree/next/packages/s2-react) | ![latest](https://img.shields.io/npm/v/@antv/s2-react/latest.svg) | ![beta](https://img.shields.io/npm/v/@antv/s2-react/beta.svg) | ![alpha](https://img.shields.io/npm/v/@antv/s2-react/alpha.svg) | ![next](https://img.shields.io/npm/v/@antv/s2-react/next.svg)| ![size](https://img.badgesize.io/https:/unpkg.com/@antv/s2-react@latest/dist/index.min.js?label=gzip%20size&compression=gzip) | ![download](https://img.shields.io/npm/dm/@antv/s2-react.svg) |
| [@antv/s2-vue](https://github.com/antvis/S2/tree/next/packages/s2-vue) | ![latest](https://img.shields.io/npm/v/@antv/s2-vue/latest.svg) | ![beta](https://img.shields.io/npm/v/@antv/s2-vue/beta.svg) | ![alpha](https://img.shields.io/npm/v/@antv/s2-vue/alpha.svg) | ![next](https://img.shields.io/npm/v/@antv/s2-vue/next.svg) | ![size](https://img.badgesize.io/https:/unpkg.com/@antv/s2-vue@latest/dist/index.min.js?label=gzip%20size&compression=gzip) | ![download](https://img.shields.io/npm/dm/@antv/s2-vue.svg) |

### 🖥️ Browser Compatibility

| [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png" alt="Edge" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)<br>Edge | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/firefox/firefox_48x48.png" alt="Firefox" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)<br>Firefox | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png" alt="Chrome" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)<br>Chrome | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/safari/safari_48x48.png" alt="Safari" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)<br>Safari |
| --- | --- | --- | --- |
| Edge | last 2 versions | last 2 versions | last 2 versions |

`@antv/s2-react` and `@antv/s2-vue` see [React JavaScript environment requirements](https://zh-hans.reactjs.org/docs/javascript-environment-requirements.html)[Vite browser compatibility](https://cn.vitejs.dev/guide/build.html#browser-compatibility)

## 👤 Author

Expand Down
Loading

0 comments on commit 2df2032

Please sign in to comment.