ECharts日歷坐標(biāo)系的月份軸有哪些屬性

2018-10-17 15:59 更新

calendar.monthLabel   |   Object

設(shè)置 ECharts 日歷坐標(biāo)中月份軸的樣式

calendar.monthLabel.show   |   boolean

[ default: true ]

是否在普通狀態(tài)下顯示日歷坐標(biāo)系的月份軸。

calendar.monthLabel.align   |   string

月份軸上文字的水平對齊方式,默認(rèn)自動(dòng)。

可選:

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

rich 中如果沒有設(shè)置 align,則會取父層級的 align。例如:

{
    align: right,
    rich: {
        a: {
            // 沒有設(shè)置 `align`,則 `align` 為 right
        }
    }
}

calendar.monthLabel.margin   |   number

[ default: 5 ]

月份軸的標(biāo)簽與軸線之間的距離。

calendar.monthLabel.position   |   string

[ default: 'start' ]

設(shè)置月份的放置位置;在開頭還是結(jié)尾。

可選值:

  • 'start'
  • 'end'

calendar.monthLabel.nameMap   |   string, Array

[ default: 'en' ]

月份顯示的效果,默認(rèn)為'en' 可設(shè)置中英文以及自定義,下標(biāo)0為對應(yīng)一月的文字顯示。

使用示例:

// 快捷設(shè)置英文 [
                'Jan', 'Feb', 'Mar',
                'Apr', 'May', 'Jun',
                'Jul', 'Aug', 'Sep',
                'Oct', 'Nov', 'Dec'
            ],
nameMap: 'en'
// 快捷設(shè)置中文 [
                '一月', '二月', '三月',
                '四月', '五月', '六月',
                '七月', '八月', '九月',
                '十月', '十一月', '十二月'
            ]
nameMap: 'cn'
// 自定義設(shè)置: 中英文混雜 或者不顯示
nameMap: [
            '一月', 'Feb', '三月',
            '四月', 'May', '六月',
            '七月', '八月', '',
            '十月', 'Nov', '十二月'
        ],

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

calendar.monthLabel.formatter   |   string, Function

[ default: null ]

用來格式化月份文本,支持字符串模板和回調(diào)函數(shù)兩種形式。

示例:

// 使用字符串模板,例如:2017-02
/*
    模板變量{nameMap} 月份原本名稱 eg:'Feb'
    模板變量{yyyy}   四位數(shù)年份 eg: 2017
    模板變量{yy}   后兩位數(shù)年份 eg: 17
    模板變量{MM}   兩位數(shù)月份 eg: 02
    模板變量{M}   一位數(shù)月份 eg: 2
*/
formatter: '{yyyy}-{MM}'
// 使用回調(diào)函數(shù)
/*
    param.nameMap 月份原本名稱 eg:'Feb'
    param.yyyy   四位數(shù)年份 eg: 2017
    param.yy   后兩位數(shù)年份 eg: 17
    param.MM   兩位數(shù)月份 eg: 02
    param.M   一位數(shù)月份 eg: 2
*/
formatter: function (param) {
    // ...
    return param.MM;
}

calendar.monthLabel.color   |   Color

[ default: #000 ]

月份軸文字的顏色。

calendar.monthLabel.fontStyle   |   string

[ default: 'normal' ]

月份軸文字字體的風(fēng)格

可選:

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

calendar.monthLabel.fontWeight   |   string

[ default: normal ]

文字字體的粗細(xì)

可選:

  • '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

文字垂直對齊方式,默認(rèn)自動(dòng)。

可選:

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

rich 中如果沒有設(shè)置 verticalAlign,則會取父層級的 verticalAlign。例如:

{
    verticalAlign: bottom,
    rich: {
        a: {
            // 沒有設(shè)置 `verticalAlign`,則 `verticalAlign` 為 bottom
        }
    }
}

calendar.monthLabel.lineHeight   |   number

行高。

rich 中如果沒有設(shè)置 lineHeight,則會取父層級的 lineHeight。例如:

{
    lineHeight: 56,
    rich: {
        a: {
            // 沒有設(shè)置 `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 對象。
}

當(dāng)使用圖片的時(shí)候,可以使用 width 或 height 指定高寬,也可以不指定自適應(yīng)。

calendar.monthLabel.borderColor   |   string

[ default: 'transparent' ]

文字塊邊框顏色。

calendar.monthLabel.borderWidth   |   number

[ default: 0 ]

文字塊邊框?qū)挾取?/p>

calendar.monthLabel.borderRadius   |   number, Array

[ default: 0 ]

文字塊的圓角。

calendar.monthLabel.padding   |   number, Array

[ default: 0 ]

文字塊的內(nèi)邊距。例如:

  • padding: [3, 4, 5, 6]:表示 [上, 右, 下, 左] 的邊距。
  • padding: 4:表示 padding: [4, 4, 4, 4]。
  • padding: [3, 4]:表示 padding: [3, 4, 3, 4]。
注意,文字塊的 width 和 height 指定的是內(nèi)容高寬,不包含 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

文字塊的寬度。一般不用指定,不指定則自動(dòng)是文字的寬度。在想做表格項(xiàng)或者使用圖片(參見 backgroundColor)時(shí),可能會使用它。

注意,文字塊的 width 和 height 指定的是內(nèi)容高寬,不包含 padding。

width 也可以是百分比字符串,如 '100%'。表示的是所在文本塊的 contentWidth(即不包含文本塊的 padding)的百分之多少。之所以以 contentWidth 做基數(shù),因?yàn)槊總€(gè)文本片段只能基于 content box 布局。如果以 outerWidth 做基數(shù),則百分比的計(jì)算在實(shí)用中不具有意義,可能會超出。

注意,如果不定義 rich 屬性,則不能指定 width 和 height。

calendar.monthLabel.height   |   number, string

文字塊的高度。一般不用指定,不指定則自動(dòng)是文字的高度。在使用圖片(參見 backgroundColor)時(shí),可能會使用它。

注意,文字塊的 width 和 height 指定的是內(nèi)容高寬,不包含 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 里面,可以自定義富文本樣式。利用富文本樣式,可以在標(biāo)簽中做出非常豐富的效果。

例如:

label: {
    normal: {

        // 在文本中,可以對部分文本采用 rich 中定義樣式。
        // 這里需要在文本中使用標(biāo)記符號:
        // `{styleName|text content text content}` 標(biāo)記樣式名。
        // 注意,換行仍是使用 '\n'。
        formatter: [
            '{a|這段文本采用樣式a}',
            '{b|這段文本采用樣式b}這段用默認(rèn)樣式{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
            },
            ...
        }
    }
}

詳情參見教程:富文本標(biāo)簽

以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號