bxs-tools-ui 3.2.0-1 → 3.2.0-2

package/packages/canvas-poster/readme.md

@@ -1,139 +1,179 @@
-<!--仅用于绕过 eslint-loader 校验的错误信息：Parsing error: Invalid character-->
-<!--??以目前现象看，文档首字符不为 "<" 会报错??-->
-## canvas海报（CanvasPoster）
-说明：canvas绘制海报。支持文本自动换行、自定义字体、圆角矩形、圆角图片等。  
-内容：图片、背景色、文案  
-属性：画布的宽度、高度、海报的数据  
-方法：  
-
-###
+## Canvas 海报（CanvasPoster）
+
+基于 Canvas 绘制海报的组件，支持图片、文本、矩形三种绘制元素，并提供文本自动换行、自定义字体、圆角矩形、圆角图片等能力。
+
+**支持的绘制元素类型**：
+
+1. `image`：图片（支持圆角、自定义宽高、跨域加载）
+2. `text`：文本（支持自动换行、自定义字体、颜色、对齐方式）
+3. `rect`：矩形（支持圆角、透明度）
+
+---
+
 ### 模块引用（import）
+
 ```javascript
-import CanvasPoster from 'bxs-tools-ui';
+import { CanvasPoster } from 'bxs-tools-ui';
 export default {
   components: {
-  CanvasPoster
+    CanvasPoster
   }
-}
+};
 ```
 
-## 示例
-``` html
+---
+
+### 示例（example）
+
+```html
 <template>
-  <CanvasPoster :poster-data="posterData"></CanvasPoster>
+  <CanvasPoster :poster-data="posterData" />
 </template>
 
