Bootstrap原生不提供时间轴组件，需用border-start、CSS动画和IntersectionObserver手写滚动触发逻辑。核心是监听元素进入视口后添加.visible类实现淡入效果，注意间距、transition覆盖及SSR时机问题。
Bootstrap 本身不提供时间轴（Timeline）组件，也没有内置动态动画逻辑——所谓“Bootstrap 时间轴动画”，实际是用 Bootstrap 的栅格、工具类和 CSS 动画能力，配合少量 JavaScript 控制显隐或滚动触发。直接依赖 bootstrap.js 或 bootstrap.min.css 无法自动实现“动态时间轴”，必须手写关键逻辑。
为什么原生 Bootstrap 没有 timeline 组件
Bootstrap 官方组件列表里从 v4 到 v5.3 都没有 timeline。社区常见的时间轴效果，本质是开发者用 col + border-start（v5.3+）或自定义伪元素模拟竖线，再靠 opacity、transform 和 intersectionObserver 实现“随滚动逐条出现”的动态感。
- Bootstrap 的
border-start可快速画出时间轴主干，但不会自动响应滚动 -
fade、slide-in等动画类只负责入场样式，不控制触发时机 - 若强行用
data-bs-toggle="collapse"做点击展开，会丢失“滚动进入视口才动”的自然感
用 IntersectionObserver 触发每项淡入动画
这是最轻量、兼容性好（Chrome 51+/Firefox 55+）、不依赖第三方库的方案。核心是监听每个时间轴节点是否进入视口，然后添加动画 class。
HTML 结构示例（使用 Bootstrap 5.3）：
<div class="timeline">
<div class="timeline-item">
<div class="timeline-content">
<h4>2023</h4>
<p>项目启动</p>
</div>
</div>
<div class="timeline-item">
<div class="timeline-content">
<h4>2024</h4>
<p>上线交付</p>
</div>
</div>
</div>
CSS 动画准备（加在 或单独 CSS 文件中）：
.timeline-item {
opacity: 0;
transform: translateY(20px);
transition: opacity 0.6s ease-out, transform 0.6s ease-out;
}
.timeline-item.visible {
opacity: 1;
transform: translateY(0);
}
JS 触发逻辑（放在页面底部或 DOMContentLoaded 里）：
const observer = new IntersectionObserver((entries) => {
entries.forEach(entry => {
if (entry.isIntersecting) {
entry.target.classList.add('visible');
// 可选：触发后停止监听，避免重复执行
observer.unobserve(entry.target);
}
});
}, { threshold: 0.1 });
document.querySelectorAll('.timeline-item').forEach(el => observer.observe(el));
用 border-start + position-relative 快速搭时间轴骨架
Bootstrap 5.3 提供了 border-start 工具类，比手动写伪元素更可靠，且支持响应式断点（如 border-start-md）。
- 给外层容器加
position-relative，方便内部圆点绝对定位 - 每个
.timeline-item用border-start border-primary画竖线 - 用
ps-4（padding-start）留出内容空间，避免文字贴边 - 圆点用
position-absolute top-0 start-0 translate-middle+bg-primary rounded-circle实现
注意：border-start 在 Safari 15.4 之前有渲染 bug，若需兼容老 Safari，建议降级为自定义 CSS 类或改用 before 伪元素。
容易被忽略的三个细节
动态时间轴不是“加个动画就完事”，以下三点常导致效果卡顿、错位或失效：
- 没设
timeline-item的margin-bottom，导致竖线连成一片——加mb-5或自定义间距 - 动画 class（如
.visible）未加!important，被 Bootstrap 的transition工具类覆盖——检查 computed styles 中transition是否生效 - 在 SSR（如 Next.js）或静态生成页面中，
IntersectionObserver初始化太早，DOM 还没挂载——确保 JS 在useEffect(() => {}, [])或$(document).ready()后运行
真正让时间轴“动起来”的，从来不是框架本身，而是你对 IntersectionObserver 的调用时机、CSS transition 的属性选择，以及对 Bootstrap 工具类边界条件的验证。别指望一键组件，盯住那几行 JS 和两个 class 就够了。
