设置 ECharts 时间轴的文本标签。
ECharts 时间轴文本标签的状态有两个: normal 和 emphasis。normal 是文本正常的样式,emphasis 是文本高亮的样式,比如鼠标悬浮或者图例联动高亮的时候会使用 emphasis 作为文本的样式。
在 normal 状态下设置 ECharts 时间轴文本标签。
[ default: 'auto' ]
时间轴文本标签的位置。
可选的配置方式:
[ default: true ]
是否显示 label。
[ default: 'auto' ]
label 的间隔。当指定为数值时,例如指定为 2,则每隔两个显示一个 label。
[ default: 0 ]
label 的旋转角度。正值表示逆时针旋转。
[ default: null ]
刻度标签的内容格式器,支持字符串模板和回调函数两种形式。
示例:
// 使用字符串模板,模板变量为刻度默认标签 {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('/');
}
[ default: '#304654' ]
timeline.lable.normal文字的颜色。
[ default: 'normal' ]
timeline.lable.normal文字字体的风格
可选:
[ default: normal ]
timeline.lable.normal文字字体的粗细
可选:
[ default: 'sans-serif' ]
timeline.lable.normal文字的字体系列
还可以是 'serif' , 'monospace', 'Arial', 'Courier New', 'Microsoft YaHei', ...
[ default: 12 ]
timeline.lable.normal文字的字体大小
文字水平对齐方式,默认自动。
可选:
rich 中如果没有设置 align,则会取父层级的 align。例如:
{
align: right,
rich: {
a: {
// 没有设置 `align`,则 `align` 为 right
}
}
}
文字垂直对齐方式,默认自动。
可选:
rich 中如果没有设置 verticalAlign,则会取父层级的 verticalAlign。例如:
{
verticalAlign: bottom,
rich: {
a: {
// 没有设置 `verticalAlign`,则 `verticalAlign` 为 bottom
}
}
}
时间轴文本标签的行高。
rich 中如果没有设置 lineHeight,则会取父层级的 lineHeight。例如:
{
lineHeight: 56,
rich: {
a: {
// 没有设置 `lineHeight`,则 `lineHeight` 为 56
}
}
}
[ default: 'transparent' ]
文字块背景色。
可以是直接的颜色值,例如:'#123234', 'red', rgba(0,23,11,0.3)'。
可以支持使用图片,例如:
backgroundColor: {
image: 'xxx/xxx.png'
// 这里可以是图片的 URL,
// 或者图片的 dataURI,
// 或者 HTMLImageElement 对象,
// 或者 HTMLCanvasElement 对象。
}
当使用图片的时候,可以使用 width 或 height 指定高宽,也可以不指定自适应。
[ default: 'transparent' ]
文字块边框颜色。
[ default: 0 ]
文字块边框宽度。
[ default: 0 ]
文字块的圆角。
[ default: 0 ]
文字块的内边距。例如:
注意,文字块的 width 和 height 指定的是内容高宽,不包含 padding。
[ default: 'transparent' ]
文字块的背景阴影颜色。
[ default: 0 ]
文字块的背景阴影长度。
[ default: 0 ]
文字块的背景阴影 X 偏移。
[ default: 0 ]
文字块的背景阴影 Y 偏移。
文字块的宽度。一般不用指定,不指定则自动是文字的宽度。在想做表格项或者使用图片(参见 backgroundColor)时,可能会使用它。
注意,文字块的 width 和 height 指定的是内容高宽,不包含 padding。
width 也可以是百分比字符串,如 '100%'。表示的是所在文本块的 contentWidth(即不包含文本块的 padding)的百分之多少。之所以以 contentWidth 做基数,因为每个文本片段只能基于 content box 布局。如果以 outerWidth 做基数,则百分比的计算在实用中不具有意义,可能会超出。
注意,如果不定义 rich 属性,则不能指定 width 和 height。
文字块的高度。一般不用指定,不指定则自动是文字的高度。在使用图片(参见 backgroundColor)时,可能会使用它。
注意,文字块的 width 和 height 指定的是内容高宽,不包含 padding。
注意,如果不定义 rich 属性,则不能指定 width 和 height。
[ default: 'transparent' ]
文字本身的描边颜色。
[ default: 0 ]
文字本身的描边宽度。
[ default: 'transparent' ]
文字本身的阴影颜色。
[ default: 0 ]
文字本身的阴影长度。
[ default: 0 ]
文字本身的阴影 X 偏移。
[ default: 0 ]
文字本身的阴影 Y 偏移。
在 rich 里面,可以自定义富文本样式。利用富文本样式,可以在标签中做出非常丰富的效果。
例如:
label: {
normal: {
// 在文本中,可以对部分文本采用 rich 中定义样式。
// 这里需要在文本中使用标记符号:
// `{styleName|text content text content}` 标记样式名。
// 注意,换行仍是使用 '\n'。
formatter: [
'{a|这段文本采用样式a}',
'{b|这段文本采用样式b}这段用默认样式{x|这段用样式x}'
].join('\n'),
rich: {
a: {
color: 'red',
lineHeight: 10
},
b: {
backgroundColor: {
image: 'xxx/xxx.jpg'
},
height: 40
},
x: {
fontSize: 18,
fontFamily: 'Microsoft YaHei',
borderColor: '#449933',
borderRadius: 4
},
...
}
}
}
详情参见教程:富文本标签
在 emphasis 状态下设置 ECharts 时间轴文本标签。
[ default: true ]
是否显示 label。
[ default: 'auto' ]
label 的间隔。当指定为数值时,例如指定为 2,则每隔两个显示一个 label。
[ default: 0 ]
label 的旋转角度。正值表示逆时针旋转。
[ default: null ]
刻度标签的内容格式器,支持字符串模板和回调函数两种形式。
示例:
// 使用字符串模板,模板变量为刻度默认标签 {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('/');
}
[ default: '#c23531' ]
timeline.lable.emphasis文字的颜色。
[ default: 'normal' ]
timeline.lable.emphasis文字字体的风格
可选:
[ default: normal ]
timeline.lable.emphasis文字字体的粗细
可选:
[ default: 'sans-serif' ]
timeline.lable.emphasis文字的字体系列
还可以是 'serif' , 'monospace', 'Arial', 'Courier New', 'Microsoft YaHei', ...
[ default: 12 ]
timeline.lable.emphasis文字的字体大小
文字水平对齐方式,默认自动。
可选:
rich 中如果没有设置 align,则会取父层级的 align。例如:
{
align: right,
rich: {
a: {
// 没有设置 `align`,则 `align` 为 right
}
}
}
文字垂直对齐方式,默认自动。
可选:
rich 中如果没有设置 verticalAlign,则会取父层级的 verticalAlign。例如:
{
verticalAlign: bottom,
rich: {
a: {
// 没有设置 `verticalAlign`,则 `verticalAlign` 为 bottom
}
}
}
emphasis 状态下时间轴文本标签的行高。
rich 中如果没有设置 lineHeight,则会取父层级的 lineHeight。例如:
{
lineHeight: 56,
rich: {
a: {
// 没有设置 `lineHeight`,则 `lineHeight` 为 56
}
}
}
[ default: 'transparent' ]
文字块背景色。
可以是直接的颜色值,例如:'#123234', 'red', rgba(0,23,11,0.3)'。
可以支持使用图片,例如:
backgroundColor: {
image: 'xxx/xxx.png'
// 这里可以是图片的 URL,
// 或者图片的 dataURI,
// 或者 HTMLImageElement 对象,
// 或者 HTMLCanvasElement 对象。
}
当使用图片的时候,可以使用 width 或 height 指定高宽,也可以不指定自适应。
[ default: 'transparent' ]
文字块边框颜色。
[ default: 0 ]
文字块边框宽度。
[ default: 0 ]
文字块的圆角。
[ default: 0 ]
文字块的内边距。例如:
注意,文字块的 width 和 height 指定的是内容高宽,不包含 padding。
[ default: 'transparent' ]
文字块的背景阴影颜色。
[ default: 0 ]
文字块的背景阴影长度。
[ default: 0 ]
文字块的背景阴影 X 偏移。
[ default: 0 ]
文字块的背景阴影 Y 偏移。
文字块的宽度。一般不用指定,不指定则自动是文字的宽度。在想做表格项或者使用图片(参见 backgroundColor)时,可能会使用它。
注意,文字块的 width 和 height 指定的是内容高宽,不包含 padding。
width 也可以是百分比字符串,如 '100%'。表示的是所在文本块的 contentWidth(即不包含文本块的 padding)的百分之多少。之所以以 contentWidth 做基数,因为每个文本片段只能基于 content box 布局。如果以 outerWidth 做基数,则百分比的计算在实用中不具有意义,可能会超出。
注意,如果不定义 rich 属性,则不能指定 width 和 height。
文字块的高度。一般不用指定,不指定则自动是文字的高度。在使用图片(参见 backgroundColor)时,可能会使用它。
注意,文字块的 width 和 height 指定的是内容高宽,不包含 padding。
注意,如果不定义 rich 属性,则不能指定 width 和 height。
[ default: 'transparent' ]
文字本身的描边颜色。
[ default: 0 ]
文字本身的描边宽度。
[ default: 'transparent' ]
文字本身的阴影颜色。
[ default: 0 ]
文字本身的阴影长度。
[ default: 0 ]
文字本身的阴影 X 偏移。
[ default: 0 ]
文字本身的阴影 Y 偏移。
在 rich 里面,可以自定义富文本样式。利用富文本样式,可以在标签中做出非常丰富的效果。
例如:
label: {
normal: {
// 在文本中,可以对部分文本采用 rich 中定义样式。
// 这里需要在文本中使用标记符号:
// `{styleName|text content text content}` 标记样式名。
// 注意,换行仍是使用 '\n'。
formatter: [
'{a|这段文本采用样式a}',
'{b|这段文本采用样式b}这段用默认样式{x|这段用样式x}'
].join('\n'),
rich: {
a: {
color: 'red',
lineHeight: 10
},
b: {
backgroundColor: {
image: 'xxx/xxx.jpg'
},
height: 40
},
x: {
fontSize: 18,
fontFamily: 'Microsoft YaHei',
borderColor: '#449933',
borderRadius: 4
},
...
}
}
}
详情参见教程:富文本标签