@fluentui/react-positioning 0.0.0-nightly0e0cf06c3420211029.1 → 0.0.0-nightly554221a5aa20211202.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (68) hide show
  1. package/CHANGELOG.json +114 -8
  2. package/CHANGELOG.md +35 -7
  3. package/dist/react-positioning.d.ts +28 -0
  4. package/lib/createArrowStyles.d.ts +27 -0
  5. package/lib/createArrowStyles.js +73 -0
  6. package/lib/createArrowStyles.js.map +1 -0
  7. package/lib/createVirtualElementFromClick.js +17 -15
  8. package/lib/createVirtualElementFromClick.js.map +1 -1
  9. package/lib/index.d.ts +2 -1
  10. package/lib/index.js +2 -1
  11. package/lib/index.js.map +1 -1
  12. package/lib/usePopper.js +363 -320
  13. package/lib/usePopper.js.map +1 -1
  14. package/lib/usePopperMouseTarget.js +28 -22
  15. package/lib/usePopperMouseTarget.js.map +1 -1
  16. package/lib/utils/getBasePlacement.js +1 -1
  17. package/lib/utils/getBasePlacement.js.map +1 -1
  18. package/lib/utils/getBoundary.js +15 -10
  19. package/lib/utils/getBoundary.js.map +1 -1
  20. package/lib/utils/getReactFiberFromNode.d.ts +0 -1
  21. package/lib/utils/getReactFiberFromNode.js +39 -35
  22. package/lib/utils/getReactFiberFromNode.js.map +1 -1
  23. package/lib/utils/getScrollParent.js +46 -32
  24. package/lib/utils/getScrollParent.js.map +1 -1
  25. package/lib/utils/mergeArrowOffset.js +30 -25
  26. package/lib/utils/mergeArrowOffset.js.map +1 -1
  27. package/lib/utils/positioningHelper.d.ts +1 -1
  28. package/lib/utils/positioningHelper.js +42 -34
  29. package/lib/utils/positioningHelper.js.map +1 -1
  30. package/lib/utils/resolvePositioningShorthand.js +58 -20
  31. package/lib/utils/resolvePositioningShorthand.js.map +1 -1
  32. package/lib/utils/useCallbackRef.js +35 -29
  33. package/lib/utils/useCallbackRef.js.map +1 -1
  34. package/lib-commonjs/createArrowStyles.d.ts +27 -0
  35. package/lib-commonjs/createArrowStyles.js +83 -0
  36. package/lib-commonjs/createArrowStyles.js.map +1 -0
  37. package/lib-commonjs/createVirtualElementFromClick.js +23 -16
  38. package/lib-commonjs/createVirtualElementFromClick.js.map +1 -1
  39. package/lib-commonjs/index.d.ts +2 -1
  40. package/lib-commonjs/index.js +28 -6
  41. package/lib-commonjs/index.js.map +1 -1
  42. package/lib-commonjs/types.js +4 -1
  43. package/lib-commonjs/types.js.map +1 -1
  44. package/lib-commonjs/usePopper.js +377 -324
  45. package/lib-commonjs/usePopper.js.map +1 -1
  46. package/lib-commonjs/usePopperMouseTarget.js +38 -25
  47. package/lib-commonjs/usePopperMouseTarget.js.map +1 -1
  48. package/lib-commonjs/utils/getBasePlacement.js +7 -2
  49. package/lib-commonjs/utils/getBasePlacement.js.map +1 -1
  50. package/lib-commonjs/utils/getBoundary.js +23 -12
  51. package/lib-commonjs/utils/getBoundary.js.map +1 -1
  52. package/lib-commonjs/utils/getReactFiberFromNode.d.ts +0 -1
  53. package/lib-commonjs/utils/getReactFiberFromNode.js +44 -36
  54. package/lib-commonjs/utils/getReactFiberFromNode.js.map +1 -1
  55. package/lib-commonjs/utils/getScrollParent.js +53 -33
  56. package/lib-commonjs/utils/getScrollParent.js.map +1 -1
  57. package/lib-commonjs/utils/index.js +14 -2
  58. package/lib-commonjs/utils/index.js.map +1 -1
  59. package/lib-commonjs/utils/mergeArrowOffset.js +36 -26
  60. package/lib-commonjs/utils/mergeArrowOffset.js.map +1 -1
  61. package/lib-commonjs/utils/positioningHelper.d.ts +1 -1
  62. package/lib-commonjs/utils/positioningHelper.js +50 -35
  63. package/lib-commonjs/utils/positioningHelper.js.map +1 -1
  64. package/lib-commonjs/utils/resolvePositioningShorthand.js +66 -23
  65. package/lib-commonjs/utils/resolvePositioningShorthand.js.map +1 -1
  66. package/lib-commonjs/utils/useCallbackRef.js +45 -32
  67. package/lib-commonjs/utils/useCallbackRef.js.map +1 -1
  68. package/package.json +8 -8
@@ -1,32 +1,43 @@
1
1
  "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
3
6
  exports.usePopper = void 0;