+<script>
+import { CanvasPoster } from 'bxs-tools-ui';
+
 export default {
-  data () {
+  components: { CanvasPoster },
+  data() {
     return {
       posterData: [
         {
           type: 'image',
-          url: 'https://media.winbaoxian.com/autoUpload/planbook/712d0f9ecd593a33029b5ea1b6ab419f2e014e5029e1a-MTGQfr_fw658_7f99c5bc34a5ef5.jpeg',
+          url: 'https://media.winbaoxian.com/xxx.jpeg',
           width: window.innerWidth,
           height: window.innerHeight
-        }, {
+        },
+        {
           type: 'image',
-          url: 'https://media.winbaoxian.com/autoUpload/planbook/712d0f9ecd593a33029b5ea1b6ab419f2e014e5029e1a-MTGQfr_fw658_7f99c5bc34a5ef5.jpeg',
+          url: 'https://media.winbaoxian.com/avatar.jpeg',
           point: [200, 250],
           width: 100,
           height: 100,
           radius: 50
-        }, {
-          type: 'image',
-          url: 'https://media.winbaoxian.com/autoUpload/planbook/712d0f9ecd593a33029b5ea1b6ab419f2e014e5029e1a-MTGQfr_fw658_7f99c5bc34a5ef5.jpeg',
-          point: [250, 300],
-          width: 100,
-          height: 100
-        },{
+        },
+        {
           type: 'text',
-          tx: '单行文本单行文本单行文本单行文本单行文本单行文本单行文本',
+          tx: '单行标题文本',
           textAlign: 'center',
-          point: [window.innerWidth / 2, 20],
-        },  {
+          point: [window.innerWidth / 2, 20]
+        },
+        {
           type: 'text',
-          tx: '文本自动换行文本自动换行文本自动换行文本自动换行文本自动换行文本自动换行文本自动换行文本自动换行文本自动换行文本自动换行文本自动换行文本自动换行',
+          tx: '支持自动换行的长文本内容，超出宽度后会自动折行显示。',
           color: '#fff',
           fontWeight: 'bold',
           fontSize: 18,
           fontFamily: 'Times',
-          // textAlign: 'center',
           lineHeight: 36,
           autoLine: true,
           right: 50,
-          point: [50, 60],
-        }, {
+          point: [50, 60]
+        },
+        {
           type: 'rect',
           color: '#267a9a',
           point: [50, window.innerHeight - 250],
           width: window.innerWidth * 0.4,
           height: 100,
           radius: 20
-        }, {
+        },
+        {
           type: 'rect',
           color: 'rgba(255, 255, 0, 0.5)',
           point: [0, window.innerHeight - 130],
           width: window.innerWidth,
           height: 130
-        }, {
+        },
+        {
           type: 'image',
-          url: 'https://media.winbaoxian.com/autoUpload/planbook/QR_code_845accfa76b4bd0.jpeg',
+          url: 'https://media.winbaoxian.com/QR_code.jpeg',
           point: [window.innerWidth - 115, window.innerHeight - 115],
           width: 100,
           height: 100,
           radius: 5
         }
       ]
-    }
+    };
   }
-}
+};
+</script>
 ```
 
+---
+
+### Attributes
+
+#### 根级 props
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| `poster-data` | 必传，海报绘制元素数组 | Array | `[]` |
+| `canvas-width` | 可选，Canvas 画布宽度 | Number | `window.innerWidth` |
+| `canvas-height` | 可选，Canvas 画布高度 | Number | `window.innerHeight` |
+
+
+#### 绘制元素：image（图片）
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| `type` | 必传，固定值 `'image'` | String | — |
+| `url` | 必传，图片地址 | String | — |
+| `crossOrigin` | 允许跨源加载，可解除 `getImageData` / `toBlob` / `toDataURL` 限制 | String | — |
+| `point` | 绘制起点坐标 `[x, y]` | Array | `[0, 0]` |
+| `width` | 图片宽度 | Number | 图片自身宽度 |
+| `height` | 图片高度 | Number | 图片自身高度 |
+| `radius` | 圆角半径 | Number | — |
+
+
+#### 绘制元素：text（文本）
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| `type` | 必传，固定值 `'text'` | String | — |
+| `tx` | 必传，绘制的文本内容 | String | — |
+| `color` | 字体颜色 | String | `'#333'` |
+| `fontWeight` | 字体加粗（如 `'bold'`） | String | — |
+| `fontSize` | 字体大小（px） | Number | `12` |
+| `fontFamily` | 字体族 | String | `'Arial'` |
+| `textAlign` | 文本对齐方式 | String | `'start'` |
+| `point` | 绘制起点坐标 `[x, y]` | Array | `[0, 0]` |
+| `autoLine` | 是否自动换行 | Boolean | `false` |
+| `right` | 文本与右边界的距离，仅 `autoLine` 为 `true` 时有效 | Number | `0` |
+| `lineHeight` | 行距，仅 `autoLine` 为 `true` 时有效 | Number | 与 `fontSize` 相同 |
+
+
+#### 绘制元素：rect（矩形）
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| `type` | 必传，固定值 `'rect'` | String | — |
+| `color` | 必传，填充颜色，支持 `rgba` | String | — |
+| `point` | 绘制起点坐标 `[x, y]` | Array | `[0, 0]` |
+| `width` | 矩形宽度 | Number | `window.innerWidth` |
+| `height` | 矩形高度 | Number | `window.innerHeight` |
+| `radius` | 圆角半径 | Number | — |
+
+---
+
+### Methods
+
+| 方法名 | 说明 | 参数 |
+| --- | --- | --- |
+| `drawPoster` | 按 `posterData` 顺序依次绘制所有元素（`mounted` 时自动调用一次）；**`posterData` 变更后不会自动重绘**，需通过 `$refs` 手动调用此方法或重新挂载组件 | — |
+
+> **注意**：组件 canvas 的 `id` 固定为 `canvasPoster`，同一页面中存在多个实例时会发生 DOM id 冲突，请避免同时渲染多个实例。
+
+---
+
+### Events
+
+-
 
-## Attribute
-| 参数| 说明 | 类型 | 默认值 |
-| --- | --- | --- |  --- |
-| canvas-width | canvas画布的宽度 | number | 文档显示区的宽度 (window.innerWidth) |
-| canvas-height | canvas画布的高度 | number | 文档显示区的高度 (window.innerHeight) |
-| poster-data | 海报的数据 | Array | 以数组形式传参，每个子元素是json对象，不同类型的绘制元素结构不一样。下方三种绘制元素的数据结构 |
-
-以下参数中，type是元素的类型：image(图片)、text(文本)、rect(矩形)  
-###  
-  
-### 绘制:图片
-| 参数| 说明 | 类型 | 默认值 | 版本 |
-| --- | --- | --- | --- | --- |
-| type | 必传, 图片传'image' | string | - | - |
-| url | 必传, 图片地址 | string | - | - |
-| crossOrigin | 可选, 允许跨源加载图片，避免 canvas 对非同源图片的限制，比如：getImageData()、toBlob()、toDataURL() 等方法的使用。 | string | - | 1.1.0-9 |
-| point | 可选,绘图的起点,x轴、y轴坐标 | array | [0, 0] | - |
-| width | 可选,图片的宽度 | number | 图片自身宽度 | - |
-| height | 可选,图片的高度 | number | 图片自身高度 | - |
-| radius | 可选,图片的圆色值 | number | - | - |
-  
-### 绘制:文本  
-| 参数| 说明 | 类型 | 默认值 |
-| --- | --- | --- |  --- |
-| type | 必传, 文本传'text' | string | - |
-| tx | 必传, 要绘制的文本 | string | - |
-| color | 可选,字体颜色 | string | #333 |
-| fontWeight | 选择，字体加粗 | string | - |
-| fontSize | 可选,字体大小 | number | 12 |
-| fontFamily | 可选，字体 | string | Arial |
-| textAlign | 可选,文本对齐方式 | string | start |
-| point | 可选,绘图的起点,x轴、y轴坐标 | array | [0, 0] |
-| autoLine | 可选, 自动换行 | boolean | false |
-| right | 可选, 文本与右边界的距离。只对自动换行的有效 | number | 0 |
-| lineHeight | 可选, 行距。只对自动换行的有效 | number | 默认与fontSize同 |
-   
-### 绘制:矩形
-| 参数| 说明 | 类型 | 默认值 |
-| --- | --- | --- |  --- |
-| type | 必传,矩形传'rect' | string | - |
-| color | 必传,字体颜色。设置透明度可使用rgba(0,0,0,0.5) | string | - |
-| width | 可选,矩形的宽度 | number | 文档显示区的宽度(window.innerWidth) |
-| height | 可选,矩形的高度 | number | 文档显示区的高度(window.innerHeight) |
-| point | 可选,绘图的起点,x轴、y轴坐标 | array | [0, 0] |
-| radius | 可选,图片的圆色值 | number | - |
+---
 
+### Slot
 
+| 插槽名 | 说明 |
+| --- | --- |
+| `default` | 位于 `<canvas>` 标签内部，作为浏览器不支持 Canvas 时的降级内容 |

package/packages/index.ts

@@ -50,6 +50,6 @@ export {
 }
 
 export default {
-  version: '3.2.0-1',
+  version: '3.2.0-2',
   install
 }

package/packages/insure-calculate/readme.md

@@ -1,151 +1,207 @@
-<!--仅用于绕过 eslint-loader 校验的错误信息：Parsing error: Invalid character-->
-<!--??以目前现象看，文档首字符不为 "<" 会报错??-->
 ## 试算业务组件（InsureCalculate）
 
-## Import
-```js
-import { InsureCalculate } from 'bxs-tools-ui';
-```
-或
-```js
-import Vue from 'vue'
+保险产品试算组件，基于服务端下发的试算因子（`widgets` / `current_data`）动态渲染表单，并支持重新计算保费。可作为**组件**嵌入页面使用，也可直接调用**方法**（`insureCalculate` / `checkInsureCalculate`）完成纯数据试算。
+
+> **注意**：组件模式内部会自动请求用户信息接口，兼容 C 端场景；方法模式不含用户信息逻辑，C 端调用时必须在 `urlParams` 中传入 `uuid`。
+
+---
+
+### 模块引用（import）
+
+```javascript
 import { InsureCalculate } from 'bxs-tools-ui';
+export default {
+  components: {
+    InsureCalculate
+  }
+};
 ```
 
