zh/option-gl/component/axis3D-common.md

{{ target: component-axis3D-common-axis-interval }} ${name}的显示间隔，在类目轴中有效。{{ if: !${isAxisLabel} }}默认同 axisLabel.interval 一样。{{ /if }}

默认会自动计算interval以保证较好的展示效果。

可以设置成 0 强制显示所有标签。

如果设置为 1，表示『隔一个标签显示一个标签』，如果值为 2，表示『隔两个标签显示一个标签』，以此类推。

可以用数值表示间隔的数据，也可以通过回调函数控制。回调函数格式如下：

(index:number, value: string) => boolean

第一个参数是类目的 index，第二个值是类目名称，如果跳过则返回 false。

刻度标签的内容格式器。支持字符串模板和回调函数两种形式。

示例:

// 使用字符串模板，模板变量为刻度默认标签 {value}
formatter: '{value} kg'

// 使用函数模板，函数参数分别为刻度数值（类目），刻度的索引
formatter: function (value, index) {
    // 格式化成月/日，只在第一个刻度显示年份
    var date = new Date(value);
    var texts = [(date.getMonth() + 1), date.getDate()];
    if (index === 0) {
        texts.unshift(date.getYear());
    }
    return texts.join('/');
}

#${prefix|default(‘#’)} axisLine(Object) 坐标轴轴线相关设置。 ##${prefix|default(‘#’)} show(boolean) = ${defaultShow|default(true)} 是否显示坐标轴轴线。

{{ if: ${hasLabelInterval|default(true)} }} ##${prefix|default(‘#’)} interval(number|Function) = ‘auto’ {{ use: component-axis3D-common-axis-interval( name=“坐标轴刻度标签”, isAxisLabel=true, componentType=${componentType} ) }} {{ /if }}

##${prefix|default(‘#’)} lineStyle(Object) {{ use: partial-line-style(prefix=‘##’ + ${prefix|default(‘#’)}, defaultColor=“‘#333’”, defaultWidth=2, name=“坐标轴线”) }}

#${prefix|default(‘#’)} axisLabel(Object) 坐标轴刻度标签的相关设置。 ##${prefix|default(‘#’)} show(boolean) = ${defaultShow|default(true)} 是否显示刻度标签。

##${prefix|default(‘#’)} margin(number) = 8 刻度标签与轴线之间的距离。

注意： 这个距离是三维空间而非屏幕空间的。

##${prefix|default(‘#’)} formatter(string|Function) = null {{use: axis-common-formatter-desc}}

##${prefix|default(‘#’)} textStyle(Object) {{ use: partial-text-style( prefix=‘##’ + ${prefix|default(‘#’)}, defaultColor=“‘#333’” )}}

###${prefix|default(‘#’)} color(Color|Function)

刻度标签文字的颜色，默认取 axisLine.lineStyle.color。支持回调函数，格式如下

(val: string) => Color

参数是标签的文本，返回颜色值，如下示例：

textStyle: {
    color: function (value, index) {
        return value >= 0 ? 'green' : 'red';
    }
}

#${prefix|default(‘#’)} axisTick(Object) 坐标轴刻度相关设置。 ##${prefix|default(‘#’)} show(boolean) = ${defaultShow|default(true)} 是否显示坐标轴刻度。

##${prefix|default(‘#’)} length(number) = 5 坐标轴刻度的长度。

##${prefix|default(‘#’)} lineStyle(Object) {{ use: partial-line-style(prefix=‘##’ + ${prefix|default(‘#’)}, defaultColor=“‘#333’”, defaultWidth=1, name=“坐标轴线”) }}

###${prefix|default(‘#’)} color(Color)

刻度线的颜色，默认取 axisLine.lineStyle.color。

#${prefix|default(‘#’)} splitLine(Object) 坐标轴轴线相关设置。 ##${prefix|default(‘#’)} show(boolean) = ${defaultShow|default(true)} 是否显示坐标轴轴线。

##${prefix|default(‘#’)} lineStyle(Object) {{ use: partial-line-style(prefix=‘##’ + ${prefix|default(‘#’)}, defaultColor=“‘#333’”, defaultWidth=2, name=“坐标轴线”) }}

#${prefix|default(‘#’)} splitArea(Object)

坐标轴在 grid3D 的平面上的分隔区域。 ##${prefix|default(‘#’)} show(boolean) = ${defaultShow|default(false)} 是否显示分隔区域。

{{ if: ${hasLabelInterval|default(true)} }} ##${prefix|default(‘#’)} interval(number|Function) = ‘auto’ {{ use: component-axis3D-common-axis-interval( name=“坐标轴分隔区域”, componentType=${componentType} ) }} {{ /if }}

##${prefix|default(‘#’)} areaStyle(Object) 分隔区域的样式设置。 ###${prefix|default(‘#’)} color(Array) = [‘rgba(250,250,250,0.3)’,‘rgba(200,200,200,0.3)’] 分隔区域颜色。分隔区域会按数组中颜色的顺序依次循环设置颜色。默认是一个深浅的间隔色。 {{ use:partial-style-shadow-opacity(prefix=‘##’ + ${prefix|default(‘#’)}) }}

#${prefix|default(‘#’)} axisPointer(Object) 坐标轴指示线。

##${prefix|default(‘#’)} show(boolean) = ${defaultShow|default(true)}

是否显示坐标轴指示线。

##${prefix|default(‘#’)} lineStyle(Object)

{{ use: partial-line-style(prefix=‘##’ + ${prefix|default(‘#’)}, defaultColor=“‘rgba(0, 0, 0, 0.8)’”, defaultWidth=1, name=“坐标轴指示线”) }}

##${prefix|default(‘#’)} label(Object)

指示线标签。

###${prefix|default(‘#’)} show(boolean) = true

是否显示指示线标签。默认数值轴显示，类目轴不显示。

###${prefix|default(‘#’)} formatter(Function)

标签格式器，函数第一个参数是当前坐标轴的数值，第二个参数是所有坐标轴的数值数组。

(value: number, valueAll: Array) => string

###${prefix|default(‘#’)} margin(number)

标签距离坐标轴的距离。同刻度标签一样，这个距离是三维空间而非屏幕像素。

###${prefix|default(‘#’)} textStyle(Object)

{{ use: partial-text-style( prefix=‘###’ + ${prefix|default(‘#’)}, defaultFontSize=16 )}}

{{ use: component-axis3D-common-axisLine( prefix=${prefix|default(‘#’)} ) }}

{{ use: component-axis3D-common-axisLabel( prefix=${prefix|default(‘#’)} ) }}

{{ use: component-axis3D-common-axisTick( prefix=${prefix|default(‘#’)} ) }}

{{ use: component-axis3D-common-splitLine( prefix=${prefix|default(‘#’)} ) }}

{{ use: component-axis3D-common-splitArea( prefix=${prefix|default(‘#’)} ) }}

{{ use: component-axis3D-common-axisPointer( prefix=${prefix|default(‘#’)} ) }}