400 feature custom total data pivot table

common/changes/@visactor/vtable/400-feature-customTotalData-pivotTable_2023-10-17-03-26.json

@@ -0,0 +1,11 @@
+{
+  "changes": [
+    {
+      "comment": "feat: support use custom data as summary data #400\n\n",
+      "type": "patch",
+      "packageName": "@visactor/vtable"
+    }
+  ],
+  "packageName": "@visactor/vtable",
+  "email": "892739385@qq.com"
+}

common/changes/@visactor/vtable/400-feature-customTotalData-pivotTable_2023-10-17-07-27.json

@@ -0,0 +1,11 @@
+{
+  "changes": [
+    {
+      "comment": "fix: analysis pivot tree summary value is wrong\n\n",
+      "type": "patch",
+      "packageName": "@visactor/vtable"
+    }
+  ],
+  "packageName": "@visactor/vtable",
+  "email": "892739385@qq.com"
+}

common/changes/@visactor/vtable/400-feature-customTotalData-pivotTable_2023-10-17-11-03.json

@@ -0,0 +1,11 @@
+{
+  "changes": [
+    {
+      "comment": "docs: add analysis rules demos\n\n",
+      "type": "patch",
+      "packageName": "@visactor/vtable"
+    }
+  ],
+  "packageName": "@visactor/vtable",
+  "email": "892739385@qq.com"
+}

docs/assets/demo/en/data-analysis/pivot-analysis-custom-total.md

