常见问题

产品 / 插件
平台 / 框架

如何处理白板显示不完整或留白的问题?

产品 / 插件:超级白板

平台 / 框架:全平台

更新时间:2021-09-26 11:28


问题描述

  1. 创建一个纯白板,渲染后出现白板超过父容器尺寸的现象。
  2. 创建一个文件白板,渲染后出现白板没有正好铺满父容器,而是上下留白、左右留白或者居中的现象。
  3. 多页文件白板(PDF、Office 等)在滚动时会短暂出现部分区域留白。

问题原因

  1. 对于纯白板,如果需要挂载的父容器宽高比例与创建该白板时传入的单页的宽度与高度的比例不相同,就会出现渲染后的实际大小超过父容器尺寸的现象。

  2. 对于文件白板,渲染策略与普通白板不同,且不同的文件类型也有差异:

    • 尺寸小于等于 640 * 400 的图片,会等比放大到 640 * 400 后居中显示。

    • 静态 PPT、动态 PPT 以及自定义 H5 文件都是按照文件的原始尺寸等比缩放显示,确保文件可完整显示。

    • 其他文件等比缩放至自身宽度与父容器宽度一致。

      如果文件单页比例与需要挂载的父容器宽高比例不一致,就可能出现周边留白的现象。 需要注意的是,当 PDF 文件满足以下条件时,超级白板 SDK 会将其视为 PPT 转成的 PDF,适用 PPT 的渲染策略: PDF 每一页的宽高比例相同,且 ‘614 / 1280 <= 高/宽 <= 1’。

  3. 超级白板 SDK 内部对文件内容的每一页的加载方式是懒加载的模式,在网速较慢的情况下,会出现短时间的空白,表示当前文件内容还未渲染完成。

解决方案

以 web 平台为例

  1. 对于问题描述中的 1,请确保创建白板时传入的宽度与高度的比例和要挂载的父容器宽高比一致。
  2. 对于问题描述中的 2,请按照实际情况修改父容器的尺寸,使其与要展示的文件页等比例。
  3. 对于问题描述中的 3,非功能问题,无需解决。

相关链接

创建超级白板

本篇目录
下载 PDF