-## Example
+---
+
+### 示例（example）
+
 ```html
-<!-- template -->
-<insure-calculate />
-```
-```js
+<template>
+  <InsureCalculate
+    ref="insureCalculate"
+    :calculate-data="calculateData"
+    :product-id="productId"
+    :plan-params="planParams"
+    :is-show-duty="true"
+    :show-header="true"
+    title="试算"
+    :show-footer="true"
+    @closeInsureCalculate="onClose"
+    @sureInsureCalculate="onSure"
+  >
+    <template #header>
+      <!-- 自定义顶部内容（可选） -->
+    </template>
+    <template #footer>
+      <!-- 自定义底部内容（可选） -->
+    </template>
+  </InsureCalculate>
+</template>
+
+<script>
+import { InsureCalculate } from 'bxs-tools-ui';
+
 export default {
-  components: {
-    InsureCalculate
+  components: { InsureCalculate },
+  data() {
+    return {
+      productId: '102163',
+      calculateData: {},
+      planParams: {
+        detail_age: '30周岁',
+        detail_sex: '1'
+      }
+    };
+  },
+  methods: {
+    // 主动获取当前试算数据（调用组件 confirm 方法）
+    getCalculateData() {
+      this.$refs.insureCalculate.confirm().then(({ t_version, code, data }) => {
+        console.log(t_version, data);
+      });
+    },
+    onClose() {},
+    onSure() {}
   }
-}
+};
+</script>
 ```
 
