tadcode-wpsjs 1.2.1 → 1.3.0

package/README.md

@@ -6,6 +6,8 @@
 
 在部署远程代码的情况下，可以远程调用`WpsjsGlobal`，实现对支持`AirScript`的多维表，智能表格等远程操作。如果你对`AirScript`，感兴趣，也能帮助你学习`WpsjsGlobal`。
 
+In the case of deploying remote code, WpsjsGlobal can be remotely called to achieve remote operations on multidimensional tables, smart tables, and other tables that support AirScript. If you are interested in AirScript, it can also help you learn WpsjsGlobal.
+
 原理是使用代理收集调用信息，之后让远程代码进行调用并且返回结果。
 远程代码在`tadcode-wpsjs/remoteCode`目录的`index.js`文件中。
 将其复制粘贴到对应`webhook`的脚本中才能支持`WpsjsGlobal`对象的调用。
@@ -53,7 +55,7 @@ const data = await wpsjsGlobal.Application.Sheet.GetSheets()
 console.log(data)
 ```
 
-### 重命名（远程赋值操作）
+### 多维表的重命名（赋值操作）
 
 ```ts
 import { initRemoteCallWpsjsGlobal,setValue } from 'tadcode-wpsjs'
@@ -68,6 +70,23 @@ const sheet = wpsjsGlobal.Application.Sheets(1)
 await setValue(sheet,'Name','table1001')
 ```
 
+### 修改记录区域字体颜色（赋值操作，此写法可以复用对象）
+
+```ts
+import type { Font } from 'application:datatable'
+import { initRemoteCallWpsjsGlobal,setValue } from 'tadcode-wpsjs'
+/* 脚本令牌 具体获取方式参考上面 */
+const scriptToken = 'xxxx'
+/* webhook url地址 具体获取方式参考上面 */
+const webhookURL = 'xxxx'
+const wpsjsGlobal = initRemoteCallWpsjsGlobal({ scriptToken, webhookURL,  })
+
+const range = wpsjsGlobal.Application.ActiveSheet.RecordRange([1, 2], [1, 2]).Font as unknown as Font
+range.Color = '#ff00ff'
+/* 注意：赋值操作依旧远程操作。此函数会拿到最后一次赋值操作的promise */
+await setValueOk()
+```
+
 ### 执行脚本并且返回（不用部署remoteCode代码）
 
 ```ts
