0

0

如何在 Antora 文档中启用 SVG 图像的原生 Tooltip 交互功能

心靈之曲

心靈之曲

发布时间:2026-01-26 12:41:17

|

482人浏览过

|

来源于php中文网

原创

antora 默认使用 `如何在 Antora 文档中启用 SVG 图像的原生 Tooltip 交互功能` 标签嵌入 svg,导致其中的 `

` 或 `tooltip` 无法显示;通过 asciidoc 的 `opts=interactive` 选项可自动改用 `<object>` 方式嵌入,完美支持 svg 内置提示、缩放与矢量交互,无需修改 <a style="color:#f60; text-decoration:underline;" title="css" href="https://www.php.cn/zt/15716.html" target="_blank">css</a> 或 ui 模板。<p>在 Antora 构建的文档中,SVG 图像常被用于展示架构图、流程图等富含语义信息的可视化内容。许多作者会直接在 SVG 源码中添加 <title> 元素(或使用 toolTip 类库)来提供悬停提示,例如:</p><pre class="brush:php;toolbar:false;"><!-- sample.svg 片段 --> <circle cx="50" cy="50" r="30" fill="#4285f4"> <title>用户服务模块:负责身份认证与会话管理</title> </circle></pre><p>然而,当该 SVG 以 <img src="sample.svg"> 方式嵌入 HTML 时,<a style="color:#f60; text-decoration:underline;" title="浏览器" href="https://www.php.cn/zt/16180.html" target="_blank">浏览器</a><strong>完全隔离 SVG 内部结构</strong>——所有 <title>、<desc>、JavaScript 和 CSS 均失效,Tooltip 自然不可见。</p> <p>✅ 正确解法:使用 AsciiDoc 原生支持的 opts=interactive<br> 该选项会令 Asciidoctor(Antora 底层渲染引擎)自动将图像渲染为 <object type="image/svg+xml" data="...">,使 SVG 完整上下文(包括 DOM、事件、CSS、标题)在页面中可访问:</p><pre class="brush:php;toolbar:false;">// ✅ 推荐写法:启用交互式 SVG image::architecture.svg[系统架构图,opts=interactive,width=100%] // ⚠️ 注意:width=100% 在 interactive 模式下可能受限于容器 // 若需响应式铺满,建议搭配 CSS 容器控制(见下方)</pre><p>? 补充说明: </p> <ul> <li> <p>width=100% 在 opts=interactive 下<strong>部分浏览器(如 Safari)可能不生效</strong>,因 <object> 默认采用固有尺寸。此时推荐组合使用: </p><pre class="brush:php;toolbar:false;">image::diagram.svg[流程图,opts=interactive,width=3072]</pre><p>width=3072 并非固定像素值,而是设为一个足够大的“最大宽度”(max-width),配合 SVG 自身的 viewBox 属性,可实现高质量响应式缩放(矢量无损)。 </p><div class="aritcle_card flexRow"> <div class="artcardd flexRow"> <a class="aritcle_card_img" href="/ai/2709" title="一点PPT"><img src="https://img.php.cn/upload/ai_manual/001/246/273/177310570147998.png" alt="一点PPT" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a> <div class="aritcle_card_info flexColumn"> <a href="/ai/2709" title="一点PPT">一点PPT</a> <p>一句话生成专业PPT,AI自动排版配图</p> </div> <a href="/ai/2709" title="一点PPT" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a> </div> </div> </li> <li> <p>如需严格 100% 宽度且保持比例,可在 Antora UI 的 doc.css 中追加轻量样式(非必需,但增强兼容性):</p><pre class="brush:php;toolbar:false;">.imageblock > .content > object { display: block; width: 100%; height: auto; }</pre></li> </ul> <p>? 总结: </p> <ul> <li> <strong>无需修改 Antora UI 的 CSS 或模板文件</strong>(如 doc.css#L435–440); </li> <li> <strong>无需手动替换 <img> 为 <object></strong>——opts=interactive 由 Asciidoctor 自动处理; </li> <li>Tooltip、缩放、无障碍描述(<desc>)、甚至内联 JS 交互均可原生支持; </li> <li>对初学者极友好:只需在 AsciiDoc 图像宏中增加一个属性,零<a style="color:#f60; text-decoration:underline;" title="前端" href="https://www.php.cn/zt/15813.html" target="_blank">前端</a>知识门槛。</li> </ul> <p>立即尝试:将你的 image::xxx.svg[alt] 改为 image::xxx.svg[alt,opts=interactive,width=2048],重建文档即可验证 Tooltip 是否正常悬停显示。</p></object>

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1949

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2119

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

1171

2024.11.28

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

531

2023.06.20

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

576

2023.07.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

760

2023.08.03

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

6235

2023.08.17

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

492

2023.09.01

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Sass 教程
Sass 教程

共14课时 | 0.9万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.6万人学习

CSS教程
CSS教程

共754课时 | 42.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号