在段落中插入超链接

场景说明

在文档中插入超链接,可以链接到网页、文件或文档内部位置。

适用场景:

• 添加参考链接
• 创建文档导航
• 链接到外部资源
• 文档交叉引用

相关 API 文档

• Hyperlinks - 超链接集合
• Hyperlinks.add - 插入超链接
• Bookmark.focus - 定位到书签

示例代码

插入超链接

async function insertHyperlink() {
  // 获取书签并定位
  const bookmark = await Application.ActiveDocument.Bookmarks.item('linkPlace');
  await bookmark.focus();
  
  // 插入超链接
  // Address: 链接地址（必填），支持 http、https、mailto 等协议
  // TextToDisplay: 显示文本（可选），不指定则使用选中的文本
  const params = {
    Address: 'https://example.com',
    TextToDisplay: '点击访问示例网站'
  };
  
  await Application.ActiveDocument.Hyperlinks.add(params);
  console.log('超链接插入成功');
}

注意事项

• 插入超链接前需要先定位到目标位置（使用 bookmark.focus() 或选中文本）
• Address 参数支持多种协议：http、https、mailto 等
• TextToDisplay 参数可选，不指定则使用当前选中的文本
• 超链接会自动应用链接样式（通常是蓝色下划线）