-## Attention
-- 组件使用过程中，关于A/C端用户 `userUuid` 的问题，组件内容使用了计划书获取用户信息的接口(`//app.winbaoxian.cn/planBook/common/currentUser`)，会主动带上用户信息进行请求，因此兼容了C端使用的情况；
-- 方法使用过程中，考虑到使用场景复杂性，没有获取用户信息，因此C端在使用方法时【必须】给用户信息，具体参考 `urlParams` 对象；
-
-## Attribute
-| 参数| 说明 | 类型 | 默认值 | 版本 |
-| --- | --- | --- |   --- |  --- |
-|calculateData|试算组件原始数据，详见下表|Object|{}|-|
-|productId|试算产品ID|String|例如：102163，100559|-|
-|isDev|可选，运行环境模式，默认根据`window.location.port`的值来判断当前环境是否为开发环境，用户可使用手动设置组件的属性`isDev`来覆盖默认的判定，默认false|Boolean|true,false|-|
-|planParams|初始化对象，详见下表|Object|-|-|
-|isShowDuty|是否展示试算责任|Boolean|false|-|
-|showHeader|是否展示顶部标题|Boolean|false|-|
-|title|顶部标题，showHeader为true的时候才有效|String|''|-|
-|showFooter|是否展示底部按钮|Boolean|false|-|
-|appid|tob环境变量，必传，判断是否tob环境，处理对应逻辑|String|''|-|
-|openId|tob环境变量，选传，如果没有获取到uuid且用户传了openId，openId的值会赋给uuid|String|''|-|
-
-
-
-## planParams 对象
-| 参数| 说明 | 类型 | 默认值 |
-| --- | --- | --- |   --- |
-|detail_age|被保人年龄|String, 例：50周岁 或 1990-06-17，没有限制不传值|-|
-|detail_sex|被保人性别|String, 例：'1'：男,'2'：女，没有限制不传值|-|
-|detail_relation|投被保人关系|String | undefined, 
-非本人：'-1';
-指定人：本人：'1','14-丈夫','15-妻子','16-儿子','17-女儿','18-父亲','19-母亲'；
-不限制：'' | undefined | null|-|
-|detail_applicant_age|投保人年龄|String, 例：50周岁 或 1990-06-17，没有限制不传值|-|
-|detail_applicant_sex|投保人性别|String, 例：'1'：男,'2'：女，没有限制不传值|-|
-
-
-## calculateData 对象
-| 参数| 说明 | 类型 | 默认值 |
-| --- | --- | --- |   --- |
-|widgets|页面渲染数据，详见下表|Array|-|
-|current_data|当前选项映射值，详见下表|Object|-|
-|total_premium|保留字段，试算保费|Number|-|
-|product_id|保留字段，当前试算产品ID|String|-|
-|risk_premiums|保留字段，试算附加险相关信息|Array|-|
-|terms|保留字段，险种说明|Array|-|
-
-## widgets 对象
-| 参数| 说明 | 类型 | 默认值 |
-| --- | --- | --- |   --- |
-|cal_key|试算因子是否重新计算保费相关，1代表该因子与保费相关，0代表该因子与保费无关|Number|-|
-|hidden|试算因子是否隐藏展示该试算因子，服务端控制，0代表展示该因子，1代表隐藏该因子|Number|-|
-|key|作为试算因子参数opts的取值key，与关键字opts联合使用，即opts[key]进行取值|Number|-|
-|label|试算因子名称|String|-|
-|opts|试算因子的取值范围，与关键字key联合使用|String|-|
-|riskCode|试算因子的险种code|String|-|
-|type|试算因子映射的前端组件|String|-|
-
-## current_data 对象
-| 参数| 说明 | 类型 | 默认值 |
-| --- | --- | --- |   --- |
-|k|试算因子的java名称，对应widgets对象中的key|String|-|
-|risk|试算因子的险种code，对应widgets对象中的riskCode|String|-|
-|v|试算因子当前项对应的值，对应widgets对象中opts中的某个值|String|-|
-|age|保留字段，calendar组件特有属性，对应当前年龄数值|Number|-|
-|sv|保留字段，calendar组件特有属性，对应可选年龄范围|String|-|
-
-## Event
-| 事件名称 | 说明 | 参数 |
+---
+
+### Attributes
+
+| 参数 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| `calculateData` | 必传，试算组件原始数据 | Object | `{}` |
+| `productId` | 必传，试算产品 ID | String / Number | — |
+| `uuid` | 可选，C 端用户 uuid；传入后跳过内部自动获取用户信息接口 | String | — |
+| `planParams` | 必传，初始化参数，见 PlanParams 对象 | Object | — |
+| `lsTime` | 可选，本地缓存时长（分钟） | Number | `10` |
+| `isDev` | 可选，是否为开发环境；默认根据 `window.location.port` 自动判断，可手动覆盖 | Boolean | — |
+| `isShowDuty` | 可选，是否展示试算责任 | Boolean | `false` |
+| `showHeader` | 可选，是否展示顶部标题栏 | Boolean | `false` |
+| `title` | 可选，顶部标题，`showHeader` 为 `true` 时有效 | String | `''` |
+| `showFooter` | 可选，是否展示底部确定按钮 | Boolean | `false` |
+| `appid` | 可选，ToB 环境变量，用于判断是否为 ToB 环境 | String | `''` |
+| `openId` | 可选，ToB 环境变量；未获取到 `uuid` 时用于替代 `userUuid` | String | `''` |
+
+
+#### calculateData 对象
+
+| 参数 | 说明 | 类型 |
 | --- | --- | --- |