@@ -0,0 +1,216 @@
+---
+category: examples
+group: data-analysis
+title: Custom Total
+cover: https://lf9-dp-fe-cms-tos.byteorg.com/obj/bit-cloud/VTable/preview/pivot-analysis-custom-total.png
+link: '../guide/table_type/Pivot_table/pivot_table_dataAnalysis'
+---
+
+# Pivot analysis table—customized summary data
+
+Pivot analysis table data summary, if summary data is passed in the data source record, the table will give priority to using the user-input value as the summary value.
+
+## Key configuration
+
+- `PivotTable`
+- `columns`
+- `rows`
+- `indicators`
+- `enableDataAnalysis` turns on pivot data analysis
+- `dataConfig` configures data rules, optional configuration items
+## Code demo
+
+```javascript livedemo template=vtable
+
+let  tableInstance;
+  fetch('https://lf9-dp-fe-cms-tos.byteorg.com/obj/bit-cloud/VTable/North_American_Superstore_Pivot_Chart_data.json')
+    .then((res) => res.json())
+    .then((data) => {
+      debugger
+data = data.concat([
+  // 追加汇总数据
+  {
+    "Region": "Central",
+    "Segment": "Consumer",
+    "Category": "Office Supplies",
+    "Quantity": "1111",
+     "Sales": "3333",
+      "Profit": "2222",
+  },
+{
+    "Region": "Central",
+    "Category": "Office Supplies",
+    "Sub-Category": "Appliances",
+    "Quantity": "1111",
+     "Sales": "3333",
+      "Profit": "2222",
+  },
+  {
+    "Region": "Central",
+    "Quantity": "4444",
+     "Sales": "6666",
+      "Profit": "5555",
+  },
+  {
+   "Category": "Office Supplies",
+    "Quantity": "7777",
+     "Sales": "9999",
+      "Profit": "8888",
+  },
+  {
+    "Quantity": "9999",
+     "Sales": "9999",
+      "Profit": "9999",
+  }
+])
+const option = {
+records:data,
+  "rows": [
+      {
+         "dimensionKey": "Category",
+          "title": "Category",
+          "headerStyle": {
+              "textStick": true
+          },
+          "width": "auto",
+      },
+      {
+         "dimensionKey": "Sub-Category",
+          "title": "Sub-Catogery",
+          "headerStyle": {
+              "textStick": true
+          },
+          "width": "auto",
+      },
+  ],
+  "columns": [
+      {
+         "dimensionKey": "Region",
+          "title": "Region",
+          "headerStyle": {
+              "textStick": true
+          },
+          "width": "auto",
+      },
+       {
+         "dimensionKey": "Segment",
+          "title": "Segment",
+          "headerStyle": {
+              "textStick": true
+          },
+          "width": "auto",
+      },
+  ],
+   "indicators": [
+              {
+                  "indicatorKey": "Quantity",
+                  "title": "Quantity",
+                  "width": "auto",
+                  "showSort": false,
+                  "headerStyle":{
+                    fontWeight: "normal",
+                  },
+                   style:{
+                    padding:[16,28,16,28],
+                    color(args){
+                      if(args.dataValue>=0)
+                      return 'black';
+                      return 'red'
+                    },
+                    bgColor(arg) {
+                      const rowHeaderPaths = arg.cellHeaderPaths.rowHeaderPaths;
+                      if (rowHeaderPaths?.[1]?.value === 'Sub Totals') {
+                        return '#ba54ba';
+                      } else if (rowHeaderPaths?.[0]?.value === 'Row Totals') {
+                        return '#ff9900';
+                      }
+                      return undefined;
+                    }
+                   }
+              },
+              {
+                  "indicatorKey": "Sales",
+                  "title": "Sales",
+                  "width": "auto",
+                  "showSort": false,
+                  "headerStyle":{
+                    fontWeight: "normal",
+                  },
+                  "format":(rec)=>{return '$'+Number(rec).toFixed(2)},
+                  style:{
+                    padding:[16,28,16,28],
+                    color(args){
+                      if(args.dataValue>=0)
+                      return 'black';
+                      return 'red'
+                    },
+                     bgColor(arg) {
+                      const rowHeaderPaths = arg.cellHeaderPaths.rowHeaderPaths;
+                      if (rowHeaderPaths?.[1]?.value === 'Sub Totals') {
+                        return '#ba54ba';
+                      } else if (rowHeaderPaths?.[0]?.value === 'Row Totals') {
+                        return '#ff9900';
+                      }
+                      return undefined;
+                    }
+                   }
+              },
+              {
+                  "indicatorKey": "Profit",
+                  "title": "Profit",
+                  "width": "auto",
+                  "showSort": false,
+                  "headerStyle":{
+                    fontWeight: "normal",
+                  },
+                  "format":(rec)=>{return '$'+Number(rec).toFixed(2)},
+                  style:{
+                    padding:[16,28,16,28],
+                    color(args){
+                      if(args.dataValue>=0)
+                      return 'black';
+                      return 'red'
+                    },
+                     bgColor(arg) {
+                      const rowHeaderPaths = arg.cellHeaderPaths.rowHeaderPaths;
+                      if (rowHeaderPaths?.[1]?.value === 'Sub Totals') {
+                        return '#ba54ba';
+                      } else if (rowHeaderPaths?.[0]?.value === 'Row Totals') {
+                        return '#ff9900';
+                      }
+                      return undefined;
+                    }
+                   }
+              }
+          ],
+  "corner": {
+      "titleOnDimension": "row",
+      "headerStyle": {
+          "textStick": true
+      }
+  },
+  dataConfig: {
+    totals: {
+        row: {
+          showGrandTotals: true,
+          showSubTotals: true,
+          subTotalsDimensions: ['Category'],
+          grandTotalLabel: 'Row Totals',
+          subTotalLabel: 'Sub Totals'
+        },
+        column: {
+          showGrandTotals: true,
+          showSubTotals: true,
+          subTotalsDimensions: ['Region'],
+          grandTotalLabel: 'Column Totals',
+          subTotalLabel: 'Sub Totals'
+        }
+      },
+  },
+  enableDataAnalysis: true,
+  widthMode:'standard'
+};
+tableInstance = new VTable.PivotTable(document.getElementById(CONTAINER_ID),option);
+window['tableInstance'] = tableInstance;
+    })
+```