clickgo 5.16.2 → 5.17.1

package/dist/lib/control.d.ts

@@ -626,6 +626,11 @@ export interface ISelectItemclickedEvent {
         'arrow': boolean;
     };
 }
+export interface IStabChangeEvent extends ICustomEvent {
+    'detail': {
+        'value': number;
+    };
+}
 export interface ISwitchChangeEvent extends ICustomEvent {
     'detail': {
         'value': boolean;

package/doc/clickgo-rag.md

@@ -1842,6 +1842,20 @@ ECharts 配置选项。
 
 滚动方向限制。`v` 仅允许垂直滚动，内容宽度被约束在容器内不产生横向溢出；`h` 仅允许水平滚动，子元素以行方向排列，高度被约束在容器内不产生纵向溢出；默认空值时两个方向均可滚动。
 
+#### state
+
+`'idle'` | `'loading'` | `'complete'`
+
+加载状态。`idle` 表示空闲可加载，`loading` 表示加载中会展示旋转动画，此时不触发 `load` 事件；`complete` 表示已加载完毕，显示完成图形（圆点加线条），也不再触发 `load` 事件。默认 `idle`。
+
+### 事件
+
+#### load
+
+`(): void`
+
+触底加载事件。当内容滚动至距底部 50px 以内时触发，仅在 `state` 为 `idle` 时生效。内容未填满容器时挂载后也会自动触发。
+
 ### 方法
 
 #### toBottom
@@ -1850,23 +1864,37 @@ ECharts 配置选项。
 
 滚动到底部。
 
+#### checkLoad
+
+`(): void`
+
+手动检查是否满足触底条件并触发 `load` 事件，一般无需直接调用。
+
 ### 样式
 
 该控件采用 flex 布局，由顶部的画布区域和底部的横向滚动条区域组成。画布区域内部包含一个可平移的显示容器。
 
 支持通过鼠标或触摸在非节点区域进行点击拖拽操作，从而实现画布的平移。当内容超出显示范围时，组件会自动显示自定义的 `cg-scroll` 滚动条，以保证在不同平台上具有一致的交互体验。
 
-画布组件具备自适应能力，能够实时监听容器和内容的大小变化并更新滚动状态。支持通过 `gutter` 参数灵活设置内部子元素之间的布局间距。
+底部加载区域（`.load-footer`）在 `state` 为 `loading` 或 `complete` 时显示，居中展示加载或完成图形。图形颜色跟随主题变量 `--g-color`，以保证多主题的一致性和框架的跨语言通用性。
 
 ### 示例
 
 ```xml
-<eflow :gutter="10">
-    <div>Node 1</div>
-    <div>Node 2</div>
+<eflow direction="v" :gutter="10" :state="state" @load="onLoad">
+    <div v-for="item in list" :key="item.id">{{ item.name }}</div>
 </eflow>
 ```
 
+```typescript
+public async onLoad(): Promise<void> {
+    this.state = 'loading';
+    const res = await fetchPage(++this.page);
+    this.list.push(...res.items);
+    this.state = res.hasMore ? 'idle' : 'complete';
+}
+```
+
 ## empty
 ---
 
@@ -6445,7 +6473,15 @@ QR 码组件，用于生成二维码。
 
 ### 事件
 
-无。
+#### change
+
+切换选项卡时触发。
+
+参数：
+
+`event: { go: boolean, preventDefault: Function, detail: { value: number } }`
+
+其中 `detail.value` 为即将切换到的索引，`preventDefault()` 可阻止切换。
 
 ### 样式
 
@@ -10393,6 +10429,7 @@ lib/control/index.md
 - [ISelectRemovedEvent](interfaces/ISelectRemovedEvent.md)
 - [ISelectRemoveEvent](interfaces/ISelectRemoveEvent.md)
 - [ISelectTagclickEvent](interfaces/ISelectTagclickEvent.md)
+- [IStabChangeEvent](interfaces/IStabChangeEvent.md)
 - [IStepClickedEvent](interfaces/IStepClickedEvent.md)
 - [ISwitchChangeEvent](interfaces/ISwitchChangeEvent.md)
 - [ITabChangedEvent](interfaces/ITabChangedEvent.md)
@@ -10987,6 +11024,7 @@ Custom Event
 - [`ISelectAddEvent`](ISelectAddEvent.md)
 - [`ISelectRemoveEvent`](ISelectRemoveEvent.md)
 - [`ISelectChangeEvent`](ISelectChangeEvent.md)
+- [`IStabChangeEvent`](IStabChangeEvent.md)
 - [`ISwitchChangeEvent`](ISwitchChangeEvent.md)
 - [`ITabChangeEvent`](ITabChangeEvent.md)
 - [`ITabCloseEvent`](ITabCloseEvent.md)
@@ -11191,7 +11229,7 @@ lib/control/interfaces/IFabricLayerchangeEvent.md
 
 # Interface: IFabricLayerchangeEvent
 
-Defined in: [lib/control.ts:1487](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1487)
+Defined in: [lib/control.ts:1495](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1495)
 
 ## Properties
 
@@ -11199,7 +11237,7 @@ Defined in: [lib/control.ts:1487](https://github.com/maiyun/clickgo/blob/master/
 
 > **detail**: `object`
 
-Defined in: [lib/control.ts:1488](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1488)
+Defined in: [lib/control.ts:1496](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1496)
 
 #### next
 
@@ -11224,7 +11262,7 @@ lib/control/interfaces/IFabricLayerlistchangeEvent.md
 
 # Interface: IFabricLayerlistchangeEvent
 
-Defined in: [lib/control.ts:1496](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1496)
+Defined in: [lib/control.ts:1504](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1504)
 
 ## Properties
 
@@ -11232,7 +11270,7 @@ Defined in: [lib/control.ts:1496](https://github.com/maiyun/clickgo/blob/master/
 
 > **detail**: `object`
 
-Defined in: [lib/control.ts:1497](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1497)
+Defined in: [lib/control.ts:1505](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1505)
 
 #### names
 
@@ -11263,7 +11301,7 @@ lib/control/interfaces/IFabricObjectchangeEvent.md
 
 # Interface: IFabricObjectchangeEvent
 
-Defined in: [lib/control.ts:1507](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1507)
+Defined in: [lib/control.ts:1515](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1515)
 
 ## Properties
 
@@ -11271,7 +11309,7 @@ Defined in: [lib/control.ts:1507](https://github.com/maiyun/clickgo/blob/master/
 
 > **detail**: `object`
 
-Defined in: [lib/control.ts:1508](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1508)
+Defined in: [lib/control.ts:1516](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1516)
 
 #### angle
 
@@ -12662,7 +12700,7 @@ lib/control/interfaces/IObjviewerLine.md
 
 # Interface: IObjviewerLine
 
-Defined in: [lib/control.ts:1523](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1523)
+Defined in: [lib/control.ts:1531](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1531)
 
 ## Properties
 
@@ -12670,7 +12708,7 @@ Defined in: [lib/control.ts:1523](https://github.com/maiyun/clickgo/blob/master/
 
 > **end**: [`IObjviewerLineObj`](IObjviewerLineObj.md)
 
-Defined in: [lib/control.ts:1527](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1527)
+Defined in: [lib/control.ts:1535](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1535)
 
 ***
 
@@ -12678,7 +12716,7 @@ Defined in: [lib/control.ts:1527](https://github.com/maiyun/clickgo/blob/master/
 
 > `optional` **hue?**: `string`
 
-Defined in: [lib/control.ts:1529](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1529)
+Defined in: [lib/control.ts:1537](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1537)
 
 默认 255
 
@@ -12688,7 +12726,7 @@ Defined in: [lib/control.ts:1529](https://github.com/maiyun/clickgo/blob/master/
 
 > `optional` **name?**: `string`
 
-Defined in: [lib/control.ts:1525](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1525)
+Defined in: [lib/control.ts:1533](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1533)
 
 -- 可自定义线段的名称
 
@@ -12698,7 +12736,7 @@ Defined in: [lib/control.ts:1525](https://github.com/maiyun/clickgo/blob/master/
 
 > `optional` **path?**: `string`
 
-Defined in: [lib/control.ts:1530](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1530)
+Defined in: [lib/control.ts:1538](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1538)
 
 ***
 
@@ -12706,7 +12744,7 @@ Defined in: [lib/control.ts:1530](https://github.com/maiyun/clickgo/blob/master/
 
 > **start**: [`IObjviewerLineObj`](IObjviewerLineObj.md)
 
-Defined in: [lib/control.ts:1526](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1526)
+Defined in: [lib/control.ts:1534](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1534)
 
 ***
 
@@ -12714,7 +12752,7 @@ Defined in: [lib/control.ts:1526](https://github.com/maiyun/clickgo/blob/master/
 
 > `optional` **stroke?**: `"down"` \| `"solid"` \| `"dashed"` \| `"up"`
 
-Defined in: [lib/control.ts:1532](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1532)
+Defined in: [lib/control.ts:1540](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1540)
 
 默认 solid
 
@@ -12729,7 +12767,7 @@ lib/control/interfaces/IObjviewerLineObj.md
 
 # Interface: IObjviewerLineObj
 
-Defined in: [lib/control.ts:1535](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1535)
+Defined in: [lib/control.ts:1543](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1543)
 
 ## Properties
 
@@ -12737,7 +12775,7 @@ Defined in: [lib/control.ts:1535](https://github.com/maiyun/clickgo/blob/master/
 
 > **obj**: `HTMLElement` \| [`AbstractControl`](../classes/AbstractControl.md)
 
-Defined in: [lib/control.ts:1536](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1536)
+Defined in: [lib/control.ts:1544](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1544)
 
 ***
 
@@ -12745,7 +12783,7 @@ Defined in: [lib/control.ts:1536](https://github.com/maiyun/clickgo/blob/master/
 
 > **pos**: `"b"` \| `"tr"` \| `"lt"` \| `"t"` \| `"r"` \| `"rb"` \| `"bl"` \| `"l"`
 
-Defined in: [lib/control.ts:1537](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1537)
+Defined in: [lib/control.ts:1545](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1545)
 
 lib/control/interfaces/IPaletteChangedEvent.md
 ---
@@ -13417,6 +13455,65 @@ Defined in: [lib/control.ts:1392](https://github.com/maiyun/clickgo/blob/master/
 
 > **value**: `string`
 
+lib/control/interfaces/IStabChangeEvent.md
+---
+
+[**Documents for clickgo**](../../../index.md)
+
+***
+
+[Documents for clickgo](../../../index.md) / [lib/control](../index.md) / IStabChangeEvent
+
+# Interface: IStabChangeEvent
+
+Defined in: [lib/control.ts:1415](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1415)
+
+Custom Event
+
+## Extends
+
+- [`ICustomEvent`](ICustomEvent.md)
+
+## Properties
+
+### detail
+
+> **detail**: `object`
+
+Defined in: [lib/control.ts:1416](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1416)
+
+#### value
+
+> **value**: `number`
+
+***
+
+### go
+
+> **go**: `boolean`
+
+Defined in: [lib/control.ts:878](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L878)
+
+#### Inherited from
+
+[`ICustomEvent`](ICustomEvent.md).[`go`](ICustomEvent.md#go)
+
+***
+
+### preventDefault
+
+> **preventDefault**: () => `void`
+
+Defined in: [lib/control.ts:879](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L879)
+
+#### Returns
+
+`void`
+
+#### Inherited from
+
+[`ICustomEvent`](ICustomEvent.md).[`preventDefault`](ICustomEvent.md#preventdefault)
+
 lib/control/interfaces/IStepClickedEvent.md
 ---
 
@@ -13428,7 +13525,7 @@ lib/control/interfaces/IStepClickedEvent.md
 
 # Interface: IStepClickedEvent
 
-Defined in: [lib/control.ts:1477](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1477)
+Defined in: [lib/control.ts:1485](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1485)
 
 ## Properties
 
@@ -13436,7 +13533,7 @@ Defined in: [lib/control.ts:1477](https://github.com/maiyun/clickgo/blob/master/
 
 > **detail**: `object`
 
-Defined in: [lib/control.ts:1478](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1478)
+Defined in: [lib/control.ts:1486](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1486)
 
 #### index
 
@@ -13461,7 +13558,7 @@ lib/control/interfaces/ISwitchChangeEvent.md
 
 # Interface: ISwitchChangeEvent
 
-Defined in: [lib/control.ts:1415](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1415)
+Defined in: [lib/control.ts:1423](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1423)
 
 Custom Event
 
@@ -13475,7 +13572,7 @@ Custom Event
 
 > **detail**: `object`
 
-Defined in: [lib/control.ts:1416](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1416)
+Defined in: [lib/control.ts:1424](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1424)
 
 #### value
 
@@ -13520,7 +13617,7 @@ lib/control/interfaces/ITabChangedEvent.md
 
 # Interface: ITabChangedEvent
 
-Defined in: [lib/control.ts:1429](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1429)
+Defined in: [lib/control.ts:1437](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1437)
 
 ## Properties
 
@@ -13528,7 +13625,7 @@ Defined in: [lib/control.ts:1429](https://github.com/maiyun/clickgo/blob/master/
 
 > **detail**: `object`
 
-Defined in: [lib/control.ts:1430](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1430)
+Defined in: [lib/control.ts:1438](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1438)
 
 #### value
 
@@ -13545,7 +13642,7 @@ lib/control/interfaces/ITabChangeEvent.md
 
 # Interface: ITabChangeEvent
 
-Defined in: [lib/control.ts:1423](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1423)
+Defined in: [lib/control.ts:1431](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1431)
 
 Custom Event
 
@@ -13559,7 +13656,7 @@ Custom Event
 
 > **detail**: `object`
 
-Defined in: [lib/control.ts:1424](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1424)
+Defined in: [lib/control.ts:1432](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1432)
 
 #### value
 
@@ -13604,7 +13701,7 @@ lib/control/interfaces/ITabCloseEvent.md
 
 # Interface: ITabCloseEvent
 
-Defined in: [lib/control.ts:1435](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1435)
+Defined in: [lib/control.ts:1443](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1443)
 
 Custom Event
 
@@ -13618,7 +13715,7 @@ Custom Event
 
 > **detail**: `object`
 
-Defined in: [lib/control.ts:1436](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1436)
+Defined in: [lib/control.ts:1444](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1444)
 
 #### index
 
@@ -13667,7 +13764,7 @@ lib/control/interfaces/ITableSortEvent.md
 
 # Interface: ITableSortEvent
 
-Defined in: [lib/control.ts:1444](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1444)
+Defined in: [lib/control.ts:1452](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1452)
 
 Custom Event
 
@@ -13681,7 +13778,7 @@ Custom Event
 
 > **detail**: `object`
 
-Defined in: [lib/control.ts:1445](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1445)
+Defined in: [lib/control.ts:1453](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1453)
 
 #### index
 
@@ -13734,7 +13831,7 @@ lib/control/interfaces/ITagDropEvent.md
 
 # Interface: ITagDropEvent
 
-Defined in: [lib/control.ts:1468](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1468)
+Defined in: [lib/control.ts:1476](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1476)
 
 ## Properties
 
@@ -13742,7 +13839,7 @@ Defined in: [lib/control.ts:1468](https://github.com/maiyun/clickgo/blob/master/
 
 > **detail**: `object`
 
-Defined in: [lib/control.ts:1469](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1469)
+Defined in: [lib/control.ts:1477](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1477)
 
 #### after
 
@@ -13889,7 +13986,7 @@ lib/control/interfaces/ITuieditorImguploadEvent.md
 
 # Interface: ITuieditorImguploadEvent
 
-Defined in: [lib/control.ts:1454](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1454)
+Defined in: [lib/control.ts:1462](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1462)
 
 ## Properties
 
@@ -13897,7 +13994,7 @@ Defined in: [lib/control.ts:1454](https://github.com/maiyun/clickgo/blob/master/
 
 > **detail**: `object`
 
-Defined in: [lib/control.ts:1455](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1455)
+Defined in: [lib/control.ts:1463](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1463)
 
 #### callback
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clickgo",
-  "version": "5.16.2",
+  "version": "5.17.1",
   "description": "Background interface, software interface, mobile phone APP interface operation library.",
   "type": "module",
   "keywords": [