# 通過 pip 安裝 Pyecharts
$ pip install pyecharts

# 安裝完成后可以通過以下命令檢查 Pyecharts 是否安裝成功
$ pip list

from pyecharts.charts import Bar

# v1 版本開始支持鏈?zhǔn)秸{(diào)用
bar = (
    Bar()
    .add_xaxis(['襯衫', '毛衣', '褲子'])
    .add_yaxis('商家A', [10, 20, 30])
    .add_yaxis('商家B', [30, 20, 10])
)

# render 會(huì)生成本地 html 文件，默認(rèn)當(dāng)前目錄，且文件名稱為 render.html
# 同樣也可以傳入?yún)?shù)，例如：bar.render('mycharts.html')
bar.render()

class TitleOpts(
    # 主標(biāo)題文本，支持使用 \n 換行。
    title: Optional[str] = None,

    # 主標(biāo)題跳轉(zhuǎn) URL 鏈接
    title_link: Optional[str] = None,

    # 主標(biāo)題跳轉(zhuǎn)鏈接方式
    # 默認(rèn)值是: blank
    # 可選參數(shù): 'self', 'blank'
    # 'self' 當(dāng)前窗口打開; 'blank' 新窗口打開
    title_target: Optional[str] = None,

    # 副標(biāo)題文本，支持使用 \n 換行。
    subtitle: Optional[str] = None,

    # 副標(biāo)題跳轉(zhuǎn) URL 鏈接
    subtitle_link: Optional[str] = None,

    # 副標(biāo)題跳轉(zhuǎn)鏈接方式
    # 默認(rèn)值是: blank
    # 可選參數(shù): 'self', 'blank'
    # 'self' 當(dāng)前窗口打開; 'blank' 新窗口打開
    subtitle_target: Optional[str] = None,

    # title 組件離容器左側(cè)的距離。
    # left 的值可以是像 20 這樣的具體像素值，可以是像 '20%' 這樣相對(duì)于容器高寬的百分比，
    # 也可以是 'left', 'center', 'right'。
    # 如果 left 的值為'left', 'center', 'right'，組件會(huì)根據(jù)相應(yīng)的位置自動(dòng)對(duì)齊。
    pos_left: Optional[str] = None,

    # title 組件離容器右側(cè)的距離。
    # right 的值可以是像 20 這樣的具體像素值，可以是像 '20%' 這樣相對(duì)于容器高寬的百分比。
    pos_right: Optional[str] = None,

    # title 組件離容器上側(cè)的距離。
    # top 的值可以是像 20 這樣的具體像素值，可以是像 '20%' 這樣相對(duì)于容器高寬的百分比，
    # 也可以是 'top', 'middle', 'bottom'。
    # 如果 top 的值為'top', 'middle', 'bottom'，組件會(huì)根據(jù)相應(yīng)的位置自動(dòng)對(duì)齊。
    pos_top: Optional[str] = None,

    # title 組件離容器下側(cè)的距離。
    # bottom 的值可以是像 20 這樣的具體像素值，可以是像 '20%' 這樣相對(duì)于容器高寬的百分比。
    pos_bottom: Optional[str] = None,

    # 標(biāo)題內(nèi)邊距，單位px，默認(rèn)各方向內(nèi)邊距為5，接受數(shù)組分別設(shè)定上右下左邊距。
    # // 設(shè)置內(nèi)邊距為 5
    # padding: 5
    # // 設(shè)置上下的內(nèi)邊距為 5，左右的內(nèi)邊距為 10
    # padding: [5, 10]
    # // 分別設(shè)置四個(gè)方向的內(nèi)邊距
    # padding: [
    #     5,  // 上
    #     10, // 右
    #     5,  // 下
    #     10, // 左
    # ]
    padding: Union[Sequence, Numeric] = 5,

    # 主副標(biāo)題之間的間距。
    item_gap: Numeric = 10,

    # 主標(biāo)題字體樣式配置項(xiàng)，參考 `series_options.TextStyleOpts`
    title_textstyle_opts: Union[TextStyleOpts, dict, None] = None,

    # 副標(biāo)題字體樣式配置項(xiàng)，參考 `series_options.TextStyleOpts`
    subtitle_textstyle_opts: Union[TextStyleOpts, dict, None] = None,
)

