logo

G2

  • 文档
  • 图表介绍
  • API
  • 图表示例
  • 主题
  • 周边生态
  • 所有产品antv logo arrow
  • 5.3.3
  • 快速上手
  • 简介
    • 什么是 G2
    • 在前端框架中使用
    • Spec 和 API
  • 核心概念
    • 图表(Chart)
      • G2 图表组成
      • 如何使用图表
    • 标记(Mark)
      • 概览
      • area
      • box
      • boxplot
      • cell
      • chord
      • density
      • gauge
      • heatmap
      • image
      • interval
      • line
      • lineX
      • lineY
      • link
      • liquid
      • sunburst
      • point
      • polygon
      • range
      • rangeX
      • rangeY
      • rect
      • shape
      • text
      • vector
      • wordCloud
    • 视图(View)
    • 数据(Data)
      • 概览
      • custom
      • ema
      • fetch
      • filter
      • fold
      • inline
      • join
      • kde
      • log
      • map
      • pick
      • rename
      • slice
      • sort
      • sortBy
    • 编码(Encode)
    • 比例尺(Scale)
      • 概览
      • band
      • linear
      • log
      • ordinal
      • point
      • quantile
      • quantize
      • sqrt
      • threshold
      • time
      • pow
    • 转换(Transform)
      • 概览
      • bin
      • binX
      • diffY
      • dodgeX
      • flexX
      • group
      • groupColor
      • groupX
      • groupY
      • jitter
      • jitterX
      • jitterY
      • normalizeY
      • pack
      • sample
      • select
      • selectX
      • selectY
      • sortColor
      • sortX
      • sortY
      • stackEnter
      • stackY
      • symmetryY
    • 坐标系(Coordinate)
      • 概览
      • fisheye
      • parallel
      • polar
      • theta
      • transpose
      • radial
      • cartesian3D
      • helix
    • 样式(Style)
    • 动画(Animate)
      • 概览
      • fadeIn
      • fadeOut
      • growInX
      • growInY
      • morphing
      • pathIn
      • scaleInX
      • scaleInY
      • scaleOutX
      • scaleOutY
      • waveIn
      • zoomIn
      • zoomOut
    • 状态(State)
    • 交互(Interaction)
      • 概览
      • brushAxisHighlight
      • brushHighlight
      • brushXHighlight
      • brushYHighlight
      • brushFilter
      • brushXFilter
      • brushYFilter
      • chartIndex
      • elementHighlight
      • elementHighlightByColor
      • elementHighlightByX
      • elementSelect
      • elementSelectByColor
      • elementSelectByX
      • fisheye
      • legendFilter
      • legendHighlight
      • poptip
      • scrollbarFilter
      • sliderFilter
    • 复合(Composition)
      • 概览
      • facetCircle
      • facetRect
      • repeatMatrix
      • spaceFlex
      • spaceLayer
      • timingKeyframe
    • 主题(Theme)
      • 概览
      • academy
      • classic
      • classicDark
    • 事件(Event)
    • 颜色映射(Color)
  • 图表 API
  • 图表组件
    • 标题(Title)
    • 坐标轴(Axis)
    • 图例(Legend)
    • 滚动条(Scrollbar)
    • 缩略轴(Slider)
    • 提示信息(Tooltip)
    • 数据标签(Label)
  • 进阶主题
    • 关系图(Graph)
      • forceGraph
      • pack
      • sankey
      • tree
      • treemap
    • 地图(Geo)
      • geoPath
      • geoView
    • 3D 图表(3D Chart)
      • 绘制 3D 图表
      • point3D
      • line3D
      • interval3D
      • surface3D
    • 插件扩展(Plugin)
      • renderer
      • rough
      • lottie
      • a11y
    • 按需打包
    • 设置纹理
    • 服务端渲染(SSR)
    • Spec 函数表达式支持 (5.3.0 支持)
  • 版本特性
    • 新版本特性
    • v4 升级 v5 指南
  • 常见问题 FAQ

视图(View)

上一篇
wordCloud
下一篇
概览

Resources

Ant Design
Galacea Effects
Umi-React 应用开发框架
Dumi-组件/文档研发工具
ahooks-React Hooks 库

社区

体验科技专栏
seeconfSEE Conf-蚂蚁体验科技大会