-| confirm | 获取当前组件试算因子的数据，返回格式如下 | 当前分值 |
-| closeInsureCalculate | 当showHeader为true时，点击关闭按钮触发该事件 | 当前分值 |
-| sureInsureCalculate | 当showFooter为true时，点击确定按钮触发该事件 | 当前分值 |
-
-## confirm事件返回对象
-| 参数| 说明 | 类型 | 默认值 |
-| --- | --- | --- |   --- |
-|t_version|当前事件触发的时间戳|Number|-|
-|data|calculateData对象|Object|-|
-
-## 方法
-| 方法名称 | 说明 | 参数 |
+| `widgets` | 页面渲染数据，见 widgets 对象 | Array |
+| `current_data` | 当前选项映射值，元素见 current_data 对象 | Array |
+| `total_premium` | 试算保费（保留字段） | Number |
+| `product_id` | 当前试算产品 ID（保留字段） | String |
+| `risk_premiums` | 试算附加险相关信息（保留字段） | Array |
+| `terms` | 险种说明（保留字段） | Array |
+
+
+#### widgets 对象（单项）
+
+| 参数 | 说明 | 类型 |
 | --- | --- | --- |
-| insureCalculate | insureCalculate方法执行条件如下 | -- |
-| checkInsureCalculate | checkInsureCalculate方法执行条件如下 | -- |
+| `cal_key` | 是否与保费相关；`1` 相关，`0` 不相关 | Number |
+| `hidden` | 是否隐藏；`0` 展示，`1` 隐藏 | Number |
+| `key` | 取值 key，与 `opts` 联合使用：`opts[key]` | Number |
+| `label` | 试算因子名称 | String |
+| `opts` | 试算因子取值范围，以 `key` 为索引的对象，取当前值用 `opts[key]` | Object |
+| `riskCode` | 险种 code | String |
+| `type` | 映射的前端组件类型 | String |
 
