直接跳到内容
本页目录

HTML 文本

PnHTML 组件允许在面板中渲染任意 HTML。它可以渲染包含有效 HTML 的字符串以及具有 _repr_html_ 方法的对象,还可以定义自定义 CSS 样式。

底层实现为panel.pane.HTML,参数基本一致,参考文档:https://panel.holoviz.org/reference/panes/HTML.html

基本用法

PnHTML 组件接受整个 HTML5 规范,包括任何嵌入的脚本标签(这些标签将被执行)。它还支持 styles 字典来控制渲染 HTML 内容的 <div> 标签的样式。

要更新 objectstyles,我们可以直接设置它:

HTML 文档

PnHTML 组件设计用于显示基本 HTML 内容。它不适合渲染包含 JavaScript 或其他动态元素的完整 HTML 文档。

要显示完整的 HTML 文档,您可以转义 HTML 内容并将其嵌入在 iframe 中。以下是实现方式:

这种方法确保嵌入的 HTML 安全地隔离在 iframe 中,防止任何脚本直接在 Panel 环境中执行。这种方法特别适用于嵌入需要自己独立 HTML 结构的丰富内容,如交互式可视化。

API

属性

属性名说明类型默认值
object要显示的字符串或具有 _repr_html_ 方法的对象str, object None
disable_math是否禁用使用 $$ 分隔符转义的字符串的 MathJax 数学渲染boolean True
enable_streaming是否启用文本片段的流式传输。这将在更新时对 object 进行差异比较,只发送添加的尾部块boolean False
sanitize_html是否对发送到前端的 HTML 进行净化boolean False
sanitize_hook如果 sanitize_html=True,应用的净化回调Callable bleach.clean
styles指定 CSS 样式的字典dict {}
style指定 CSS 样式 ''
sizing_mode尺寸调整模式str 'fixed'
width宽度int, str None
height高度int, str None
min_width最小宽度int None
min_height最小高度int None
max_width最大宽度int None
max_height最大高度int None
margin外边距int, tuple 5
css_classesCSS类名列表list []

Slots

插槽名说明
default自定义默认内容

Controls

src/examples/panel_vuepy/panes/HTML

HTML 文本已经加载完毕