双轴图 chart-biaxial

2026年7月20日大约 3 分钟

双轴图 `chart-biaxial`

一个类目轴 + 左右两个数值轴（柱 + 线），用于「量 + 率」同图。

类型串：chart-biaxial　默认尺寸：[460, 320]　分类：图表与表格

实时预览

下面渲染的是真实组件（与编辑器 / 运行时同源）。修改右侧「样式参数」，左侧预览实时更新；点击底部「全页面查看」可放大。

属性

下表为本组件特有的属性；position / size / opacity / background / border / 联动选中 / 筛选等通用参数见组件手册总览。

chart

属性	名称	类型	默认
`title`	标题	`string`	`双轴图`
`title-show`	显示标题	`boolean`	`true`
`title-color`	标题颜色	`color`	`#ffffff`
`show-label`	显示数值	`boolean`	`false`
`show-legend`	显示图例	`boolean`	`true`

bar

属性	名称	类型	默认
`bar-color`	柱颜色	`color`	`#3aa1ff`
`bar-width`	柱宽	`number(unit=px,min=0)`	`18`
`bar-radius`	圆角	`number(unit=px,min=0)`	`2`
`bar-stack`	堆叠	`boolean`	`false`
`left-axis-name`	左轴名称	`string`	—

line

属性	名称	类型	默认
`line-color`	折线颜色	`color`	`#f7b500`
`line-width`	折线宽度	`number(unit=px,min=0)`	`2`
`smooth`	平滑曲线	`boolean`	`true`
`show-symbol`	显示数据点	`boolean`	`true`
`symbol-size`	数据点大小	`number(unit=px,min=0)`	`5`
`right-axis-name`	右轴名称	`string`	—

axis

属性	名称	类型	默认
`chart-axis-color`	轴线颜色	`color`	`#3a4252`
`chart-axis-label-color`	文字颜色	`color`	`#9aa4b2`
`split-line`	显示分割线	`boolean`	`true`

static

属性	名称	类型	默认
`categories`	类目	`string`	`示例1,示例2,示例3,示例4,示例5`
`bar-name`	柱系列名	`string`	`值1`
`bar-values`	柱数值	`string`	`1048,735,580,1005,700`
`line-name`	折线系列名	`string`	`值3`
`line-values`	折线数值	`string`	`250,600,450,300,360`

数据绑定

字段槽	类型 / 约束	说明
`category-field`	`field(recommend=string,min=1,max=1)`	类目轴
`metric-fields`	`field(recommend=number,min=0)`	柱状（左轴）
`line-metric-fields`	`field(recommend=number,min=0)`	折线（右轴）

事件

触发器

触发器在预览 / 播放态生效（编辑态点击 = 选中组件）。写在本组件 options.interactions 的 groups[].trigger 里。

触发器	名称	触发时机	payload（供动作公式 `{:字段}` 取值）
`itemClicked`	点击某项	点击图表某个数据项时触发	该项类目维度，如 `{城市:"北京"}`（仅类目，不含数值）
`click`	点击	点击本组件时触发	无
`mouseEnter`	鼠标移入	指针移入组件时触发	无
`mouseLeave`	鼠标移出	指针移出组件时触发	无
`appear`	入场	组件出现时触发（配合进场动画）	无
`disappear`	离场	组件消失时触发（配合退场动画）	无
`receiveBehaviorEvent`	接收行为事件	收到 `sendBehaviorEvent` 动作或宿主 `ctx.emit` 投递的事件时触发（按 `eventName` 匹配）	发送方携带的 data

动作

触发器命中后执行的动作。本组件既可发起动作（配在自己的交互里），也可作为其它组件动作的目标。

动作	名称	说明
`changeOption`	修改设置	把本组件（或其它组件）的某个属性改为静态值 / 公式动态值
`switchState`	切换状态	切到多状态里的某个状态（`state:""` 回默认态）
`appear / disappear`	进 / 退场动画	对目标 `opacity` 做 0↔100 插值的显隐动画

完整动作清单（switchScreen / switchWindow / openUrl / sendBehaviorEvent / transfer / executeScript / requestApi 等）与持久化写法见事件交互。

示例

{
  "type": "chart-biaxial",
  "uid": "w_chart_biaxial",
  "options": {
    "position": [40, 40],
    "size": [460, 320],
    "category-field": [["conn_demo", "tbl_demo", "字段名"]],
    "metric-fields": [["conn_demo", "tbl_demo", "字段名"]],
    "line-metric-fields": [["conn_demo", "tbl_demo", "字段名"]]
  }
}

绑定三元组 [连接uid, 表uid, 字段uid] 指向工程 connections 里的真实字段，见数据系统。

延伸阅读：组件手册总览 · 数据系统 · 事件交互。