如何在 Bootstrap 折叠组件中单次点击即加载 NGL 3D 分子可视化

千强酱_1964

千强酱_1964

2025-12-30

154人浏览

原创

如何在 Bootstrap 折叠组件中单次点击即加载 NGL 3D 分子可视化

本文解决在 bootstrap `collapse` 组件内调用 ngl 3d 查看器时需双击才生效的问题,核心是确保 dom 元素完全展开后再初始化 ngl stage。

在使用 Bootstrap 的 .collapse 类实现“点击展开 + 加载 3D 视图”交互时,常见问题为:用户首次点击“Show 3D”,折叠区域开始展开动画,但此时

尚未完成渲染(仍处于 display: none 或过渡态),导致 new NGL.Stage(id, ...) 初始化失败或静默忽略——结果是第二次点击时元素已就绪,3D 才真正加载,造成“需双击”的错觉。

根本原因在于:Bootstrap 的 collapse 切换是异步的(含 CSS 过渡),而 showPDB() 在点击瞬间立即执行,此时目标容器尚未被浏览器布局引擎确认为可见、可渲染的 DOM 节点。

✅ 正确解法不是简单加 setTimeout(如答案中未设延迟值的空 setTimeout 仅推入微任务队列,无法保证 DOM 更新完成),而是应监听 Bootstrap 提供的 原生事件钩子,在折叠内容完全显示后触发 NGL 初始化。

浏览器会话(免费版)
浏览器会话(免费版)

浏览器会话管理免费版,支持一次性页面抓取、基础会话列表与简易调试。

下载

✅ 推荐方案:使用 Bootstrap 的 shown.bs.collapse 事件

将 showPDB 调用解耦,改为监听 #show_0 展开完成事件,并传入参数:

<div class="row">
  <div class="col" data-toggle="collapse" data-target="#show_0" id="_show_0">
    <b>Show 3D</b>
  </div>
</div>

<div id="show_0" class="collapse">
  <div class="row">
    <div class="col">
      <div id="viewport_0" style="width:100%; height:800px;"></div>
    </div>
  </div>
</div>

<script>
// 定义加载函数(不立即执行)
function showPDB(path, containerId) {
  // 确保容器存在且可见
  const container = document.getElementById(containerId);
  if (!container || getComputedStyle(container).display === 'none') {
    console.warn(`Container #${containerId} not ready yet.`);
    return;
  }

  const stage = new NGL.Stage(containerId, { backgroundColor: 'white' });
  stage.loadFile(path).then(function (o) {
    o.addRepresentation("cartoon", { color: 'white' });
    o.autoView();
  }).catch(err => console.error("Failed to load PDB:", err));
}

// 监听展开完成事件(推荐!)
document.getElementById('show_0').addEventListener('shown.bs.collapse', function () {
  showPDB('https://alphafold.ebi.ac.uk/files/AF-P08047-F1-model_v4.pdb', 'viewport_0');
});
</script>

⚠️ 注意事项

  • 不要依赖 onclick 行内调用 + setTimeout:未指定毫秒数的 setTimeout(fn) 默认延迟 0ms,仅进入宏任务队列,无法保证 DOM 重排(reflow)完成;而 shown.bs.collapse 是 Bootstrap 在 transitionend 后精确触发的真实完成信号。
  • 确保 NGL 脚本加载完成:<script src="https://&lt;a%20style=" color: text-decoration:underline title="cdn" href="https://m.php.cn/zt/19618.html" target="_blank">cdn.<a style="color:#f60; text-decoration:underline;" title= "js"href="https://m.php.cn/zt/15802.html" target="_blank">jsdelivr.net/<a style="color:#f60; text-decoration:underline;" title= "npm"href="https://m.php.cn/zt/16096.html" target="_blank">npm/ngl@latest/dist/ngl.min.js"></script> 应置于

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
bootstrap框架介绍
bootstrap框架介绍

本专题整合了bootstrap框架相关介绍,阅读专题下面的文章了解更多详细内容。

2026.03.18

805

21

bootstrap安装教程
bootstrap安装教程

本专题整合了bootstrap安装相关教程,阅读专题下面的文章了解更多详细操作教程。

2026.03.18

219

9

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

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

2023.06.20

5076

8

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

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

2023.07.28

1475

5

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

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

2023.08.03

1958

5

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

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

2023.08.17

10623

11

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

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

2023.09.01

1080

4

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

3244

5

Js中concat和push的区别
Js中concat和push的区别

Js中concat和push的区别:1、concat用于将两个或多个数组合并成一个新数组,并返回这个新数组,而push用于向数组的末尾添加一个或多个元素,并返回修改后的数组的新长度;2、concat不会修改原始数组,是创建新的数组,而push会修改原数组,将新元素添加到原数组的末尾等等。本专题为大家提供concat和push相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.14

1689

5

热门下载

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

精品课程

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