帮助

GitHub
StackOverflow

more products更多产品

Ant DesignAnt Design-企业级 UI 设计语言
yuque语雀-知识创作与分享工具
EggEgg-企业级 Node 开发框架
kitchenKitchen-Sketch 工具集
GalaceanGalacean-互动图形解决方案
xtech蚂蚁体验科技
© Copyright 2025 Ant Group Co., Ltd..备案号:京ICP备15032932号-38

Loading...

概述

在 G2 中,视图(View) 是图表的核心组成单元,用于承载和组织多个标记(Mark),并统一管理数据、坐标系、交互、样式等。每个视图拥有独立的数据、坐标系和交互配置,是应用交互和样式的最小单位。通过合理拆分视图,可以实现多图层、分面、嵌套等复杂可视化布局。

视图不仅支持灵活的数据和编码配置,还能继承和覆盖父级(如复合视图、分面等)传递的配置,实现灵活的组合与复用。


适用场景

  • 单一图表(如柱状图、折线图等)的基础绘制
  • 多图层叠加(如柱状图+折线图、点图+热力图等)
  • 分面(Facet)、小 multiples、仪表盘等复合布局
  • 局部交互、局部样式、局部数据的独立管理
  • 主题、动画、状态等高级特性分区应用

配置项

视图支持丰富的配置项,涵盖数据、编码、坐标、样式、交互等各个方面。其配置项与顶层 Chart 基本一致,常用如下:

配置项说明类型作用范围/继承关系
data数据源array/objectview 及其所有 children
encode数据到视觉通道的映射objectview 及其所有 children
scale视觉通道的比例尺object可继承/覆盖(view/mark)
transform数据变换array可继承/覆盖(view/mark)
coordinate坐标系配置object可继承/覆盖(view/mark)
style视图区域样式object仅本 view
axis坐标轴配置object可继承/覆盖(view/mark)
legend图例配置object可继承/覆盖(view/mark)
tooltip提示框配置object仅本 view
interaction交互配置object可继承/覆盖(view/mark)
theme主题配置object可继承/覆盖
children子标记(marks)或视图array仅本 view

说明:

  • data、encode、scale、axis、legend、transform、coordinate、interaction 等配置在 view 层级设置后,会自动作用于所有 children(mark),mark 层级也可单独覆盖。
  • 其他如 style、tooltip 仅作用于当前 view。 完整配置示例:
({
type: 'view',
data: [
{ type: 'A', value: 30 },
{ type: 'B', value: 50 },
{ type: 'C', value: 20 },
],
encode: { x: 'type', y: 'value' },
scale: { y: { nice: true } },
coordinate: { type: 'rect' },
style: { viewFill: '#f5f5f5' },
axis: { y: { grid: true } },
legend: { color: { position: 'top' } },
tooltip: {
title: { field: 'type' },
items: [{ field: 'value' }],
},
interaction: { elementHighlight: true },
theme: { color: ['#5B8FF9', '#5AD8A6', '#5D7092'] },
children: [
{ type: 'interval' },
{ type: 'line', style: { stroke: '#faad14' } },
],
});

配置方式

1. 配置式声明

直接在 options 中声明视图及其子元素:

({
type: 'view',
data: [...],
encode: {...},
children: [
{ type: 'interval', encode: {...} },
{ type: 'line', encode: {...} },
],
});

2. API 链式调用

通过 API 创建视图并添加标记:

const chart = new G2.Chart();
const view = chart.view({ data: [...] });
view.interval().encode('x', 'type').encode('y', 'value');
view.line().encode('x', 'type').encode('y', 'value');
chart.render();

3. 复合视图与分面

视图可作为复合节点(如分面、空间布局)的子节点:

const facet = chart.facetRect();
facet.view().interval().encode('x', 'type').encode('y', 'value');
facet.view().line().encode('x', 'type').encode('y', 'value');

视图与样式

视图支持设置自身区域的样式(如背景色、边框等),并可对子标记进行统一样式管理。详见样式(Style)。

({
type: 'view',
style: {
viewFill: '#e6f7ff',
plotFill: '#fffbe6',
mainFill: '#fff',
contentFill: '#f0f5ff',
},
children: [{ type: 'interval', style: { fill: '#5B8FF9' } }],
});