ECharts 柱状图的文本标签,可用于说明图形的一些数据信息,比如值,名称等,label 选项在 ECharts 2.x 中放置于itemStyle.normal下,在 ECharts 3 中为了让整个配置项结构更扁平合理,label 被拿出来跟 itemStyle 平级,并且跟 itemStyle 一样拥有 normal 和 emphasis 两个状态。本节只对 normal 状态下的设置进行讲述,如果要使用 emphasis 状态对柱状图文本标签进行设置,您可以参考 normal 状态实现设置。
通过 normal 状态设置 ECharts 柱状图的文本标签。
[ default: false ]
是否显示柱状图文本标签。值为 boolean 类型,默认值为 false,即不显示。
[ default: 'inside' ]
设置文本标签的位置。类型为 string 和 Array。
可选值列表如下:
// 绝对的像素值
position: [10, 10],
// 相对的百分比
position: ['50%', '50%']
参见:label position。
[ default: 5 ]
设置文本标签离柱状图元素的距离,值类型为 number,默认值为 5。当 position 为字符描述值(如 'top'、'insideRight')时候有效。
参见:label position。
柱状图文本标签的旋转角度,值类型为 number。从 -90 度到 90 度。正值是逆时针。
参见:label rotation。
是否对文本标签文字进行偏移,值类型为 Array。默认不偏移。例如:[30, 40] 表示文字在横向上偏移 30,纵向上偏移 40。
文本标签内容格式器,支持字符串模板和回调函数两种形式,字符串模板与回调函数返回的字符串均支持用 n 换行。值类型为 string、Function。
字符串模板:
模板变量有 {a}、{b}、{c},分别表示系列名,数据名,数据值。
示例:
formatter: '{b}: {c}'
回调函数:
回调函数格式:
(params: Object|Array) => string
参数 params 是 formatter 需要的单个数据集。格式如下:
{
componentType: 'series',
// 系列类型
seriesType: string,
// 系列在传入的 option.series 中的 index
seriesIndex: number,
// 系列名称
seriesName: string,
// 数据名,类目名
name: string,
// 数据在传入的 data 数组中的 index
dataIndex: number,
// 传入的原始数据项
data: Object,
// 传入的数据值
value: number|Array,
// 数据图形的颜色
color: string,
}
[ default: "#fff" ]
文本标签文字的颜色,值类型为 color。
如果设置为 'auto',则为视觉映射得到的颜色,如系列色。
[ default: 'normal' ]
文本标签文字字体的风格。
值类型为 string,可选:
[ default: normal ]
柱状图文本标签文字字体的粗细
值类型为 string,可选:
[ default: 'sans-serif' ]
文本标签文字的字体系列,值类型为 string。
还可以是 'serif' , 'monospace', 'Arial', 'Courier New', 'Microsoft YaHei', ...
[ default: 12 ]
文本标签文字的字体大小,值类型为 number。
文本标签文字的水平对齐方式,默认自动。
值类型为 string,可选:
rich 中如果没有设置 align,则会取父层级的 align。例如:
{
align: right,
rich: {
a: {
// 没有设置 `align`,则 `align` 为 right
}
}
}
文字垂直对齐方式,默认自动。
值类型为 string,可选:
rich 中如果没有设置 verticalAlign,则会取父层级的 verticalAlign。例如:
{
verticalAlign: bottom,
rich: {
a: {
// 没有设置 `verticalAlign`,则 `verticalAlign` 为 bottom
}
}
}
柱状图文本标签的行高,值类型为 number。
rich 中如果没有设置 lineHeight,则会取父层级的 lineHeight。例如:
{
lineHeight: 56,
rich: {
a: {
// 没有设置 `lineHeight`,则 `lineHeight` 为 56
}
}
}
series[i]-bar.label.normal.backgroundColor
[ default: 'transparent' ]
文字块背景色,值类型为 string、Object。
可以是直接的颜色值,例如:'#123234', 'red', rgba(0,23,11,0.3)'。
可以支持使用图片,例如:
backgroundColor: {
image: 'xxx/xxx.png'
// 这里可以是图片的 URL,
// 或者图片的 dataURI,
// 或者 HTMLImageElement 对象,
// 或者 HTMLCanvasElement 对象。
}
当使用图片的时候,可以使用 width 或 height 指定高宽,也可以不指定自适应。
如果设置为 'auto',则为视觉映射得到的颜色,如系列色。
[ default: 'transparent' ]
文字块边框颜色,值类型为 string。
如果设置为 'auto',则为视觉映射得到的颜色,如系列色。
[ default: 0 ]
文字块边框宽度,值类型为 number。
[ default: 0 ]
文字块的圆角,值类型为 number、Array。
[ default: 0 ]
文字块的内边距,值类型为 number、Array。例如:
注意,文字块的 width 和 height 指定的是内容高宽,不包含 padding。
[ default: 'transparent' ]
文字块的背景阴影颜色,值类型为 string。
[ default: 0 ]
文字块的背景阴影长度,值类型为 number。
[ default: 0 ]
文字块的背景阴影 X 偏移,值类型为 number。
[ default: 0 ]
文字块的背景阴影 Y 偏移,值类型为 number。
文字块的宽度,值类型为 number、string。一般不用指定,不指定则自动是文字的宽度。在想做表格项或者使用图片(参见 backgroundColor)时,可能会使用它。
注意,文字块的 width 和 height 指定的是内容高宽,不包含 padding。
width 也可以是百分比字符串,如 '100%'。表示的是所在文本块的 contentWidth(即不包含文本块的 padding)的百分之多少。之所以以 contentWidth 做基数,因为每个文本片段只能基于 content box 布局。如果以 outerWidth 做基数,则百分比的计算在实用中不具有意义,可能会超出。
注意,如果不定义 rich 属性,则不能指定 width 和 height。
文字块的高度,值类型为 number、string。一般不用指定,不指定则自动是文字的高度。在使用图片(参见 backgroundColor)时,可能会使用它。
注意,文字块的 width 和 height 指定的是内容高宽,不包含 padding;如果不定义 rich 属性,则不能指定 width 和 height。
[ default: 'transparent' ]
文字本身的描边颜色,值类型为 string。
如果设置为 'auto',则为视觉映射得到的颜色,如系列色。
[ default: 0 ]
文字本身的描边宽度,值类型为 number。
[ default: 'transparent' ]
文字本身的阴影颜色,值类型为 string。
[ default: 0 ]
文字本身的阴影长度,值类型为 number。
[ default: 0 ]
文字本身的阴影 X 偏移,值类型为 number。
[ default: 0 ]
文字本身的阴影 Y 偏移,值类型为 number。
在 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
},
...
}
}
}
详情参见教程:富文本标签
series[i]-treemap.silent设置 Treemap 图形是否不响应和触发鼠标事件,值类型为 boolean,默认为 false,即响应和触发鼠标事件...
Highcharts 曲线区域图Highcharts 区域图以下实例演示了曲线区域图。我们在前面的章节已经了解了 Highcharts 基本配置语法。接下...
Highcharts 堆叠条形图Highcharts 条形图以下实例演示了堆叠条形图。我们在前面的章节已经了解了 Highcharts 基本配置语法。接下...
Highcharts 堆叠组柱形图Highcharts 柱形图以下实例演示了堆叠组柱形图。我们在前面的章节已经了解了 Highcharts 基本配置语法。...
部署应用部署应用是指编译或构建代码并将生成的JavaScript、CSS和HTML托管到Web服务器上的过程。本节基于“入门”教程中的前序步...
生命周期钩子当Angular实例化组件类并渲染组件视图及其子视图时,组件实例的生命周期就开始了。生命周期一直伴随着变更检测,Ang...
模板变量模板变量可以帮助你在模板的另一部分使用这个部分的数据。使用模板变量,你可以执行某些任务,比如响应用户输入或微调应...
里程碑5:路由守卫现在,任何用户都能在任何时候导航到任何地方。但有时候出于种种原因需要控制对该应用的不同部分的访问。可能...
添加本地化包要利用Angular的本地化功能,请用AngularCLI将@angular/localize包添加到你的项目中。要添加@angular/localiz...