JSRUN 用代码说话

自定义yAxis中坐标轴名称的富文本样式

编辑教程

自定义yAxis中坐标轴名称的富文本样式

ECharts 的富文本标签可以应用在许多地方,自然在 yAxis 中也可以使用富文本标签来对 y 坐标轴的名称样式进行设置。

yAxis 通过自定义富文本样式,可以实现文字的一些样式设置,文字块的设置,文字阴影的设置等等。

yAxis.nameTextStyle.rich

Object 在 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  
            },  
            ...  
        }  
    }  
}

yAxis.nameTextStyle.rich.<user defined style name>

Objecty

使用富文本标签,可以自定义样式的名称。


yAxis.nameTextStyle.rich.<user defined style name>.color

Color [ 默认值: "#fff" ]

通过富文本标签设置坐标轴名称文字的颜色。


yAxis.nameTextStyle.rich.<user defined style name>.fontStyle

string [ 默认值: 'normal' ]

通过富文本标签设置坐标轴名称文字的字体风格

可选:

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

yAxis.nameTextStyle.rich.<user defined style name>.fontWeight

string [ 默认值: normal ]

通过富文本标签设置坐标轴名称文字的字体粗细

可选:

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

yAxis.nameTextStyle.rich.<user defined style name>.fontFamily

string [ 默认值: 'sans-serif' ]

通过富文本标签设置坐标轴名称文字的字体系列,默认值为:'sans-serif' 。

还可以有如下的取值: 'serif' , 'monospace', 'Arial', 'Courier New', 'Microsoft YaHei', ...


yAxis.nameTextStyle.rich.<user defined style name>.fontSize

number [ 默认值: 12 ]

通过富文本标签设置坐标轴名称文字的字体大小。


yAxis.nameTextStyle.rich.<user defined style name>.align

string

通过富文本标签设置坐标轴名称文字的水平对齐方式,默认自动。

可选:

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

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

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

yAxis.nameTextStyle.rich.<user defined style name>.verticalAlign

string

通过富文本标签设置坐标轴名称文字垂直对齐方式,默认自动。

可选:

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

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

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

yAxis.nameTextStyle.rich.<user defined style name>.lineHeight

number

通过富文本标签设置坐标轴名称的行高。

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

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

yAxis.nameTextStyle.rich.<user defined style name>.backgroundColor

string, Object [ 默认值: 'transparent' ]

通过富文本标签设置坐标轴名称文字块的背景色。

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

可以支持使用图片,例如:

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

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


yAxis.nameTextStyle.rich.<user defined style name>.borderColor

string

[ 默认值: 'transparent' ]

通过富文本标签设置坐标轴名称文字块的边框颜色。


yAxis.nameTextStyle.rich.<user defined style name>.borderWidth

number

[ 默认值: 0 ]

通过富文本标签设置坐标轴名称文字块的边框宽度。


yAxis.nameTextStyle.rich.<user defined style name>.borderRadius

number, Array

[ 默认值: 0 ]

通过富文本标签设置坐标轴名称文字块的圆角。


yAxis.nameTextStyle.rich.<user defined style name>.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。


yAxis.nameTextStyle.rich.<user defined style name>.shadowColor

string

[ 默认值: 'transparent' ]

通过富文本标签设置坐标轴名称文字块的背景阴影颜色。


yAxis.nameTextStyle.rich.<user defined style name>.shadowBlur

number

[ 默认值: 0 ]

通过富文本标签设置坐标轴名称文字块的背景阴影长度。


yAxis.nameTextStyle.rich.<user defined style name>.shadowOffsetX

number

[ 默认值: 0 ]

通过富文本标签设置坐标轴名称文字块的背景阴影 X 偏移。


yAxis.nameTextStyle.rich.<user defined style name>.shadowOffsetY

number [ 默认值: 0 ]

通过富文本标签设置坐标轴名称文字块的背景阴影 Y 偏移。


yAxis.nameTextStyle.rich.<user defined style name>.width

number, string

通过富文本标签设置坐标轴名称文字块的宽度。

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

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

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

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


yAxis.nameTextStyle.rich.<user defined style name>.height

number, string

通过富文本标签设置坐标轴名称文字块的高度。

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

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

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


yAxis.nameTextStyle.rich.<user defined style name>.textBorderColor

string [ 默认值: 'transparent' ]

通过富文本标签设置坐标轴名称文字本身的描边颜色。


yAxis.nameTextStyle.rich.<user defined style name>.textBorderWidth

number [ 默认值: 0 ]

通过富文本标签设置坐标轴名称文字本身的描边宽度。


yAxis.nameTextStyle.rich.<user defined style name>.textShadowColor

string [ 默认值: 'transparent' ]

通过富文本标签设置坐标轴名称文字本身的阴影颜色。


yAxis.nameTextStyle.rich.<user defined style name>.textShadowBlur

number [ 默认值: 0 ]

通过富文本标签设置坐标轴名称文字本身的阴影长度。


yAxis.nameTextStyle.rich.<user defined style name>.textShadowOffsetX

number [ 默认值: 0 ]

通过富文本标签设置坐标轴名称文字本身的阴影 X 偏移。


yAxis.nameTextStyle.rich.<user defined style name>.textShadowOffsetY

number [ 默认值: 0 ]

通过富文本标签设置坐标轴名称文字本身的阴影 Y 偏移。

JSRUN闪电教程系统是国内最先开创的教程维护系统, 所有工程师都可以参与共同维护的闪电教程,让知识的积累变得统一完整、自成体系。 大家可以一起参与进共编,让零散的知识点帮助更多的人。
X
支付宝
9.99
无法付款,请点击这里
金额: 0
备注:
转账时请填写正确的金额和备注信息,到账由人工处理,可能需要较长时间
如有疑问请联系QQ:565830900
正在生成二维码, 此过程可能需要15秒钟