-## Slot
-无
 
-## 关于时间单位的转换
-| 期间| 说明 | 类型 |
+#### current_data 对象（单项）
+
+| 参数 | 说明 | 类型 |
+| --- | --- | --- |
+| `k` | 试算因子 Java 名称，对应 `widgets.key` | String |
+| `risk` | 险种 code，对应 `widgets.riskCode` | String |
+| `v` | 当前选项值，对应 `widgets.opts` 中的某个值 | String |
+| `age` | calendar 组件特有，当前年龄数值（保留字段） | Number |
+| `sv` | calendar 组件特有，可选年龄范围（保留字段） | String |
+
+
+#### PlanParams 对象
+
+| 参数 | 说明 | 类型 |
 | --- | --- | --- |
-|30D|30天|String|
-|12M|12个月|String|
-|1Y|趸交或者1年交|String|
-|20Y|20年|String|
-|70A|至70周岁|String|
-|100O|终生|String|
-
-## insureCalculate 方法
-| 期间| 说明 | 类型 |
+| `detail_age` | 被保人年龄，如 `'50周岁'` 或 `'1990-06-17'`；无限制不传 | String |
+| `detail_sex` | 被保人性别，`'1'` 男 / `'2'` 女；无限制不传 | String |
+| `detail_relation` | 投被保人关系；非本人：`'-1'`；本人：`'1'`；其他关系见备注；不限制：`''` / `undefined` / `null` | String |
+| `detail_applicant_age` | 投保人年龄，格式同 `detail_age`；无限制不传 | String |
+| `detail_applicant_sex` | 投保人性别，格式同 `detail_sex`；无限制不传 | String |
+
+> `detail_relation` 其他关系值：`'14'` 丈夫 / `'15'` 妻子 / `'16'` 儿子 / `'17'` 女儿 / `'18'` 父亲 / `'19'` 母亲
+
+---
+
+### Methods
+
+#### 组件实例方法（通过 `$refs` 调用）
+
+| 方法名 | 说明 | 出参 |
 | --- | --- | --- |
