Skip to content

Public

公共处理函数

语法

表达式.Public

表达式:文档类型应用对象

示例

//@file=base.docx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 公共处理对象
  const panes = await app.Public
}

KeyBoardHeight

JSSDK: v1.1.11+、WebOffice v3.1.1+ 支持

【移动端】获取和设置键盘高度

注:设置高度为 逻辑像素,设置前请先处理物理像素和逻辑像素的转换

语法

表达式.KeyBoardHeight

表达式:实例化的 Public 对象

示例

//@file=base.docx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 公共处理对象
  const Public = await app.Public

  // 【移动端】获取键盘高度
  const height = await Public.KeyBoardHeight

  // 设置高度
  Public.KeyBoardHeight = 48
}

DispatchModelVisible()

JSSDK: v1.1.10+、WebOffice v2.3.1+ 支持

派发第三方弹窗操作事件

语法

表达式.DispatchModelVisible({ Visible })

表达式:实例化的 Public 对象

参数

属性数据类型默认值必填说明
Visible
boolean
false
可视化状态

返回值

返回对应的 Public 对象。

示例

//@file=base.docx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 公共处理对象
  const Public = await app.Public

  // 派发第三方弹窗操作事件
  const pane = await Public.DispatchModelVisible(true)
}

JSSDK: v1.1.15+、WebOffice v4.1.1+ 支持

封装 window.open,并加入跳转链接安全检查逻辑

语法

表达式.OpenLink()

表达式:实例化的 Public 对象

参数

参数同 window.open()参考链接

示例

//@file=base.docx
async function example() {
  await instance.ready()

  const app = instance.Application

  await app.Public.OpenLink('https://www.kdocs.cn')

  await app.Public.OpenLink('https://www.baidu.com')
}

PreviewRestore()

恢复历史版本

语法

表达式.PreviewRestore({ Version, Reversion, })

表达式:实例化的 Public 对象

参数

属性数据类型默认值必填说明
Version
number
按历史版本恢复
Revision
number
按协作纪录恢复
HistoryId
string
历史版本 ID

返回值

返回对应的 Public 对象。

示例

//@file=base.docx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 公共处理对象
  const Public = await app.Public

  // 恢复历史版本
  const pane = await Public.PreviewRestore({
    Version: 535,
    HistoryId: 'test'
  })
}

SendBroadcast()

发送全局广播

语法

表达式.SendBroadcast({ Data, Id })

表达式:实例化的 Public 对象

参数

属性数据类型默认值必填说明
Data
Object
信息
Id
Boolean
指定接收信息的用户 ID

返回值

返回对应的 Public 对象。

示例

//@file=base.docx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 公共处理对象
  const Public = await app.Public

  // 发送全局广播
  const result = await Public.SendBroadcast({
    Data: { message: '测试' }
  })
}