AntV
AntV Infographic
文档
参考
示例
AI
企业版

目录

  • Overview
  • 一维数据/列表数据
  • 层级数据
  • 快速开始
    • 入门指南
    • 信息图语法
  • 核心概念
    • 设计
    • 模版
    • 数据
    • 主题
    • 资源
  • 自定义设计
    • 自定义结构
    • 自定义数据项
    • 自定义模版
    • 自定义主题
    • 自定义色板
    • 自定义字体
    • 自定义资源加载器
    • 自定义图案
  • 信息图理论
    • 信息图分类
    • 核心理论
    • 信息图构成要素
    • 信息图设计
  • 参与贡献
    • 项目介绍
    • 开源计划
    • 贡献指南
    • 代码规范
    • 提交 PR
文档
核心概念

数据

AntV Infographic 设计了一种灵活且易用的数据配置方式,它能够简单的表达一维数据和层级数据,并支持一定程度的扩展性。后续我们会完善对于关系数据等复杂数据结构的支持。

以下为数据的类型定义:

export interface Data { title?: string; desc?: string; items: ItemDatum[]; [key: string]: any; } export interface ItemDatum { icon?: string | ResourceConfig; label?: string; desc?: string; value?: number; illus?: string | ResourceConfig; children?: ItemDatum[]; [key: string]: any; }

其中 Data 包含标题、描述和数据项列表,并支持扩展其他字段。ItemDatum 列表支持配置图标、标题、描述、数值、插图和子项等字段,也支持扩展其他字段。完整的数据说明请查阅Data

一维数据/列表数据

下面是一个简单的一维数据示例:

new Infographic({ // 其他配置项... data: { title: '信息图标题', desc: '这是信息图的描述文本', items: [ { icon: 'https://example.com/icon1.svg', label: '数据项 1', desc: '这是数据项 1 的描述', }, { icon: 'https://example.com/icon2.svg', label: '数据项 2', desc: '这是数据项 2 的描述', }, ], }, });

层级数据

当需要表达层级结构数据时,可以通过 children 字段进行嵌套,例如:

new Infographic({ // 其他配置项... data: { title: '信息图标题', desc: '这是信息图的描述文本', items: [ { label: '一级数据项 1', children: [ { label: '二级数据项 1-1', }, { label: '二级数据项 1-2', }, ], }, { label: '一级数据项 2', children: [ { label: '二级数据项 2-1', }, ], }, ], }, });

Note

数据使用请注意以下事项:

  • 并非所有结构和数据项设计都会消费传入的全部数据字段,这取决于其具体实现,通常多余的字段不会有影响,但缺失数据字段可能会导致渲染效果异常。使用前请查阅具体的结构和数据项设计说明
  • 扩展字段需要在自定义结构或数据项中进行访问并映射到视觉元素
  • 数据中关于资源的使用请阅读资源
上一章模版
下一章主题

AntV Infographic
Copyright © Ant Group Co.
文档
快速开始
核心概念
自定义设计
信息图理论
API 参考
JSX
API
设计资产
更多
更多示例
AI 在线体验
GitHub
参与贡献
友情链接
AntV
G2
G6
L7
export interface Data {
title?: string;
desc?: string;
items: ItemDatum[];
[key: string]: any;
}

export interface ItemDatum {
icon?: string | ResourceConfig;
label?: string;
desc?: string;
value?: number;
illus?: string | ResourceConfig;
children?: ItemDatum[];
[key: string]: any;
}
new Infographic({
// 其他配置项...
data: {
title: '信息图标题',
desc: '这是信息图的描述文本',
items: [
{
icon: 'https://example.com/icon1.svg',
label: '数据项 1',
desc: '这是数据项 1 的描述',
},
{
icon: 'https://example.com/icon2.svg',
label: '数据项 2',
desc: '这是数据项 2 的描述',
},
],
},
});
new Infographic({
// 其他配置项...
data: {
title: '信息图标题',
desc: '这是信息图的描述文本',
items: [
{
label: '一级数据项 1',
children: [
{
label: '二级数据项 1-1',
},
{
label: '二级数据项 1-2',
},
],
},
{
label: '一级数据项 2',
children: [
{
label: '二级数据项 2-1',
},
],
},
],
},
});