Pyecharts全局配置项01---TitleOpts

Intro

  Pycharts分为 v0.5.X 和 v1 两个大版本,v0.5.X 和 v1 间不兼容,v1 是一个全新的版本。用法和v0.5差异较大,由此做些学习笔记。本文介绍标题相关的参数设置。

参数设置

class TitleOpts(
    # 主标题文本,支持使用 \n 换行。
    title: Optional[str] = None,

    # 主标题跳转 URL 链接
    title_link: Optional[str] = None,

    # 主标题跳转链接方式
    # 默认值是: blank
    # 可选参数: 'self', 'blank'
    # 'self' 当前窗口打开; 'blank' 新窗口打开
    title_target: Optional[str] = None,

    # 副标题文本,支持使用 \n 换行。
    subtitle: Optional[str] = None,

    # 副标题跳转 URL 链接
    subtitle_link: Optional[str] = None,

    # 副标题跳转链接方式
    # 默认值是: blank
    # 可选参数: 'self', 'blank'
    # 'self' 当前窗口打开; 'blank' 新窗口打开
    subtitle_target: Optional[str] = None,

    # title 组件离容器左侧的距离。
    # left 的值可以是像 20 这样的具体像素值,可以是像 '20%' 这样相对于容器高宽的百分比,
    # 也可以是 'left', 'center', 'right'。
    # 如果 left 的值为'left', 'center', 'right',组件会根据相应的位置自动对齐。
    pos_left: Optional[str] = None,

    # title 组件离容器右侧的距离。
    # right 的值可以是像 20 这样的具体像素值,可以是像 '20%' 这样相对于容器高宽的百分比。
    pos_right: Optional[str] = None,

    # title 组件离容器上侧的距离。
    # top 的值可以是像 20 这样的具体像素值,可以是像 '20%' 这样相对于容器高宽的百分比,
    # 也可以是 'top', 'middle', 'bottom'。
    # 如果 top 的值为'top', 'middle', 'bottom',组件会根据相应的位置自动对齐。
    pos_top: Optional[str] = None,

    # title 组件离容器下侧的距离。
    # bottom 的值可以是像 20 这样的具体像素值,可以是像 '20%' 这样相对于容器高宽的百分比。
    pos_bottom: Optional[str] = None,

    # 标题内边距,单位px,默认各方向内边距为5,接受数组分别设定上右下左边距。
    # // 设置内边距为 5
    # padding: 5
    # // 设置上下的内边距为 5,左右的内边距为 10
    # padding: [5, 10]
    # // 分别设置四个方向的内边距
    # padding: [
    #     5,  // 上
    #     10, // 右
    #     5,  // 下
    #     10, // 左
    # ]
    padding: Union[Sequence, Numeric] = 5,

    # 主副标题之间的间距。
    item_gap: Numeric = 10,

    # 主标题字体样式配置项,参考 `series_options.TextStyleOpts`
    title_textstyle_opts: Union[TextStyleOpts, dict, None] = None,

    # 副标题字体样式配置项,参考 `series_options.TextStyleOpts`
    subtitle_textstyle_opts: Union[TextStyleOpts, dict, None] = None,
)

标题参数主要有以下几个部分:

  • 文本参数,如主副标题名、主副标题跳转链接
  • 位置参数,如标签在图标中的位置、主副标题之间的位置
  • 文本字体样式参数
class TextStyleOpts(
    # 文字颜色。
    color: Optional[str] = None,

    # 文字字体的风格
    # 可选:'normal','italic','oblique'
    font_style: Optional[str] = None,

    # 主标题文字字体的粗细,可选:
    # 'normal','bold','bolder','lighter'
    font_weight: Optional[str] = None,

    # 文字的字体系列
    # 还可以是 'serif' , 'monospace', 'Arial', 'Courier New', 'Microsoft YaHei', ...
    font_family: Optional[str] = None,

    # 文字的字体大小
    font_size: Optional[Numeric] = None,

    # 文字水平对齐方式,默认自动
    align: Optional[str] = None,

    # 文字垂直对齐方式,默认自动
    vertical_align: Optional[str] = None,

    # 行高
    line_height: Optional[str] = None,

    # 文字块背景色。可以是直接的颜色值,例如:'#123234', 'red', 'rgba(0,23,11,0.3)'
    background_color: Optional[str] = None,

    # 文字块边框颜色
    border_color: Optional[str] = None,

    # 文字块边框宽度
    border_width: Optional[Numeric] = None,

    # 文字块的圆角
    border_radius: Union[Numeric, Sequence, None] = None,

    # 文字块的内边距 
    # 例如 padding: [3, 4, 5, 6]:表示 [上, 右, 下, 左] 的边距
    # 例如 padding: 4:表示 padding: [4, 4, 4, 4]
    # 例如 padding: [3, 4]:表示 padding: [3, 4, 3, 4]
    padding: Union[Numeric, Sequence, None] = None,

    # 文字块的背景阴影颜色
    shadow_color: Optional[str] = None,

    # 文字块的背景阴影长度
    shadow_blur: Optional[Numeric] = None,

    # 文字块的宽度
    width: Optional[str] = None,

    # 文字块的高度
    height: Optional[str] = None,

    # 在 rich 里面,可以自定义富文本样式。利用富文本样式,可以在标签中做出非常丰富的效果
    # 具体配置可以参考一下 https://www.echartsjs.com/tutorial.html#%E5%AF%8C%E6%96%87%E6%9C%AC%E6%A0%87%E7%AD%BE
    rich: Optional[dict] = None,
)

Demo

x = list(range(0, 10))
y1 = [i * 2 + 1 for i in list(range(0, 10))]
y2 = [i * 3 + 2 for i in list(range(0, 10))]
from pyecharts.charts import Line
from pyecharts import options as opts
line1 = (
    Line()
    .add_xaxis(xaxis_data=x)
    .add_yaxis("y1", y1)
    .add_yaxis("y2", y2)  
    .set_global_opts(
        title_opts=opts.TitleOpts(title="Practice makes perfect"  # 主标题文本
                                  ,title_link="www.baidu.com"     # 主标题跳转链接,似乎不可用
                                  ,pos_right="center"             # 标题位置
                                  ,subtitle="subtitle,2020.02.15" # 副标题文本   
                                  ,item_gap=5                     # 主副标题间隔
                                  ,title_textstyle_opts=opts.TextStyleOpts(color="blue"         # 主标题颜色
                                                                           ,font_weight="bold"  # 字体加粗"
                                                                          )
                                              ) # 设置标题

                    ,xaxis_opts =opts.AxisOpts(name="Date")
                    ,yaxis_opts =opts.AxisOpts(name="Rate")
                    ,legend_opts=opts.LegendOpts(pos_right="10%",pos_top="20%",orient="vertical")
                    )
)
line1.render_notebook()
#line1.render()

Pyecharts全局配置项01---TitleOpts

标题参数相对较少,常用的也就是标题的位置和标题的样式(颜色、字体等),上面的demo涉及了部分参数,其余可以文档中自查。

Ref

[1] 标题配置项文档
[2] 字体配置项文档

                                2020-02-15 于南京市栖霞区

上一篇:js 实现 java 函数重载


下一篇:深圳市蛋壳公寓租房数据分析