weboffice-js-sdk 2.0.3-beta.5 → 2.0.3-beta.7

package/dist/OfficeSDK.d.ts

@@ -32,15 +32,15 @@ export interface HeaderBarsCommandRef {
     onCommandClick?: () => void | Promise<void>;
     getState: () => HeaderBarsCommandState | undefined;
 }
+export type HeaderBarsTitleChangeHandler = (title: string) => void | Promise<void>;
 export interface HeaderBarsFacade {
     visible: boolean;
+    onTitleChange?: HeaderBarsTitleChangeHandler;
     getVisible: () => Promise<boolean>;
     setVisible: (visible: boolean) => Promise<void>;
     addCommand: (command: HeaderBarsCommandDefinition, posCommand: string, pos?: 'before' | 'after') => Promise<boolean>;
     getCommand: (id: string) => HeaderBarsCommandRef;
     listViewCommands: () => Promise<HeaderBarsCommandState[]>;
-    setTitleDraft: (title: string) => Promise<void>;
-    confirmTitleChange: (title: string) => Promise<void>;
 }
 export declare const MessageEvent: typeof InvokeMethod;
 export declare class OfficeSDK extends TinyEmitter {
@@ -114,6 +114,8 @@ export declare class OfficeSDK extends TinyEmitter {
     private readonly headerBarsCommands;
     private readonly headerBarsCommandOverrides;
     private readonly headerBarsCommandRefs;
+    private headerBarsTitleChangeHandler?;
+    private headerBarsTitleChangeSubscribed;
     private readonly onViewportResize;
     /**
      * 归一化后的缺省页配置，构造时一次算完，后续仅读取。
@@ -164,6 +166,12 @@ export declare class OfficeSDK extends TinyEmitter {
      */
     private bindContainerMethodHandlers;
     private initHeaderBarsFacade;
+    /**
+     * 订阅 iframe 侧 titleChange 事件，并在宿主设置了 headerBars.onTitleChange 时转发标题值。
+     * 输入：无。
+     * 输出：监听建立成功后返回 Promise<void>；重复调用只会订阅一次。
+     */
+    private ensureHeaderBarsTitleChangeSubscription;
     private invokeHeaderBars;
     private syncHeaderBarsCommands;
     private applyHeaderBarsChanged;
@@ -347,14 +355,27 @@ export interface OfficeSDKOptions extends Omit<ContainerMethods, 'getContainerRe
      * 指定石墨 SDK 编辑器界面语言，添加到 iframe URLSearchParams 的参数列表。
      * 若未指定，则 iframe 使用服务器设置的默认语言。
      *
-     * 目前支持的语言取值：
+     * 目前支持的标准语言取值：
      * 1. zh-CN（简体中文）
-     * 2. en（英文）
-     * 3. ja（日文）
-     * 4. ar-SA（阿拉伯语）
-     * 5. ru-RU（俄语）
+     * 2. zh-TW（繁体中文）
+     * 3. en-US（英文）
+     * 4. ja-JP（日文）
+     * 5. ko-KR（韩文）
+     * 6. es-ES（西班牙语）
+     * 7. pt-PT（葡萄牙语）
+     * 8. de-DE（德语）
+     * 9. fr-FR（法语）
+     * 10. it-IT（意大利语）
+     * 11. ru-RU（俄语）
+     * 12. id-ID（印尼语）
+     * 13. vi-VN（越南语）
+     * 14. th-TH（泰语）
+     * 15. ms-MY（马来语）
+     * 16. ar-SA（阿拉伯语）
+     *
+     * 为兼容旧版写法，仍接受 en、ja，传入后会自动映射为 en-US、ja-JP。
      */
-    lang?: 'zh-CN' | 'en' | 'ja' | 'ar-SA' | 'ru-RU';
+    lang?: 'zh-CN' | 'zh-TW' | 'en-US' | 'ja-JP' | 'ko-KR' | 'es-ES' | 'pt-PT' | 'de-DE' | 'fr-FR' | 'it-IT' | 'ru-RU' | 'id-ID' | 'vi-VN' | 'th-TH' | 'ms-MY' | 'ar-SA' | 'en' | 'ja';
     /**
      * 是否禁用提及的浮动卡片组件
      */