4
- var react_utilities_1 = require("@fluentui/react-utilities");
5
- var react_shared_contexts_1 = require("@fluentui/react-shared-contexts");
6
- var index_1 = require("./utils/index");
7
- var PopperJs = require("@popperjs/core");
8
- var React = require("react");
9
- //
7
+
8
+ const react_utilities_1 = /*#__PURE__*/require("@fluentui/react-utilities");
9
+
10
+ const react_shared_contexts_1 = /*#__PURE__*/require("@fluentui/react-shared-contexts");
11
+
12
+ const index_1 = /*#__PURE__*/require("./utils/index");
13
+
14
+ const PopperJs = /*#__PURE__*/require("@popperjs/core");
15
+
16
+ const React = /*#__PURE__*/require("react"); //
10
17
  // Dev utils to detect if nodes have "autoFocus" props.
11
18
  //
19
+
12
20
  /**
13
21
  * Detects if a passed HTML node has "autoFocus" prop on a React's fiber. Is needed as React handles autofocus behavior
14
22
  * in React DOM and will not pass "autoFocus" to an actual HTML.
15
23
  */
24
+
25
+
16
26
  function hasAutofocusProp(node) {
17
- var _a;
18
- // https://github.com/facebook/react/blob/848bb2426e44606e0a55dfe44c7b3ece33772485/packages/react-dom/src/client/ReactDOMHostConfig.js#L157-L166
19
- var isAutoFocusableElement = node.nodeName === 'BUTTON' ||
20
- node.nodeName === 'INPUT' ||
21
- node.nodeName === 'SELECT' ||
22
- node.nodeName === 'TEXTAREA';
23
- if (isAutoFocusableElement) {
24
- return !!((_a = index_1.getReactFiberFromNode(node)) === null || _a === void 0 ? void 0 : _a.pendingProps.autoFocus);
25
- }
26
- return false;
27
+ var _a; // https://github.com/facebook/react/blob/848bb2426e44606e0a55dfe44c7b3ece33772485/packages/react-dom/src/client/ReactDOMHostConfig.js#L157-L166
28
+
29
+
30
+ const isAutoFocusableElement = node.nodeName === 'BUTTON' || node.nodeName === 'INPUT' || node.nodeName === 'SELECT' || node.nodeName === 'TEXTAREA';
31
+
32
+ if (isAutoFocusableElement) {
33
+ return !!((_a = index_1.getReactFiberFromNode(node)) === null || _a === void 0 ? void 0 : _a.pendingProps.autoFocus);
34
+ }
35
+
36
+ return false;
27
37
  }
38
+
28
39
  function hasAutofocusFilter(node) {
29
- return hasAutofocusProp(node) ? NodeFilter.FILTER_ACCEPT : NodeFilter.FILTER_SKIP;
40
+ return hasAutofocusProp(node) ? NodeFilter.FILTER_ACCEPT : NodeFilter.FILTER_SKIP;
30
41
  }
31
42
  /**
32
43
  * Provides a callback to resolve Popper options, it's stable and should be used as a dependency to trigger updates
@@ -35,194 +46,230 @@ function hasAutofocusFilter(node) {
35
46
  * A callback is used there intentionally as some of Popper.js modifiers require DOM nodes (targer, container, arrow)
36
47
  * that can't be resolved properly during an initial rendering.
37
48
  */
