python柱状图类VisualMapOpts方法说明

# 这是一个类，继承了 `BasicOpts` 类
class VisualMapOpts(BasicOpts):
    # 初始化函数，定义了一些参数及其默认值。其中包括 range_color、range_size、和 range_opacity 等参数
    def __init__(
        self,
        is_show: bool = True,  # 是否显示视觉映射组件，默认为 True
        type_: str = "color",  # 视觉映射的类型，可选值为 "color" 或 "size"，默认为 "color"
        min_: Numeric = 0,  # 传入数据的最小值，默认为 0
        max_: Numeric = 100,  # 传入数据的最大值，默认为 100
        range_text: Optional[Sequence] = None,  # 区间文字，可以是列表或元组，例如 ["low", "high"]，默认为空
        range_color: Optional[Sequence[str]] = None,  # 区间颜色，可以是列表或元组，例如 ["#50a3ba", "#eac763", "#d94e5d"]，默认为空
        range_size: Optional[Sequence[int]] = None,  # 区间大小，可以是列表或元组，例如 [20, 50]，默认为空
        range_opacity: Union[Numeric, Sequence[Numeric]] = None,  # 区间透明度，可以是数字或列表或元组，例如 [0.3, 1]，默认为空
        orient: str = "vertical",  # 组件方向，可选值为 "horizontal" 或 "vertical"，默认为 "vertical"
        pos_left: Optional[str] = None,  # 组件的左侧距离，例如 "20%"，默认为空
        pos_right: Optional[str] = None,  # 组件的右侧距离，例如 "20%"，默认为空
        pos_top: Optional[str] = None,  # 组件的顶部距离，例如 "20%"，默认为空
        pos_bottom: Optional[str] = None,  # 组件的底部距离，例如 "20%"，默认为空
        padding: Union[int, Sequence[int]] = 5,  # 内部间距，默认为 5
        split_number: int = 5,  # 分割段数，默认为 5
        series_index: Union[Numeric, Sequence, None] = None,  # 控制只对某些系列进行映射，默认为空
        is_hover_link: bool = True,  # 鼠标悬停时是否启用联动高亮效果，默认为 True
        dimension: Optional[Numeric] = None,  # 指定 data 中哪个维度的数据用来映射，例如 0 或 "x"，默认为空
        is_calculable: bool = True,  # 是否显示拖拽用的手柄（手柄可以用来调整选中范围），默认为 True
        is_piecewise: bool = False,  # 是否分段显示，默认为 False
        is_inverse: bool = False,  # 是否反转组件，默认为 False
        precision: Optional[int] = None,  # 数据的小数精度，例如 0 或 1，默认为空
        pieces: Optional[Sequence] = None,  # 分段信息，可以是列表或元组（仅当 is_piecewise 为 True 时有效），例如 [(0, 30), (30, 60), (60, 90)]，默认为空
        out_of_range: Optional[Sequence] = None,  # 未在映射范围内的数据颜色，例如 "#999"，默认为空
        item_width: int = 0,  # 分段控件单元的宽度（仅当 is_piecewise 为 True 且未指定宽度时有效），默认为 0
        item_height: int = 0,  # 分段控件单元的高度（仅当 is_piecewise 为 True 且未指定高度时有效），默认为 0
        background_color: Optional[str] = None,  # 组件背景颜色，默认为空
        border_color: Optional[str] = None,  # 组件边框颜色，默认为空
        border_width: int = 0,  # 组件边框宽度，默认为 0
        textstyle_opts: Union[TextStyleOpts, dict, None] = None,  # 文本样式设置，可为 TextStyleOpts 对象、字典或空值，默认为空
    ):
        # 初始化内部区间操作，并根据视觉映射类型设置不同的区间操作
        _inrange_op: dict = {}
        if type_ == "color":
            range_color = range_color or ["#50a3ba", "#eac763", "#d94e5d"]
            _inrange_op.update(color=range_color)
        elif type_ == "size":
            range_size = range_size or [20, 50]
            _inrange_op.update(symbolSize=range_size)
        if range_opacity is not None:
            _inrange_op.update(opacity=range_opacity)

        # 根据是否分段显示设置视觉映射类型
        _visual_typ = "piecewise" if is_piecewise else "continuous"

        # 根据是否分段显示及宽高未指定设置默认宽高
        if is_piecewise and item_width == 0 and item_height == 0:
            item_width, item_height = 20, 14
        elif item_width == 0 and item_height == 0:
            item_width, item_height = 20, 140

        # 存储参数到 opts 字典中
        self.opts: dict = {
            "show": is_show,
            "type": _visual_typ,
            "min": min_,
            "max": max_,
            "text": range_text,
            "textStyle": textstyle_opts,
            "inRange": _inrange_op,
            "calculable": is_calculable,
            "inverse": is_inverse,
            "precision": precision,
            "splitNumber": split_number,
            "dimension": dimension,
            "seriesIndex": series_index,
            "hoverLink": is_hover_link,
            "orient": orient,
            "left": pos_left,
            "top": pos_top,
            "bottom": pos_bottom,
            "right": pos_right,
            "padding": padding,
            "showLabel": True,
            "itemWidth": item_width,
            "itemHeight": item_height,
            "outOfRange": out_of_range,
            "backgroundColor": background_color,
            "borderColor": border_color,
            "borderWidth": border_width,
        }

        # 如果分段显示，则增加 pieces 参数
        if is_piecewise:
            self.opts.update(pieces=pieces)