Skip to content

Legend scroll fix #2426

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 6 commits into from
Mar 1, 2018
Merged
Show file tree
Hide file tree
Changes from 4 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion src/components/dragelement/index.js
Original file line number Diff line number Diff line change
Expand Up @@ -135,7 +135,7 @@ dragElement.init = function init(options) {
startY = offset[1];
initialTarget = e.target;
initialEvent = e;
rightClick = (e.buttons && e.buttons === 2) || e.ctrlKey;
rightClick = e.buttons === 2 || e.ctrlKey;

newMouseDownTime = (new Date()).getTime();
if(newMouseDownTime - gd._mouseDownTime < DBLCLICKDELAY) {
Expand Down
4 changes: 2 additions & 2 deletions src/components/legend/constants.js
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,8 @@
'use strict';

module.exports = {
scrollBarWidth: 4,
scrollBarHeight: 20,
scrollBarWidth: 6,
scrollBarMinHeight: 20,
scrollBarColor: '#808BA4',
scrollBarMargin: 4
};
75 changes: 41 additions & 34 deletions src/components/legend/draw.js
Original file line number Diff line number Diff line change
Expand Up @@ -94,10 +94,10 @@ module.exports = function draw(gd) {
scrollBar.enter().append('rect')
.attr({
'class': 'scrollbar',
'rx': 20,
'ry': 2,
'width': 0,
'height': 0
rx: 20,
ry: 3,
width: 0,
height: 0
})
.call(Color.fill, '#808BA4');

Expand Down Expand Up @@ -207,12 +207,9 @@ module.exports = function draw(gd) {
// legend, background and border, scroll box and scroll bar
Drawing.setTranslate(legend, lx, ly);

var scrollBarYMax = legendHeight -
constants.scrollBarHeight -
2 * constants.scrollBarMargin,
scrollBoxYMax = opts._height - legendHeight,
scrollBarY,
scrollBoxY;
// to be safe, remove previous listeners
scrollBar.on('.drag', null);
legend.on('wheel', null);

if(opts._height <= legendHeight || gd._context.staticPlot) {
// if scrollbar should not be shown.
Expand All @@ -233,10 +230,21 @@ module.exports = function draw(gd) {
});

scrollBox.call(Drawing.setClipUrl, clipId);

Drawing.setRect(scrollBar, 0, 0, 0, 0);
delete opts._scrollY;
}
else {
scrollBarY = constants.scrollBarMargin,
scrollBoxY = scrollBox.attr('data-scroll') || 0;
var scrollBarHeight = Math.max(constants.scrollBarMinHeight,
legendHeight * legendHeight / opts._height);
var scrollBarYMax = legendHeight -
scrollBarHeight -
2 * constants.scrollBarMargin;
var scrollBoxYMax = opts._height - legendHeight;
var scrollRatio = scrollBarYMax / scrollBoxYMax;

// scrollBoxY is 0 or a negative number
var scrollBoxY = Math.max(opts._scrollY || 0, -scrollBoxYMax);

// increase the background and clip-path width
// by the scrollbar width and margin
Expand All @@ -262,52 +270,51 @@ module.exports = function draw(gd) {

scrollBox.call(Drawing.setClipUrl, clipId);

if(firstRender) scrollHandler(scrollBarY, scrollBoxY);
scrollHandler(scrollBoxY, scrollBarHeight, scrollRatio);

legend.on('wheel', null); // to be safe, remove previous listeners
legend.on('wheel', function() {
scrollBoxY = Lib.constrain(
scrollBox.attr('data-scroll') -
opts._scrollY -
d3.event.deltaY / scrollBarYMax * scrollBoxYMax,
-scrollBoxYMax, 0);
scrollBarY = constants.scrollBarMargin -
scrollBoxY / scrollBoxYMax * scrollBarYMax;
scrollHandler(scrollBarY, scrollBoxY);
scrollHandler(scrollBoxY, scrollBarHeight, scrollRatio);
if(scrollBoxY !== 0 && scrollBoxY !== -scrollBoxYMax) {
d3.event.preventDefault();
}
});

// to be safe, remove previous listeners
scrollBar.on('.drag', null);
scrollBox.on('.drag', null);
var eventY0, scrollBoxY0;

var drag = d3.behavior.drag().on('drag', function() {
scrollBarY = Lib.constrain(
d3.event.y - constants.scrollBarHeight / 2,
constants.scrollBarMargin,
constants.scrollBarMargin + scrollBarYMax);
scrollBoxY = - (scrollBarY - constants.scrollBarMargin) /
scrollBarYMax * scrollBoxYMax;
scrollHandler(scrollBarY, scrollBoxY);
var drag = d3.behavior.drag()
.on('dragstart', function() {
eventY0 = d3.event.sourceEvent.clientY;
scrollBoxY0 = scrollBoxY;
})
.on('drag', function() {
var e = d3.event.sourceEvent;
if(e.buttons === 2 || e.ctrlKey) return;

scrollBoxY = Lib.constrain(
(eventY0 - e.clientY) / scrollRatio + scrollBoxY0,
-scrollBoxYMax, 0);
scrollHandler(scrollBoxY, scrollBarHeight, scrollRatio);
});

scrollBar.call(drag);
scrollBox.call(drag);
}


function scrollHandler(scrollBarY, scrollBoxY) {
function scrollHandler(scrollBoxY, scrollBarHeight, scrollRatio) {
opts._scrollY = gd._fullLayout.legend._scrollY = scrollBoxY;
scrollBox
.attr('data-scroll', scrollBoxY)
.call(Drawing.setTranslate, 0, scrollBoxY);

scrollBar.call(
Drawing.setRect,
legendWidth,
scrollBarY,
constants.scrollBarMargin - scrollBoxY * scrollRatio,
constants.scrollBarWidth,
constants.scrollBarHeight
scrollBarHeight
);
clipPath.select('rect').attr({
y: opts.borderwidth - scrollBoxY
Expand Down
185 changes: 165 additions & 20 deletions test/jasmine/tests/legend_scroll_test.js
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,9 @@ var DBLCLICKDELAY = require('@src/constants/interactions').DBLCLICKDELAY;
var d3 = require('d3');
var createGraph = require('../assets/create_graph_div');
var destroyGraph = require('../assets/destroy_graph_div');
var failTest = require('../assets/fail_test');
var getBBox = require('../assets/get_bbox');
var mouseEvent = require('../assets/mouse_event');
var mock = require('../../image/mocks/legend_scroll.json');

describe('The legend', function() {
Expand Down Expand Up @@ -47,6 +49,17 @@ describe('The legend', function() {
return d3.select('g.legend').select('.legendtoggle').node();
}

function getScroll(gd) {
return gd._fullLayout.legend._scrollY;
}

function hasScrollBar() {
var scrollBar = getScrollBar();
return scrollBar &&
+scrollBar.getAttribute('width') > 0 &&
+scrollBar.getAttribute('height') > 0;
}

describe('when plotted with many traces', function() {
var gd;

Expand Down Expand Up @@ -76,26 +89,153 @@ describe('The legend', function() {
});

it('should scroll when there\'s a wheel event', function() {
var legend = getLegend(),
scrollBox = getScrollBox(),
legendHeight = getLegendHeight(gd),
scrollBoxYMax = gd._fullLayout.legend._height - legendHeight,
scrollBarYMax = legendHeight -
constants.scrollBarHeight -
2 * constants.scrollBarMargin,
initialDataScroll = scrollBox.getAttribute('data-scroll'),
wheelDeltaY = 100,
finalDataScroll = '' + Lib.constrain(initialDataScroll -
wheelDeltaY / scrollBarYMax * scrollBoxYMax,
-scrollBoxYMax, 0);
var legend = getLegend();
var scrollBox = getScrollBox();
var scrollBar = getScrollBar();
var legendHeight = getLegendHeight(gd);
var scrollBoxYMax = gd._fullLayout.legend._height - legendHeight;
var scrollBarYMax = legendHeight -
scrollBar.getBoundingClientRect().height -
2 * constants.scrollBarMargin;
var initialDataScroll = getScroll(gd);
var wheelDeltaY = 100;
var finalDataScroll = Lib.constrain(initialDataScroll -
wheelDeltaY / scrollBarYMax * scrollBoxYMax,
-scrollBoxYMax, 0);

legend.dispatchEvent(scrollTo(wheelDeltaY));

expect(scrollBox.getAttribute('data-scroll')).toBe(finalDataScroll);
expect(getScroll(gd)).toBe(finalDataScroll);
expect(scrollBox.getAttribute('transform')).toBe(
'translate(0, ' + finalDataScroll + ')');
});

function dragScroll(element, rightClick) {
var scrollBar = getScrollBar();
var scrollBarBB = scrollBar.getBoundingClientRect();
var legendHeight = getLegendHeight(gd);
var scrollBoxYMax = gd._fullLayout.legend._height - legendHeight;
var scrollBarYMax = legendHeight -
scrollBarBB.height -
2 * constants.scrollBarMargin;
var initialDataScroll = getScroll(gd);
var dy = 50;
var finalDataScroll = Lib.constrain(initialDataScroll -
dy / scrollBarYMax * scrollBoxYMax,
-scrollBoxYMax, 0);

var y0 = scrollBarBB.top + scrollBarBB.height / 5;
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

notice that I moved the drag point away from the center of the scrollBar, thereby testing that it drags from where you grab it rather than snapping to the center.

var y1 = y0 + dy;

var elBB = element.getBoundingClientRect();
var x = elBB.left + elBB.width / 2;

var opts = {element: element};
if(rightClick) {
opts.button = 2;
opts.buttons = 2;
}

mouseEvent('mousedown', x, y0, opts);
mouseEvent('mousemove', x, y1, opts);
mouseEvent('mouseup', x, y1, opts);

expect(finalDataScroll).not.toBe(initialDataScroll);

return finalDataScroll;
}

it('should scroll on dragging the scrollbar', function() {
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are these general legend scrollbox tests and/or tests that 🔒 the fix for #2387? (I'm asking as I would be surprised if #2387 was reproducible in a jasmine test).

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, these do test #2387, if I'm interpreting it correctly. What I think was happening in #2387 is that somehow the scrollBox drag was being triggered - and that's what I decided (with no dissent) had no reason ever to happen. So this test shows that regular drag works, then the next one shows that the scrollBox won't drag even if it does somehow get the event, and then the third new test shows that right-click (the only form of #2387 I could reproduce on my own computer) even on the scrollBar will not trigger drag.

var finalDataScroll = dragScroll(getScrollBar());
var scrollBox = getScrollBox();

var dataScroll = getScroll(gd);
expect(dataScroll).toBeCloseTo(finalDataScroll, 3);
expect(scrollBox.getAttribute('transform')).toBe(
'translate(0, ' + dataScroll + ')');
});

it('should not scroll on dragging the scrollbox', function() {
var scrollBox = getScrollBox();
var finalDataScroll = dragScroll(scrollBox);

var dataScroll = getScroll(gd);
expect(dataScroll).not.toBeCloseTo(finalDataScroll, 3);
expect(scrollBox.getAttribute('transform')).toBe(
'translate(0, ' + dataScroll + ')');
});

it('should not scroll on dragging the scrollbar with a right click', function() {
var finalDataScroll = dragScroll(getScrollBar(), true);
var scrollBox = getScrollBox();

var dataScroll = getScroll(gd);
expect(dataScroll).not.toBeCloseTo(finalDataScroll, 3);
expect(scrollBox.getAttribute('transform')).toBe(
'translate(0, ' + dataScroll + ')');
});

it('removes scroll bar and handlers when switching to horizontal', function(done) {
expect(hasScrollBar()).toBe(true);

Plotly.relayout(gd, {'legend.orientation': 'h'})
.then(function() {
expect(hasScrollBar()).toBe(false);
expect(getScroll(gd)).toBeUndefined();

getLegend().dispatchEvent(scrollTo(100));
expect(hasScrollBar()).toBe(false);
expect(getScroll(gd)).toBeUndefined();

return Plotly.relayout(gd, {'legend.orientation': 'v'});
})
.then(function() {
expect(hasScrollBar()).toBe(true);
expect(getScroll(gd)).toBe(0);

getLegend().dispatchEvent(scrollTo(100));
expect(hasScrollBar()).toBe(true);
expect(getScroll(gd)).not.toBe(0);
})
.catch(failTest)
.then(done);
});

it('updates scrollBar size/existence on deleteTraces', function(done) {
expect(hasScrollBar()).toBe(true);
var dataScroll = dragScroll(getScrollBar());
var scrollBarHeight = getScrollBar().getBoundingClientRect().height;
var scrollBarHeight1;

Plotly.deleteTraces(gd, [0])
.then(function() {
expect(getScroll(gd)).toBeCloseTo(dataScroll, 3);
scrollBarHeight1 = getScrollBar().getBoundingClientRect().height;
expect(scrollBarHeight1).toBeGreaterThan(scrollBarHeight);

// we haven't quite removed the scrollbar, but we should have clipped the scroll value
return Plotly.deleteTraces(gd, [0, 1, 2, 3, 4, 5, 6, 7]);
})
.then(function() {
expect(getScroll(gd)).toBeGreaterThan(dataScroll + 1);
var scrollBarHeight2 = getScrollBar().getBoundingClientRect().height;
expect(scrollBarHeight2).toBeGreaterThan(scrollBarHeight1);

// now no more scrollBar
return Plotly.deleteTraces(gd, [0, 1]);
})
.then(function() {
expect(hasScrollBar()).toBe(false);
expect(getScroll(gd)).toBeUndefined();

getLegend().dispatchEvent(scrollTo(100));
expect(hasScrollBar()).toBe(false);
expect(getScroll(gd)).toBeUndefined();
})
.catch(failTest)
.then(done);
});

it('should keep the scrollbar position after a toggle event', function(done) {
var legend = getLegend(),
scrollBox = getScrollBox(),
Expand All @@ -104,12 +244,12 @@ describe('The legend', function() {

legend.dispatchEvent(scrollTo(wheelDeltaY));

var dataScroll = scrollBox.getAttribute('data-scroll');
var dataScroll = getScroll(gd);
toggle.dispatchEvent(new MouseEvent('mousedown'));
toggle.dispatchEvent(new MouseEvent('mouseup'));
setTimeout(function() {
expect(+toggle.parentNode.style.opacity).toBeLessThan(1);
expect(scrollBox.getAttribute('data-scroll')).toBe(dataScroll);
expect(getScroll(gd)).toBe(dataScroll);
expect(scrollBox.getAttribute('transform')).toBe(
'translate(0, ' + dataScroll + ')');
done();
Expand Down Expand Up @@ -142,12 +282,12 @@ describe('The legend', function() {
expect(scrollBar.getAttribute('x')).toBe(scrollBarX);
expect(scrollBar.getAttribute('y')).toBe(scrollBarY);

var dataScroll = scrollBox.getAttribute('data-scroll');
var dataScroll = getScroll(gd);
toggle.dispatchEvent(new MouseEvent('mousedown'));
toggle.dispatchEvent(new MouseEvent('mouseup'));
setTimeout(function() {
expect(+toggle.parentNode.style.opacity).toBeLessThan(1);
expect(scrollBox.getAttribute('data-scroll')).toBe(dataScroll);
expect(getScroll(gd)).toBe(dataScroll);
expect(scrollBox.getAttribute('transform')).toBe(
'translate(0, ' + dataScroll + ')');
expect(scrollBar.getAttribute('width')).toBeGreaterThan(0);
Expand All @@ -172,13 +312,18 @@ describe('The legend', function() {
scrollBar = getScrollBar(),
legendHeight = getLegendHeight(gd);

// The scrollbar is 20px tall and has 4px margins
// The scrollbar is >20px tall and has 4px margins
var scrollBarHeight = scrollBar.getBoundingClientRect().height;
// in this mock there are 22 traces, and 13 are visible in the legend
// at any given time
expect(scrollBarHeight).toBeCloseTo(legendHeight * 13 / 22, -1);

legend.dispatchEvent(scrollTo(-1000));
expect(+scrollBar.getAttribute('y')).toBe(4);
expect(+scrollBar.getAttribute('y')).toBeCloseTo(4, 3);

legend.dispatchEvent(scrollTo(10000));
expect(+scrollBar.getAttribute('y')).toBe(legendHeight - 4 - 20);
expect(+scrollBar.getAttribute('y'))
.toBeCloseTo(legendHeight - 4 - scrollBarHeight, 3);
});

it('should be removed from DOM when \'showlegend\' is relayout\'ed to false', function(done) {
Expand Down