@@ -81,13 +100,13 @@ const data =await result.json()
 console.log(data)
 ```
 
-## 支持
-
-如果对你有用请在[gitcode](https://gitcode.com/caisijian/tadcode-wpsjs)给个`star`
-
 ## 基于wps官方文档
 - [**AirScript文档**](https://airsheet.wps.cn/docs/apitoken/intro.html)
 - [**WPS多维表格：“开发”功能使用说明文档**](https://365.kdocs.cn/l/ctzsgDlAGF0l)
 - [**执行AirScript脚本操作使用指南**](https://365.kdocs.cn/l/cdQOqc6TZuMk)
 - [**快速入门多维表“开发”**](https://365.kdocs.cn/l/ctx1jAV1xJhR)
 - [**WPS开放平台dbsheet-Api部分**](https://365.kdocs.cn/3rd/open/documents/app-integration-dev/guide/dbsheet/Api/api-instro)
+
+## 支持
+
+如果对你有用请在[gitcode](https://gitcode.com/caisijian/tadcode-wpsjs)给个`star`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tadcode-wpsjs",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "type": "module",
   "scripts": {
     "hot": "NODE_ENV=development bun --hot ignore/index.ts",

package/types/application/Font.d.ts

@@ -0,0 +1,10 @@
+declare module 'application:datatable' {
+  // Font 接口
+  interface Font {
+    // 属性
+    Color: string;
+  }
+
+  // 导出 Font 类型
+  export type { Font };
+}

package/types/application/Window.d.ts

@@ -0,0 +1,57 @@
+declare module 'application:datatable' {
+  // 基础类型定义
+  interface HookParams {
+    recordId: string;
+    activeFieldId?: string;
+    isShowComment?: boolean;
+  }
+
+  interface Hook {
+    InvokeSingle(callback: (params: HookParams) => boolean): void;
+  }
+
+  // Navigator 类型（根据文档引用）
+  interface Navigator {
+    // Navigator属性
+  }
+
+  // NoticeBar 类型（根据文档引用）
+  interface NoticeBar {
+    // NoticeBar属性
+  }
+
+  // FormViewUI 类型（根据文档引用）
+  interface FormViewUI {
+    // FormViewUI属性
+  }
+
+  // GanttViewUI 类型（根据文档引用）
+  interface GanttViewUI {
+    // GanttViewUI属性
+  }
+
+  // GridViewUI 类型（根据文档引用）
+  interface GridViewUI {
+    // GridViewUI属性
+  }
+
+  // Window 接口
+  interface Window {
+    // 属性
+    readonly Navigator: Navigator;
+    readonly NoticeBar: NoticeBar;
+    readonly FormViewUI: FormViewUI;
+    readonly GanttViewUI: GanttViewUI;
+    readonly GridViewUI: GridViewUI;
+
+    // 方法
+    SetLayout(isClassic: boolean): void;
+    BailHook(CmbId: string): Hook;
+    DisplayRecord(RecodId?: string): void;
+    HiddenAllRecord(): void;
+    InterceptCopyRecordLink?(): void; // 文档中有列出但无详细说明
+  }
+
+  // 导出 Window 类型
+  export type { Window };
+}

package/types/application/index.d.ts

@@ -9,6 +9,7 @@ declare module 'application:datatable' {
     Sheets,
     Sheet,
     View,
+    Window
   } from "application:datatable"
 
   interface Application {
@@ -21,6 +22,7 @@ declare module 'application:datatable' {
     Sheets: Sheets,
     ActiveSheet: Sheet,
     ActiveView: View,
+    Window: Window,
   }
 
   export type { Application }

package/return.wpsjs.json

@@ -1,72 +0,0 @@
-{
-  "data": {
-    "logs": [
-      {
-        "filename": "<system>",
-        "timestamp": "04:19:17.543",
-        "unix_time": 1772396357543,
-        "level": "info",
-        "args": [
-          "脚本环境(1.0)初始化..."
-        ]
-      },
-      {
-        "filename": "<system>",
-        "timestamp": "04:19:18.519",
-        "unix_time": 1772396358519,
-        "level": "info",
-        "args": [
-          "已开始执行"
-        ]
-      },
-      {
-        "filename": "未命名脚本文件.js:9:15",
-        "timestamp": "04:19:18.537",
-        "unix_time": 1772396358537,
-        "level": "info",
-        "args": [
-          "[\"Application\"]"
-        ]
-      },
-      {
-        "filename": "未命名脚本文件.js:9:15",
-        "timestamp": "04:19:18.537",
-        "unix_time": 1772396358537,
-        "level": "info",
-        "args": [
-          "[\"ActiveView\"]"
-        ]
-      },
-      {
-        "filename": "未命名脚本文件.js:9:15",
-        "timestamp": "04:19:18.539",
-        "unix_time": 1772396358539,
-        "level": "info",
-        "args": [
-          "[\"Records\"]"
-        ]
-      },
-      {
-        "filename": "未命名脚本文件.js:9:15",
-        "timestamp": "04:19:18.542",
-        "unix_time": 1772396358542,
-        "level": "info",
-        "args": [
-          "[\"Select\"]"
-        ]
-      }
-    ],
-    "result": null
-  },
-  "error": "Cannot read properties of undefined (reading 'getRecordViewRow')",
-  "error_details": {
-    "name": "TypeError",
-    "msg": "Cannot read properties of undefined (reading 'getRecordViewRow')",
-    "stack": [
-      "",
-      "    at 未命名脚本文件.js:18:31"
-    ],
-    "unix_time": 1772396358544
-  },
-  "status": "finished"
-}