Skip to content

Commit dc58b26

Browse files
my-tienmy-tien
committed
New axis prop zerolinelayer with values "below traces" (default) and "above traces"
1 parent 85e3f73 commit dc58b26

File tree

7 files changed

+165
-3
lines changed

7 files changed

+165
-3
lines changed

‎src/plots/cartesian/axes.js

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2365,6 +2365,7 @@ axes.draw = function(gd, arg, opts) {
23652365
if(plotinfo.minorGridlayer) plotinfo.minorGridlayer.selectAll('path').remove();
23662366
if(plotinfo.gridlayer) plotinfo.gridlayer.selectAll('path').remove();
23672367
if(plotinfo.zerolinelayer) plotinfo.zerolinelayer.selectAll('path').remove();
2368+
if(plotinfo.zerolinelayerAbove) plotinfo.zerolinelayerAbove.selectAll('path').remove();
23682369

23692370
fullLayout._infolayer.select('.g-' + xa._id + 'title').remove();
23702371
fullLayout._infolayer.select('.g-' + ya._id + 'title').remove();
@@ -2462,6 +2463,7 @@ axes.drawOne = function(gd, ax, opts) {
24622463
var axLetter = axId.charAt(0);
24632464
var counterLetter = axes.counterLetter(axId);
24642465
var mainPlotinfo = fullLayout._plots[ax._mainSubplot];
2466+
var zerolineIsAbove = ax.zerolinelayer === 'above traces';
24652467

24662468
// this happens when updating matched group with 'missing' axes
24672469
if(!mainPlotinfo) return;
@@ -2576,7 +2578,7 @@ axes.drawOne = function(gd, ax, opts) {
25762578
});
25772579
axes.drawZeroLine(gd, ax, {
25782580
counterAxis: counterAxis,
2579-
layer: plotinfo.zerolinelayer,
2581+
layer: zerolineIsAbove ? plotinfo.zerolinelayerAbove : plotinfo.zerolinelayer,
25802582
path: gridPath,
25812583
transFn: transTickFn
25822584
});
@@ -3555,6 +3557,7 @@ axes.drawLabels = function(gd, ax, opts) {
35553557

35563558
var fullLayout = gd._fullLayout;
35573559
var axId = ax._id;
3560+
var zerolineIsAbove = ax.zerolinelayer === 'above traces';
35583561
var cls = opts.cls || axId + 'tick';
35593562

35603563
var vals = opts.vals.filter(function(d) { return d.text; });
@@ -3763,8 +3766,10 @@ axes.drawLabels = function(gd, ax, opts) {
37633766
var mainPlotinfo = fullLayout._plots[ax._mainSubplot];
37643767

37653768
var sel;
3766-
if(e.K === ZERO_PATH.K) sel = mainPlotinfo.zerolinelayer.selectAll('.' + ax._id + 'zl');
3767-
else if(e.K === MINORGRID_PATH.K) sel = mainPlotinfo.minorGridlayer.selectAll('.' + ax._id);
3769+
if(e.K === ZERO_PATH.K) {
3770+
var zerolineLayer = zerolineIsAbove ? mainPlotinfo.zerolinelayerAbove : mainPlotinfo.zerolinelayer;
3771+
sel = zerolineLayer.selectAll('.' + ax._id + 'zl');
3772+
} else if(e.K === MINORGRID_PATH.K) sel = mainPlotinfo.minorGridlayer.selectAll('.' + ax._id);
37683773
else if(e.K === GRID_PATH.K) sel = mainPlotinfo.gridlayer.selectAll('.' + ax._id);
37693774
else sel = mainPlotinfo[ax._id.charAt(0) + 'axislayer'];
37703775

‎src/plots/cartesian/index.js

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -614,6 +614,12 @@ function makeSubplotLayer(gd, plotinfo) {
614614
plotinfo.overplot = ensureSingle(plotgroup, 'g', 'overplot');
615615
plotinfo.plot = ensureSingle(plotinfo.overplot, 'g', id);
616616

617+
if(mainplotinfo && hasMultipleZ) {
618+
plotinfo.zerolinelayerAbove = mainplotinfo.zerolinelayerAbove;
619+
} else {
620+
plotinfo.zerolinelayerAbove = ensureSingle(plotgroup, 'g', 'zerolinelayer-above');
621+
}
622+
617623
if(!hasZ) {
618624
plotinfo.xlines = ensureSingle(plotgroup, 'path', 'xlines-above');
619625
plotinfo.ylines = ensureSingle(plotgroup, 'path', 'ylines-above');
@@ -643,6 +649,7 @@ function makeSubplotLayer(gd, plotinfo) {
643649
plotinfo.minorGridlayer = mainplotinfo.minorGridlayer;
644650
plotinfo.gridlayer = mainplotinfo.gridlayer;
645651
plotinfo.zerolinelayer = mainplotinfo.zerolinelayer;
652+
plotinfo.zerolinelayerAbove = mainplotinfo.zerolinelayerAbove;
646653

647654
ensureSingle(mainplotinfo.overlinesBelow, 'path', xId);
648655
ensureSingle(mainplotinfo.overlinesBelow, 'path', yId);

‎src/plots/cartesian/layout_attributes.js

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1016,6 +1016,18 @@ module.exports = {
10161016
editType: 'ticks',
10171017
description: 'Sets the line color of the zero line.'
10181018
},
1019+
zerolinelayer: {
1020+
valType: 'enumerated',
1021+
values: ['above traces', 'below traces'],
1022+
dflt: 'below traces',
1023+
editType: 'plot',
1024+
description: [
1025+
'Sets the layer on which this zeroline is displayed.',
1026+
'If *above traces*, this zeroline is displayed above all the subplot\'s traces',
1027+
'If *below traces*, this zeroline is displayed below all the subplot\'s traces,',
1028+
'but above the grid lines.'
1029+
].join(' ')
1030+
},
10191031
zerolinewidth: {
10201032
valType: 'number',
10211033
dflt: 1,

‎src/plots/cartesian/line_grid_defaults.js

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -67,11 +67,13 @@ module.exports = function handleLineGridDefaults(containerIn, containerOut, coer
6767
}
6868

6969
if(!opts.noZeroLine) {
70+
var zeroLineLayer = coerce2('zerolinelayer');
7071
var zeroLineColor = coerce2('zerolinecolor', dfltColor);
7172
var zeroLineWidth = coerce2('zerolinewidth');
7273
var showZeroLine = coerce('zeroline', opts.showGrid || !!zeroLineColor || !!zeroLineWidth);
7374

7475
if(!showZeroLine) {
76+
delete containerOut.zerolineLayer;
7577
delete containerOut.zerolinecolor;
7678
delete containerOut.zerolinewidth;
7779
}

‎test/image/mocks/zzz_zerolinelayer_above.json

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
{
2+
"data": [
3+
{
4+
"type": "bar",
5+
"x": [-1, 0, 2, 3],
6+
"y": [-1, 2, -3, 4],
7+
"name": "xy"
8+
},
9+
{
10+
"line": {
11+
"width": 10
12+
},
13+
"mode": "lines",
14+
"x": [-1, 0, 2, 3],
15+
"y": [-3, 1, -1, 2],
16+
"xaxis": "x2",
17+
"yaxis": "y2",
18+
"name": "x2y2"
19+
}
20+
],
21+
"layout": {
22+
"title": {
23+
"text": "All zerolines above traces (x/x2: pink, y/y2: black)"
24+
},
25+
"width": 600,
26+
"height": 400,
27+
"xaxis": {
28+
"zeroline": true,
29+
"zerolinewidth": 5,
30+
"zerolinecolor": "pink",
31+
"zerolinelayer": "above traces"
32+
},
33+
"xaxis2": {
34+
"overlaying": "x",
35+
"zeroline": true,
36+
"zerolinewidth": 5,
37+
"zerolinecolor": "pink",
38+
"zerolinelayer": "above traces",
39+
"side": "top"
40+
},
41+
"yaxis": {
42+
"zeroline": true,
43+
"zerolinewidth": 5,
44+
"zerolinecolor": "black",
45+
"zerolinelayer": "above traces",
46+
"range": [-1, 4]
47+
},
48+
"yaxis2": {
49+
"zeroline": true,
50+
"zerolinewidth": 5,
51+
"zerolinecolor": "black",
52+
"zerolinelayer": "above traces",
53+
"range": [-3, 2],
54+
"overlaying": "y",
55+
"side": "right"
56+
}
57+
}
58+
}

‎test/image/mocks/zzz_zerolinelayer_below.json

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
{
2+
"data": [
3+
{
4+
"type": "bar",
5+
"x": [-1, 0, 2, 3],
6+
"y": [-1, 2, -3, 4],
7+
"name": "xy"
8+
},
9+
{
10+
"line": {
11+
"width": 10
12+
},
13+
"mode": "lines",
14+
"x": [-1, 0, 2, 3],
15+
"y": [-3, 1, -1, 2],
16+
"xaxis": "x2",
17+
"yaxis": "y2",
18+
"name": "x2y2"
19+
}
20+
],
21+
"layout": {
22+
"title": {
23+
"text": "All zerolines below traces (x/x2: pink, y/y2: black)"
24+
},
25+
"width": 600,
26+
"height": 400,
27+
"xaxis": {
28+
"zeroline": true,
29+
"zerolinewidth": 5,
30+
"zerolinecolor": "pink",
31+
"zerolinelayer": "below traces"
32+
},
33+
"xaxis2": {
34+
"overlaying": "x",
35+
"zeroline": true,
36+
"zerolinewidth": 5,
37+
"zerolinecolor": "pink",
38+
"zerolinelayer": "below traces",
39+
"side": "top"
40+
},
41+
"yaxis": {
42+
"zeroline": true,
43+
"zerolinewidth": 5,
44+
"zerolinecolor": "black",
45+
"zerolinelayer": "below traces",
46+
"range": [-1, 4]
47+
},
48+
"yaxis2": {
49+
"zeroline": true,
50+
"zerolinewidth": 5,
51+
"zerolinecolor": "black",
52+
"zerolinelayer": "below traces",
53+
"range": [-3, 2],
54+
"overlaying": "y",
55+
"side": "right"
56+
}
57+
}
58+
}

‎test/plot-schema.json

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14959,6 +14959,16 @@
1495914959
"editType": "ticks",
1496014960
"valType": "color"
1496114961
},
14962+
"zerolinelayer": {
14963+
"description": "Sets the layer on which this zeroline is displayed. If *above traces*, this zeroline is displayed above all the subplot's traces If *below traces*, this zeroline is displayed below all the subplot's traces, but above the grid lines.",
14964+
"dflt": "below traces",
14965+
"editType": "plot",
14966+
"valType": "enumerated",
14967+
"values": [
14968+
"above traces",
14969+
"below traces"
14970+
]
14971+
},
1496214972
"zerolinewidth": {
1496314973
"description": "Sets the width (in px) of the zero line.",
1496414974
"dflt": 1,
@@ -16193,6 +16203,16 @@
1619316203
"editType": "ticks",
1619416204
"valType": "color"
1619516205
},
16206+
"zerolinelayer": {
16207+
"description": "Sets the layer on which this zeroline is displayed. If *above traces*, this zeroline is displayed above all the subplot's traces If *below traces*, this zeroline is displayed below all the subplot's traces, but above the grid lines.",
16208+
"dflt": "below traces",
16209+
"editType": "plot",
16210+
"valType": "enumerated",
16211+
"values": [
16212+
"above traces",
16213+
"below traces"
16214+
]
16215+
},
1619616216
"zerolinewidth": {
1619716217
"description": "Sets the width (in px) of the zero line.",
1619816218
"dflt": 1,

0 commit comments

Comments
 (0)