Bookmark_智能媒体管理-阿里云帮助中心

本文介绍与文字文档Bookmark相关的API。

Bookmarks

ActiveDocument.Bookmarks

获取文档中的所有书签。

重要

JS-SDK V1.1.10及以上版本支持此功能。

语法
表达式.ActiveDocument.Bookmarks
表达式：文档类型应用对象

示例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  //获取所有书签
  const bookmarks = await app.ActiveDocument.Bookmarks;
}

方法

ActiveDocument.Bookmarks.Add()

通过Add()方法，您可以添加书签。

重要

JS-SDK V1.1.10及以上版本支持此功能。
仅PC端支持此功能。

语法
表达式.ActiveDocument.Bookmarks.Add({ Name, Range })
表达式：文档类型应用对象

参数

属性

数据类型

是否必填

描述

Name

String

是

书签名。命名规则如下：

不能多于一个单词。
不能含有空格、数字以及半角句号（.）等特殊符号。

Range

Object

是

书签标记的文本区域。可将书签设置到一个折叠的区域（插入点）。

Range说明

属性	数据类型	是否必填	描述
Start	Number	是	设置书签的起点。
End	Number	是	设置书签的终点。

示例

async function example() {
  await instance.ready();

  const app = instance.Application;

  //获取所有书签
  const bookmarks = await app.ActiveDocument.Bookmarks;

  //添加书签
  await bookmarks.Add({
    Name: 'Aliyun',
    Range: {
      Start: 1,
      End: 10,
    },
  });
}

ActiveDocument.Bookmarks.GetBookmarkText()

通过GetBookmarkText()方法，您可以获取书签内容。

重要

JS-SDK V1.1.10及以上版本支持此功能。

语法
表达式.ActiveDocument.Bookmarks.GetBookmarkText(Name)
表达式：文档类型应用对象
参数
属性
数据类型
是否必填
描述
Name
String
是
书签名。

示例

async function example() {
  await instance.ready();

  const app = instance.Application;

  //获取所有书签
  const bookmarks = await app.ActiveDocument.Bookmarks;

  //添加书签
  await bookmarks.Add({
    Name: 'Aliyun',
    Range: {
      Start: 1,
      End: 10,
    },
  });

  //获取书签内容
  const bookmarkText = await bookmarks.GetBookmarkText('Aliyun');
  console.log(bookmarkText);
}

ActiveDocument.Bookmarks.Json()

通过Json()方法，您可以获取所有书签信息。

重要

JS-SDK V1.1.10及以上版本支持此功能。

语法
表达式.ActiveDocument.Bookmarks.Json()
表达式：文档类型应用对象
参数
属性
数据类型
描述
name
String
书签名。
begin
Number
书签开始位置。
end
Number
书签结束位置。

示例

async function example() {
  await instance.ready();

  const app = instance.Application;

  //获取所有书签
  const bookmarks = await app.ActiveDocument.Bookmarks;


  //添加书签
  await app.ActiveDocument.Bookmarks.Add({
    Name: 'Aliyun',
    Range: {
      Start: 1,
      End: 10,
    },
  });

  //获取所有书签信息
  const bookmarks = await app.ActiveDocument.Bookmarks.Json();
  console.log(bookmarks);
}

ActiveDocument.Bookmarks.ReplaceBookmark()

通过ReplaceBookmark()方法，您可以替换书签内容。

重要

JS-SDK V1.1.10及以上版本支持此功能。

语法
表达式.ActiveDocument.Bookmarks.ReplaceBookmark(Data)
表达式：文档类型应用对象
参数
属性
数据类型
是否必填
描述
Data
Array.<Object>
是
替换内容结构体。
Data说明
属性
数据类型
是否必填
描述
name
String
是
替换书签的名称。
type
String
是
替换书签的类型。书签类型为TEXT。
value
String
是
替换书签的新内容。
返回值
返回Boolean，true表示替换成功，false表示替换失败。

示例

async function example() {
  await instance.ready();

  const app = instance.Application;

  //获取所有书签
  const bookmarks = await app.ActiveDocument.Bookmarks;

  //添加书签
  await bookmarks.Add({
    Name: 'Aliyun',
    Range: {
      Start: 1,
      End: 10,
    },
  });

  //替换书签内容
  const isReplaceSuccess = await bookmarks.ReplaceBookmark([
    {
      name: 'Aliyun',
      type: 'text',
      value: '替换书签内容',
    },
  ]);
  console.log(isReplaceSuccess);
}

Bookmark

ActiveDocument.Bookmarks.Item()

获取单个书签对象。

重要

JS-SDK V1.1.10及以上版本支持此功能。

语法
表达式.ActiveDocument.Bookmarks.Item(Name)
表达式：文档类型应用对象
参数
属性
数据类型
是否必填
描述
Name
String
是
书签名。

示例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  //获取所有书签
  const bookmarks = await app.ActiveDocument.Bookmarks;

  //添加书签
  await bookmarks.Add({
    Name: 'Aliyun',
    Range: {
      Start: 1,
      End: 10,
    },
  });

  //获取单个书签对象
  await app.ActiveDocument.Bookmarks.Item('Aliyun');
}

方法

ActiveDocument.Bookmarks.Item(Name).Delete()

通过Delete()方法，您可以删除单个书签。

重要

JS-SDK V1.1.10及以上版本支持此功能。

语法
表达式.ActiveDocument.Bookmarks.Item(Name).Delete()
表达式：文档类型应用对象

示例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  //获取所有书签
  const bookmarks = await app.ActiveDocument.Bookmarks;

  //添加书签
  await bookmarks.Add({
    Name: 'Aliyun',
    Range: {
      Start: 1,
      End: 10,
    },
  });

  //获取单个书签对象
  await app.ActiveDocument.Bookmarks.Item('Aliyun');

  //删除单个书签
  await app.ActiveDocument.Bookmarks.Item('Aliyun').Delete();
}

属性

ActiveDocument.Bookmarks.Item(Name).Name

通过Name属性，您可以获取单个书签名称。

重要

JS-SDK V1.1.10及以上版本支持此功能。

语法
表达式.ActiveDocument.Bookmarks.Item(Name).Name
表达式：文档类型应用对象

示例

async function example() {
  await instance.ready();

  const app = instance.Application;
  
  //获取所有书签
  const bookmarks = await app.ActiveDocument.Bookmarks;

  //添加书签
  await bookmarks.Add({
    Name: 'Aliyun',
    Range: {
      Start: 1,
      End: 10,
    },
  });

  //获取单个书签对象
  await app.ActiveDocument.Bookmarks.Item('Aliyun');

  //获取单个书签名称
  await app.ActiveDocument.Bookmarks.Item('Aliyun').Name;
}

属性	数据类型	描述
name	String	书签名。
begin	Number	书签开始位置。
end	Number	书签结束位置。