.tooltip-inner { max-width: 300px } 无效是因为 Tooltip DOM 被 Popper 动态挂载到 ,脱离上下文,受 Bootstrap 原生样式覆盖、加载顺序影响及全局样式干扰;最可靠方案是用 template 注入自定义 class 并配对设置 word-break: break-word 和 overflow-wrap: break-word,同时必须启用 html: true。

直接给 .tooltip-inner 写 max-width 通常无效——不是 CSS 没生效,而是 Tooltip 的 DOM 被 Popper 动态挂载到 底部,脱离原始上下文,容易被 Bootstrap 原生样式覆盖或受父容器干扰。
为什么 .tooltip-inner { max-width: 300px } 不起作用
常见现象是:样式在 DevTools 里显示为 strikethrough(被划掉),悬停后提示框依然窄长、内容挤成一行甚至横向溢出。根本原因有三个:
- 你的 CSS 文件加载顺序在
bootstrap.min.css之前,权重被原生规则压住 - 没加
!important且选择器不够具体(比如只写.tooltip-inner,而 Bootstrap 用的是.tooltip .tooltip-inner) - Tooltip 实际渲染时挂载在
,但某些全局样式(如body * { max-width: 100% })意外传导下来,限制了宽度计算
用 template 注入自定义 class 最可靠
这是唯一能绕过权重冲突、精准控制单个 Tooltip 宽度的方式。你保留 Bootstrap 必需的 class,只在外层加自己的命名空间:
const tooltip = new bootstrap.Tooltip(el, {
template: `
<div class="tooltip my-tooltip-wide" role="tooltip">
<div class="tooltip-arrow"></div>
<div class="tooltip-inner"></div>
</div>
`,
html: true
});
然后在 CSS 中(确保在 Bootstrap 之后加载)写:
立即学习“前端免费学习笔记(深入)”;
.my-tooltip-wide .tooltip-inner {
max-width: 320px;
word-break: break-word;
overflow-wrap: break-word;
}
-
word-break: break-word和overflow-wrap: break-word必须配对使用,否则长无空格字符串(如 UUID、base64)仍不换行 - 不要只依赖
white-space: normal,它对中英文混排和数字串效果不稳定 - 如果加了边框或 padding,记得同步调整
.tooltip-arrow的margin-top,否则箭头会错位
别漏掉 html: true 这个开关
这个配置项决定你写的 template 是否被当作 HTML 解析。如果设为 false(默认值),整个 template 字符串会被当作文本插入,style 属性、class 名都失效,max-width 自然也不起作用。
- 必须显式传
html: true,哪怕你没在 template 里写内联样式 - 如果用 data 属性初始化(如
data-bs-html="true"),也要确认它和 JS 初始化不冲突 - 在 Vue/React 等框架中,若 Tooltip 是动态挂载的,需确保
html: true在组件 mounted 或 useEffect 里正确传入
真正卡住宽度的往往不是 max-width 本身,而是内容区域的换行策略和 template 的解析开关——这两个点一错,再大的数值也撑不开。


















