单轴的类目标签属性及文字样式

singleAxis.data[i]

Object

ECharts单轴的类目数据，在类目轴（type: 'category'）中有效。

示例：

// 所有类目名称列表
data: ['周一', '周二', '周三', '周四', '周五', '周六', '周日']
// 每一项也可以是具体的配置项，此时取配置项中的 `value` 为类目名
data: [{
    value: '周一',
    // 突出周一
    textStyle: {
        fontSize: 20,
        color: 'red'
    }
}, '周二', '周三', '周四', '周五', '周六', '周日']

singleAxis.data[i].value

string

单个类目名称。

singleAxis.data[i].textStyle

Object

单轴类目标签的文字样式。

singleAxis.data[i].textStyle.color

Color [ 默认值 "#fff" ]

单轴类目标签文字的颜色。

singleAxis.data[i].textStyle.fontStyle | string

[ 默认值 'normal' ]

单轴类目标签文字字体的风格

可选：

• 'normal'
• 'italic'
• 'oblique'

singleAxis.data[i].textStyle.fontWeight

string [ 默认值 normal ]

单轴类目标签文字字体的粗细

可选：

• 'normal'
• 'bold'
• 'bolder'
• 'lighter'
• 100 | 200 | 300 | 400...

singleAxis.data[i].textStyle.fontFamily

string [ 默认值 'sans-serif' ]

单轴类目标签文字的字体系列

还可以是 'serif' , 'monospace', 'Arial', 'Courier New', 'Microsoft YaHei', ...

singleAxis.data[i].textStyle.fontSize

number [ 默认值 12 ]

单轴类目标签文字的字体大小

singleAxis.data[i].textStyle.align

string

单轴类目标签文字水平对齐方式，默认自动。

可选：

• 'left'
• 'center'
• 'right'

rich 中如果没有设置 align，则会取父层级的 align。例如：

{
    align: right,
    rich: {
        a: {
            // 没有设置 `align`，则 `align` 为 right
        }
    }
}

singleAxis.data[i].textStyle.verticalAlign

string

单轴类目标签文字的垂直对齐方式，默认自动。

可选：

• 'top'
• 'middle'
• 'bottom'

rich 中如果没有设置 verticalAlign，则会取父层级的 verticalAlign。例如：

{
    verticalAlign: bottom,
    rich: {
        a: {
            // 没有设置 `verticalAlign`，则 `verticalAlign` 为 bottom
        }
    }
}

singleAxis.data[i].textStyle.lineHeight

number

单轴类目标签文字的行高。

rich 中如果没有设置 lineHeight，则会取父层级的 lineHeight。例如：

{
    lineHeight: 56,
    rich: {
        a: {
            // 没有设置 `lineHeight`，则 `lineHeight` 为 56
        }
    }
}

singleAxis.data[i].textStyle.backgroundColor

string, Object [ 默认值 'transparent' ]

单轴类目标签文字块背景色。

可以是直接的颜色值，例如：'#123234', 'red', rgba(0,23,11,0.3)'。

可以支持使用图片，例如：

backgroundColor: {
    image: 'xxx/xxx.png'
    // 这里可以是图片的 URL，
    // 或者图片的 dataURI，
    // 或者 HTMLImageElement 对象，
    // 或者 HTMLCanvasElement 对象。
}

当使用图片的时候，可以使用 width 或 height 指定高宽，也可以不指定自适应。

singleAxis.data[i].textStyle.borderColor

string [ 默认值 'transparent' ]

文字块边框颜色。

singleAxis.data[i].textStyle.borderWidth

number [ 默认值 0 ]

文字块边框宽度。

singleAxis.data[i].textStyle.borderRadius

number, Array [ 默认值 0 ]

文字块的圆角。

singleAxis.data[i].textStyle.padding

number, Array [ 默认值 0 ]

文字块的内边距。例如：

• padding: [3, 4, 5, 6]：表示 [上, 右, 下, 左] 的边距。
• padding: 4：表示 padding: [4, 4, 4, 4]。
• padding: [3, 4]：表示 padding: [3, 4, 3, 4]。

注意，文字块的 width 和 height 指定的是内容高宽，不包含 padding。

singleAxis.data[i].textStyle.shadowColor

string [ 默认值 'transparent' ]

文字块的背景阴影颜色。

singleAxis.data[i].textStyle.shadowBlur

number [ 默认值 0 ]

文字块的背景阴影长度。

singleAxis.data[i].textStyle.shadowOffsetX

number [ 默认值 0 ]

文字块的背景阴影 X 偏移。

singleAxis.data[i].textStyle.shadowOffsetY

number [ 默认值 0 ]

文字块的背景阴影 Y 偏移。

singleAxis.data[i].textStyle.width

number, string

文字块的宽度。一般不用指定，不指定则自动是文字的宽度。在想做表格项或者使用图片（参见 backgroundColor）时，可能会使用它。

注意，文字块的 width 和 height 指定的是内容高宽，不包含 padding。

width 也可以是百分比字符串，如 '100%'。表示的是所在文本块的 contentWidth（即不包含文本块的 padding）的百分之多少。之所以以 contentWidth 做基数，因为每个文本片段只能基于 content box 布局。如果以 outerWidth 做基数，则百分比的计算在实用中不具有意义，可能会超出。

注意，如果不定义 rich 属性，则不能指定 width 和 height。

singleAxis.data[i].textStyle.height

number, string

文字块的高度。一般不用指定，不指定则自动是文字的高度。在使用图片（参见 backgroundColor）时，可能会使用它。

注意，文字块的 width 和 height 指定的是内容高宽，不包含 padding。

注意，如果不定义 rich 属性，则不能指定 width 和 height。

singleAxis.data[i].textStyle.textBorderColor

string [ 默认值 'transparent' ]

单轴类目标签文字本身的描边颜色。

singleAxis.data[i].textStyle.textBorderWidth

number [ 默认值 0 ]

文字本身的描边宽度。

singleAxis.data[i].textStyle.textShadowColor

string [ 默认值 'transparent' ]

文字本身的阴影颜色。

singleAxis.data[i].textStyle.textShadowBlur

number [ 默认值 0 ]

文字本身的阴影长度。

singleAxis.data[i].textStyle.textShadowOffsetX

number [ 默认值 0 ]

文字本身的阴影 X 偏移。

singleAxis.data[i].textStyle.textShadowOffsetY

number [ 默认值 0 ]

文字本身的阴影 Y 偏移。