Debian Codegraph @

packages/popper/src/modifiers/arrow.js

raw
1 import getClientRect from '../utils/getClientRect';
2 import getOuterSizes from '../utils/getOuterSizes';
3 import isModifierRequired from '../utils/isModifierRequired';
4 import getStyleComputedProperty from '../utils/getStyleComputedProperty';
5
6 /**
7 * @function
8 * @memberof Modifiers
9 * @argument {Object} data - The data object generated by update method
10 * @argument {Object} options - Modifiers configuration and options
11 * @returns {Object} The data object, properly modified
12 */
13 export default function arrow(data, options) {
14 // arrow depends on keepTogether in order to work
15 if (!isModifierRequired(data.instance.modifiers, 'arrow', 'keepTogether')) {
16 return data;
17 }
18
19 let arrowElement = options.element;
20
21 // if arrowElement is a string, suppose it's a CSS selector
22 if (typeof arrowElement === 'string') {
23 arrowElement = data.instance.popper.querySelector(arrowElement);
24
25 // if arrowElement is not found, don't run the modifier
26 if (!arrowElement) {
27 return data;
28 }
29 } else {
30 // if the arrowElement isn't a query selector we must check that the
31 // provided DOM node is child of its popper node
32 if (!data.instance.popper.contains(arrowElement)) {
33 console.warn(
34 'WARNING: `arrow.element` must be child of its popper element!'
35 );
36 return data;
37 }
38 }
39
40 const placement = data.placement.split('-')[0];
41 const { popper, reference } = data.offsets;
42 const isVertical = ['left', 'right'].indexOf(placement) !== -1;
43
44 const len = isVertical ? 'height' : 'width';
45 const sideCapitalized = isVertical ? 'Top' : 'Left';
46 const side = sideCapitalized.toLowerCase();
47 const altSide = isVertical ? 'left' : 'top';
48 const opSide = isVertical ? 'bottom' : 'right';
49 const arrowElementSize = getOuterSizes(arrowElement)[len];
50
51 //
52 // extends keepTogether behavior making sure the popper and its
53 // reference have enough pixels in conjunction
54 //
55
56 // top/left side
57 if (reference[opSide] - arrowElementSize < popper[side]) {
58 data.offsets.popper[side] -=
59 popper[side] - (reference[opSide] - arrowElementSize);
60 }
61 // bottom/right side
62 if (reference[side] + arrowElementSize > popper[opSide]) {
63 data.offsets.popper[side] +=
64 reference[side] + arrowElementSize - popper[opSide];
65 }
66 data.offsets.popper = getClientRect(data.offsets.popper);
67
68 // compute center of the popper
69 const center = reference[side] + reference[len] / 2 - arrowElementSize / 2;
70
71 // Compute the sideValue using the updated popper offsets
72 // take popper margin in account because we don't have this info available
73 const css = getStyleComputedProperty(data.instance.popper);
74 const popperMarginSide = parseFloat(css[`margin${sideCapitalized}`]);
75 const popperBorderSide = parseFloat(css[`border${sideCapitalized}Width`]);
76 let sideValue =
77 center - data.offsets.popper[side] - popperMarginSide - popperBorderSide;
78
79 // prevent arrowElement from being placed not contiguously to its popper
80 sideValue = Math.max(Math.min(popper[len] - arrowElementSize, sideValue), 0);
81
82 data.arrowElement = arrowElement;
83 data.offsets.arrow = {
84 [side]: Math.round(sideValue),
85 [altSide]: '', // make sure to unset any eventual altSide value from the DOM node
86 };
87
88 return data;
89 }