-|urlParams|第一位入参：作为api的拼接参数|参考 urlParams 对象|
-|postParams|第二位入参：作为api的试算参数|参考 postParams对象|
-|planParams|第三位入参：计划书参数，作为设定postParams的current_data对象的默认值传入，函数内部建立映射机制，如果增加或者修改，联系开发人员|参考 planParams对象|
-|返回值|出参：Promise对象，包含{code, data}；code为200表示请求正常，其他值对应请求错误；data包含{widgets,total_premium,terms,product_id,current_data}，对应calculateData对象。|-|
+| `confirm` | 主动获取当前试算数据，不触发试算请求 | Promise `{ t_version, code: 200, data }`；`data` 含 `widgets / total_premium / terms / product_id / current_data / risk_premiums` |
+
+#### 工具函数（从 `bxs-utils` 导入，非组件实例方法）
+
+| 方法名 | 说明 | 入参 | 出参 |
+| --- | --- | --- | --- |
+| `insureCalculate` | 执行试算，返回完整的试算数据 | `urlParams`, `postParams`, `planParams` | Promise `{ code, data }`；`code === 200` 表示成功；`data` 含 `widgets / total_premium / terms / product_id / current_data` |
+| `checkInsureCalculate` | 校验试算是否成功 | `urlParams`, `postParams`, `planParams` | Promise `{ code, data }`；`code === 200` 表示试算成功 |
 
-## checkInsureCalculate 方法
-| 期间| 说明 | 类型 |
+
+#### urlParams 对象
+
+| 参数 | 说明 | 类型 |
 | --- | --- | --- |
-|urlParams|第一位入参：作为api的拼接参数|参考 urlParams 对象|
-|postParams|第二位入参：作为api的试算参数|参考 postParams对象|
-|planParams|第三位入参：计划书参数，作为设定postParams的current_data对象的默认值传入，函数内部建立映射机制，如果增加或者修改，联系开发人员|参考 planParams对象|
-|返回值|出参：Promise对象，包含{code, data}；code为200表示试算成功，其他值对应试算失败|-|
+| `uuid` | C 端必传，用户 uuid | String |
+| `appid` | ToB 必传，作为 url 中 `appId` 字段传递 | String |
+| `openId` | ToB 选传，未获取到 `uuid` 时作为 `userUuid` 传递 | String |
+
 
-## postParams 对象
-| 期间| 说明 | 类型 |
+#### postParams 对象
+
+| 参数 | 说明 | 类型 |
 | --- | --- | --- |
-|product_id|产品id|'101768'|
-|current_data|当前试算因子对象，默认值为null|参考 current_data对象|
-|scenario|默认值，固定值`h5Widget`，服务端区分试算来源为H5，可不传，已兼容|h5Widget|
+| `product_id` | 产品 ID | String |
+| `current_data` | 当前试算因子对象，默认 `null` | Object |
+| `scenario` | 固定值 `'h5Widget'`，可不传（已兼容） | String |
+
+
+#### 时间单位说明
 
-## urlParams 对象
-| 期间| 说明 | 类型 |
+| 值 | 含义 |
+| --- | --- |
+| `30D` | 30 天 |
+| `12M` | 12 个月 |
+| `1Y` | 趸交或 1 年交 |
+| `20Y` | 20 年 |
+| `70A` | 至 70 周岁 |
+| `100O` | 终生 |
+
+---
+
+### Events
+
+| 事件名 | 说明 | 回调参数 |
 | --- | --- | --- |
-|uuid|c端必传用户uuid|-|
-|appid|tob环境变量，必传，url上作为appId字段的值传递|String|
-|openId|tob环境变量，选传，在没有获取到uuid的情况下，作为userUuid字段的值进行传递|String|
+| `closeInsureCalculate` | `showHeader` 为 `true` 时，点击关闭按钮触发 | — |
+| `sureInsureCalculate` | `showFooter` 为 `true` 时，点击确定按钮触发 | — |
+
+---
+
+### Slot
+
+| 插槽名 | 说明 |
+| --- | --- |
+| `header` | 自定义顶部内容，`showHeader` 为 `true` 时生效；不传则展示默认标题栏（含标题文字和关闭按钮） |
+| `footer` | 自定义底部内容，`showFooter` 为 `true` 时生效；不传则展示默认确定按钮 |