新聞中心
您可以使用 series[i]-bar 來在 ECharts 中實(shí)現(xiàn)柱狀(條形)圖,ECharts 柱狀(條形)圖是通過柱形的高度(條形的寬度)來表現(xiàn)數(shù)據(jù)的大小的,柱狀圖可以應(yīng)用在直角坐標(biāo)系上,該直角坐標(biāo)系需要至少有一個(gè)類目軸或時(shí)間軸。下文中介紹了 ECharts 柱狀圖的一些基本的屬性設(shè)置,通過這些屬性,您可以更好的了解柱狀圖。

十年專注成都網(wǎng)站制作,企業(yè)網(wǎng)站制作,個(gè)人網(wǎng)站制作服務(wù),為大家分享網(wǎng)站制作知識(shí)、方案,網(wǎng)站設(shè)計(jì)流程、步驟,成功服務(wù)上千家企業(yè)。為您提供網(wǎng)站建設(shè),網(wǎng)站制作,網(wǎng)頁設(shè)計(jì)及定制高端網(wǎng)站建設(shè)服務(wù),專注于企業(yè)網(wǎng)站制作,高端網(wǎng)頁制作,對(duì)成都iso認(rèn)證等多個(gè)行業(yè),擁有多年的網(wǎng)站設(shè)計(jì)經(jīng)驗(yàn)。
series[i]-bar.type
將 ECharts 系列的 type 值設(shè)置為 bar,從而實(shí)現(xiàn)柱形圖;type 的取值類型為 string。
series[i]-bar.name
設(shè)置 ECharts 柱狀圖的名稱,用于 tooltip 的顯示,legend 的圖例篩選,在 setOption 更新數(shù)據(jù)和配置項(xiàng)時(shí)用于指定對(duì)應(yīng)的系列。name 的取值類型為 string。
series[i]-bar.legendHoverLink
使用柱狀圖時(shí)是否啟用圖例 hover 時(shí)的聯(lián)動(dòng)高亮;該屬性是一個(gè) boolean 類型的值,在 ECharts 中默認(rèn)取值為 true。
series[i]-bar.coordinateSystem
設(shè)置該柱狀圖使用的坐標(biāo)系,屬于 string 類型的值,默認(rèn)取值如下:
- 'cartesian2d':使用二維的直角坐標(biāo)系(也稱笛卡爾坐標(biāo)系),通過 xAxisIndex、yAxisIndex 指定相應(yīng)的坐標(biāo)軸組件。
series[i]-bar.xAxisIndex
使用的 x 軸的 index,在單個(gè)圖表實(shí)例中存在多個(gè) x 軸的時(shí)候有用。該屬性的值為 number 類型,默認(rèn)值為 0。
series[i]-bar.yAxisIndex
使用的 y 軸的 index,在單個(gè)圖表實(shí)例中存在多個(gè) y軸的時(shí)候有用。該屬性的值為 number 類型,默認(rèn)值為 0。
series[i]-bar.label
柱狀圖上的文本標(biāo)簽,這是一個(gè) Object ,可用于說明圖形的一些數(shù)據(jù)信息,比如值,名稱等,label 選項(xiàng)在 ECharts 2.x 中放置于 itemStyle.normal 下,在 ECharts 3 中為了讓整個(gè)配置項(xiàng)結(jié)構(gòu)更扁平合理,label 被拿出來跟 itemStyle 平級(jí),并且跟 itemStyle 一樣擁有 normal, emphasis 兩個(gè)狀態(tài)。
series[i]-bar.stack
柱狀圖的數(shù)據(jù)堆疊,同個(gè)類目軸上柱狀圖配置相同的 stack 值可以堆疊放置。stack 值的類型為 string,默認(rèn)狀態(tài)下為 null。
series[i]-bar.cursor
鼠標(biāo)懸浮時(shí)在柱狀圖元素上時(shí)鼠標(biāo)的樣式是什么。該屬性的值為 string 類型,默認(rèn)取值為 pointer,同 CSS 的 cursor。
series[i]-bar.barWidth
柱狀圖中柱條的寬度,不設(shè)置時(shí)自適應(yīng),其值為 number 或 string 類型,支持設(shè)置成相對(duì)于類目寬度的百分比。
在同一坐標(biāo)系上,此屬性會(huì)被多個(gè) 'bar' 系列共享。此屬性應(yīng)設(shè)置于此坐標(biāo)系中最后一個(gè) 'bar' 系列上才會(huì)生效,并且是對(duì)此坐標(biāo)系中所有 'bar' 系列生效。
series[i]-bar.barMaxWidth
柱狀圖中柱條的最大寬度,不設(shè)置時(shí)自適應(yīng),其值為 number 或 string 類型,支持設(shè)置成相對(duì)于類目寬度的百分比。
在同一坐標(biāo)系上,此屬性會(huì)被多個(gè) 'bar' 系列共享。此屬性應(yīng)設(shè)置于此坐標(biāo)系中最后一個(gè) 'bar' 系列上才會(huì)生效,并且是對(duì)此坐標(biāo)系中所有 'bar' 系列生效。
series[i]-bar.barMinHeight
柱狀圖中柱條的最小高度,可用于防止某數(shù)據(jù)項(xiàng)的值過小而影響交互。取值為 number 類型,默認(rèn)值為 0。
series[i]-bar.barGap
設(shè)置柱狀圖的柱間距離,可設(shè)固定值(如 20)或者百分比(如 '30%'(默認(rèn)值),表示柱子寬度的 30%)。取值為 string 類型。
如果想要兩個(gè)系列的柱子重疊,可以設(shè)置 barGap 為 '-100%'。這在用柱子做背景的時(shí)候有用。
在同一坐標(biāo)系上,此屬性會(huì)被多個(gè) 'bar' 系列共享。此屬性應(yīng)設(shè)置于此坐標(biāo)系中最后一個(gè) 'bar' 系列上才會(huì)生效,并且是對(duì)此坐標(biāo)系中所有 'bar' 系列生效。
例子:
點(diǎn)擊編輯實(shí)例 》》
series[i]-bar.barCategoryGap
設(shè)置類目間柱形距離,默認(rèn)為類目間距的20%,可設(shè)固定值。取值為 string 類型。
在同一坐標(biāo)系上,此屬性會(huì)被多個(gè) 'bar' 系列共享。此屬性應(yīng)設(shè)置于此坐標(biāo)系中最后一個(gè) 'bar' 系列上才會(huì)生效,并且是對(duì)此坐標(biāo)系中所有 'bar' 系列生效。
series[i]-bar.dimensions
使用 dimensions 定義 data 每個(gè)維度的信息。取值為 Array 例如:
series: {
type: 'xxx',
// 定義了每個(gè)維度的名稱。這個(gè)名稱會(huì)被顯示到默認(rèn)的 tooltip 中。
dimensions: ['date', 'open', 'close', 'highest', 'lowest']
data: [
// 有了上面 dimensions 定義后,下面這五個(gè)維度的名稱分別為:
// 'date', 'open', 'close', 'highest', 'lowest'
[12, 44, 55, 66, 2],
[23, 6, 16, 23, 1],
...
]
}
series: {
type: 'xxx',
dimensions: [
null, // 如果此維度不想給出定義,則使用 null 即可
{type: 'ordinal'}, // 只定義此維度的類型。
// 'ordinal' 表示離散型,一般文本使用這種類型。
// 如果類型沒有被定義,會(huì)自動(dòng)猜測(cè)類型。
{name: 'good', type: 'number'},
'bad' // 等同于 {name: 'bad'}
]
}
dimensions 數(shù)組中的每一項(xiàng)可以是:
- string,如 'someName',等同于 {name: 'someName'}
- Object,屬性可以有:
- name: string。
- type: string,支持
- number
- float,即 Float64Array
- int,即 Int32Array
- ordinal,表示離散數(shù)據(jù),一般指字符串。
- time,表示時(shí)間類型,時(shí)間類型的支持參見 data
值得一提的是,當(dāng)定義了 dimensions 后,默認(rèn) tooltip 中對(duì)個(gè)維度的顯示,會(huì)變?yōu)椤贺Q排』,從而方便顯示每個(gè)維度的名稱。如果沒有定義 dimensions,則默認(rèn) tooltip 會(huì)橫排顯示,且只顯示數(shù)值沒有維度名稱可顯示。
series[i]-bar.encode
定義 data 的哪個(gè)維度被編碼成什么。比如:
series: {
type: 'xxx',
encode: {
x: [3, 1, 5], // 表示維度 3、1、5 映射到 x 軸。
y: 2, // 表示維度 2 映射到 y 軸。
tooltip: [3, 2, 4] // 表示維度 3、2、4 會(huì)在 tooltip 中顯示。
label: 3 // 表示 label 使用維度 3。
},
data: [
// 每一列稱為一個(gè)『維度』。
// 這里分別是維度 0、1、2、3、4。
[12, 44, 55, 66, 2],
[23, 6, 16, 23, 1],
...
]
}
encode 支持的屬性,根據(jù)坐標(biāo)系不同而不同。 對(duì)于 直角坐標(biāo)系(cartesian2d),支持 x、y。 對(duì)于 極坐標(biāo)系(polar),支持 radius、angle。 對(duì)于 地理坐標(biāo)系(geo),支持 lng,lat。 此外,均支持 tooltip 和 label 和 itemName(用于指定 tooltip 中數(shù)據(jù)項(xiàng)名稱)。
當(dāng)使用 dimensions 給維度定義名稱后,encode 中可直接引用名稱,例如:
series: {
type: 'xxx',
dimensions: ['date', 'open', 'close', 'highest', 'lowest'],
encode: {
x: 'date',
y: ['open', 'close', 'highest', 'lowest']
},
data: [ ... ]
}
series[i]-bar.data[i]
柱狀圖中的數(shù)據(jù)內(nèi)容數(shù)組,是一個(gè) Object。數(shù)組項(xiàng)通常為具體的數(shù)據(jù)項(xiàng)。
通常來說,數(shù)據(jù)用一個(gè)二維數(shù)組表示。如下,每一列被稱為一個(gè)『維度』。
series: [{
data: [
// 維度X 維度Y 其他維度 ...
[ 3.4, 4.5, 15, 43],
[ 4.2, 2.3, 20, 91],
[ 10.8, 9.5, 30, 18],
[ 7.2, 8.8, 18, 57]
]
}]
- 在 直角坐標(biāo)系 (grid) 中『維度X』和『維度Y』會(huì)默認(rèn)對(duì)應(yīng)于 xAxis 和 yAxis。
- 在 極坐標(biāo)系 (polar) 中『維度X』和『維度Y』會(huì)默認(rèn)對(duì)應(yīng)于 radiusAxis 和 angleAxis。
- 后面的其他維度是可選的,可以在別處被使用,例如:
- 在 visualMap 中可以將一個(gè)或多個(gè)維度映射到顏色,大小等多個(gè)圖形屬性上。
- 在 series.symbolSize 中可以使用回調(diào)函數(shù),基于某個(gè)維度得到 symbolSize 值。
- 使用 tooltip.formatter 或 series.label.normal.formatter 可以把其他維度的值展示出來。
特別地,當(dāng)只有一個(gè)軸為類目軸(axis.type 為 'category')的時(shí)候,數(shù)據(jù)可以簡(jiǎn)化用一個(gè)一維數(shù)組表示。例如:
xAxis: {
data: ['a', 'b', 'm', 'n']
},
series: [{
// 與 xAxis.data 一一對(duì)應(yīng)。
data: [23, 44, 55, 19]
// 它其實(shí)是下面這種形式的簡(jiǎn)化:
// data: [[0, 23], [1, 44], [2, 55], [3, 19]]
}]
『值』與 軸類型 的關(guān)系:
- 當(dāng)某維度對(duì)應(yīng)于數(shù)值軸(axis.type 為 'value' 或者 'log')的時(shí)候:
其值可以為 number(例如 12)。(也可以兼容 string 形式的 number,例如 '12') - 當(dāng)某維度對(duì)應(yīng)于類目軸(axis.type 為 'category')的時(shí)候:
其值須為類目的『序數(shù)』(從 0 開始)或者類目的『字符串值』。例如: xAxis: { type: 'category', data: ['星期一', '星期二', '星期三', '星期四'] }, yAxis: { type: 'category', data: ['a', 'b', 'm', 'n', 'p', 'q'] }, series: [{ data: [ // xAxis yAxis [ 0, 0, 2 ], // 意思是此點(diǎn)位于 xAxis: '星期一', yAxis: 'a'。 [ '星期四', 2, 1 ], // 意思是此點(diǎn)位于 xAxis: '星期四', yAxis: 'm'。 [ 2, 'p', 2 ], // 意思是此點(diǎn)位于 xAxis: '星期三', yAxis: 'p'。 [ 3, 3, 5 ] ] }]雙類目軸的示例可以參考 Github Punchcard 示例。 - 當(dāng)某維度對(duì)應(yīng)于時(shí)間軸(type 為 'time')的時(shí)候,值可以為:
- 一個(gè)時(shí)間戳,如 1484141700832,表示 UTC 時(shí)間。
- 或者字符串形式的時(shí)間描述:
- ISO 8601 的子集,只包含這些形式(這幾種格式,除非指明時(shí)區(qū),否則均表示本地時(shí)間,與 moment 一致):
- 部分年月日時(shí)間: '2012-03', '2012-03-01', '2012-03-01 05', '2012-03-01 05:06'.
- 使用 'T' 或空格分割: '2012-03-01T12:22:33.123', '2012-03-01 12:22:33.123'.
- 時(shí)區(qū)設(shè)定: '2012-03-01T12:22:33Z', '2012-03-01T12:22:33+8000', '2012-03-01T12:22:33-05:00'.
- 其他的時(shí)間字符串,包括(均表示本地時(shí)間): '2012', '2012-3-1', '2012/3/1', '2012/03/01', '2009/6/12 2:00', '2009/6/12 2:05:08', '2009/6/12 2:05:08.123'
- ISO 8601 的子集,只包含這些形式(這幾種格式,除非指明時(shí)區(qū),否則均表示本地時(shí)間,與 moment 一致):
- 或者用戶自行初始化的 Date 實(shí)例:
- 注意,用戶自行初始化 Date 實(shí)例的時(shí)候,瀏覽器的行為有差異,不同字符串的表示也不同。
- 例如:在 chrome 中,new Date('2012-01-01') 表示 UTC 時(shí)間的 2012 年 1 月 1 日,而 new Date('2012-1-1') 和 new Date('2012/01/01') 表示本地時(shí)間的 2012 年 1 月 1 日。在 safari 中,不支持 new Date('2012-1-1')這種表示方法。
- 所以,使用 new Date(dataString) 時(shí),可使用第三方庫解析(如 moment),或者使用 echarts.number.parseDate,或者參見 這里。
當(dāng)需要對(duì)個(gè)別數(shù)據(jù)進(jìn)行個(gè)性化定義時(shí):
數(shù)組項(xiàng)可用對(duì)象,其中的 value 像表示具體的數(shù)值,如:
[ 12, 34, { value : 56, //自定義標(biāo)簽樣式,僅對(duì)該數(shù)據(jù)項(xiàng)有效 label: {}, //自定義特殊 itemStyle,僅對(duì)該數(shù)據(jù)項(xiàng)有效 itemStyle:{} }, 10 ] // 或 [ [12, 33], [34, 313], { value: [56, 44], label: {}, itemStyle:{} }, [10, 33] ]空值:
當(dāng)某數(shù)據(jù)不存在時(shí)(ps:不存在不代表值為 0),可以用 '-' 或者 null 或者 undefined 或者 NaN 表示。
例如,無數(shù)據(jù)在折線圖中可表現(xiàn)為該點(diǎn)是斷開的,在其它圖中可表示為圖形不存在。
series[i]-bar.markArea
柱狀圖的標(biāo)域,常用于標(biāo)記圖表中某個(gè)范圍的數(shù)據(jù),例如標(biāo)出某段時(shí)間投放了廣告。
series[i]-bar.zlevel
柱狀圖所有圖形的 zlevel 值,值類型為 number,默認(rèn)值為 0。
zlevel用于 Canvas 分層,不同zlevel值的圖形會(huì)放置在不同的 Canvas 中,Canvas 分層是一種常見的優(yōu)化手段。我們可以把一些圖形變化頻繁(例如有動(dòng)畫)的組件設(shè)置成一個(gè)單獨(dú)的zlevel。需要注意的是過多的 Canvas 會(huì)引起內(nèi)存開銷的增大,在手機(jī)端上需要謹(jǐn)慎使用以防崩潰。
zlevel 大的 Canvas 會(huì)放在 zlevel 小的 Canvas 的上面。
series[i]-bar.z
柱狀圖組件的所有圖形的 z 值,值類型為 number,默認(rèn)值為 2。控制圖形的前后順序。z 值小的圖形會(huì)被 z 值大的圖形覆蓋。
z 相比 zlevel 優(yōu)先級(jí)更低,而且不會(huì)創(chuàng)建新的 Canvas。
series[i]-bar.silent
柱狀圖是否不響應(yīng)和觸發(fā)鼠標(biāo)事件,值為 boolean 類型,默認(rèn)為 false,即響應(yīng)和觸發(fā)鼠標(biāo)事件。
series[i]-bar.animation
柱狀圖是否開啟動(dòng)畫,值為 boolean 類型,默認(rèn)為 true。
series[i]-bar.animationThreshold
柱狀圖是否開啟動(dòng)畫的閾值,值為 number 類型,默認(rèn)為 2000,當(dāng)單個(gè)系列顯示的圖形數(shù)量大于這個(gè)閾值時(shí)會(huì)關(guān)閉動(dòng)畫。
series[i]-bar.animationDuration
初始動(dòng)畫的時(shí)長(zhǎng),支持回調(diào)函數(shù),值為 number 類型,默認(rèn)為 1000,可以通過每個(gè)數(shù)據(jù)返回不同的 delay 時(shí)間實(shí)現(xiàn)更戲劇的初始動(dòng)畫效果:
animationDuration: function (idx) { // 越往后的數(shù)據(jù)延遲越大 return idx * 100; }series[i]-bar.animationEasing
柱狀圖初始動(dòng)畫的緩動(dòng)效果,值為 string 類型,默認(rèn)為 cubicOut。不同的緩動(dòng)效果可以參考 緩動(dòng)示例。
series[i]-bar.animationDelay
初始動(dòng)畫的延遲,支持回調(diào)函數(shù),類型為 number 或 Function ,默認(rèn)為 0??梢酝ㄟ^每個(gè)數(shù)據(jù)返回不同的 delay 時(shí)間實(shí)現(xiàn)更戲劇的初始動(dòng)畫效果。
如下示例:
animationDelay: function (idx) { // 越往后的數(shù)據(jù)延遲越大 return idx * 100; }也可以看該示例
series[i]-bar.animationDurationUpdate
柱狀圖數(shù)據(jù)更新動(dòng)畫的時(shí)長(zhǎng),類型為 number 或 Function ,默認(rèn)為 300。
支持回調(diào)函數(shù),可以通過每個(gè)數(shù)據(jù)返回不同的 delay 時(shí)間實(shí)現(xiàn)更戲劇的更新動(dòng)畫效果:
animationDurationUpdate: function (idx) { // 越往后的數(shù)據(jù)延遲越大 return idx * 100; }series[i]-bar.animationEasingUpdate
柱狀圖數(shù)據(jù)更新動(dòng)畫的緩動(dòng)效果,類型為 string,默認(rèn)值為 cubicOut。
series[i]-bar.animationDelayUpdate number, Function[ default: 0 ]
柱狀圖數(shù)據(jù)更新動(dòng)畫的延遲,支持回調(diào)函數(shù),類型為 number 或 Function ,默認(rèn)為 0,可以通過每個(gè)數(shù)據(jù)返回不同的 delay 時(shí)間實(shí)現(xiàn)更戲劇的更新動(dòng)畫效果。
如下示例:
animationDelayUpdate: function (idx) { // 越往后的數(shù)據(jù)延遲越大 return idx * 100; }也可以看該示例
文章標(biāo)題:創(chuàng)新互聯(lián)ECharts教程:ECharts柱狀圖基本屬性設(shè)置
當(dāng)前網(wǎng)址:http://fisionsoft.com.cn/article/dpgeced.html


咨詢
建站咨詢