def set_global_opts(
    self,
    title_opts: types.Title = opts.TitleOpts(),
    legend_opts: types.Legend = opts.LegendOpts(),
    tooltip_opts: types.Tooltip = None,
    toolbox_opts: types.Toolbox = None,
    brush_opts: types.Brush = None,
    xaxis_opts: types.Axis = None,
    yaxis_opts: types.Axis = None,
    visualmap_opts: types.VisualMap = None,
    datazoom_opts: types.DataZoom = None,
    graphic_opts: types.Graphic = None,
    axispointer_opts: types.AxisPointer = None,
):

from pyecharts.charts import Bar
from pyecharts import options as opts

bar = (
    Bar()
    .add_xaxis(['襯衫', '毛衣', '褲子'])
    .add_yaxis('商家A', [10, 20, 30])
    .add_yaxis('商家B', [30, 20, 10])
    .set_global_opts(
        title_opts=opts.TitleOpts(
            title='This is title'
        )
    )
)

bar.render()

class ItemStyleOpts(
    # 圖形的顏色。
    # 顏色可以使用 RGB 表示，比如 'rgb(128, 128, 128)'，如果想要加上 alpha 通道表示不透明度，
    # 可以使用 RGBA，比如 'rgba(128, 128, 128, 0.5)'，也可以使用十六進(jìn)制格式，比如 '#ccc'。
    # 除了純色之外顏色也支持漸變色和紋理填充
    # 
    # 線性漸變，前四個(gè)參數(shù)分別是 x0, y0, x2, y2, 范圍從 0 - 1，相當(dāng)于在圖形包圍盒中的百分比，
    # 如果 globalCoord 為 `true`，則該四個(gè)值是絕對(duì)的像素位置
    # color: {
    #    type: 'linear',
    #    x: 0,
    #    y: 0,
    #    x2: 0,
    #    y2: 1,
    #    colorStops: [{
    #        offset: 0, color: 'red' // 0% 處的顏色
    #    }, {
    #        offset: 1, color: 'blue' // 100% 處的顏色
    #    }],
    #    global: false // 缺省為 false
    # }
    # 
    # 徑向漸變，前三個(gè)參數(shù)分別是圓心 x, y 和半徑，取值同線性漸變
    # color: {
    #    type: 'radial',
    #    x: 0.5,
    #    y: 0.5,
    #    r: 0.5,
    #    colorStops: [{
    #        offset: 0, color: 'red' // 0% 處的顏色
    #    }, {
    #        offset: 1, color: 'blue' // 100% 處的顏色
    #    }],
    #    global: false // 缺省為 false
    # }
    # 
    # 紋理填充
    # color: {
    #    image: imageDom, // 支持為 HTMLImageElement, HTMLCanvasElement，不支持路徑字符串
    #    repeat: 'repeat' // 是否平鋪, 可以是 'repeat-x', 'repeat-y', 'no-repeat'
    # }
    color: Optional[str] = None,

    # 陰線 圖形的顏色。
    color0: Optional[str] = None,

    # 圖形的描邊顏色。支持的顏色格式同 color，不支持回調(diào)函數(shù)。
    border_color: Optional[str] = None,

    # 陰線 圖形的描邊顏色。
    border_color0: Optional[str] = None,

    # 描邊寬度，默認(rèn)不描邊。
    border_width: Optional[Numeric] = None,

    # 支持 'dashed', 'dotted'。
    border_type: Optional[str] = None,

    # 圖形透明度。支持從 0 到 1 的數(shù)字，為 0 時(shí)不繪制該圖形。
    opacity: Optional[Numeric] = None,

    # 區(qū)域的顏色。    
    area_color: Optional[str] = None,
)

from pyecharts.charts import Bar
from pyecharts import options as opts

bar = (
    Bar()
    .add_xaxis(['襯衫', '毛衣', '褲子'])
    .add_yaxis('商家A', [10, 20, 30])
    .add_yaxis('商家B', [30, 20, 10])
    .set_series_opts(
        itemstyle_opts=opts.ItemStyleOpts(
            color='#0066FF'
        )
    )
)

bar.render()

from pyecharts.charts import Bar
from pyecharts import options as opts

bar = (
    Bar()
    .add_xaxis(['襯衫', '毛衣', '褲子'])
    .add_yaxis('商家A', [10, 20, 30], itemstyle_opts=opts.ItemStyleOpts(color='#5edd55'))
    .add_yaxis('商家B', [30, 20, 10], itemstyle_opts=opts.ItemStyleOpts(color='#33c0eb'))
)

bar.render()