{ "id": { "desc": "

组件 ID。默认不指定。指定则可用于在 option 或者 API 中引用组件。

\n" }, "source": { "desc": "

原始数据。一般来说,原始数据表达的是二维表。可以用如下这些格式表达二维表:

\n

二维数组,其中第一行/列可以给出 维度名,也可以不给出,直接就是数据:

\n
[\n    ['product', '2015', '2016', '2017'],\n    ['Matcha Latte', 43.3, 85.8, 93.7],\n    ['Milk Tea', 83.1, 73.4, 55.1],\n    ['Cheese Cocoa', 86.4, 65.2, 82.5],\n    ['Walnut Brownie', 72.4, 53.9, 39.1]\n]\n
\n

按行的 key-value 形式(对象数组),其中键(key)表明了 维度名:

\n
[\n    {product: 'Matcha Latte', count: 823, score: 95.8},\n    {product: 'Milk Tea', count: 235, score: 81.4},\n    {product: 'Cheese Cocoa', count: 1042, score: 91.2},\n    {product: 'Walnut Brownie', count: 988, score: 76.9}\n]\n
\n

按列的 key-value 形式,每一项表示二维表的 “一列”:

\n
{\n    'product': ['Matcha Latte', 'Milk Tea', 'Cheese Cocoa', 'Walnut Brownie'],\n    'count': [823, 235, 1042, 988],\n    'score': [95.8, 81.4, 91.2, 76.9]\n}\n
\n

关于 dataset 的详情,请参见教程。

\n" }, "dimensions": { "desc": "

使用 dimensions 定义 series.data 或者 dataset.source 的每个维度的信息。

\n

注意:如果使用了 dataset,那么可以在 dataset.dimensions 中定义 dimension ,或者在 dataset.source 的第一行/列中给出 dimension 名称。于是就不用在这里指定 dimension。但如果在这里指定了 dimensions,那么优先使用这里的。

\n

例如:

\n
option = {\n    dataset: {\n        source: [\n            // 有了上面 dimensions 定义后,下面这五个维度的名称分别为:\n            // 'date', 'open', 'close', 'highest', 'lowest'\n            [12, 44, 55, 66, 2],\n            [23, 6, 16, 23, 1],\n            ...\n        ]\n    },\n    series: {\n        type: 'xxx',\n        // 定义了每个维度的名称。这个名称会被显示到默认的 tooltip 中。\n        dimensions: ['date', 'open', 'close', 'highest', 'lowest']\n    }\n}\n
\n
series: {\n    type: 'xxx',\n    dimensions: [\n        null,                // 如果此维度不想给出定义,则使用 null 即可\n        {type: 'ordinal'},   // 只定义此维度的类型。\n                             // 'ordinal' 表示离散型,一般文本使用这种类型。\n                             // 如果类型没有被定义,会自动猜测类型。\n        {name: 'good', type: 'number'},\n        'bad'                // 等同于 {name: 'bad'}\n    ]\n}\n
\n

dimensions 数组中的每一项可以是:

\n\n

值得一提的是,当定义了 dimensions 后,默认 tooltip 中对个维度的显示,会变为『竖排』,从而方便显示每个维度的名称。如果没有定义 dimensions,则默认 tooltip 会横排显示,且只显示数值没有维度名称可显示。

\n" }, "sourceHeader": { "desc": "

dataset.source 第一行/列是否是 维度名 信息。可选值:

\n\n

注意:“第一行/列” 的意思是,如果 series.seriesLayoutBy 设置为 'column'(默认值),则取第一行,如果 series.seriesLayoutBy 设置为 'row',则取第一列。

\n" }, "transform": { "desc": "

参见这个教程: datat transform.

\n" }, "transform-filter.config": { "desc": "

"sort" 数据转换器的“条件”。

\n

参见这个教程: datat transform.

\n" }, "transform-filter.print": { "desc": "

使用 transform 时,有时候我们会配不对,显示不出来结果,并且不知道哪里错了。所以,这里提供了一个配置项 transform.print 方便 debug 。这个配置项只在开发环境中生效。如下例:

\n
option = {\n    dataset: [{\n        source: [ ... ]\n    }, {\n        transform: {\n            type: 'filter',\n            config: { ... }\n            // 配置为 `true` 后, transform 的结果\n            // 会被 console.log 打印出来。\n            print: true\n        }\n    }],\n    ...\n}\n
\n" }, "transform-sort.config": { "desc": "

"sort" 数据转换器的“条件”。

\n

参见这个教程: datat transform.

\n" }, "transform-sort.print": { "desc": "

使用 transform 时,有时候我们会配不对,显示不出来结果,并且不知道哪里错了。所以,这里提供了一个配置项 transform.print 方便 debug 。这个配置项只在开发环境中生效。如下例:

\n
option = {\n    dataset: [{\n        source: [ ... ]\n    }, {\n        transform: {\n            type: 'filter',\n            config: { ... }\n            // 配置为 `true` 后, transform 的结果\n            // 会被 console.log 打印出来。\n            print: true\n        }\n    }],\n    ...\n}\n
\n" }, "transform-xxx:xxx": { "desc": "

除了上述的内置的数据转换器外,我们也可以使用外部的数据转换器。外部数据转换器能提供或自己定制更丰富的功能。

\n

参见这个教程: datat transform.

\n" }, "transform-xxx:xxx.type": { "desc": "

内置数据转换器没有名空间(如 type: 'filter', type: 'sort')。

\n

外部数据转换器须有名空间(如 type: 'ecStat:regression')。

\n" }, "transform-xxx:xxx.config": { "desc": "

这里设置每个数据转换器所须的参数。每种数据转换器有自己的参数格式定义。

\n" }, "transform-xxx:xxx.print": { "desc": "

使用 transform 时,有时候我们会配不对,显示不出来结果,并且不知道哪里错了。所以,这里提供了一个配置项 transform.print 方便 debug 。这个配置项只在开发环境中生效。如下例:

\n
option = {\n    dataset: [{\n        source: [ ... ]\n    }, {\n        transform: {\n            type: 'filter',\n            config: { ... }\n            // 配置为 `true` 后, transform 的结果\n            // 会被 console.log 打印出来。\n            print: true\n        }\n    }],\n    ...\n}\n
\n" }, "fromDatasetIndex": { "desc": "

指定 dataset.transform 以哪个 dataset 作为输入。如果 dataset.transform 被指定了,但是 fromDatasetIndex 和 fromDatasetId 都没有被指定,那么默认会使用 fromDatasetIndex: 0.

\n

参见这个教程: datat transform.

\n" }, "fromDatasetId": { "desc": "

指定 dataset.transform 以哪个 dataset 作为输入。

\n

参见这个教程: datat transform.

\n" }, "fromTransformResult": { "desc": "

如果一个 dataset.transform 会产出多个结果 data ,我们可以使用 fromTransformResult 获得特定的结果。

\n

大多数场景下,transform 只会产出一个结果,所以大多数情况下 fromTransformResult 并不需要指定。当不指定 fromTransformResult 时,默认使用 fromTransformResult: 0。

\n

参见这个教程: datat transform.

\n" } }