49
+
50
+
38
51
  function usePopperOptions(options, popperOriginalPositionRef) {
39
- var arrowPadding = options.arrowPadding, autoSize = options.autoSize, coverTarget = options.coverTarget, flipBoundary = options.flipBoundary, offset = options.offset, onStateUpdate = options.onStateUpdate, overflowBoundary = options.overflowBoundary,
52
+ const {
53
+ arrowPadding,
54
+ autoSize,
55
+ coverTarget,
56
+ flipBoundary,
57
+ offset,
58
+ onStateUpdate,
59
+ overflowBoundary,
40
60
  // eslint-disable-next-line @typescript-eslint/naming-convention
41
- unstable_disableTether = options.unstable_disableTether, pinned = options.pinned;
42
- var isRtl = react_shared_contexts_1.useFluent().dir === 'rtl';
43
- var placement = index_1.getPlacement(options.align, options.position, isRtl);
44
- var strategy = options.positionFixed ? 'fixed' : 'absolute';
45
- var handleStateUpdate = react_utilities_1.useEventCallback(function (_a) {
46
- var state = _a.state;
47
- if (onStateUpdate) {
48
- onStateUpdate(state);
61
+ unstable_disableTether,
62
+ pinned
63
+ } = options;
64
+ const isRtl = react_shared_contexts_1.useFluent().dir === 'rtl';
65
+ const placement = index_1.getPlacement(options.align, options.position, isRtl);
66
+ const strategy = options.positionFixed ? 'fixed' : 'absolute';
67
+ const handleStateUpdate = react_utilities_1.useEventCallback(({
68
+ state
69
+ }) => {
70
+ if (onStateUpdate) {
71
+ onStateUpdate(state);
72
+ }
73
+ });
74
+ const offsetModifier = React.useMemo(() => offset ? {
75
+ name: 'offset',
76
+ options: {
77
+ offset: isRtl ? index_1.applyRtlToOffset(offset) : offset
78
+ }
79
+ } : null, [offset, isRtl]);
80
+ return React.useCallback((target, container, arrow) => {
81
+ var _a;
82
+
83
+ const scrollParentElement = index_1.getScrollParent(container);
84
+ const hasScrollableElement = scrollParentElement ? scrollParentElement !== ((_a = scrollParentElement.ownerDocument) === null || _a === void 0 ? void 0 : _a.body) : false;
85
+ const modifiers = [
86
+ /**
87
+ * We are setting the position to `fixed` in the first effect to prevent scroll jumps in case of the content
88
+ * with managed focus. Modifier sets the position to `fixed` before all other modifier effects. Another part of
89
+ * a patch modifies ".forceUpdate()" directly after a Popper will be created.
90
+ */
91
+ {
92
+ name: 'positionStyleFix',
93
+ enabled: true,
94
+ phase: 'afterWrite',
95
+ effect: ({
96
+ state,
97
+ instance
98
+ }) => {
99
+ // ".isFirstRun" is a part of our patch, on a first evaluation it will "undefined"
100
+ // should be disabled for subsequent runs as it breaks positioning for them
101
+ if (instance.isFirstRun !== false) {
102
+ popperOriginalPositionRef.current = state.elements.popper.style.position;
103
+ state.elements.popper.style.position = 'fixed';
49
104
  }
50
- });
51
- var offsetModifier = React.useMemo(function () {
52
- return offset
53
- ? {
54
- name: 'offset',
55
- options: { offset: isRtl ? index_1.applyRtlToOffset(offset) : offset },
56
- }
57
- : null;
58
- }, [offset, isRtl]);
59
- return React.useCallback(function (target, container, arrow) {
60
- var _a;
61
- var scrollParentElement = index_1.getScrollParent(container);
62
- var hasScrollableElement = scrollParentElement
63
- ? scrollParentElement !== ((_a = scrollParentElement.ownerDocument) === null || _a === void 0 ? void 0 : _a.body)
64
- : false;
65
- var modifiers = [
66
- /**
67
- * We are setting the position to `fixed` in the first effect to prevent scroll jumps in case of the content
68
- * with managed focus. Modifier sets the position to `fixed` before all other modifier effects. Another part of
69
- * a patch modifies ".forceUpdate()" directly after a Popper will be created.
70
- */
71
- {
72
- name: 'positionStyleFix',
73
- enabled: true,
74
- phase: 'afterWrite',
75
- effect: function (_a) {
76
- var state = _a.state, instance = _a.instance;
77
- // ".isFirstRun" is a part of our patch, on a first evaluation it will "undefined"
78
- // should be disabled for subsequent runs as it breaks positioning for them
79
- if (instance.isFirstRun !== false) {
80
- popperOriginalPositionRef.current = state.elements.popper.style.position;
81
- state.elements.popper.style.position = 'fixed';
82
- }
83
- return function () { return undefined; };
84
- },
85
- requires: [],
86
- },
87
- { name: 'flip', options: { flipVariations: true } },
88
- /**
89
- * pinned disables the flip modifier by setting flip.enabled to false; this
90
- * disables automatic repositioning of the popper box; it will always be placed according to
91
- * the values of `align` and `position` props, regardless of the size of the component, the
92
- * reference element or the viewport.
93
- */
94
- pinned && { name: 'flip', enabled: false },
95
- /**
96
- * When the popper box is placed in the context of a scrollable element, we need to set
97
- * preventOverflow.escapeWithReference to true and flip.boundariesElement to 'scrollParent'
98
- * (default is 'viewport') so that the popper box will stick with the targetRef when we
99
- * scroll targetRef out of the viewport.
100
- */
101
- hasScrollableElement && { name: 'flip', options: { boundary: 'clippingParents' } },
102
- hasScrollableElement && { name: 'preventOverflow', options: { boundary: 'clippingParents' } },
103
- offsetModifier,
104
- /**
105
- * This modifier is necessary to retain behaviour from popper v1 where untethered poppers are allowed by
106
- * default. i.e. popper is still rendered fully in the viewport even if anchor element is no longer in the
107
- * viewport.
108
- */
109
- unstable_disableTether && {
110
- name: 'preventOverflow',
111
- options: { altAxis: unstable_disableTether === 'all', tether: false },
112
- },
113
- flipBoundary && {
114
- name: 'flip',
115
- options: {
116
- altBoundary: true,
117
- boundary: index_1.getBoundary(container, flipBoundary),
118
- },
119
- },
120
- overflowBoundary && {
121
- name: 'preventOverflow',
122
- options: {
123
- altBoundary: true,
124
- boundary: index_1.getBoundary(container, overflowBoundary),
125
- },
126
- },
127
- {
128
- name: 'onUpdate',
129
- enabled: true,
130
- phase: 'afterWrite',
131
- fn: handleStateUpdate,
132
- },
133
- {
134
- // Similar code as popper-maxsize-modifier: https://github.com/atomiks/popper.js/blob/master/src/modifiers/maxSize.js
135
- // popper-maxsize-modifier only calculates the max sizes.
136
- // This modifier can apply max sizes always, or apply the max sizes only when overflow is detected
137
- name: 'applyMaxSize',
138
- enabled: !!autoSize,
139
- phase: 'beforeWrite',
140
- requiresIfExists: ['offset', 'preventOverflow', 'flip'],
141
- options: {
142
- altBoundary: true,
143
- boundary: index_1.getBoundary(container, overflowBoundary),
144
- },
145
- fn: function (_a) {
146
- var state = _a.state, modifierOptions = _a.options;
147
- var overflow = PopperJs.detectOverflow(state, modifierOptions);
148
- var _b = state.modifiersData.preventOverflow || { x: 0, y: 0 }, x = _b.x, y = _b.y;
149
- var _c = state.rects.popper, width = _c.width, height = _c.height;
150
- var basePlacement = index_1.getBasePlacement(state.placement);
151
- var widthProp = basePlacement === 'left' ? 'left' : 'right';
152
- var heightProp = basePlacement === 'top' ? 'top' : 'bottom';
153
- var applyMaxWidth = autoSize === 'always' ||
154
- autoSize === 'width-always' ||
155
- (overflow[widthProp] > 0 && (autoSize === true || autoSize === 'width'));
156
- var applyMaxHeight = autoSize === 'always' ||
157
- autoSize === 'height-always' ||
158
- (overflow[heightProp] > 0 && (autoSize === true || autoSize === 'height'));
159
- if (applyMaxWidth) {
160
- state.styles.popper.maxWidth = width - overflow[widthProp] - x + "px";
161
- }
162
- if (applyMaxHeight) {
163
- state.styles.popper.maxHeight = height - overflow[heightProp] - y + "px";
164
- }
165
- },
166
- },
167
- /**
168
- * This modifier is necessary in order to render the pointer. Refs are resolved in effects, so it can't be
169
- * placed under computed modifiers. Deep merge is not required as this modifier has only these properties.
170
- */
171
- {
172
- name: 'arrow',
173
- enabled: !!arrow,
174
- options: { element: arrow, padding: arrowPadding },
175
- },
176
- /**
177
- * Modifies popper offsets to cover the reference rect, but still keep edge alignment
178
- */
179
- {
180
- name: 'coverTarget',
181
- enabled: !!coverTarget,
182
- phase: 'main',
183
- requiresIfExists: ['offset', 'preventOverflow', 'flip'],
184
- fn: function (_a) {
185
- var state = _a.state;
186
- var basePlacement = index_1.getBasePlacement(state.placement);
187
- switch (basePlacement) {
188
- case 'bottom':
189
- state.modifiersData.popperOffsets.y -= state.rects.reference.height;
190
- break;
191
- case 'top':
192
- state.modifiersData.popperOffsets.y += state.rects.reference.height;
193
- break;
194
- case 'left':
195
- state.modifiersData.popperOffsets.x += state.rects.reference.width;
196
- break;
197
- case 'right':
198
- state.modifiersData.popperOffsets.x -= state.rects.reference.width;
199
- break;
200
- }
201
- },
202
- },
203
- ].filter(Boolean); // filter boolean conditional spreading values
204
- var popperOptions = {
205
- modifiers: modifiers,
206
- placement: placement,
207
- strategy: strategy,
208
- onFirstUpdate: function (state) { return handleStateUpdate({ state: state }); },
105
+
106
+ return () => undefined;
107
+ },
108
+ requires: []
109
+ }, {
110
+ name: 'flip',
111
+ options: {
112
+ flipVariations: true
113
+ }
114
+ },
115
+ /**
116
+ * pinned disables the flip modifier by setting flip.enabled to false; this
117
+ * disables automatic repositioning of the popper box; it will always be placed according to
118
+ * the values of `align` and `position` props, regardless of the size of the component, the
119
+ * reference element or the viewport.
120
+ */
121
+ pinned && {
122
+ name: 'flip',
123
+ enabled: false
124
+ },
125
+ /**
126
+ * When the popper box is placed in the context of a scrollable element, we need to set
127
+ * preventOverflow.escapeWithReference to true and flip.boundariesElement to 'scrollParent'
128
+ * (default is 'viewport') so that the popper box will stick with the targetRef when we
129
+ * scroll targetRef out of the viewport.
130
+ */
131
+ hasScrollableElement && {
132
+ name: 'flip',
133
+ options: {
134
+ boundary: 'clippingParents'
135
+ }
136
+ }, hasScrollableElement && {
137
+ name: 'preventOverflow',
138
+ options: {
139
+ boundary: 'clippingParents'
140
+ }
141
+ }, offsetModifier,
142
+ /**
143
+ * This modifier is necessary to retain behaviour from popper v1 where untethered poppers are allowed by
144
+ * default. i.e. popper is still rendered fully in the viewport even if anchor element is no longer in the
145
+ * viewport.
146
+ */
147
+ unstable_disableTether && {
148
+ name: 'preventOverflow',
149
+ options: {
150
+ altAxis: unstable_disableTether === 'all',
151
+ tether: false
152
+ }
153
+ }, flipBoundary && {
154
+ name: 'flip',
155
+ options: {
156
+ altBoundary: true,
157
+ boundary: index_1.getBoundary(container, flipBoundary)
158
+ }
159
+ }, overflowBoundary && {
160
+ name: 'preventOverflow',
161
+ options: {
162
+ altBoundary: true,
163
+ boundary: index_1.getBoundary(container, overflowBoundary)
164
+ }
165
+ }, {
166
+ name: 'onUpdate',
167
+ enabled: true,
168
+ phase: 'afterWrite',
169
+ fn: handleStateUpdate
170
+ }, {
171
+ // Similar code as popper-maxsize-modifier: https://github.com/atomiks/popper.js/blob/master/src/modifiers/maxSize.js
172
+ // popper-maxsize-modifier only calculates the max sizes.
173
+ // This modifier can apply max sizes always, or apply the max sizes only when overflow is detected
174
+ name: 'applyMaxSize',
175
+ enabled: !!autoSize,
176
+ phase: 'beforeWrite',
177
+ requiresIfExists: ['offset', 'preventOverflow', 'flip'],
178
+ options: {
179
+ altBoundary: true,
180
+ boundary: index_1.getBoundary(container, overflowBoundary)
181
+ },
182
+
183
+ fn({
184
+ state,
185
+ options: modifierOptions
186
+ }) {
187
+ const overflow = PopperJs.detectOverflow(state, modifierOptions);
188
+ const {
189
+ x,
190
+ y
191
+ } = state.modifiersData.preventOverflow || {
192
+ x: 0,
193
+ y: 0
209
194
  };
210
- return popperOptions;
211
- }, [
212
- arrowPadding,
213
- autoSize,
214
- coverTarget,
215
- flipBoundary,
216
- offsetModifier,
217
- overflowBoundary,
218
- placement,
219
- strategy,
220
- unstable_disableTether,
221
- pinned,
222
- // These can be skipped from deps as they will not ever change
223
- handleStateUpdate,
224
- popperOriginalPositionRef,
225
- ]);
195
+ const {
196
+ width,
197
+ height
198
+ } = state.rects.popper;
199
+ const basePlacement = index_1.getBasePlacement(state.placement);
200
+ const widthProp = basePlacement === 'left' ? 'left' : 'right';
201
+ const heightProp = basePlacement === 'top' ? 'top' : 'bottom';
202
+ const applyMaxWidth = autoSize === 'always' || autoSize === 'width-always' || overflow[widthProp] > 0 && (autoSize === true || autoSize === 'width');
203
+ const applyMaxHeight = autoSize === 'always' || autoSize === 'height-always' || overflow[heightProp] > 0 && (autoSize === true || autoSize === 'height');
204
+
205
+ if (applyMaxWidth) {
206
+ state.styles.popper.maxWidth = `${width - overflow[widthProp] - x}px`;
207
+ }
208
+
209
+ if (applyMaxHeight) {
210
+ state.styles.popper.maxHeight = `${height - overflow[heightProp] - y}px`;
211
+ }
212
+ }
213
+
214
+ },
215
+ /**
216
+ * This modifier is necessary in order to render the pointer. Refs are resolved in effects, so it can't be
217
+ * placed under computed modifiers. Deep merge is not required as this modifier has only these properties.
218
+ */
219
+ {
220
+ name: 'arrow',
221
+ enabled: !!arrow,
222
+ options: {
223
+ element: arrow,
224
+ padding: arrowPadding
225
+ }
226
+ },
227
+ /**
228
+ * Modifies popper offsets to cover the reference rect, but still keep edge alignment
229
+ */
230
+ {
231
+ name: 'coverTarget',
232
+ enabled: !!coverTarget,
233
+ phase: 'main',
234
+ requiresIfExists: ['offset', 'preventOverflow', 'flip'],
235
+
236
+ fn({
237
+ state
238
+ }) {
239
+ const basePlacement = index_1.getBasePlacement(state.placement);
240
+
241
+ switch (basePlacement) {
242
+ case 'bottom':
243
+ state.modifiersData.popperOffsets.y -= state.rects.reference.height;
244
+ break;
245
+
246
+ case 'top':
247
+ state.modifiersData.popperOffsets.y += state.rects.reference.height;
248
+ break;
249
+
250
+ case 'left':
251
+ state.modifiersData.popperOffsets.x += state.rects.reference.width;
252
+ break;
253
+
254
+ case 'right':
255
+ state.modifiersData.popperOffsets.x -= state.rects.reference.width;
256
+ break;
257
+ }
258
+ }
259
+
260
+ }].filter(Boolean); // filter boolean conditional spreading values
261
+
262
+ const popperOptions = {
263
+ modifiers,
264
+ placement,
265
+ strategy,
266
+ onFirstUpdate: state => handleStateUpdate({
267
+ state
268
+ })
269
+ };
270
+ return popperOptions;
271
+ }, [arrowPadding, autoSize, coverTarget, flipBoundary, offsetModifier, overflowBoundary, placement, strategy, unstable_disableTether, pinned, // These can be skipped from deps as they will not ever change
272
+ handleStateUpdate, popperOriginalPositionRef]);
226
273
  }
227
274
  /**
228
275
  * Exposes Popper positioning API via React hook. Contains few important differences between an official "react-popper"
@@ -232,130 +279,136 @@ function usePopperOptions(options, popperOriginalPositionRef) {
232
279
  * - contains a specific to React fix related to initial positioning when containers have components with managed focus
233
280
  * to avoid focus jumps
234
281
  */
235
- function usePopper(options) {
236
- if (options === void 0) { options = {}; }
237
- var _a = options.enabled, enabled = _a === void 0 ? true : _a;
238
- var isFirstMount = react_utilities_1.useFirstMount();
239
- var popperOriginalPositionRef = React.useRef('absolute');
240
- var resolvePopperOptions = usePopperOptions(options, popperOriginalPositionRef);
241
- var popperInstanceRef = React.useRef(null);
242
- var handlePopperUpdate = react_utilities_1.useEventCallback(function () {
243
- var _a;
244
- (_a = popperInstanceRef.current) === null || _a === void 0 ? void 0 : _a.destroy();
245
- popperInstanceRef.current = null;
246
- var _b = options.target, target = _b === void 0 ? targetRef.current : _b;
247
- var popperInstance = null;
248
- if (react_utilities_1.canUseDOM() && enabled) {
249
- if (target && containerRef.current) {
250
- popperInstance = PopperJs.createPopper(target, containerRef.current, resolvePopperOptions(target, containerRef.current, arrowRef.current));
251
- }
252
- }
253
- if (popperInstance) {
254
- /**
255
- * The patch updates `.forceUpdate()` Popper function which restores the original position before the first
256
- * forceUpdate() call. See also "positionStyleFix" modifier in usePopperOptions().
257
- */
258
- var originalForceUpdate_1 = popperInstance.forceUpdate;
259
- popperInstance.isFirstRun = true;
260
- popperInstance.forceUpdate = function () {
261
- if (popperInstance === null || popperInstance === void 0 ? void 0 : popperInstance.isFirstRun) {
262
- popperInstance.state.elements.popper.style.position = popperOriginalPositionRef.current;
263
- popperInstance.isFirstRun = false;
264
- }
265
- originalForceUpdate_1();
266
- };
267
- }
268
- popperInstanceRef.current = popperInstance;
269
- });
270
- // Refs are managed by useCallbackRef() to handle ref updates scenarios.
271
- //
272
- // The first scenario are updates for a targetRef, we can handle it properly only via callback refs, but it causes
273
- // re-renders (we would like to avoid them).
274
- //
275
- // The second problem is related to refs resolution on React's layer: refs are resolved in the same order as effects
276
- // that causes an issue when you have a container inside a target, for example: a menu in ChatMessage.
277
- //
278
- // function ChatMessage(props) {
279
- // <div className="message" ref={targetRef}> // 3) ref will be resolved only now, but it's too late already
280
- // <Popper target={targetRef}> // 2) create a popper instance
281
- // <div className="menu" /> // 1) capture ref from this element
282
- // </Popper>
283
- // </div>
284
- // }
285
- //
286
- // Check a demo on CodeSandbox: https://codesandbox.io/s/popper-refs-emy60.
287
- //
288
- // This again can be solved with callback refs. It's not a huge issue as with hooks we are moving popper's creation
289
- // to ChatMessage itself, however, without `useCallback()` refs it's still a Pandora box.
290
- var targetRef = index_1.useCallbackRef(null, handlePopperUpdate, true);
291
- var containerRef = index_1.useCallbackRef(null, handlePopperUpdate, true);
292
- var arrowRef = index_1.useCallbackRef(null, handlePopperUpdate, true);
293
- React.useImperativeHandle(options.popperRef, function () { return ({
294
- updatePosition: function () {
295
- var _a;
296
- (_a = popperInstanceRef.current) === null || _a === void 0 ? void 0 : _a.update();
297
- },
298
- }); }, []);
299
- react_utilities_1.useIsomorphicLayoutEffect(function () {
300
- handlePopperUpdate();
301
- return function () {
302
- var _a;
303
- (_a = popperInstanceRef.current) === null || _a === void 0 ? void 0 : _a.destroy();
304
- popperInstanceRef.current = null;
305
- };
306
- }, [handlePopperUpdate, options.enabled, options.target]);
307
- react_utilities_1.useIsomorphicLayoutEffect(function () {
308
- var _a;
309
- if (!isFirstMount) {
310
- (_a = popperInstanceRef.current) === null || _a === void 0 ? void 0 : _a.setOptions(resolvePopperOptions(options.target || targetRef.current, containerRef.current, arrowRef.current));
282
+
283
+
284
+ function usePopper(options = {}) {
285
+ const {
286
+ enabled = true
287
+ } = options;
288
+ const isFirstMount = react_utilities_1.useFirstMount();
289
+ const popperOriginalPositionRef = React.useRef('absolute');
290
+ const resolvePopperOptions = usePopperOptions(options, popperOriginalPositionRef);
291
+ const popperInstanceRef = React.useRef(null);
292
+ const handlePopperUpdate = react_utilities_1.useEventCallback(() => {
293
+ var _a;
294
+
295
+ (_a = popperInstanceRef.current) === null || _a === void 0 ? void 0 : _a.destroy();
296
+ popperInstanceRef.current = null;
297
+ const {
298
+ target = targetRef.current
299
+ } = options;
300
+ let popperInstance = null;
301
+
302
+ if (react_utilities_1.canUseDOM() && enabled) {
303
+ if (target && containerRef.current) {
304
+ popperInstance = PopperJs.createPopper(target, containerRef.current, resolvePopperOptions(target, containerRef.current, arrowRef.current));
305
+ }
306
+ }
307
+
308
+ if (popperInstance) {
309
+ /**
310
+ * The patch updates `.forceUpdate()` Popper function which restores the original position before the first
311
+ * forceUpdate() call. See also "positionStyleFix" modifier in usePopperOptions().
312
+ */
313
+ const originalForceUpdate = popperInstance.forceUpdate;
314
+ popperInstance.isFirstRun = true;
315
+
316
+ popperInstance.forceUpdate = () => {
317
+ if (popperInstance === null || popperInstance === void 0 ? void 0 : popperInstance.isFirstRun) {
318
+ popperInstance.state.elements.popper.style.position = popperOriginalPositionRef.current;
319
+ popperInstance.isFirstRun = false;
311
320
  }
312
- },
313
- // Missing deps:
314
- // options.target - The useIsomorphicLayoutEffect before this will create a new popper instance if target changes
315
- // isFirstMount - Should never change after mount
316
- // arrowRef, containerRef, targetRef - Stable between renders
317
- // eslint-disable-next-line react-hooks/exhaustive-deps
318
- [resolvePopperOptions]);
319
- if (process.env.NODE_ENV !== 'production') {
320
- // This checked should run only in development mode
321
- // eslint-disable-next-line react-hooks/rules-of-hooks
322
- React.useEffect(function () {
323
- var _a;
324
- if (containerRef.current) {
325
- var contentNode = containerRef.current;
326
- var treeWalker = (_a = contentNode.ownerDocument) === null || _a === void 0 ? void 0 : _a.createTreeWalker(contentNode, NodeFilter.SHOW_ELEMENT, {
327
- acceptNode: hasAutofocusFilter,
328
- });
329
- while (treeWalker === null || treeWalker === void 0 ? void 0 : treeWalker.nextNode()) {
330
- var node = treeWalker.currentNode;
331
- // eslint-disable-next-line no-console
332
- console.warn('<Popper>:', node);
333
- // eslint-disable-next-line no-console
334
- console.warn([
335
- '<Popper>: ^ this node contains "autoFocus" prop on a React element. This can break the initial',
336
- 'positioning of an element and cause a window jump effect. This issue occurs because React polyfills',
337
- '"autoFocus" behavior to solve inconsistencies between different browsers:',
338
- 'https://github.com/facebook/react/issues/11851#issuecomment-351787078',
339
- '\n',
340
- 'However, ".focus()" in this case occurs before any other React effects will be executed',
341
- '(React.useEffect(), componentDidMount(), etc.) and we can not prevent this behavior. If you really',
342
- 'want to use "autoFocus" please add "position: fixed" to styles of the element that is wrapped by',
343
- '"Popper".',
344
- "In general, it's not recommended to use \"autoFocus\" as it may break accessibility aspects:",
345
- 'https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/master/docs/rules/no-autofocus.md',
346
- '\n',
347
- 'We suggest to use the "trapFocus" prop on Fluent components or a catch "ref" and then use',
348
- '"ref.current.focus" in React.useEffect():',
349
- 'https://reactjs.org/docs/refs-and-the-dom.html#adding-a-ref-to-a-dom-element',
350
- ].join(' '));
351
- }
352
- }
353
- // We run this check once, no need to add deps here
354
- // TODO: Should be rework to handle options.enabled and contentRef updates
355
- // eslint-disable-next-line react-hooks/exhaustive-deps
356
- }, []);
321
+
322
+ originalForceUpdate();
323
+ };
357
324
  }
358
- return { targetRef: targetRef, containerRef: containerRef, arrowRef: arrowRef };
325
+
326
+ popperInstanceRef.current = popperInstance;
327
+ }); // Refs are managed by useCallbackRef() to handle ref updates scenarios.
328
+ //
329
+ // The first scenario are updates for a targetRef, we can handle it properly only via callback refs, but it causes
330
+ // re-renders (we would like to avoid them).
331
+ //
332
+ // The second problem is related to refs resolution on React's layer: refs are resolved in the same order as effects
333
+ // that causes an issue when you have a container inside a target, for example: a menu in ChatMessage.
334
+ //
335
+ // function ChatMessage(props) {
336
+ // <div className="message" ref={targetRef}> // 3) ref will be resolved only now, but it's too late already
337
+ // <Popper target={targetRef}> // 2) create a popper instance
338
+ // <div className="menu" /> // 1) capture ref from this element
339
+ // </Popper>
340
+ // </div>
341
+ // }
342
+ //
343
+ // Check a demo on CodeSandbox: https://codesandbox.io/s/popper-refs-emy60.
344
+ //
345
+ // This again can be solved with callback refs. It's not a huge issue as with hooks we are moving popper's creation
346
+ // to ChatMessage itself, however, without `useCallback()` refs it's still a Pandora box.
347
+
348
+ const targetRef = index_1.useCallbackRef(null, handlePopperUpdate, true);
349
+ const containerRef = index_1.useCallbackRef(null, handlePopperUpdate, true);
350
+ const arrowRef = index_1.useCallbackRef(null, handlePopperUpdate, true);
351
+ React.useImperativeHandle(options.popperRef, () => ({
352
+ updatePosition: () => {
353
+ var _a;
354
+
355
+ (_a = popperInstanceRef.current) === null || _a === void 0 ? void 0 : _a.update();
356
+ }
357
+ }), []);
358
+ react_utilities_1.useIsomorphicLayoutEffect(() => {
359
+ handlePopperUpdate();
360
+ return () => {
361
+ var _a;
362
+
363
+ (_a = popperInstanceRef.current) === null || _a === void 0 ? void 0 : _a.destroy();
364
+ popperInstanceRef.current = null;
365
+ };
366
+ }, [handlePopperUpdate, options.enabled, options.target]);
367
+ react_utilities_1.useIsomorphicLayoutEffect(() => {
368
+ var _a;
369
+
370
+ if (!isFirstMount) {
371
+ (_a = popperInstanceRef.current) === null || _a === void 0 ? void 0 : _a.setOptions(resolvePopperOptions(options.target || targetRef.current, containerRef.current, arrowRef.current));
372
+ }
373
+ }, // Missing deps:
374
+ // options.target - The useIsomorphicLayoutEffect before this will create a new popper instance if target changes
375
+ // isFirstMount - Should never change after mount
376
+ // arrowRef, containerRef, targetRef - Stable between renders
377
+ // eslint-disable-next-line react-hooks/exhaustive-deps
378
+ [resolvePopperOptions]);
379
+
380
+ if (process.env.NODE_ENV !== 'production') {
381
+ // This checked should run only in development mode
382
+ // eslint-disable-next-line react-hooks/rules-of-hooks
383
+ React.useEffect(() => {
384
+ var _a;
385
+
386
+ if (containerRef.current) {
387
+ const contentNode = containerRef.current;
388
+ const treeWalker = (_a = contentNode.ownerDocument) === null || _a === void 0 ? void 0 : _a.createTreeWalker(contentNode, NodeFilter.SHOW_ELEMENT, {
389
+ acceptNode: hasAutofocusFilter
390
+ });
391
+
392
+ while (treeWalker === null || treeWalker === void 0 ? void 0 : treeWalker.nextNode()) {
393
+ const node = treeWalker.currentNode; // eslint-disable-next-line no-console
394
+
395
+ console.warn('<Popper>:', node); // eslint-disable-next-line no-console
396
+
397
+ console.warn(['<Popper>: ^ this node contains "autoFocus" prop on a React element. This can break the initial', 'positioning of an element and cause a window jump effect. This issue occurs because React polyfills', '"autoFocus" behavior to solve inconsistencies between different browsers:', 'https://github.com/facebook/react/issues/11851#issuecomment-351787078', '\n', 'However, ".focus()" in this case occurs before any other React effects will be executed', '(React.useEffect(), componentDidMount(), etc.) and we can not prevent this behavior. If you really', 'want to use "autoFocus" please add "position: fixed" to styles of the element that is wrapped by', '"Popper".', `In general, it's not recommended to use "autoFocus" as it may break accessibility aspects:`, 'https://github.com/jsx-eslint/eslint-plugin-jsx-a11y/blob/master/docs/rules/no-autofocus.md', '\n', 'We suggest to use the "trapFocus" prop on Fluent components or a catch "ref" and then use', '"ref.current.focus" in React.useEffect():', 'https://reactjs.org/docs/refs-and-the-dom.html#adding-a-ref-to-a-dom-element'].join(' '));
398
+ }
399
+ } // We run this check once, no need to add deps here
400
+ // TODO: Should be rework to handle options.enabled and contentRef updates
401
+ // eslint-disable-next-line react-hooks/exhaustive-deps
402
+
403
+ }, []);
404
+ }
405
+
406
+ return {
407
+ targetRef,
408
+ containerRef,
409
+ arrowRef
410
+ };
359
411
  }
412
+
360
413
  exports.usePopper = usePopper;
361
414
  //# sourceMappingURL=usePopper.js.map