width与height仅在pdf尺寸设为「自定义」时生效,单位为px,不支持百分比;需配合「适合宽度」「适合页面」等视图模式才能实现内容适配,而非仅靠调整窗口尺寸。

PDF预览组件的 WIDTH 与 HEIGHT 属性生效前提
这两个属性只在 pdf 尺寸 设置为「自定义」时才起作用;选「小」「中」「大」等预设尺寸时,WIDTH 和 HEIGHT 会被忽略,组件强制使用对应固定像素值(如「中」= 600 * 500px)。
常见错误是改了 WIDTH 却没切到「自定义」模式,结果页面尺寸毫无变化。
- 必须先在属性面板将
pdf 尺寸下拉选项设为「自定义」 -
WIDTH和HEIGHT的单位是像素(px),不支持百分比或auto - 若值过小(如
WIDTH: 100),可能触发内部最小宽高保护逻辑,实际渲染仍高于设定值
设置后页面被裁剪或留白过多怎么办
预览窗口大小 ≠ PDF 页面内容的实际显示比例。即使 WIDTH 和 HEIGHT 设得很大,PDF 默认仍按「实际大小」缩放,导致内容只占左上角一小块,其余是空白;反之设得太小又会裁掉边缘。
真正控制内容填充效果的是视图模式,不是窗口尺寸:
- 「适合宽度」:PDF 页面水平方向拉满整个
WIDTH,高度自适应(可能溢出HEIGHT) - 「适合页面」:整个 PDF 页面等比缩放后居中放入
WIDTH × HEIGHT区域,可能上下/左右留白 - 「实际大小」:无视
WIDTH/HEIGHT,强制以 100% 像素比渲染,超出部分需滚动查看
所以,调 WIDTH 和 HEIGHT 是为了框定容器,而调「适合宽度」这类选项才是让内容适配这个容器的关键。
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图,自动匹配视觉风格。触发场景:文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
动态修改 WIDTH 和 HEIGHT 的注意事项
某些低版本平台不支持运行时重设这两个属性——改了变量值,DOM 上的 style.width 和 style.height 没变,或者变了但 PDF 渲染器未重新布局。
- 推荐做法:用
key或ref强制组件卸载重挂(如 React 中给组件加key={width + 'x' + height}) - 避免直接操作 DOM 的
style,PDF 预览组件内部通常有 iframe 或 canvas 渲染层,外部样式无法穿透 - 如果配合响应式设计,记得监听
window.resize后重新计算并触发 key 更新,而不是仅改 state
为什么设了 WIDTH=800,实际 DOM 宽度却是 824px?
这是组件内边距(padding)、边框(border)或外层包裹容器的 margin 导致的视觉误差。PDF 预览组件通常自带基础样式,例如左右各 12px 间距,或顶部工具栏固定占用 48px 高度。
调试建议:
- 用浏览器开发者工具检查该组件最外层元素的 computed styles,看是否有额外 padding/border
- 确认
WIDTH控制的是渲染区域(canvas 或 iframe)还是外层 div 容器 - 某些平台把
WIDTH解释为「内容区宽度」,而总宽度 =WIDTH + 左右 padding + border
真正需要像素级精准时,别只信配置项,一定要 inspect 元素看最终 layout。










