ECharts日历坐标系的月份轴有哪些属性

calendar.monthLabel   |   Object

设置 ECharts 日历坐标中月份轴的样式

calendar.monthLabel.show   |   boolean

[ default: true ]

是否在普通状态下显示日历坐标系的月份轴。

calendar.monthLabel.align   |   string

月份轴上文字的水平对齐方式，默认自动。

可选：

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

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

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

calendar.monthLabel.margin   |   number

[ default: 5 ]

月份轴的标签与轴线之间的距离。

calendar.monthLabel.position   |   string

[ default: 'start' ]

设置月份的放置位置；在开头还是结尾。

可选值：

• 'start'
• 'end'

calendar.monthLabel.nameMap   |   string, Array

[ default: 'en' ]

月份显示的效果，默认为'en' 可设置中英文以及自定义，下标0为对应一月的文字显示。

使用示例：

// 快捷设置英文 [
                'Jan', 'Feb', 'Mar',
                'Apr', 'May', 'Jun',
                'Jul', 'Aug', 'Sep',
                'Oct', 'Nov', 'Dec'
            ],
nameMap: 'en'
// 快捷设置中文 [
                '一月', '二月', '三月',
                '四月', '五月', '六月',
                '七月', '八月', '九月',
                '十月', '十一月', '十二月'
            ]
nameMap: 'cn'
// 自定义设置： 中英文混杂 或者不显示
nameMap: [
            '一月', 'Feb', '三月',
            '四月', 'May', '六月',
            '七月', '八月', '',
            '十月', 'Nov', '十二月'
        ],

calendar: [{
    monthLabel: {
        nameMap: 'en'
    }
}]

calendar.monthLabel.formatter   |   string, Function

[ default: null ]

用来格式化月份文本，支持字符串模板和回调函数两种形式。

示例：

// 使用字符串模板，例如：2017-02
/*
    模板变量{nameMap} 月份原本名称 eg：'Feb'
    模板变量{yyyy}   四位数年份 eg: 2017
    模板变量{yy}   后两位数年份 eg: 17
    模板变量{MM}   两位数月份 eg: 02
    模板变量{M}   一位数月份 eg: 2
*/
formatter: '{yyyy}-{MM}'
// 使用回调函数
/*
    param.nameMap 月份原本名称 eg：'Feb'
    param.yyyy   四位数年份 eg: 2017
    param.yy   后两位数年份 eg: 17
    param.MM   两位数月份 eg: 02
    param.M   一位数月份 eg: 2
*/
formatter: function (param) {
    // ...
    return param.MM;
}

calendar.monthLabel.color   |   Color

[ default: #000 ]

月份轴文字的颜色。

calendar.monthLabel.fontStyle   |   string

[ default: 'normal' ]

月份轴文字字体的风格

可选：

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

calendar.monthLabel.fontWeight   |   string

[ default: normal ]

文字字体的粗细

可选：

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

calendar.monthLabel.fontFamily   |   string

[ default: 'sans-serif' ]

文字的字体系列

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

calendar.monthLabel.fontSize   |   number

[ default: 12 ]

文字的字体大小

calendar.monthLabel.verticalAlign   |   string

文字垂直对齐方式，默认自动。

可选：

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

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

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

calendar.monthLabel.lineHeight   |   number

行高。

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

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

calendar.monthLabel.backgroundColor   |   string, Object

[ default: 'transparent' ]

文字块背景色。

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

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

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

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

calendar.monthLabel.borderColor   |   string

[ default: 'transparent' ]

文字块边框颜色。

calendar.monthLabel.borderWidth   |   number

[ default: 0 ]

文字块边框宽度。

calendar.monthLabel.borderRadius   |   number, Array

[ default: 0 ]

文字块的圆角。

calendar.monthLabel.padding   |   number, Array

[ default: 0 ]

文字块的内边距。例如：

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

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

calendar.monthLabel.shadowColor   |   string

[ default: 'transparent' ]

文字块的背景阴影颜色。

calendar.monthLabel.shadowBlur   |   number

[ default: 0 ]

文字块的背景阴影长度。

calendar.monthLabel.shadowOffsetX   |   number

[ default: 0 ]

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

calendar.monthLabel.shadowOffsetY   |   number

[ default: 0 ]

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

calendar.monthLabel.width   |   number, string

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

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

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

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

calendar.monthLabel.height   |   number, string

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

注意，文字块的 width 和 height 指定的是内容高宽，不包含 padding；如果不定义 rich 属性，则不能指定 width 和 height。

calendar.monthLabel.textBorderColor   |   string

[ default: 'transparent' ]

文字本身的描边颜色。

calendar.monthLabel.textBorderWidth   |   number

[ default: 0 ]

文字本身的描边宽度。

calendar.monthLabel.textShadowColor   |   string

[ default: 'transparent' ]

文字本身的阴影颜色。

calendar.monthLabel.textShadowBlur   |   number

[ default: 0 ]

文字本身的阴影长度。

calendar.monthLabel.textShadowOffsetX   |   number

[ default: 0 ]

文字本身的阴影 X 偏移。

calendar.monthLabel.textShadowOffsetY   |   number

[ default: 0 ]

文字本身的阴影 Y 偏移。

calendar.monthLabel.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
            },
            ...
        }
    }
}

详情参见教程：富文本标签