pyecharts源码解读（16）图表类包charts之组合图表： 顺序多图Page

当前pyecharts的版本为1.9.0。

概述

pyecharts/charts/composite_charts/包中的四个模块分别定义了组合图表类，其中pyecharts/charts/composite_charts/page.py模块只定义了顺序类Page。

Page类继承自图表基类CompositeMixin，作用为在一个容器中顺序显示多个图表。输出的HTML结构如下：

Page类的签名为class Page(page_title: str = "Awesome-pyecharts", js_host: str = "", interval: int = 1, layout: Union[PageLayoutOpts, dict] = PageLayoutOpts())。

Page类的构造方法参数如下：

• js_host：JavaScript库的URL。字符串，默认值为""。
• page_title：HTML页面标题。字符串，默认值为"Awesome-pyecharts"。
• interval：图表间隔（<br>标签个数）。整数，默认值为1。
• layout：布局配置。PageLayoutOpts对象或字典，默认值为PageLayoutOpts()。Page类支持三种布局模式：默认布局、SimplePageLayout布局、DraggablePageLayout布局。

Page类的类变量如下：

• SimplePageLayout：简单布局模式。值为 PageLayoutOpts( justify_content="center", display="flex", flex_wrap="wrap")。
• DraggablePageLayout ：可拖拽模式。值为PageLayoutOpts()。

Page类的属性如下：

• js_host：JavaScript库的URL。字符串，默认值为全局变量CurrentConfig.ONLINE_HOST。属性值为构造方法参数js_host与全局变量CurrentConfig.ONLINE_HOST进行或操作的结果。
• page_title：HTML页面标题。字符串，默认值为全局变量CurrentConfig.PAGE_TITLE。
• page_interval：每个图表之间的间隔。值为构造方法参数interval值。整数。即在HTML文档中插入的<br/>标签个数。
• layout ：布局配置字符串。
• download_button：是否显示下载按钮。布尔值。默认值为False。
• js_functions：自定义JavaScript语句。类型为OrderedSet对象。默认值为OrderedSet()。
• js_dependencies：定义JavaScript依赖库。类型为OrderedSet对象。默认值为OrderedSet("echarts")。
• _charts：容器中图表实例列表。类型为列表。默认值为[]。

Page类的方法如下：

• add(*chart)：将图表类实例添加页面中。方法可接收任意个图表类实例。
• render：调用render包engine模块中的render函数渲染HTML文档。默认渲染模板为"simple_page.html"。
• render_embed：调用render包engine模块中的render_embed函数输出HTML字符串。默认渲染模板为"simple_page.html"。
• render_notebook：调用render包engine模块中的render_notebook函数将输出嵌入到notebook中。默认渲染模板为 "nb_jupyter_notebook_page.html"或"nb_jupyter_lab_page.html"。

简易选项卡Page案例

from pyecharts.charts import Line, Page

a = ["衬衫", "羊毛衫", "雪纺衫", "裤子", "高跟鞋", "袜子"]
b1 = [5, 20, 36, 10, 75, 90]
b2 = [7, 25, 31, 14, 65, 100]

line1 = Line()
line1.add_xaxis(a)
line1.add_yaxis("", b1)

line2 = Line()
line2.add_xaxis(a)
line2.add_yaxis("", b2)

page = Page()
page.add(line1,line2)
page.render()