@react-aria/landmark 3.0.0-beta.11 → 3.0.0-beta.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. package/dist/types.d.ts +2 -3
  2. package/dist/types.d.ts.map +1 -1
  3. package/dist/useLandmark.main.js +25 -25
  4. package/dist/useLandmark.main.js.map +1 -1
  5. package/dist/useLandmark.mjs +26 -26
  6. package/dist/useLandmark.module.js +25 -25
  7. package/dist/useLandmark.module.js.map +1 -1
  8. package/package.json +5 -5
  9. package/src/useLandmark.ts +5 -5
package/dist/types.d.ts CHANGED
@@ -1,5 +1,4 @@
1
- import { AriaLabelingProps, DOMAttributes, FocusableElement } from "@react-types/shared";
2
- import { RefObject } from "react";
1
+ import { AriaLabelingProps, DOMAttributes, FocusableElement, RefObject } from "@react-types/shared";
3
2
  export type AriaLandmarkRole = 'main' | 'region' | 'search' | 'navigation' | 'form' | 'banner' | 'contentinfo' | 'complementary';
4
3
  export interface AriaLandmarkProps extends AriaLabelingProps {
5
4
  role: AriaLandmarkRole;
@@ -38,6 +37,6 @@ export function createLandmarkController(): LandmarkController;
38
37
  * @param props - Props for the landmark.
39
38
  * @param ref - Ref to the landmark.
40
39
  */
41
- export function useLandmark(props: AriaLandmarkProps, ref: RefObject<FocusableElement>): LandmarkAria;
40
+ export function useLandmark(props: AriaLandmarkProps, ref: RefObject<FocusableElement | null>): LandmarkAria;
42
41
 
43
42
  //# sourceMappingURL=types.d.ts.map
package/dist/types.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"mappings":";;AAiBA,+BAA+B,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,aAAa,GAAG,eAAe,CAAC;AAEjI,kCAAmC,SAAQ,iBAAiB;IAC1D,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,KAAK,IAAI,CAAA;CACpD;AAED;IACE,aAAa,EAAE,aAAa,CAAA;CAC7B;AA4BD;IACE;;;OAGG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAA;CACxB;AAED,wEAAwE;AACxE;IACE,wCAAwC;IACxC,SAAS,CAAC,IAAI,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC;IACrD,4CAA4C;IAC5C,aAAa,CAAC,IAAI,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC;IACzD,wCAAwC;IACxC,SAAS,IAAI,OAAO,CAAC;IACrB,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,EAAE,IAAI,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC;IACvF;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAA;CAChB;AAwWD,uFAAuF;AACvF,4CAA4C,kBAAkB,CAkC7D;AAED;;;;GAIG;AACH,4BAA4B,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,UAAU,gBAAgB,CAAC,GAAG,YAAY,CAuCpG","sources":["packages/@react-aria/landmark/src/packages/@react-aria/landmark/src/useLandmark.ts","packages/@react-aria/landmark/src/packages/@react-aria/landmark/src/index.ts","packages/@react-aria/landmark/src/index.ts"],"sourcesContent":[null,null,"/*\n * Copyright 2022 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nexport type {AriaLandmarkRole, AriaLandmarkProps, LandmarkAria, LandmarkController} from './useLandmark';\nexport {useLandmark, createLandmarkController} from './useLandmark';\n"],"names":[],"version":3,"file":"types.d.ts.map"}
1
+ {"mappings":";AAiBA,+BAA+B,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,aAAa,GAAG,eAAe,CAAC;AAEjI,kCAAmC,SAAQ,iBAAiB;IAC1D,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,KAAK,IAAI,CAAA;CACpD;AAED;IACE,aAAa,EAAE,aAAa,CAAA;CAC7B;AA4BD;IACE;;;OAGG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAA;CACxB;AAED,wEAAwE;AACxE;IACE,wCAAwC;IACxC,SAAS,CAAC,IAAI,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC;IACrD,4CAA4C;IAC5C,aAAa,CAAC,IAAI,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC;IACzD,wCAAwC;IACxC,SAAS,IAAI,OAAO,CAAC;IACrB,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,EAAE,IAAI,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC;IACvF;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAA;CAChB;AAwWD,uFAAuF;AACvF,4CAA4C,kBAAkB,CAkC7D;AAED;;;;GAIG;AACH,4BAA4B,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,UAAU,gBAAgB,GAAG,IAAI,CAAC,GAAG,YAAY,CAuC3G","sources":["packages/@react-aria/landmark/src/packages/@react-aria/landmark/src/useLandmark.ts","packages/@react-aria/landmark/src/packages/@react-aria/landmark/src/index.ts","packages/@react-aria/landmark/src/index.ts"],"sourcesContent":[null,null,"/*\n * Copyright 2022 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nexport type {AriaLandmarkRole, AriaLandmarkProps, LandmarkAria, LandmarkController} from './useLandmark';\nexport {useLandmark, createLandmarkController} from './useLandmark';\n"],"names":[],"version":3,"file":"types.d.ts.map"}
package/dist/useLandmark.main.js CHANGED
@@ -26,20 +26,20 @@ $parcel$export(module.exports, "useLandmark", () => $202c109aedff6705$export$4cc
26
26
  // LandmarkManagerApi or Landmark interfaces change.
27
27
  const $202c109aedff6705$var$LANDMARK_API_VERSION = 1;
28
28
  // Symbol under which the singleton landmark manager instance is attached to the document.
29
- const $202c109aedff6705$var$landmarkSymbol = Symbol.for("react-aria-landmark-manager");
29
+ const $202c109aedff6705$var$landmarkSymbol = Symbol.for('react-aria-landmark-manager');
30
30
  function $202c109aedff6705$var$subscribe(fn) {
31
- document.addEventListener("react-aria-landmark-manager-change", fn);
32
- return ()=>document.removeEventListener("react-aria-landmark-manager-change", fn);
31
+ document.addEventListener('react-aria-landmark-manager-change', fn);
32
+ return ()=>document.removeEventListener('react-aria-landmark-manager-change', fn);
33
33
  }
34
34
  function $202c109aedff6705$var$getLandmarkManager() {
35
- if (typeof document === "undefined") return null;
35
+ if (typeof document === 'undefined') return null;
36
36
  // Reuse an existing instance if it has the same or greater version.
37
37
  let instance = document[$202c109aedff6705$var$landmarkSymbol];
38
38
  if (instance && instance.version >= $202c109aedff6705$var$LANDMARK_API_VERSION) return instance;
39
39
  // Otherwise, create a new instance and dispatch an event so anything using the existing
40
40
  // instance updates and re-registers their landmarks with the new one.
41
41
  document[$202c109aedff6705$var$landmarkSymbol] = new $202c109aedff6705$var$LandmarkManager();
42
- document.dispatchEvent(new CustomEvent("react-aria-landmark-manager-change"));
42
+ document.dispatchEvent(new CustomEvent('react-aria-landmark-manager-change'));
43
43
  return document[$202c109aedff6705$var$landmarkSymbol];
44
44
  }
45
45
  // Subscribes a React component to the current landmark manager instance.
@@ -49,26 +49,26 @@ function $202c109aedff6705$var$useLandmarkManager() {
49
49
  class $202c109aedff6705$var$LandmarkManager {
50
50
  setupIfNeeded() {
51
51
  if (this.isListening) return;
52
- document.addEventListener("keydown", this.f6Handler, {
52
+ document.addEventListener('keydown', this.f6Handler, {
53
53
  capture: true
54
54
  });
55
- document.addEventListener("focusin", this.focusinHandler, {
55
+ document.addEventListener('focusin', this.focusinHandler, {
56
56
  capture: true
57
57
  });
58
- document.addEventListener("focusout", this.focusoutHandler, {
58
+ document.addEventListener('focusout', this.focusoutHandler, {
59
59
  capture: true
60
60
  });
61
61
  this.isListening = true;
62
62
  }
63
63
  teardownIfNeeded() {
64
64
  if (!this.isListening || this.landmarks.length > 0 || this.refCount > 0) return;
65
- document.removeEventListener("keydown", this.f6Handler, {
65
+ document.removeEventListener('keydown', this.f6Handler, {
66
66
  capture: true
67
67
  });
68
- document.removeEventListener("focusin", this.focusinHandler, {
68
+ document.removeEventListener('focusin', this.focusinHandler, {
69
69
  capture: true
70
70
  });
71
- document.removeEventListener("focusout", this.focusoutHandler, {
71
+ document.removeEventListener('focusout', this.focusoutHandler, {
72
72
  capture: true
73
73
  });
74
74
  this.isListening = false;
@@ -90,7 +90,7 @@ class $202c109aedff6705$var$LandmarkManager {
90
90
  addLandmark(newLandmark) {
91
91
  this.setupIfNeeded();
92
92
  if (this.landmarks.find((landmark)=>landmark.ref === newLandmark.ref) || !newLandmark.ref.current) return;
93
- if (this.landmarks.filter((landmark)=>landmark.role === "main").length > 1) console.error('Page can contain no more than one landmark with the role "main".');
93
+ if (this.landmarks.filter((landmark)=>landmark.role === 'main').length > 1) console.error('Page can contain no more than one landmark with the role "main".');
94
94
  if (this.landmarks.length === 0) {
95
95
  this.landmarks = [
96
96
  newLandmark
@@ -177,18 +177,18 @@ class $202c109aedff6705$var$LandmarkManager {
177
177
  // When we reach the end of the landmark sequence, fire a custom event that can be listened for by applications.
178
178
  // If this event is canceled, we return immediately. This can be used to implement landmark navigation across iframes.
179
179
  if (nextLandmarkIndex < 0) {
180
- if (!element.dispatchEvent(new CustomEvent("react-aria-landmark-navigation", {
180
+ if (!element.dispatchEvent(new CustomEvent('react-aria-landmark-navigation', {
181
181
  detail: {
182
- direction: "backward"
182
+ direction: 'backward'
183
183
  },
184
184
  bubbles: true,
185
185
  cancelable: true
186
186
  }))) return true;
187
187
  nextLandmarkIndex = this.landmarks.length - 1;
188
188
  } else if (nextLandmarkIndex >= this.landmarks.length) {
189
- if (!element.dispatchEvent(new CustomEvent("react-aria-landmark-navigation", {
189
+ if (!element.dispatchEvent(new CustomEvent('react-aria-landmark-navigation', {
190
190
  detail: {
191
- direction: "forward"
191
+ direction: 'forward'
192
192
  },
193
193
  bubbles: true,
194
194
  cancelable: true
@@ -201,7 +201,7 @@ class $202c109aedff6705$var$LandmarkManager {
201
201
  if (wrapIfNeeded()) return undefined;
202
202
  // Skip over hidden landmarks.
203
203
  let i = nextLandmarkIndex;
204
- while((_this_landmarks_nextLandmarkIndex_ref_current = this.landmarks[nextLandmarkIndex].ref.current) === null || _this_landmarks_nextLandmarkIndex_ref_current === void 0 ? void 0 : _this_landmarks_nextLandmarkIndex_ref_current.closest("[aria-hidden=true]")){
204
+ while((_this_landmarks_nextLandmarkIndex_ref_current = this.landmarks[nextLandmarkIndex].ref.current) === null || _this_landmarks_nextLandmarkIndex_ref_current === void 0 ? void 0 : _this_landmarks_nextLandmarkIndex_ref_current.closest('[aria-hidden=true]')){
205
205
  nextLandmarkIndex += backward ? -1 : 1;
206
206
  if (wrapIfNeeded()) return undefined;
207
207
  if (nextLandmarkIndex === i) break;
@@ -213,7 +213,7 @@ class $202c109aedff6705$var$LandmarkManager {
213
213
  * If not, focus the landmark itself.
214
214
  * If no landmarks at all, or none with focusable elements, don't move focus.
215
215
  */ f6Handler(e) {
216
- if (e.key === "F6") {
216
+ if (e.key === 'F6') {
217
217
  // If alt key pressed, focus main landmark, otherwise navigate forward or backward based on shift key.
218
218
  let handled = e.altKey ? this.focusMain() : this.navigate(e.target, e.shiftKey);
219
219
  if (handled) {
@@ -223,9 +223,9 @@ class $202c109aedff6705$var$LandmarkManager {
223
223
  }
224
224
  }
225
225
  focusMain() {
226
- let main = this.getLandmarkByRole("main");
226
+ let main = this.getLandmarkByRole('main');
227
227
  if (main && main.ref.current && document.contains(main.ref.current)) {
228
- this.focusLandmark(main.ref.current, "forward");
228
+ this.focusLandmark(main.ref.current, 'forward');
229
229
  return true;
230
230
  }
231
231
  return false;
@@ -245,7 +245,7 @@ class $202c109aedff6705$var$LandmarkManager {
245
245
  }
246
246
  // Otherwise, focus the landmark itself
247
247
  if (nextLandmark.ref.current && document.contains(nextLandmark.ref.current)) {
248
- this.focusLandmark(nextLandmark.ref.current, backward ? "backward" : "forward");
248
+ this.focusLandmark(nextLandmark.ref.current, backward ? 'backward' : 'forward');
249
249
  return true;
250
250
  }
251
251
  return false;
@@ -284,7 +284,7 @@ class $202c109aedff6705$var$LandmarkManager {
284
284
  return {
285
285
  navigate (direction, opts) {
286
286
  let element = (opts === null || opts === void 0 ? void 0 : opts.from) || document.activeElement;
287
- return instance.navigate(element, direction === "backward");
287
+ return instance.navigate(element, direction === 'backward');
288
288
  },
289
289
  focusNext (opts) {
290
290
  let element = (opts === null || opts === void 0 ? void 0 : opts.from) || document.activeElement;
@@ -355,7 +355,7 @@ function $202c109aedff6705$export$f50151dbd51cd1d9() {
355
355
  };
356
356
  }
357
357
  function $202c109aedff6705$export$4cc632584fd87fae(props, ref) {
358
- const { role: role, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledby, focus: focus } = props;
358
+ const { role: role, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledby, focus: focus } = props;
359
359
  let manager = $202c109aedff6705$var$useLandmarkManager();
360
360
  let label = ariaLabel || ariaLabelledby;
361
361
  let [isLandmarkFocused, setIsLandmarkFocused] = (0, $iIApB$react.useState)(false);
@@ -397,8 +397,8 @@ function $202c109aedff6705$export$4cc632584fd87fae(props, ref) {
397
397
  landmarkProps: {
398
398
  role: role,
399
399
  tabIndex: isLandmarkFocused ? -1 : undefined,
400
- "aria-label": ariaLabel,
401
- "aria-labelledby": ariaLabelledby
400
+ 'aria-label': ariaLabel,
401
+ 'aria-labelledby': ariaLabelledby
402
402
  }
403
403
  };
404
404
  }
package/dist/useLandmark.main.js.map CHANGED
@@ -1 +1 @@
1
- {"mappings":"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","sources":["packages/@react-aria/landmark/src/useLandmark.ts"],"sourcesContent":["/*\n * Copyright 2022 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport {AriaLabelingProps, DOMAttributes, FocusableElement} from '@react-types/shared';\nimport {RefObject, useCallback, useEffect, useState} from 'react';\nimport {useLayoutEffect} from '@react-aria/utils';\nimport {useSyncExternalStore} from 'use-sync-external-store/shim/index.js';\n\nexport type AriaLandmarkRole = 'main' | 'region' | 'search' | 'navigation' | 'form' | 'banner' | 'contentinfo' | 'complementary';\n\nexport interface AriaLandmarkProps extends AriaLabelingProps {\n role: AriaLandmarkRole,\n focus?: (direction: 'forward' | 'backward') => void\n}\n\nexport interface LandmarkAria {\n landmarkProps: DOMAttributes\n}\n\n// Increment this version number whenever the\n// LandmarkManagerApi or Landmark interfaces change.\nconst LANDMARK_API_VERSION = 1;\n\n// Minimal API for LandmarkManager that must continue to work between versions.\n// Changes to this interface are considered breaking. New methods/properties are\n// safe to add, but changes or removals are not allowed (same as public APIs).\ninterface LandmarkManagerApi {\n version: number,\n createLandmarkController(): LandmarkController,\n registerLandmark(landmark: Landmark): () => void\n}\n\n// Changes to this interface are considered breaking.\n// New properties MUST be optional so that registering a landmark\n// from an older version of useLandmark against a newer version of\n// LandmarkManager does not crash.\ninterface Landmark {\n ref: RefObject<FocusableElement>,\n role: AriaLandmarkRole,\n label?: string,\n lastFocused?: FocusableElement,\n focus: (direction: 'forward' | 'backward') => void,\n blur: () => void\n}\n\nexport interface LandmarkControllerOptions {\n /**\n * The element from which to start navigating.\n * @default document.activeElement\n */\n from?: FocusableElement\n}\n\n/** A LandmarkController allows programmatic navigation of landmarks. */\nexport interface LandmarkController {\n /** Moves focus to the next landmark. */\n focusNext(opts?: LandmarkControllerOptions): boolean,\n /** Moves focus to the previous landmark. */\n focusPrevious(opts?: LandmarkControllerOptions): boolean,\n /** Moves focus to the main landmark. */\n focusMain(): boolean,\n /** Moves focus either forward or backward in the landmark sequence. */\n navigate(direction: 'forward' | 'backward', opts?: LandmarkControllerOptions): boolean,\n /**\n * Disposes the landmark controller. When no landmarks are registered, and no\n * controllers are active, the landmark keyboard listeners are removed from the page.\n */\n dispose(): void\n}\n\n// Symbol under which the singleton landmark manager instance is attached to the document.\nconst landmarkSymbol = Symbol.for('react-aria-landmark-manager');\n\nfunction subscribe(fn: () => void) {\n document.addEventListener('react-aria-landmark-manager-change', fn);\n return () => document.removeEventListener('react-aria-landmark-manager-change', fn);\n}\n\nfunction getLandmarkManager(): LandmarkManagerApi | null {\n if (typeof document === 'undefined') {\n return null;\n }\n\n // Reuse an existing instance if it has the same or greater version.\n let instance = document[landmarkSymbol];\n if (instance && instance.version >= LANDMARK_API_VERSION) {\n return instance;\n }\n\n // Otherwise, create a new instance and dispatch an event so anything using the existing\n // instance updates and re-registers their landmarks with the new one.\n document[landmarkSymbol] = new LandmarkManager();\n document.dispatchEvent(new CustomEvent('react-aria-landmark-manager-change'));\n return document[landmarkSymbol];\n}\n\n// Subscribes a React component to the current landmark manager instance.\nfunction useLandmarkManager(): LandmarkManagerApi | null {\n return useSyncExternalStore(subscribe, getLandmarkManager, getLandmarkManager);\n}\n\nclass LandmarkManager implements LandmarkManagerApi {\n private landmarks: Array<Landmark> = [];\n private isListening = false;\n private refCount = 0;\n public version = LANDMARK_API_VERSION;\n\n constructor() {\n this.f6Handler = this.f6Handler.bind(this);\n this.focusinHandler = this.focusinHandler.bind(this);\n this.focusoutHandler = this.focusoutHandler.bind(this);\n }\n\n private setupIfNeeded() {\n if (this.isListening) {\n return;\n }\n document.addEventListener('keydown', this.f6Handler, {capture: true});\n document.addEventListener('focusin', this.focusinHandler, {capture: true});\n document.addEventListener('focusout', this.focusoutHandler, {capture: true});\n this.isListening = true;\n }\n\n private teardownIfNeeded() {\n if (!this.isListening || this.landmarks.length > 0 || this.refCount > 0) {\n return;\n }\n document.removeEventListener('keydown', this.f6Handler, {capture: true});\n document.removeEventListener('focusin', this.focusinHandler, {capture: true});\n document.removeEventListener('focusout', this.focusoutHandler, {capture: true});\n this.isListening = false;\n }\n\n private focusLandmark(landmark: FocusableElement, direction: 'forward' | 'backward') {\n this.landmarks.find(l => l.ref.current === landmark)?.focus?.(direction);\n }\n\n /**\n * Return set of landmarks with a specific role.\n */\n private getLandmarksByRole(role: AriaLandmarkRole) {\n return new Set(this.landmarks.filter(l => l.role === role));\n }\n\n /**\n * Return first landmark with a specific role.\n */\n private getLandmarkByRole(role: AriaLandmarkRole) {\n return this.landmarks.find(l => l.role === role);\n }\n\n private addLandmark(newLandmark: Landmark) {\n this.setupIfNeeded();\n if (this.landmarks.find(landmark => landmark.ref === newLandmark.ref) || !newLandmark.ref.current) {\n return;\n }\n\n if (this.landmarks.filter(landmark => landmark.role === 'main').length > 1) {\n console.error('Page can contain no more than one landmark with the role \"main\".');\n }\n\n if (this.landmarks.length === 0) {\n this.landmarks = [newLandmark];\n this.checkLabels(newLandmark.role);\n return;\n }\n\n\n // Binary search to insert new landmark based on position in document relative to existing landmarks.\n // https://developer.mozilla.org/en-US/docs/Web/API/Node/compareDocumentPosition\n let start = 0;\n let end = this.landmarks.length - 1;\n while (start <= end) {\n let mid = Math.floor((start + end) / 2);\n let comparedPosition = newLandmark.ref.current.compareDocumentPosition(this.landmarks[mid].ref.current as Node);\n let isNewAfterExisting = Boolean((comparedPosition & Node.DOCUMENT_POSITION_PRECEDING) || (comparedPosition & Node.DOCUMENT_POSITION_CONTAINS));\n\n if (isNewAfterExisting) {\n start = mid + 1;\n } else {\n end = mid - 1;\n }\n }\n\n this.landmarks.splice(start, 0, newLandmark);\n this.checkLabels(newLandmark.role);\n }\n\n private updateLandmark(landmark: Pick<Landmark, 'ref'> & Partial<Landmark>) {\n let index = this.landmarks.findIndex(l => l.ref === landmark.ref);\n if (index >= 0) {\n this.landmarks[index] = {...this.landmarks[index], ...landmark};\n this.checkLabels(this.landmarks[index].role);\n }\n }\n\n private removeLandmark(ref: RefObject<Element>) {\n this.landmarks = this.landmarks.filter(landmark => landmark.ref !== ref);\n this.teardownIfNeeded();\n }\n\n /**\n * Warn if there are 2+ landmarks with the same role but no label.\n * Labels for landmarks with the same role must also be unique.\n *\n * See https://www.w3.org/WAI/ARIA/apg/practices/landmark-regions/.\n */\n private checkLabels(role: AriaLandmarkRole) {\n let landmarksWithRole = this.getLandmarksByRole(role);\n if (landmarksWithRole.size > 1) {\n let duplicatesWithoutLabel = [...landmarksWithRole].filter(landmark => !landmark.label);\n if (duplicatesWithoutLabel.length > 0) {\n console.warn(\n `Page contains more than one landmark with the '${role}' role. If two or more landmarks on a page share the same role, all must be labeled with an aria-label or aria-labelledby attribute: `,\n duplicatesWithoutLabel.map(landmark => landmark.ref.current)\n );\n } else {\n let labels = [...landmarksWithRole].map(landmark => landmark.label);\n let duplicateLabels = labels.filter((item, index) => labels.indexOf(item) !== index);\n\n duplicateLabels.forEach((label) => {\n console.warn(\n `Page contains more than one landmark with the '${role}' role and '${label}' label. If two or more landmarks on a page share the same role, they must have unique labels: `,\n [...landmarksWithRole].filter(landmark => landmark.label === label).map(landmark => landmark.ref.current)\n );\n });\n }\n }\n }\n\n /**\n * Get the landmark that is the closest parent in the DOM.\n * Returns undefined if no parent is a landmark.\n */\n private closestLandmark(element: FocusableElement) {\n let landmarkMap = new Map(this.landmarks.map(l => [l.ref.current, l]));\n let currentElement = element;\n while (currentElement && !landmarkMap.has(currentElement) && currentElement !== document.body && currentElement.parentElement) {\n currentElement = currentElement.parentElement;\n }\n return landmarkMap.get(currentElement);\n }\n\n /**\n * Gets the next landmark, in DOM focus order, or previous if backwards is specified.\n * If last landmark, next should be the first landmark.\n * If not inside a landmark, will return first landmark.\n * Returns undefined if there are no landmarks.\n */\n private getNextLandmark(element: FocusableElement, {backward}: {backward?: boolean }) {\n let currentLandmark = this.closestLandmark(element);\n let nextLandmarkIndex = backward ? this.landmarks.length - 1 : 0;\n if (currentLandmark) {\n nextLandmarkIndex = this.landmarks.indexOf(currentLandmark) + (backward ? -1 : 1);\n }\n\n let wrapIfNeeded = () => {\n // When we reach the end of the landmark sequence, fire a custom event that can be listened for by applications.\n // If this event is canceled, we return immediately. This can be used to implement landmark navigation across iframes.\n if (nextLandmarkIndex < 0) {\n if (!element.dispatchEvent(new CustomEvent('react-aria-landmark-navigation', {detail: {direction: 'backward'}, bubbles: true, cancelable: true}))) {\n return true;\n }\n\n nextLandmarkIndex = this.landmarks.length - 1;\n } else if (nextLandmarkIndex >= this.landmarks.length) {\n if (!element.dispatchEvent(new CustomEvent('react-aria-landmark-navigation', {detail: {direction: 'forward'}, bubbles: true, cancelable: true}))) {\n return true;\n }\n\n nextLandmarkIndex = 0;\n }\n\n if (nextLandmarkIndex < 0 || nextLandmarkIndex >= this.landmarks.length) {\n return true;\n }\n\n return false;\n };\n\n if (wrapIfNeeded()) {\n return undefined;\n }\n\n // Skip over hidden landmarks.\n let i = nextLandmarkIndex;\n while (this.landmarks[nextLandmarkIndex].ref.current?.closest('[aria-hidden=true]')) {\n nextLandmarkIndex += backward ? -1 : 1;\n if (wrapIfNeeded()) {\n return undefined;\n }\n\n if (nextLandmarkIndex === i) {\n break;\n }\n }\n\n return this.landmarks[nextLandmarkIndex];\n }\n\n /**\n * Look at next landmark. If an element was previously focused inside, restore focus there.\n * If not, focus the landmark itself.\n * If no landmarks at all, or none with focusable elements, don't move focus.\n */\n private f6Handler(e: KeyboardEvent) {\n if (e.key === 'F6') {\n // If alt key pressed, focus main landmark, otherwise navigate forward or backward based on shift key.\n let handled = e.altKey ? this.focusMain() : this.navigate(e.target as FocusableElement, e.shiftKey);\n if (handled) {\n e.preventDefault();\n e.stopPropagation();\n }\n }\n }\n\n private focusMain() {\n let main = this.getLandmarkByRole('main');\n if (main && main.ref.current && document.contains(main.ref.current)) {\n this.focusLandmark(main.ref.current, 'forward');\n return true;\n }\n\n return false;\n }\n\n private navigate(from: FocusableElement, backward: boolean) {\n let nextLandmark = this.getNextLandmark(from, {\n backward\n });\n\n if (!nextLandmark) {\n return false;\n }\n\n // If something was previously focused in the next landmark, then return focus to it\n if (nextLandmark.lastFocused) {\n let lastFocused = nextLandmark.lastFocused;\n if (document.body.contains(lastFocused)) {\n lastFocused.focus();\n return true;\n }\n }\n\n // Otherwise, focus the landmark itself\n if (nextLandmark.ref.current && document.contains(nextLandmark.ref.current)) {\n this.focusLandmark(nextLandmark.ref.current, backward ? 'backward' : 'forward');\n return true;\n }\n\n return false;\n }\n\n /**\n * Sets lastFocused for a landmark, if focus is moved within that landmark.\n * Lets the last focused landmark know it was blurred if something else is focused.\n */\n private focusinHandler(e: FocusEvent) {\n let currentLandmark = this.closestLandmark(e.target as FocusableElement);\n if (currentLandmark && currentLandmark.ref.current !== e.target) {\n this.updateLandmark({ref: currentLandmark.ref, lastFocused: e.target as FocusableElement});\n }\n let previousFocusedElement = e.relatedTarget as FocusableElement;\n if (previousFocusedElement) {\n let closestPreviousLandmark = this.closestLandmark(previousFocusedElement);\n if (closestPreviousLandmark && closestPreviousLandmark.ref.current === previousFocusedElement) {\n closestPreviousLandmark.blur();\n }\n }\n }\n\n /**\n * Track if the focus is lost to the body. If it is, do cleanup on the landmark that last had focus.\n */\n private focusoutHandler(e: FocusEvent) {\n let previousFocusedElement = e.target as FocusableElement;\n let nextFocusedElement = e.relatedTarget;\n // the === document seems to be a jest thing for focus to go there on generic blur event such as landmark.blur();\n // browsers appear to send focus instead to document.body and the relatedTarget is null when that happens\n if (!nextFocusedElement || nextFocusedElement === document) {\n let closestPreviousLandmark = this.closestLandmark(previousFocusedElement);\n if (closestPreviousLandmark && closestPreviousLandmark.ref.current === previousFocusedElement) {\n closestPreviousLandmark.blur();\n }\n }\n }\n\n public createLandmarkController(): LandmarkController {\n let instance: LandmarkManager | null = this;\n instance.refCount++;\n instance.setupIfNeeded();\n return {\n navigate(direction, opts) {\n let element = opts?.from || (document!.activeElement as FocusableElement);\n return instance!.navigate(element, direction === 'backward');\n },\n focusNext(opts) {\n let element = opts?.from || (document!.activeElement as FocusableElement);\n return instance!.navigate(element, false);\n },\n focusPrevious(opts) {\n let element = opts?.from || (document!.activeElement as FocusableElement);\n return instance!.navigate(element, true);\n },\n focusMain() {\n return instance!.focusMain();\n },\n dispose() {\n if (instance) {\n instance.refCount--;\n instance.teardownIfNeeded();\n instance = null;\n }\n }\n };\n }\n\n public registerLandmark(landmark: Landmark): () => void {\n if (this.landmarks.find(l => l.ref === landmark.ref)) {\n this.updateLandmark(landmark);\n } else {\n this.addLandmark(landmark);\n }\n\n return () => this.removeLandmark(landmark.ref);\n }\n}\n\n/** Creates a LandmarkController, which allows programmatic navigation of landmarks. */\nexport function createLandmarkController(): LandmarkController {\n // Get the current landmark manager and create a controller using it.\n let instance: LandmarkManagerApi | null = getLandmarkManager();\n let controller = instance?.createLandmarkController();\n\n let unsubscribe = subscribe(() => {\n // If the landmark manager changes, dispose the old\n // controller and create a new one.\n controller?.dispose();\n instance = getLandmarkManager();\n controller = instance?.createLandmarkController();\n });\n\n // Return a wrapper that proxies requests to the current controller instance.\n return {\n navigate(direction, opts) {\n return controller!.navigate(direction, opts);\n },\n focusNext(opts) {\n return controller!.focusNext(opts);\n },\n focusPrevious(opts) {\n return controller!.focusPrevious(opts);\n },\n focusMain() {\n return controller!.focusMain();\n },\n dispose() {\n controller?.dispose();\n unsubscribe();\n controller = undefined;\n instance = null;\n }\n };\n}\n\n/**\n * Provides landmark navigation in an application. Call this with a role and label to register a landmark navigable with F6.\n * @param props - Props for the landmark.\n * @param ref - Ref to the landmark.\n */\nexport function useLandmark(props: AriaLandmarkProps, ref: RefObject<FocusableElement>): LandmarkAria {\n const {\n role,\n 'aria-label': ariaLabel,\n 'aria-labelledby': ariaLabelledby,\n focus\n } = props;\n let manager = useLandmarkManager();\n let label = ariaLabel || ariaLabelledby;\n let [isLandmarkFocused, setIsLandmarkFocused] = useState(false);\n\n let defaultFocus = useCallback(() => {\n setIsLandmarkFocused(true);\n }, [setIsLandmarkFocused]);\n\n let blur = useCallback(() => {\n setIsLandmarkFocused(false);\n }, [setIsLandmarkFocused]);\n\n useLayoutEffect(() => {\n if (manager) {\n return manager.registerLandmark({ref, label, role, focus: focus || defaultFocus, blur});\n }\n }, [manager, label, ref, role, focus, defaultFocus, blur]);\n\n useEffect(() => {\n if (isLandmarkFocused) {\n ref.current?.focus();\n }\n }, [isLandmarkFocused, ref]);\n\n return {\n landmarkProps: {\n role,\n tabIndex: isLandmarkFocused ? -1 : undefined,\n 'aria-label': ariaLabel,\n 'aria-labelledby': ariaLabelledby\n }\n };\n}\n"],"names":[],"version":3,"file":"useLandmark.main.js.map"}
1
+ {"mappings":"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","sources":["packages/@react-aria/landmark/src/useLandmark.ts"],"sourcesContent":["/*\n * Copyright 2022 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport {AriaLabelingProps, DOMAttributes, FocusableElement, RefObject} from '@react-types/shared';\nimport {useCallback, useEffect, useState} from 'react';\nimport {useLayoutEffect} from '@react-aria/utils';\nimport {useSyncExternalStore} from 'use-sync-external-store/shim/index.js';\n\nexport type AriaLandmarkRole = 'main' | 'region' | 'search' | 'navigation' | 'form' | 'banner' | 'contentinfo' | 'complementary';\n\nexport interface AriaLandmarkProps extends AriaLabelingProps {\n role: AriaLandmarkRole,\n focus?: (direction: 'forward' | 'backward') => void\n}\n\nexport interface LandmarkAria {\n landmarkProps: DOMAttributes\n}\n\n// Increment this version number whenever the\n// LandmarkManagerApi or Landmark interfaces change.\nconst LANDMARK_API_VERSION = 1;\n\n// Minimal API for LandmarkManager that must continue to work between versions.\n// Changes to this interface are considered breaking. New methods/properties are\n// safe to add, but changes or removals are not allowed (same as public APIs).\ninterface LandmarkManagerApi {\n version: number,\n createLandmarkController(): LandmarkController,\n registerLandmark(landmark: Landmark): () => void\n}\n\n// Changes to this interface are considered breaking.\n// New properties MUST be optional so that registering a landmark\n// from an older version of useLandmark against a newer version of\n// LandmarkManager does not crash.\ninterface Landmark {\n ref: RefObject<FocusableElement | null>,\n role: AriaLandmarkRole,\n label?: string,\n lastFocused?: FocusableElement,\n focus: (direction: 'forward' | 'backward') => void,\n blur: () => void\n}\n\nexport interface LandmarkControllerOptions {\n /**\n * The element from which to start navigating.\n * @default document.activeElement\n */\n from?: FocusableElement\n}\n\n/** A LandmarkController allows programmatic navigation of landmarks. */\nexport interface LandmarkController {\n /** Moves focus to the next landmark. */\n focusNext(opts?: LandmarkControllerOptions): boolean,\n /** Moves focus to the previous landmark. */\n focusPrevious(opts?: LandmarkControllerOptions): boolean,\n /** Moves focus to the main landmark. */\n focusMain(): boolean,\n /** Moves focus either forward or backward in the landmark sequence. */\n navigate(direction: 'forward' | 'backward', opts?: LandmarkControllerOptions): boolean,\n /**\n * Disposes the landmark controller. When no landmarks are registered, and no\n * controllers are active, the landmark keyboard listeners are removed from the page.\n */\n dispose(): void\n}\n\n// Symbol under which the singleton landmark manager instance is attached to the document.\nconst landmarkSymbol = Symbol.for('react-aria-landmark-manager');\n\nfunction subscribe(fn: () => void) {\n document.addEventListener('react-aria-landmark-manager-change', fn);\n return () => document.removeEventListener('react-aria-landmark-manager-change', fn);\n}\n\nfunction getLandmarkManager(): LandmarkManagerApi | null {\n if (typeof document === 'undefined') {\n return null;\n }\n\n // Reuse an existing instance if it has the same or greater version.\n let instance = document[landmarkSymbol];\n if (instance && instance.version >= LANDMARK_API_VERSION) {\n return instance;\n }\n\n // Otherwise, create a new instance and dispatch an event so anything using the existing\n // instance updates and re-registers their landmarks with the new one.\n document[landmarkSymbol] = new LandmarkManager();\n document.dispatchEvent(new CustomEvent('react-aria-landmark-manager-change'));\n return document[landmarkSymbol];\n}\n\n// Subscribes a React component to the current landmark manager instance.\nfunction useLandmarkManager(): LandmarkManagerApi | null {\n return useSyncExternalStore(subscribe, getLandmarkManager, getLandmarkManager);\n}\n\nclass LandmarkManager implements LandmarkManagerApi {\n private landmarks: Array<Landmark> = [];\n private isListening = false;\n private refCount = 0;\n public version = LANDMARK_API_VERSION;\n\n constructor() {\n this.f6Handler = this.f6Handler.bind(this);\n this.focusinHandler = this.focusinHandler.bind(this);\n this.focusoutHandler = this.focusoutHandler.bind(this);\n }\n\n private setupIfNeeded() {\n if (this.isListening) {\n return;\n }\n document.addEventListener('keydown', this.f6Handler, {capture: true});\n document.addEventListener('focusin', this.focusinHandler, {capture: true});\n document.addEventListener('focusout', this.focusoutHandler, {capture: true});\n this.isListening = true;\n }\n\n private teardownIfNeeded() {\n if (!this.isListening || this.landmarks.length > 0 || this.refCount > 0) {\n return;\n }\n document.removeEventListener('keydown', this.f6Handler, {capture: true});\n document.removeEventListener('focusin', this.focusinHandler, {capture: true});\n document.removeEventListener('focusout', this.focusoutHandler, {capture: true});\n this.isListening = false;\n }\n\n private focusLandmark(landmark: FocusableElement, direction: 'forward' | 'backward') {\n this.landmarks.find(l => l.ref.current === landmark)?.focus?.(direction);\n }\n\n /**\n * Return set of landmarks with a specific role.\n */\n private getLandmarksByRole(role: AriaLandmarkRole) {\n return new Set(this.landmarks.filter(l => l.role === role));\n }\n\n /**\n * Return first landmark with a specific role.\n */\n private getLandmarkByRole(role: AriaLandmarkRole) {\n return this.landmarks.find(l => l.role === role);\n }\n\n private addLandmark(newLandmark: Landmark) {\n this.setupIfNeeded();\n if (this.landmarks.find(landmark => landmark.ref === newLandmark.ref) || !newLandmark.ref.current) {\n return;\n }\n\n if (this.landmarks.filter(landmark => landmark.role === 'main').length > 1) {\n console.error('Page can contain no more than one landmark with the role \"main\".');\n }\n\n if (this.landmarks.length === 0) {\n this.landmarks = [newLandmark];\n this.checkLabels(newLandmark.role);\n return;\n }\n\n\n // Binary search to insert new landmark based on position in document relative to existing landmarks.\n // https://developer.mozilla.org/en-US/docs/Web/API/Node/compareDocumentPosition\n let start = 0;\n let end = this.landmarks.length - 1;\n while (start <= end) {\n let mid = Math.floor((start + end) / 2);\n let comparedPosition = newLandmark.ref.current.compareDocumentPosition(this.landmarks[mid].ref.current as Node);\n let isNewAfterExisting = Boolean((comparedPosition & Node.DOCUMENT_POSITION_PRECEDING) || (comparedPosition & Node.DOCUMENT_POSITION_CONTAINS));\n\n if (isNewAfterExisting) {\n start = mid + 1;\n } else {\n end = mid - 1;\n }\n }\n\n this.landmarks.splice(start, 0, newLandmark);\n this.checkLabels(newLandmark.role);\n }\n\n private updateLandmark(landmark: Pick<Landmark, 'ref'> & Partial<Landmark>) {\n let index = this.landmarks.findIndex(l => l.ref === landmark.ref);\n if (index >= 0) {\n this.landmarks[index] = {...this.landmarks[index], ...landmark};\n this.checkLabels(this.landmarks[index].role);\n }\n }\n\n private removeLandmark(ref: RefObject<Element | null>) {\n this.landmarks = this.landmarks.filter(landmark => landmark.ref !== ref);\n this.teardownIfNeeded();\n }\n\n /**\n * Warn if there are 2+ landmarks with the same role but no label.\n * Labels for landmarks with the same role must also be unique.\n *\n * See https://www.w3.org/WAI/ARIA/apg/practices/landmark-regions/.\n */\n private checkLabels(role: AriaLandmarkRole) {\n let landmarksWithRole = this.getLandmarksByRole(role);\n if (landmarksWithRole.size > 1) {\n let duplicatesWithoutLabel = [...landmarksWithRole].filter(landmark => !landmark.label);\n if (duplicatesWithoutLabel.length > 0) {\n console.warn(\n `Page contains more than one landmark with the '${role}' role. If two or more landmarks on a page share the same role, all must be labeled with an aria-label or aria-labelledby attribute: `,\n duplicatesWithoutLabel.map(landmark => landmark.ref.current)\n );\n } else {\n let labels = [...landmarksWithRole].map(landmark => landmark.label);\n let duplicateLabels = labels.filter((item, index) => labels.indexOf(item) !== index);\n\n duplicateLabels.forEach((label) => {\n console.warn(\n `Page contains more than one landmark with the '${role}' role and '${label}' label. If two or more landmarks on a page share the same role, they must have unique labels: `,\n [...landmarksWithRole].filter(landmark => landmark.label === label).map(landmark => landmark.ref.current)\n );\n });\n }\n }\n }\n\n /**\n * Get the landmark that is the closest parent in the DOM.\n * Returns undefined if no parent is a landmark.\n */\n private closestLandmark(element: FocusableElement) {\n let landmarkMap = new Map(this.landmarks.map(l => [l.ref.current, l]));\n let currentElement = element;\n while (currentElement && !landmarkMap.has(currentElement) && currentElement !== document.body && currentElement.parentElement) {\n currentElement = currentElement.parentElement;\n }\n return landmarkMap.get(currentElement);\n }\n\n /**\n * Gets the next landmark, in DOM focus order, or previous if backwards is specified.\n * If last landmark, next should be the first landmark.\n * If not inside a landmark, will return first landmark.\n * Returns undefined if there are no landmarks.\n */\n private getNextLandmark(element: FocusableElement, {backward}: {backward?: boolean }) {\n let currentLandmark = this.closestLandmark(element);\n let nextLandmarkIndex = backward ? this.landmarks.length - 1 : 0;\n if (currentLandmark) {\n nextLandmarkIndex = this.landmarks.indexOf(currentLandmark) + (backward ? -1 : 1);\n }\n\n let wrapIfNeeded = () => {\n // When we reach the end of the landmark sequence, fire a custom event that can be listened for by applications.\n // If this event is canceled, we return immediately. This can be used to implement landmark navigation across iframes.\n if (nextLandmarkIndex < 0) {\n if (!element.dispatchEvent(new CustomEvent('react-aria-landmark-navigation', {detail: {direction: 'backward'}, bubbles: true, cancelable: true}))) {\n return true;\n }\n\n nextLandmarkIndex = this.landmarks.length - 1;\n } else if (nextLandmarkIndex >= this.landmarks.length) {\n if (!element.dispatchEvent(new CustomEvent('react-aria-landmark-navigation', {detail: {direction: 'forward'}, bubbles: true, cancelable: true}))) {\n return true;\n }\n\n nextLandmarkIndex = 0;\n }\n\n if (nextLandmarkIndex < 0 || nextLandmarkIndex >= this.landmarks.length) {\n return true;\n }\n\n return false;\n };\n\n if (wrapIfNeeded()) {\n return undefined;\n }\n\n // Skip over hidden landmarks.\n let i = nextLandmarkIndex;\n while (this.landmarks[nextLandmarkIndex].ref.current?.closest('[aria-hidden=true]')) {\n nextLandmarkIndex += backward ? -1 : 1;\n if (wrapIfNeeded()) {\n return undefined;\n }\n\n if (nextLandmarkIndex === i) {\n break;\n }\n }\n\n return this.landmarks[nextLandmarkIndex];\n }\n\n /**\n * Look at next landmark. If an element was previously focused inside, restore focus there.\n * If not, focus the landmark itself.\n * If no landmarks at all, or none with focusable elements, don't move focus.\n */\n private f6Handler(e: KeyboardEvent) {\n if (e.key === 'F6') {\n // If alt key pressed, focus main landmark, otherwise navigate forward or backward based on shift key.\n let handled = e.altKey ? this.focusMain() : this.navigate(e.target as FocusableElement, e.shiftKey);\n if (handled) {\n e.preventDefault();\n e.stopPropagation();\n }\n }\n }\n\n private focusMain() {\n let main = this.getLandmarkByRole('main');\n if (main && main.ref.current && document.contains(main.ref.current)) {\n this.focusLandmark(main.ref.current, 'forward');\n return true;\n }\n\n return false;\n }\n\n private navigate(from: FocusableElement, backward: boolean) {\n let nextLandmark = this.getNextLandmark(from, {\n backward\n });\n\n if (!nextLandmark) {\n return false;\n }\n\n // If something was previously focused in the next landmark, then return focus to it\n if (nextLandmark.lastFocused) {\n let lastFocused = nextLandmark.lastFocused;\n if (document.body.contains(lastFocused)) {\n lastFocused.focus();\n return true;\n }\n }\n\n // Otherwise, focus the landmark itself\n if (nextLandmark.ref.current && document.contains(nextLandmark.ref.current)) {\n this.focusLandmark(nextLandmark.ref.current, backward ? 'backward' : 'forward');\n return true;\n }\n\n return false;\n }\n\n /**\n * Sets lastFocused for a landmark, if focus is moved within that landmark.\n * Lets the last focused landmark know it was blurred if something else is focused.\n */\n private focusinHandler(e: FocusEvent) {\n let currentLandmark = this.closestLandmark(e.target as FocusableElement);\n if (currentLandmark && currentLandmark.ref.current !== e.target) {\n this.updateLandmark({ref: currentLandmark.ref, lastFocused: e.target as FocusableElement});\n }\n let previousFocusedElement = e.relatedTarget as FocusableElement;\n if (previousFocusedElement) {\n let closestPreviousLandmark = this.closestLandmark(previousFocusedElement);\n if (closestPreviousLandmark && closestPreviousLandmark.ref.current === previousFocusedElement) {\n closestPreviousLandmark.blur();\n }\n }\n }\n\n /**\n * Track if the focus is lost to the body. If it is, do cleanup on the landmark that last had focus.\n */\n private focusoutHandler(e: FocusEvent) {\n let previousFocusedElement = e.target as FocusableElement;\n let nextFocusedElement = e.relatedTarget;\n // the === document seems to be a jest thing for focus to go there on generic blur event such as landmark.blur();\n // browsers appear to send focus instead to document.body and the relatedTarget is null when that happens\n if (!nextFocusedElement || nextFocusedElement === document) {\n let closestPreviousLandmark = this.closestLandmark(previousFocusedElement);\n if (closestPreviousLandmark && closestPreviousLandmark.ref.current === previousFocusedElement) {\n closestPreviousLandmark.blur();\n }\n }\n }\n\n public createLandmarkController(): LandmarkController {\n let instance: LandmarkManager | null = this;\n instance.refCount++;\n instance.setupIfNeeded();\n return {\n navigate(direction, opts) {\n let element = opts?.from || (document!.activeElement as FocusableElement);\n return instance!.navigate(element, direction === 'backward');\n },\n focusNext(opts) {\n let element = opts?.from || (document!.activeElement as FocusableElement);\n return instance!.navigate(element, false);\n },\n focusPrevious(opts) {\n let element = opts?.from || (document!.activeElement as FocusableElement);\n return instance!.navigate(element, true);\n },\n focusMain() {\n return instance!.focusMain();\n },\n dispose() {\n if (instance) {\n instance.refCount--;\n instance.teardownIfNeeded();\n instance = null;\n }\n }\n };\n }\n\n public registerLandmark(landmark: Landmark): () => void {\n if (this.landmarks.find(l => l.ref === landmark.ref)) {\n this.updateLandmark(landmark);\n } else {\n this.addLandmark(landmark);\n }\n\n return () => this.removeLandmark(landmark.ref);\n }\n}\n\n/** Creates a LandmarkController, which allows programmatic navigation of landmarks. */\nexport function createLandmarkController(): LandmarkController {\n // Get the current landmark manager and create a controller using it.\n let instance: LandmarkManagerApi | null = getLandmarkManager();\n let controller = instance?.createLandmarkController();\n\n let unsubscribe = subscribe(() => {\n // If the landmark manager changes, dispose the old\n // controller and create a new one.\n controller?.dispose();\n instance = getLandmarkManager();\n controller = instance?.createLandmarkController();\n });\n\n // Return a wrapper that proxies requests to the current controller instance.\n return {\n navigate(direction, opts) {\n return controller!.navigate(direction, opts);\n },\n focusNext(opts) {\n return controller!.focusNext(opts);\n },\n focusPrevious(opts) {\n return controller!.focusPrevious(opts);\n },\n focusMain() {\n return controller!.focusMain();\n },\n dispose() {\n controller?.dispose();\n unsubscribe();\n controller = undefined;\n instance = null;\n }\n };\n}\n\n/**\n * Provides landmark navigation in an application. Call this with a role and label to register a landmark navigable with F6.\n * @param props - Props for the landmark.\n * @param ref - Ref to the landmark.\n */\nexport function useLandmark(props: AriaLandmarkProps, ref: RefObject<FocusableElement | null>): LandmarkAria {\n const {\n role,\n 'aria-label': ariaLabel,\n 'aria-labelledby': ariaLabelledby,\n focus\n } = props;\n let manager = useLandmarkManager();\n let label = ariaLabel || ariaLabelledby;\n let [isLandmarkFocused, setIsLandmarkFocused] = useState(false);\n\n let defaultFocus = useCallback(() => {\n setIsLandmarkFocused(true);\n }, [setIsLandmarkFocused]);\n\n let blur = useCallback(() => {\n setIsLandmarkFocused(false);\n }, [setIsLandmarkFocused]);\n\n useLayoutEffect(() => {\n if (manager) {\n return manager.registerLandmark({ref, label, role, focus: focus || defaultFocus, blur});\n }\n }, [manager, label, ref, role, focus, defaultFocus, blur]);\n\n useEffect(() => {\n if (isLandmarkFocused) {\n ref.current?.focus();\n }\n }, [isLandmarkFocused, ref]);\n\n return {\n landmarkProps: {\n role,\n tabIndex: isLandmarkFocused ? -1 : undefined,\n 'aria-label': ariaLabel,\n 'aria-labelledby': ariaLabelledby\n }\n };\n}\n"],"names":[],"version":3,"file":"useLandmark.main.js.map"}
package/dist/useLandmark.mjs CHANGED
@@ -19,20 +19,20 @@ import {useSyncExternalStore as $3xCwh$useSyncExternalStore} from "use-sync-exte
19
19
  // LandmarkManagerApi or Landmark interfaces change.
20
20
  const $a86207c5d7f7e1fb$var$LANDMARK_API_VERSION = 1;
21
21
  // Symbol under which the singleton landmark manager instance is attached to the document.
22
- const $a86207c5d7f7e1fb$var$landmarkSymbol = Symbol.for("react-aria-landmark-manager");
22
+ const $a86207c5d7f7e1fb$var$landmarkSymbol = Symbol.for('react-aria-landmark-manager');
23
23
  function $a86207c5d7f7e1fb$var$subscribe(fn) {
24
- document.addEventListener("react-aria-landmark-manager-change", fn);
25
- return ()=>document.removeEventListener("react-aria-landmark-manager-change", fn);
24
+ document.addEventListener('react-aria-landmark-manager-change', fn);
25
+ return ()=>document.removeEventListener('react-aria-landmark-manager-change', fn);
26
26
  }
27
27
  function $a86207c5d7f7e1fb$var$getLandmarkManager() {
28
- if (typeof document === "undefined") return null;
28
+ if (typeof document === 'undefined') return null;
29
29
  // Reuse an existing instance if it has the same or greater version.
30
30
  let instance = document[$a86207c5d7f7e1fb$var$landmarkSymbol];
31
31
  if (instance && instance.version >= $a86207c5d7f7e1fb$var$LANDMARK_API_VERSION) return instance;
32
32
  // Otherwise, create a new instance and dispatch an event so anything using the existing
33
33
  // instance updates and re-registers their landmarks with the new one.
34
34
  document[$a86207c5d7f7e1fb$var$landmarkSymbol] = new $a86207c5d7f7e1fb$var$LandmarkManager();
35
- document.dispatchEvent(new CustomEvent("react-aria-landmark-manager-change"));
35
+ document.dispatchEvent(new CustomEvent('react-aria-landmark-manager-change'));
36
36
  return document[$a86207c5d7f7e1fb$var$landmarkSymbol];
37
37
  }
38
38
  // Subscribes a React component to the current landmark manager instance.
@@ -42,26 +42,26 @@ function $a86207c5d7f7e1fb$var$useLandmarkManager() {
42
42
  class $a86207c5d7f7e1fb$var$LandmarkManager {
43
43
  setupIfNeeded() {
44
44
  if (this.isListening) return;
45
- document.addEventListener("keydown", this.f6Handler, {
45
+ document.addEventListener('keydown', this.f6Handler, {
46
46
  capture: true
47
47
  });
48
- document.addEventListener("focusin", this.focusinHandler, {
48
+ document.addEventListener('focusin', this.focusinHandler, {
49
49
  capture: true
50
50
  });
51
- document.addEventListener("focusout", this.focusoutHandler, {
51
+ document.addEventListener('focusout', this.focusoutHandler, {
52
52
  capture: true
53
53
  });
54
54
  this.isListening = true;
55
55
  }
56
56
  teardownIfNeeded() {
57
57
  if (!this.isListening || this.landmarks.length > 0 || this.refCount > 0) return;
58
- document.removeEventListener("keydown", this.f6Handler, {
58
+ document.removeEventListener('keydown', this.f6Handler, {
59
59
  capture: true
60
60
  });
61
- document.removeEventListener("focusin", this.focusinHandler, {
61
+ document.removeEventListener('focusin', this.focusinHandler, {
62
62
  capture: true
63
63
  });
64
- document.removeEventListener("focusout", this.focusoutHandler, {
64
+ document.removeEventListener('focusout', this.focusoutHandler, {
65
65
  capture: true
66
66
  });
67
67
  this.isListening = false;
@@ -83,7 +83,7 @@ class $a86207c5d7f7e1fb$var$LandmarkManager {
83
83
  addLandmark(newLandmark) {
84
84
  this.setupIfNeeded();
85
85
  if (this.landmarks.find((landmark)=>landmark.ref === newLandmark.ref) || !newLandmark.ref.current) return;
86
- if (this.landmarks.filter((landmark)=>landmark.role === "main").length > 1) console.error('Page can contain no more than one landmark with the role "main".');
86
+ if (this.landmarks.filter((landmark)=>landmark.role === 'main').length > 1) console.error('Page can contain no more than one landmark with the role "main".');
87
87
  if (this.landmarks.length === 0) {
88
88
  this.landmarks = [
89
89
  newLandmark
@@ -170,18 +170,18 @@ class $a86207c5d7f7e1fb$var$LandmarkManager {
170
170
  // When we reach the end of the landmark sequence, fire a custom event that can be listened for by applications.
171
171
  // If this event is canceled, we return immediately. This can be used to implement landmark navigation across iframes.
172
172
  if (nextLandmarkIndex < 0) {
173
- if (!element.dispatchEvent(new CustomEvent("react-aria-landmark-navigation", {
173
+ if (!element.dispatchEvent(new CustomEvent('react-aria-landmark-navigation', {
174
174
  detail: {
175
- direction: "backward"
175
+ direction: 'backward'
176
176
  },
177
177
  bubbles: true,
178
178
  cancelable: true
179
179
  }))) return true;
180
180
  nextLandmarkIndex = this.landmarks.length - 1;
181
181
  } else if (nextLandmarkIndex >= this.landmarks.length) {
182
- if (!element.dispatchEvent(new CustomEvent("react-aria-landmark-navigation", {
182
+ if (!element.dispatchEvent(new CustomEvent('react-aria-landmark-navigation', {
183
183
  detail: {
184
- direction: "forward"
184
+ direction: 'forward'
185
185
  },
186
186
  bubbles: true,
187
187
  cancelable: true
@@ -194,7 +194,7 @@ class $a86207c5d7f7e1fb$var$LandmarkManager {
194
194
  if (wrapIfNeeded()) return undefined;
195
195
  // Skip over hidden landmarks.
196
196
  let i = nextLandmarkIndex;
197
- while((_this_landmarks_nextLandmarkIndex_ref_current = this.landmarks[nextLandmarkIndex].ref.current) === null || _this_landmarks_nextLandmarkIndex_ref_current === void 0 ? void 0 : _this_landmarks_nextLandmarkIndex_ref_current.closest("[aria-hidden=true]")){
197
+ while((_this_landmarks_nextLandmarkIndex_ref_current = this.landmarks[nextLandmarkIndex].ref.current) === null || _this_landmarks_nextLandmarkIndex_ref_current === void 0 ? void 0 : _this_landmarks_nextLandmarkIndex_ref_current.closest('[aria-hidden=true]')){
198
198
  nextLandmarkIndex += backward ? -1 : 1;
199
199
  if (wrapIfNeeded()) return undefined;
200
200
  if (nextLandmarkIndex === i) break;
@@ -206,7 +206,7 @@ class $a86207c5d7f7e1fb$var$LandmarkManager {
206
206
  * If not, focus the landmark itself.
207
207
  * If no landmarks at all, or none with focusable elements, don't move focus.
208
208
  */ f6Handler(e) {
209
- if (e.key === "F6") {
209
+ if (e.key === 'F6') {
210
210
  // If alt key pressed, focus main landmark, otherwise navigate forward or backward based on shift key.
211
211
  let handled = e.altKey ? this.focusMain() : this.navigate(e.target, e.shiftKey);
212
212
  if (handled) {
@@ -216,9 +216,9 @@ class $a86207c5d7f7e1fb$var$LandmarkManager {
216
216
  }
217
217
  }
218
218
  focusMain() {
219
- let main = this.getLandmarkByRole("main");
219
+ let main = this.getLandmarkByRole('main');
220
220
  if (main && main.ref.current && document.contains(main.ref.current)) {
221
- this.focusLandmark(main.ref.current, "forward");
221
+ this.focusLandmark(main.ref.current, 'forward');
222
222
  return true;
223
223
  }
224
224
  return false;
@@ -238,7 +238,7 @@ class $a86207c5d7f7e1fb$var$LandmarkManager {
238
238
  }
239
239
  // Otherwise, focus the landmark itself
240
240
  if (nextLandmark.ref.current && document.contains(nextLandmark.ref.current)) {
241
- this.focusLandmark(nextLandmark.ref.current, backward ? "backward" : "forward");
241
+ this.focusLandmark(nextLandmark.ref.current, backward ? 'backward' : 'forward');
242
242
  return true;
243
243
  }
244
244
  return false;
@@ -277,7 +277,7 @@ class $a86207c5d7f7e1fb$var$LandmarkManager {
277
277
  return {
278
278
  navigate (direction, opts) {
279
279
  let element = (opts === null || opts === void 0 ? void 0 : opts.from) || document.activeElement;
280
- return instance.navigate(element, direction === "backward");
280
+ return instance.navigate(element, direction === 'backward');
281
281
  },
282
282
  focusNext (opts) {
283
283
  let element = (opts === null || opts === void 0 ? void 0 : opts.from) || document.activeElement;
@@ -348,7 +348,7 @@ function $a86207c5d7f7e1fb$export$f50151dbd51cd1d9() {
348
348
  };
349
349
  }
350
350
  function $a86207c5d7f7e1fb$export$4cc632584fd87fae(props, ref) {
351
- const { role: role, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledby, focus: focus } = props;
351
+ const { role: role, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledby, focus: focus } = props;
352
352
  let manager = $a86207c5d7f7e1fb$var$useLandmarkManager();
353
353
  let label = ariaLabel || ariaLabelledby;
354
354
  let [isLandmarkFocused, setIsLandmarkFocused] = (0, $3xCwh$useState)(false);
@@ -390,12 +390,12 @@ function $a86207c5d7f7e1fb$export$4cc632584fd87fae(props, ref) {
390
390
  landmarkProps: {
391
391
  role: role,
392
392
  tabIndex: isLandmarkFocused ? -1 : undefined,
393
- "aria-label": ariaLabel,
394
- "aria-labelledby": ariaLabelledby
393
+ 'aria-label': ariaLabel,
394
+ 'aria-labelledby': ariaLabelledby
395
395
  }
396
396
  };
397
397
  }
398
398
 
399
399
 
400
400
  export {$a86207c5d7f7e1fb$export$f50151dbd51cd1d9 as createLandmarkController, $a86207c5d7f7e1fb$export$4cc632584fd87fae as useLandmark};
401
- //# sourceMappingURL=useLandmark.mjs.map
401
+ //# sourceMappingURL=useLandmark.module.js.map
package/dist/useLandmark.module.js CHANGED
@@ -19,20 +19,20 @@ import {useSyncExternalStore as $3xCwh$useSyncExternalStore} from "use-sync-exte
19
19
  // LandmarkManagerApi or Landmark interfaces change.
20
20
  const $a86207c5d7f7e1fb$var$LANDMARK_API_VERSION = 1;
21
21
  // Symbol under which the singleton landmark manager instance is attached to the document.
22
- const $a86207c5d7f7e1fb$var$landmarkSymbol = Symbol.for("react-aria-landmark-manager");
22
+ const $a86207c5d7f7e1fb$var$landmarkSymbol = Symbol.for('react-aria-landmark-manager');
23
23
  function $a86207c5d7f7e1fb$var$subscribe(fn) {
24
- document.addEventListener("react-aria-landmark-manager-change", fn);
25
- return ()=>document.removeEventListener("react-aria-landmark-manager-change", fn);
24
+ document.addEventListener('react-aria-landmark-manager-change', fn);
25
+ return ()=>document.removeEventListener('react-aria-landmark-manager-change', fn);
26
26
  }
27
27
  function $a86207c5d7f7e1fb$var$getLandmarkManager() {
28
- if (typeof document === "undefined") return null;
28
+ if (typeof document === 'undefined') return null;
29
29
  // Reuse an existing instance if it has the same or greater version.
30
30
  let instance = document[$a86207c5d7f7e1fb$var$landmarkSymbol];
31
31
  if (instance && instance.version >= $a86207c5d7f7e1fb$var$LANDMARK_API_VERSION) return instance;
32
32
  // Otherwise, create a new instance and dispatch an event so anything using the existing
33
33
  // instance updates and re-registers their landmarks with the new one.
34
34
  document[$a86207c5d7f7e1fb$var$landmarkSymbol] = new $a86207c5d7f7e1fb$var$LandmarkManager();
35
- document.dispatchEvent(new CustomEvent("react-aria-landmark-manager-change"));
35
+ document.dispatchEvent(new CustomEvent('react-aria-landmark-manager-change'));
36
36
  return document[$a86207c5d7f7e1fb$var$landmarkSymbol];
37
37
  }
38
38
  // Subscribes a React component to the current landmark manager instance.
@@ -42,26 +42,26 @@ function $a86207c5d7f7e1fb$var$useLandmarkManager() {
42
42
  class $a86207c5d7f7e1fb$var$LandmarkManager {
43
43
  setupIfNeeded() {
44
44
  if (this.isListening) return;
45
- document.addEventListener("keydown", this.f6Handler, {
45
+ document.addEventListener('keydown', this.f6Handler, {
46
46
  capture: true
47
47
  });
48
- document.addEventListener("focusin", this.focusinHandler, {
48
+ document.addEventListener('focusin', this.focusinHandler, {
49
49
  capture: true
50
50
  });
51
- document.addEventListener("focusout", this.focusoutHandler, {
51
+ document.addEventListener('focusout', this.focusoutHandler, {
52
52
  capture: true
53
53
  });
54
54
  this.isListening = true;
55
55
  }
56
56
  teardownIfNeeded() {
57
57
  if (!this.isListening || this.landmarks.length > 0 || this.refCount > 0) return;
58
- document.removeEventListener("keydown", this.f6Handler, {
58
+ document.removeEventListener('keydown', this.f6Handler, {
59
59
  capture: true
60
60
  });
61
- document.removeEventListener("focusin", this.focusinHandler, {
61
+ document.removeEventListener('focusin', this.focusinHandler, {
62
62
  capture: true
63
63
  });
64
- document.removeEventListener("focusout", this.focusoutHandler, {
64
+ document.removeEventListener('focusout', this.focusoutHandler, {
65
65
  capture: true
66
66
  });
67
67
  this.isListening = false;
@@ -83,7 +83,7 @@ class $a86207c5d7f7e1fb$var$LandmarkManager {
83
83
  addLandmark(newLandmark) {
84
84
  this.setupIfNeeded();
85
85
  if (this.landmarks.find((landmark)=>landmark.ref === newLandmark.ref) || !newLandmark.ref.current) return;
86
- if (this.landmarks.filter((landmark)=>landmark.role === "main").length > 1) console.error('Page can contain no more than one landmark with the role "main".');
86
+ if (this.landmarks.filter((landmark)=>landmark.role === 'main').length > 1) console.error('Page can contain no more than one landmark with the role "main".');
87
87
  if (this.landmarks.length === 0) {
88
88
  this.landmarks = [
89
89
  newLandmark
@@ -170,18 +170,18 @@ class $a86207c5d7f7e1fb$var$LandmarkManager {
170
170
  // When we reach the end of the landmark sequence, fire a custom event that can be listened for by applications.
171
171
  // If this event is canceled, we return immediately. This can be used to implement landmark navigation across iframes.
172
172
  if (nextLandmarkIndex < 0) {
173
- if (!element.dispatchEvent(new CustomEvent("react-aria-landmark-navigation", {
173
+ if (!element.dispatchEvent(new CustomEvent('react-aria-landmark-navigation', {
174
174
  detail: {
175
- direction: "backward"
175
+ direction: 'backward'
176
176
  },
177
177
  bubbles: true,
178
178
  cancelable: true
179
179
  }))) return true;
180
180
  nextLandmarkIndex = this.landmarks.length - 1;
181
181
  } else if (nextLandmarkIndex >= this.landmarks.length) {
182
- if (!element.dispatchEvent(new CustomEvent("react-aria-landmark-navigation", {
182
+ if (!element.dispatchEvent(new CustomEvent('react-aria-landmark-navigation', {
183
183
  detail: {
184
- direction: "forward"
184
+ direction: 'forward'
185
185
  },
186
186
  bubbles: true,
187
187
  cancelable: true
@@ -194,7 +194,7 @@ class $a86207c5d7f7e1fb$var$LandmarkManager {
194
194
  if (wrapIfNeeded()) return undefined;
195
195
  // Skip over hidden landmarks.
196
196
  let i = nextLandmarkIndex;
197
- while((_this_landmarks_nextLandmarkIndex_ref_current = this.landmarks[nextLandmarkIndex].ref.current) === null || _this_landmarks_nextLandmarkIndex_ref_current === void 0 ? void 0 : _this_landmarks_nextLandmarkIndex_ref_current.closest("[aria-hidden=true]")){
197
+ while((_this_landmarks_nextLandmarkIndex_ref_current = this.landmarks[nextLandmarkIndex].ref.current) === null || _this_landmarks_nextLandmarkIndex_ref_current === void 0 ? void 0 : _this_landmarks_nextLandmarkIndex_ref_current.closest('[aria-hidden=true]')){
198
198
  nextLandmarkIndex += backward ? -1 : 1;
199
199
  if (wrapIfNeeded()) return undefined;
200
200
  if (nextLandmarkIndex === i) break;
@@ -206,7 +206,7 @@ class $a86207c5d7f7e1fb$var$LandmarkManager {
206
206
  * If not, focus the landmark itself.
207
207
  * If no landmarks at all, or none with focusable elements, don't move focus.
208
208
  */ f6Handler(e) {
209
- if (e.key === "F6") {
209
+ if (e.key === 'F6') {
210
210
  // If alt key pressed, focus main landmark, otherwise navigate forward or backward based on shift key.
211
211
  let handled = e.altKey ? this.focusMain() : this.navigate(e.target, e.shiftKey);
212
212
  if (handled) {
@@ -216,9 +216,9 @@ class $a86207c5d7f7e1fb$var$LandmarkManager {
216
216
  }
217
217
  }
218
218
  focusMain() {
219
- let main = this.getLandmarkByRole("main");
219
+ let main = this.getLandmarkByRole('main');
220
220
  if (main && main.ref.current && document.contains(main.ref.current)) {
221
- this.focusLandmark(main.ref.current, "forward");
221
+ this.focusLandmark(main.ref.current, 'forward');
222
222
  return true;
223
223
  }
224
224
  return false;
@@ -238,7 +238,7 @@ class $a86207c5d7f7e1fb$var$LandmarkManager {
238
238
  }
239
239
  // Otherwise, focus the landmark itself
240
240
  if (nextLandmark.ref.current && document.contains(nextLandmark.ref.current)) {
241
- this.focusLandmark(nextLandmark.ref.current, backward ? "backward" : "forward");
241
+ this.focusLandmark(nextLandmark.ref.current, backward ? 'backward' : 'forward');
242
242
  return true;
243
243
  }
244
244
  return false;
@@ -277,7 +277,7 @@ class $a86207c5d7f7e1fb$var$LandmarkManager {
277
277
  return {
278
278
  navigate (direction, opts) {
279
279
  let element = (opts === null || opts === void 0 ? void 0 : opts.from) || document.activeElement;
280
- return instance.navigate(element, direction === "backward");
280
+ return instance.navigate(element, direction === 'backward');
281
281
  },
282
282
  focusNext (opts) {
283
283
  let element = (opts === null || opts === void 0 ? void 0 : opts.from) || document.activeElement;
@@ -348,7 +348,7 @@ function $a86207c5d7f7e1fb$export$f50151dbd51cd1d9() {
348
348
  };
349
349
  }
350
350
  function $a86207c5d7f7e1fb$export$4cc632584fd87fae(props, ref) {
351
- const { role: role, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledby, focus: focus } = props;
351
+ const { role: role, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledby, focus: focus } = props;
352
352
  let manager = $a86207c5d7f7e1fb$var$useLandmarkManager();
353
353
  let label = ariaLabel || ariaLabelledby;
354
354
  let [isLandmarkFocused, setIsLandmarkFocused] = (0, $3xCwh$useState)(false);
@@ -390,8 +390,8 @@ function $a86207c5d7f7e1fb$export$4cc632584fd87fae(props, ref) {
390
390
  landmarkProps: {
391
391
  role: role,
392
392
  tabIndex: isLandmarkFocused ? -1 : undefined,
393
- "aria-label": ariaLabel,
394
- "aria-labelledby": ariaLabelledby
393
+ 'aria-label': ariaLabel,
394
+ 'aria-labelledby': ariaLabelledby
395
395
  }
396
396
  };
397
397
  }
package/dist/useLandmark.module.js.map CHANGED
@@ -1 +1 @@
1
- {"mappings":"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","sources":["packages/@react-aria/landmark/src/useLandmark.ts"],"sourcesContent":["/*\n * Copyright 2022 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport {AriaLabelingProps, DOMAttributes, FocusableElement} from '@react-types/shared';\nimport {RefObject, useCallback, useEffect, useState} from 'react';\nimport {useLayoutEffect} from '@react-aria/utils';\nimport {useSyncExternalStore} from 'use-sync-external-store/shim/index.js';\n\nexport type AriaLandmarkRole = 'main' | 'region' | 'search' | 'navigation' | 'form' | 'banner' | 'contentinfo' | 'complementary';\n\nexport interface AriaLandmarkProps extends AriaLabelingProps {\n role: AriaLandmarkRole,\n focus?: (direction: 'forward' | 'backward') => void\n}\n\nexport interface LandmarkAria {\n landmarkProps: DOMAttributes\n}\n\n// Increment this version number whenever the\n// LandmarkManagerApi or Landmark interfaces change.\nconst LANDMARK_API_VERSION = 1;\n\n// Minimal API for LandmarkManager that must continue to work between versions.\n// Changes to this interface are considered breaking. New methods/properties are\n// safe to add, but changes or removals are not allowed (same as public APIs).\ninterface LandmarkManagerApi {\n version: number,\n createLandmarkController(): LandmarkController,\n registerLandmark(landmark: Landmark): () => void\n}\n\n// Changes to this interface are considered breaking.\n// New properties MUST be optional so that registering a landmark\n// from an older version of useLandmark against a newer version of\n// LandmarkManager does not crash.\ninterface Landmark {\n ref: RefObject<FocusableElement>,\n role: AriaLandmarkRole,\n label?: string,\n lastFocused?: FocusableElement,\n focus: (direction: 'forward' | 'backward') => void,\n blur: () => void\n}\n\nexport interface LandmarkControllerOptions {\n /**\n * The element from which to start navigating.\n * @default document.activeElement\n */\n from?: FocusableElement\n}\n\n/** A LandmarkController allows programmatic navigation of landmarks. */\nexport interface LandmarkController {\n /** Moves focus to the next landmark. */\n focusNext(opts?: LandmarkControllerOptions): boolean,\n /** Moves focus to the previous landmark. */\n focusPrevious(opts?: LandmarkControllerOptions): boolean,\n /** Moves focus to the main landmark. */\n focusMain(): boolean,\n /** Moves focus either forward or backward in the landmark sequence. */\n navigate(direction: 'forward' | 'backward', opts?: LandmarkControllerOptions): boolean,\n /**\n * Disposes the landmark controller. When no landmarks are registered, and no\n * controllers are active, the landmark keyboard listeners are removed from the page.\n */\n dispose(): void\n}\n\n// Symbol under which the singleton landmark manager instance is attached to the document.\nconst landmarkSymbol = Symbol.for('react-aria-landmark-manager');\n\nfunction subscribe(fn: () => void) {\n document.addEventListener('react-aria-landmark-manager-change', fn);\n return () => document.removeEventListener('react-aria-landmark-manager-change', fn);\n}\n\nfunction getLandmarkManager(): LandmarkManagerApi | null {\n if (typeof document === 'undefined') {\n return null;\n }\n\n // Reuse an existing instance if it has the same or greater version.\n let instance = document[landmarkSymbol];\n if (instance && instance.version >= LANDMARK_API_VERSION) {\n return instance;\n }\n\n // Otherwise, create a new instance and dispatch an event so anything using the existing\n // instance updates and re-registers their landmarks with the new one.\n document[landmarkSymbol] = new LandmarkManager();\n document.dispatchEvent(new CustomEvent('react-aria-landmark-manager-change'));\n return document[landmarkSymbol];\n}\n\n// Subscribes a React component to the current landmark manager instance.\nfunction useLandmarkManager(): LandmarkManagerApi | null {\n return useSyncExternalStore(subscribe, getLandmarkManager, getLandmarkManager);\n}\n\nclass LandmarkManager implements LandmarkManagerApi {\n private landmarks: Array<Landmark> = [];\n private isListening = false;\n private refCount = 0;\n public version = LANDMARK_API_VERSION;\n\n constructor() {\n this.f6Handler = this.f6Handler.bind(this);\n this.focusinHandler = this.focusinHandler.bind(this);\n this.focusoutHandler = this.focusoutHandler.bind(this);\n }\n\n private setupIfNeeded() {\n if (this.isListening) {\n return;\n }\n document.addEventListener('keydown', this.f6Handler, {capture: true});\n document.addEventListener('focusin', this.focusinHandler, {capture: true});\n document.addEventListener('focusout', this.focusoutHandler, {capture: true});\n this.isListening = true;\n }\n\n private teardownIfNeeded() {\n if (!this.isListening || this.landmarks.length > 0 || this.refCount > 0) {\n return;\n }\n document.removeEventListener('keydown', this.f6Handler, {capture: true});\n document.removeEventListener('focusin', this.focusinHandler, {capture: true});\n document.removeEventListener('focusout', this.focusoutHandler, {capture: true});\n this.isListening = false;\n }\n\n private focusLandmark(landmark: FocusableElement, direction: 'forward' | 'backward') {\n this.landmarks.find(l => l.ref.current === landmark)?.focus?.(direction);\n }\n\n /**\n * Return set of landmarks with a specific role.\n */\n private getLandmarksByRole(role: AriaLandmarkRole) {\n return new Set(this.landmarks.filter(l => l.role === role));\n }\n\n /**\n * Return first landmark with a specific role.\n */\n private getLandmarkByRole(role: AriaLandmarkRole) {\n return this.landmarks.find(l => l.role === role);\n }\n\n private addLandmark(newLandmark: Landmark) {\n this.setupIfNeeded();\n if (this.landmarks.find(landmark => landmark.ref === newLandmark.ref) || !newLandmark.ref.current) {\n return;\n }\n\n if (this.landmarks.filter(landmark => landmark.role === 'main').length > 1) {\n console.error('Page can contain no more than one landmark with the role \"main\".');\n }\n\n if (this.landmarks.length === 0) {\n this.landmarks = [newLandmark];\n this.checkLabels(newLandmark.role);\n return;\n }\n\n\n // Binary search to insert new landmark based on position in document relative to existing landmarks.\n // https://developer.mozilla.org/en-US/docs/Web/API/Node/compareDocumentPosition\n let start = 0;\n let end = this.landmarks.length - 1;\n while (start <= end) {\n let mid = Math.floor((start + end) / 2);\n let comparedPosition = newLandmark.ref.current.compareDocumentPosition(this.landmarks[mid].ref.current as Node);\n let isNewAfterExisting = Boolean((comparedPosition & Node.DOCUMENT_POSITION_PRECEDING) || (comparedPosition & Node.DOCUMENT_POSITION_CONTAINS));\n\n if (isNewAfterExisting) {\n start = mid + 1;\n } else {\n end = mid - 1;\n }\n }\n\n this.landmarks.splice(start, 0, newLandmark);\n this.checkLabels(newLandmark.role);\n }\n\n private updateLandmark(landmark: Pick<Landmark, 'ref'> & Partial<Landmark>) {\n let index = this.landmarks.findIndex(l => l.ref === landmark.ref);\n if (index >= 0) {\n this.landmarks[index] = {...this.landmarks[index], ...landmark};\n this.checkLabels(this.landmarks[index].role);\n }\n }\n\n private removeLandmark(ref: RefObject<Element>) {\n this.landmarks = this.landmarks.filter(landmark => landmark.ref !== ref);\n this.teardownIfNeeded();\n }\n\n /**\n * Warn if there are 2+ landmarks with the same role but no label.\n * Labels for landmarks with the same role must also be unique.\n *\n * See https://www.w3.org/WAI/ARIA/apg/practices/landmark-regions/.\n */\n private checkLabels(role: AriaLandmarkRole) {\n let landmarksWithRole = this.getLandmarksByRole(role);\n if (landmarksWithRole.size > 1) {\n let duplicatesWithoutLabel = [...landmarksWithRole].filter(landmark => !landmark.label);\n if (duplicatesWithoutLabel.length > 0) {\n console.warn(\n `Page contains more than one landmark with the '${role}' role. If two or more landmarks on a page share the same role, all must be labeled with an aria-label or aria-labelledby attribute: `,\n duplicatesWithoutLabel.map(landmark => landmark.ref.current)\n );\n } else {\n let labels = [...landmarksWithRole].map(landmark => landmark.label);\n let duplicateLabels = labels.filter((item, index) => labels.indexOf(item) !== index);\n\n duplicateLabels.forEach((label) => {\n console.warn(\n `Page contains more than one landmark with the '${role}' role and '${label}' label. If two or more landmarks on a page share the same role, they must have unique labels: `,\n [...landmarksWithRole].filter(landmark => landmark.label === label).map(landmark => landmark.ref.current)\n );\n });\n }\n }\n }\n\n /**\n * Get the landmark that is the closest parent in the DOM.\n * Returns undefined if no parent is a landmark.\n */\n private closestLandmark(element: FocusableElement) {\n let landmarkMap = new Map(this.landmarks.map(l => [l.ref.current, l]));\n let currentElement = element;\n while (currentElement && !landmarkMap.has(currentElement) && currentElement !== document.body && currentElement.parentElement) {\n currentElement = currentElement.parentElement;\n }\n return landmarkMap.get(currentElement);\n }\n\n /**\n * Gets the next landmark, in DOM focus order, or previous if backwards is specified.\n * If last landmark, next should be the first landmark.\n * If not inside a landmark, will return first landmark.\n * Returns undefined if there are no landmarks.\n */\n private getNextLandmark(element: FocusableElement, {backward}: {backward?: boolean }) {\n let currentLandmark = this.closestLandmark(element);\n let nextLandmarkIndex = backward ? this.landmarks.length - 1 : 0;\n if (currentLandmark) {\n nextLandmarkIndex = this.landmarks.indexOf(currentLandmark) + (backward ? -1 : 1);\n }\n\n let wrapIfNeeded = () => {\n // When we reach the end of the landmark sequence, fire a custom event that can be listened for by applications.\n // If this event is canceled, we return immediately. This can be used to implement landmark navigation across iframes.\n if (nextLandmarkIndex < 0) {\n if (!element.dispatchEvent(new CustomEvent('react-aria-landmark-navigation', {detail: {direction: 'backward'}, bubbles: true, cancelable: true}))) {\n return true;\n }\n\n nextLandmarkIndex = this.landmarks.length - 1;\n } else if (nextLandmarkIndex >= this.landmarks.length) {\n if (!element.dispatchEvent(new CustomEvent('react-aria-landmark-navigation', {detail: {direction: 'forward'}, bubbles: true, cancelable: true}))) {\n return true;\n }\n\n nextLandmarkIndex = 0;\n }\n\n if (nextLandmarkIndex < 0 || nextLandmarkIndex >= this.landmarks.length) {\n return true;\n }\n\n return false;\n };\n\n if (wrapIfNeeded()) {\n return undefined;\n }\n\n // Skip over hidden landmarks.\n let i = nextLandmarkIndex;\n while (this.landmarks[nextLandmarkIndex].ref.current?.closest('[aria-hidden=true]')) {\n nextLandmarkIndex += backward ? -1 : 1;\n if (wrapIfNeeded()) {\n return undefined;\n }\n\n if (nextLandmarkIndex === i) {\n break;\n }\n }\n\n return this.landmarks[nextLandmarkIndex];\n }\n\n /**\n * Look at next landmark. If an element was previously focused inside, restore focus there.\n * If not, focus the landmark itself.\n * If no landmarks at all, or none with focusable elements, don't move focus.\n */\n private f6Handler(e: KeyboardEvent) {\n if (e.key === 'F6') {\n // If alt key pressed, focus main landmark, otherwise navigate forward or backward based on shift key.\n let handled = e.altKey ? this.focusMain() : this.navigate(e.target as FocusableElement, e.shiftKey);\n if (handled) {\n e.preventDefault();\n e.stopPropagation();\n }\n }\n }\n\n private focusMain() {\n let main = this.getLandmarkByRole('main');\n if (main && main.ref.current && document.contains(main.ref.current)) {\n this.focusLandmark(main.ref.current, 'forward');\n return true;\n }\n\n return false;\n }\n\n private navigate(from: FocusableElement, backward: boolean) {\n let nextLandmark = this.getNextLandmark(from, {\n backward\n });\n\n if (!nextLandmark) {\n return false;\n }\n\n // If something was previously focused in the next landmark, then return focus to it\n if (nextLandmark.lastFocused) {\n let lastFocused = nextLandmark.lastFocused;\n if (document.body.contains(lastFocused)) {\n lastFocused.focus();\n return true;\n }\n }\n\n // Otherwise, focus the landmark itself\n if (nextLandmark.ref.current && document.contains(nextLandmark.ref.current)) {\n this.focusLandmark(nextLandmark.ref.current, backward ? 'backward' : 'forward');\n return true;\n }\n\n return false;\n }\n\n /**\n * Sets lastFocused for a landmark, if focus is moved within that landmark.\n * Lets the last focused landmark know it was blurred if something else is focused.\n */\n private focusinHandler(e: FocusEvent) {\n let currentLandmark = this.closestLandmark(e.target as FocusableElement);\n if (currentLandmark && currentLandmark.ref.current !== e.target) {\n this.updateLandmark({ref: currentLandmark.ref, lastFocused: e.target as FocusableElement});\n }\n let previousFocusedElement = e.relatedTarget as FocusableElement;\n if (previousFocusedElement) {\n let closestPreviousLandmark = this.closestLandmark(previousFocusedElement);\n if (closestPreviousLandmark && closestPreviousLandmark.ref.current === previousFocusedElement) {\n closestPreviousLandmark.blur();\n }\n }\n }\n\n /**\n * Track if the focus is lost to the body. If it is, do cleanup on the landmark that last had focus.\n */\n private focusoutHandler(e: FocusEvent) {\n let previousFocusedElement = e.target as FocusableElement;\n let nextFocusedElement = e.relatedTarget;\n // the === document seems to be a jest thing for focus to go there on generic blur event such as landmark.blur();\n // browsers appear to send focus instead to document.body and the relatedTarget is null when that happens\n if (!nextFocusedElement || nextFocusedElement === document) {\n let closestPreviousLandmark = this.closestLandmark(previousFocusedElement);\n if (closestPreviousLandmark && closestPreviousLandmark.ref.current === previousFocusedElement) {\n closestPreviousLandmark.blur();\n }\n }\n }\n\n public createLandmarkController(): LandmarkController {\n let instance: LandmarkManager | null = this;\n instance.refCount++;\n instance.setupIfNeeded();\n return {\n navigate(direction, opts) {\n let element = opts?.from || (document!.activeElement as FocusableElement);\n return instance!.navigate(element, direction === 'backward');\n },\n focusNext(opts) {\n let element = opts?.from || (document!.activeElement as FocusableElement);\n return instance!.navigate(element, false);\n },\n focusPrevious(opts) {\n let element = opts?.from || (document!.activeElement as FocusableElement);\n return instance!.navigate(element, true);\n },\n focusMain() {\n return instance!.focusMain();\n },\n dispose() {\n if (instance) {\n instance.refCount--;\n instance.teardownIfNeeded();\n instance = null;\n }\n }\n };\n }\n\n public registerLandmark(landmark: Landmark): () => void {\n if (this.landmarks.find(l => l.ref === landmark.ref)) {\n this.updateLandmark(landmark);\n } else {\n this.addLandmark(landmark);\n }\n\n return () => this.removeLandmark(landmark.ref);\n }\n}\n\n/** Creates a LandmarkController, which allows programmatic navigation of landmarks. */\nexport function createLandmarkController(): LandmarkController {\n // Get the current landmark manager and create a controller using it.\n let instance: LandmarkManagerApi | null = getLandmarkManager();\n let controller = instance?.createLandmarkController();\n\n let unsubscribe = subscribe(() => {\n // If the landmark manager changes, dispose the old\n // controller and create a new one.\n controller?.dispose();\n instance = getLandmarkManager();\n controller = instance?.createLandmarkController();\n });\n\n // Return a wrapper that proxies requests to the current controller instance.\n return {\n navigate(direction, opts) {\n return controller!.navigate(direction, opts);\n },\n focusNext(opts) {\n return controller!.focusNext(opts);\n },\n focusPrevious(opts) {\n return controller!.focusPrevious(opts);\n },\n focusMain() {\n return controller!.focusMain();\n },\n dispose() {\n controller?.dispose();\n unsubscribe();\n controller = undefined;\n instance = null;\n }\n };\n}\n\n/**\n * Provides landmark navigation in an application. Call this with a role and label to register a landmark navigable with F6.\n * @param props - Props for the landmark.\n * @param ref - Ref to the landmark.\n */\nexport function useLandmark(props: AriaLandmarkProps, ref: RefObject<FocusableElement>): LandmarkAria {\n const {\n role,\n 'aria-label': ariaLabel,\n 'aria-labelledby': ariaLabelledby,\n focus\n } = props;\n let manager = useLandmarkManager();\n let label = ariaLabel || ariaLabelledby;\n let [isLandmarkFocused, setIsLandmarkFocused] = useState(false);\n\n let defaultFocus = useCallback(() => {\n setIsLandmarkFocused(true);\n }, [setIsLandmarkFocused]);\n\n let blur = useCallback(() => {\n setIsLandmarkFocused(false);\n }, [setIsLandmarkFocused]);\n\n useLayoutEffect(() => {\n if (manager) {\n return manager.registerLandmark({ref, label, role, focus: focus || defaultFocus, blur});\n }\n }, [manager, label, ref, role, focus, defaultFocus, blur]);\n\n useEffect(() => {\n if (isLandmarkFocused) {\n ref.current?.focus();\n }\n }, [isLandmarkFocused, ref]);\n\n return {\n landmarkProps: {\n role,\n tabIndex: isLandmarkFocused ? -1 : undefined,\n 'aria-label': ariaLabel,\n 'aria-labelledby': ariaLabelledby\n }\n };\n}\n"],"names":[],"version":3,"file":"useLandmark.module.js.map"}
1
+ {"mappings":"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","sources":["packages/@react-aria/landmark/src/useLandmark.ts"],"sourcesContent":["/*\n * Copyright 2022 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport {AriaLabelingProps, DOMAttributes, FocusableElement, RefObject} from '@react-types/shared';\nimport {useCallback, useEffect, useState} from 'react';\nimport {useLayoutEffect} from '@react-aria/utils';\nimport {useSyncExternalStore} from 'use-sync-external-store/shim/index.js';\n\nexport type AriaLandmarkRole = 'main' | 'region' | 'search' | 'navigation' | 'form' | 'banner' | 'contentinfo' | 'complementary';\n\nexport interface AriaLandmarkProps extends AriaLabelingProps {\n role: AriaLandmarkRole,\n focus?: (direction: 'forward' | 'backward') => void\n}\n\nexport interface LandmarkAria {\n landmarkProps: DOMAttributes\n}\n\n// Increment this version number whenever the\n// LandmarkManagerApi or Landmark interfaces change.\nconst LANDMARK_API_VERSION = 1;\n\n// Minimal API for LandmarkManager that must continue to work between versions.\n// Changes to this interface are considered breaking. New methods/properties are\n// safe to add, but changes or removals are not allowed (same as public APIs).\ninterface LandmarkManagerApi {\n version: number,\n createLandmarkController(): LandmarkController,\n registerLandmark(landmark: Landmark): () => void\n}\n\n// Changes to this interface are considered breaking.\n// New properties MUST be optional so that registering a landmark\n// from an older version of useLandmark against a newer version of\n// LandmarkManager does not crash.\ninterface Landmark {\n ref: RefObject<FocusableElement | null>,\n role: AriaLandmarkRole,\n label?: string,\n lastFocused?: FocusableElement,\n focus: (direction: 'forward' | 'backward') => void,\n blur: () => void\n}\n\nexport interface LandmarkControllerOptions {\n /**\n * The element from which to start navigating.\n * @default document.activeElement\n */\n from?: FocusableElement\n}\n\n/** A LandmarkController allows programmatic navigation of landmarks. */\nexport interface LandmarkController {\n /** Moves focus to the next landmark. */\n focusNext(opts?: LandmarkControllerOptions): boolean,\n /** Moves focus to the previous landmark. */\n focusPrevious(opts?: LandmarkControllerOptions): boolean,\n /** Moves focus to the main landmark. */\n focusMain(): boolean,\n /** Moves focus either forward or backward in the landmark sequence. */\n navigate(direction: 'forward' | 'backward', opts?: LandmarkControllerOptions): boolean,\n /**\n * Disposes the landmark controller. When no landmarks are registered, and no\n * controllers are active, the landmark keyboard listeners are removed from the page.\n */\n dispose(): void\n}\n\n// Symbol under which the singleton landmark manager instance is attached to the document.\nconst landmarkSymbol = Symbol.for('react-aria-landmark-manager');\n\nfunction subscribe(fn: () => void) {\n document.addEventListener('react-aria-landmark-manager-change', fn);\n return () => document.removeEventListener('react-aria-landmark-manager-change', fn);\n}\n\nfunction getLandmarkManager(): LandmarkManagerApi | null {\n if (typeof document === 'undefined') {\n return null;\n }\n\n // Reuse an existing instance if it has the same or greater version.\n let instance = document[landmarkSymbol];\n if (instance && instance.version >= LANDMARK_API_VERSION) {\n return instance;\n }\n\n // Otherwise, create a new instance and dispatch an event so anything using the existing\n // instance updates and re-registers their landmarks with the new one.\n document[landmarkSymbol] = new LandmarkManager();\n document.dispatchEvent(new CustomEvent('react-aria-landmark-manager-change'));\n return document[landmarkSymbol];\n}\n\n// Subscribes a React component to the current landmark manager instance.\nfunction useLandmarkManager(): LandmarkManagerApi | null {\n return useSyncExternalStore(subscribe, getLandmarkManager, getLandmarkManager);\n}\n\nclass LandmarkManager implements LandmarkManagerApi {\n private landmarks: Array<Landmark> = [];\n private isListening = false;\n private refCount = 0;\n public version = LANDMARK_API_VERSION;\n\n constructor() {\n this.f6Handler = this.f6Handler.bind(this);\n this.focusinHandler = this.focusinHandler.bind(this);\n this.focusoutHandler = this.focusoutHandler.bind(this);\n }\n\n private setupIfNeeded() {\n if (this.isListening) {\n return;\n }\n document.addEventListener('keydown', this.f6Handler, {capture: true});\n document.addEventListener('focusin', this.focusinHandler, {capture: true});\n document.addEventListener('focusout', this.focusoutHandler, {capture: true});\n this.isListening = true;\n }\n\n private teardownIfNeeded() {\n if (!this.isListening || this.landmarks.length > 0 || this.refCount > 0) {\n return;\n }\n document.removeEventListener('keydown', this.f6Handler, {capture: true});\n document.removeEventListener('focusin', this.focusinHandler, {capture: true});\n document.removeEventListener('focusout', this.focusoutHandler, {capture: true});\n this.isListening = false;\n }\n\n private focusLandmark(landmark: FocusableElement, direction: 'forward' | 'backward') {\n this.landmarks.find(l => l.ref.current === landmark)?.focus?.(direction);\n }\n\n /**\n * Return set of landmarks with a specific role.\n */\n private getLandmarksByRole(role: AriaLandmarkRole) {\n return new Set(this.landmarks.filter(l => l.role === role));\n }\n\n /**\n * Return first landmark with a specific role.\n */\n private getLandmarkByRole(role: AriaLandmarkRole) {\n return this.landmarks.find(l => l.role === role);\n }\n\n private addLandmark(newLandmark: Landmark) {\n this.setupIfNeeded();\n if (this.landmarks.find(landmark => landmark.ref === newLandmark.ref) || !newLandmark.ref.current) {\n return;\n }\n\n if (this.landmarks.filter(landmark => landmark.role === 'main').length > 1) {\n console.error('Page can contain no more than one landmark with the role \"main\".');\n }\n\n if (this.landmarks.length === 0) {\n this.landmarks = [newLandmark];\n this.checkLabels(newLandmark.role);\n return;\n }\n\n\n // Binary search to insert new landmark based on position in document relative to existing landmarks.\n // https://developer.mozilla.org/en-US/docs/Web/API/Node/compareDocumentPosition\n let start = 0;\n let end = this.landmarks.length - 1;\n while (start <= end) {\n let mid = Math.floor((start + end) / 2);\n let comparedPosition = newLandmark.ref.current.compareDocumentPosition(this.landmarks[mid].ref.current as Node);\n let isNewAfterExisting = Boolean((comparedPosition & Node.DOCUMENT_POSITION_PRECEDING) || (comparedPosition & Node.DOCUMENT_POSITION_CONTAINS));\n\n if (isNewAfterExisting) {\n start = mid + 1;\n } else {\n end = mid - 1;\n }\n }\n\n this.landmarks.splice(start, 0, newLandmark);\n this.checkLabels(newLandmark.role);\n }\n\n private updateLandmark(landmark: Pick<Landmark, 'ref'> & Partial<Landmark>) {\n let index = this.landmarks.findIndex(l => l.ref === landmark.ref);\n if (index >= 0) {\n this.landmarks[index] = {...this.landmarks[index], ...landmark};\n this.checkLabels(this.landmarks[index].role);\n }\n }\n\n private removeLandmark(ref: RefObject<Element | null>) {\n this.landmarks = this.landmarks.filter(landmark => landmark.ref !== ref);\n this.teardownIfNeeded();\n }\n\n /**\n * Warn if there are 2+ landmarks with the same role but no label.\n * Labels for landmarks with the same role must also be unique.\n *\n * See https://www.w3.org/WAI/ARIA/apg/practices/landmark-regions/.\n */\n private checkLabels(role: AriaLandmarkRole) {\n let landmarksWithRole = this.getLandmarksByRole(role);\n if (landmarksWithRole.size > 1) {\n let duplicatesWithoutLabel = [...landmarksWithRole].filter(landmark => !landmark.label);\n if (duplicatesWithoutLabel.length > 0) {\n console.warn(\n `Page contains more than one landmark with the '${role}' role. If two or more landmarks on a page share the same role, all must be labeled with an aria-label or aria-labelledby attribute: `,\n duplicatesWithoutLabel.map(landmark => landmark.ref.current)\n );\n } else {\n let labels = [...landmarksWithRole].map(landmark => landmark.label);\n let duplicateLabels = labels.filter((item, index) => labels.indexOf(item) !== index);\n\n duplicateLabels.forEach((label) => {\n console.warn(\n `Page contains more than one landmark with the '${role}' role and '${label}' label. If two or more landmarks on a page share the same role, they must have unique labels: `,\n [...landmarksWithRole].filter(landmark => landmark.label === label).map(landmark => landmark.ref.current)\n );\n });\n }\n }\n }\n\n /**\n * Get the landmark that is the closest parent in the DOM.\n * Returns undefined if no parent is a landmark.\n */\n private closestLandmark(element: FocusableElement) {\n let landmarkMap = new Map(this.landmarks.map(l => [l.ref.current, l]));\n let currentElement = element;\n while (currentElement && !landmarkMap.has(currentElement) && currentElement !== document.body && currentElement.parentElement) {\n currentElement = currentElement.parentElement;\n }\n return landmarkMap.get(currentElement);\n }\n\n /**\n * Gets the next landmark, in DOM focus order, or previous if backwards is specified.\n * If last landmark, next should be the first landmark.\n * If not inside a landmark, will return first landmark.\n * Returns undefined if there are no landmarks.\n */\n private getNextLandmark(element: FocusableElement, {backward}: {backward?: boolean }) {\n let currentLandmark = this.closestLandmark(element);\n let nextLandmarkIndex = backward ? this.landmarks.length - 1 : 0;\n if (currentLandmark) {\n nextLandmarkIndex = this.landmarks.indexOf(currentLandmark) + (backward ? -1 : 1);\n }\n\n let wrapIfNeeded = () => {\n // When we reach the end of the landmark sequence, fire a custom event that can be listened for by applications.\n // If this event is canceled, we return immediately. This can be used to implement landmark navigation across iframes.\n if (nextLandmarkIndex < 0) {\n if (!element.dispatchEvent(new CustomEvent('react-aria-landmark-navigation', {detail: {direction: 'backward'}, bubbles: true, cancelable: true}))) {\n return true;\n }\n\n nextLandmarkIndex = this.landmarks.length - 1;\n } else if (nextLandmarkIndex >= this.landmarks.length) {\n if (!element.dispatchEvent(new CustomEvent('react-aria-landmark-navigation', {detail: {direction: 'forward'}, bubbles: true, cancelable: true}))) {\n return true;\n }\n\n nextLandmarkIndex = 0;\n }\n\n if (nextLandmarkIndex < 0 || nextLandmarkIndex >= this.landmarks.length) {\n return true;\n }\n\n return false;\n };\n\n if (wrapIfNeeded()) {\n return undefined;\n }\n\n // Skip over hidden landmarks.\n let i = nextLandmarkIndex;\n while (this.landmarks[nextLandmarkIndex].ref.current?.closest('[aria-hidden=true]')) {\n nextLandmarkIndex += backward ? -1 : 1;\n if (wrapIfNeeded()) {\n return undefined;\n }\n\n if (nextLandmarkIndex === i) {\n break;\n }\n }\n\n return this.landmarks[nextLandmarkIndex];\n }\n\n /**\n * Look at next landmark. If an element was previously focused inside, restore focus there.\n * If not, focus the landmark itself.\n * If no landmarks at all, or none with focusable elements, don't move focus.\n */\n private f6Handler(e: KeyboardEvent) {\n if (e.key === 'F6') {\n // If alt key pressed, focus main landmark, otherwise navigate forward or backward based on shift key.\n let handled = e.altKey ? this.focusMain() : this.navigate(e.target as FocusableElement, e.shiftKey);\n if (handled) {\n e.preventDefault();\n e.stopPropagation();\n }\n }\n }\n\n private focusMain() {\n let main = this.getLandmarkByRole('main');\n if (main && main.ref.current && document.contains(main.ref.current)) {\n this.focusLandmark(main.ref.current, 'forward');\n return true;\n }\n\n return false;\n }\n\n private navigate(from: FocusableElement, backward: boolean) {\n let nextLandmark = this.getNextLandmark(from, {\n backward\n });\n\n if (!nextLandmark) {\n return false;\n }\n\n // If something was previously focused in the next landmark, then return focus to it\n if (nextLandmark.lastFocused) {\n let lastFocused = nextLandmark.lastFocused;\n if (document.body.contains(lastFocused)) {\n lastFocused.focus();\n return true;\n }\n }\n\n // Otherwise, focus the landmark itself\n if (nextLandmark.ref.current && document.contains(nextLandmark.ref.current)) {\n this.focusLandmark(nextLandmark.ref.current, backward ? 'backward' : 'forward');\n return true;\n }\n\n return false;\n }\n\n /**\n * Sets lastFocused for a landmark, if focus is moved within that landmark.\n * Lets the last focused landmark know it was blurred if something else is focused.\n */\n private focusinHandler(e: FocusEvent) {\n let currentLandmark = this.closestLandmark(e.target as FocusableElement);\n if (currentLandmark && currentLandmark.ref.current !== e.target) {\n this.updateLandmark({ref: currentLandmark.ref, lastFocused: e.target as FocusableElement});\n }\n let previousFocusedElement = e.relatedTarget as FocusableElement;\n if (previousFocusedElement) {\n let closestPreviousLandmark = this.closestLandmark(previousFocusedElement);\n if (closestPreviousLandmark && closestPreviousLandmark.ref.current === previousFocusedElement) {\n closestPreviousLandmark.blur();\n }\n }\n }\n\n /**\n * Track if the focus is lost to the body. If it is, do cleanup on the landmark that last had focus.\n */\n private focusoutHandler(e: FocusEvent) {\n let previousFocusedElement = e.target as FocusableElement;\n let nextFocusedElement = e.relatedTarget;\n // the === document seems to be a jest thing for focus to go there on generic blur event such as landmark.blur();\n // browsers appear to send focus instead to document.body and the relatedTarget is null when that happens\n if (!nextFocusedElement || nextFocusedElement === document) {\n let closestPreviousLandmark = this.closestLandmark(previousFocusedElement);\n if (closestPreviousLandmark && closestPreviousLandmark.ref.current === previousFocusedElement) {\n closestPreviousLandmark.blur();\n }\n }\n }\n\n public createLandmarkController(): LandmarkController {\n let instance: LandmarkManager | null = this;\n instance.refCount++;\n instance.setupIfNeeded();\n return {\n navigate(direction, opts) {\n let element = opts?.from || (document!.activeElement as FocusableElement);\n return instance!.navigate(element, direction === 'backward');\n },\n focusNext(opts) {\n let element = opts?.from || (document!.activeElement as FocusableElement);\n return instance!.navigate(element, false);\n },\n focusPrevious(opts) {\n let element = opts?.from || (document!.activeElement as FocusableElement);\n return instance!.navigate(element, true);\n },\n focusMain() {\n return instance!.focusMain();\n },\n dispose() {\n if (instance) {\n instance.refCount--;\n instance.teardownIfNeeded();\n instance = null;\n }\n }\n };\n }\n\n public registerLandmark(landmark: Landmark): () => void {\n if (this.landmarks.find(l => l.ref === landmark.ref)) {\n this.updateLandmark(landmark);\n } else {\n this.addLandmark(landmark);\n }\n\n return () => this.removeLandmark(landmark.ref);\n }\n}\n\n/** Creates a LandmarkController, which allows programmatic navigation of landmarks. */\nexport function createLandmarkController(): LandmarkController {\n // Get the current landmark manager and create a controller using it.\n let instance: LandmarkManagerApi | null = getLandmarkManager();\n let controller = instance?.createLandmarkController();\n\n let unsubscribe = subscribe(() => {\n // If the landmark manager changes, dispose the old\n // controller and create a new one.\n controller?.dispose();\n instance = getLandmarkManager();\n controller = instance?.createLandmarkController();\n });\n\n // Return a wrapper that proxies requests to the current controller instance.\n return {\n navigate(direction, opts) {\n return controller!.navigate(direction, opts);\n },\n focusNext(opts) {\n return controller!.focusNext(opts);\n },\n focusPrevious(opts) {\n return controller!.focusPrevious(opts);\n },\n focusMain() {\n return controller!.focusMain();\n },\n dispose() {\n controller?.dispose();\n unsubscribe();\n controller = undefined;\n instance = null;\n }\n };\n}\n\n/**\n * Provides landmark navigation in an application. Call this with a role and label to register a landmark navigable with F6.\n * @param props - Props for the landmark.\n * @param ref - Ref to the landmark.\n */\nexport function useLandmark(props: AriaLandmarkProps, ref: RefObject<FocusableElement | null>): LandmarkAria {\n const {\n role,\n 'aria-label': ariaLabel,\n 'aria-labelledby': ariaLabelledby,\n focus\n } = props;\n let manager = useLandmarkManager();\n let label = ariaLabel || ariaLabelledby;\n let [isLandmarkFocused, setIsLandmarkFocused] = useState(false);\n\n let defaultFocus = useCallback(() => {\n setIsLandmarkFocused(true);\n }, [setIsLandmarkFocused]);\n\n let blur = useCallback(() => {\n setIsLandmarkFocused(false);\n }, [setIsLandmarkFocused]);\n\n useLayoutEffect(() => {\n if (manager) {\n return manager.registerLandmark({ref, label, role, focus: focus || defaultFocus, blur});\n }\n }, [manager, label, ref, role, focus, defaultFocus, blur]);\n\n useEffect(() => {\n if (isLandmarkFocused) {\n ref.current?.focus();\n }\n }, [isLandmarkFocused, ref]);\n\n return {\n landmarkProps: {\n role,\n tabIndex: isLandmarkFocused ? -1 : undefined,\n 'aria-label': ariaLabel,\n 'aria-labelledby': ariaLabelledby\n }\n };\n}\n"],"names":[],"version":3,"file":"useLandmark.module.js.map"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@react-aria/landmark",
3
- "version": "3.0.0-beta.11",
3
+ "version": "3.0.0-beta.13",
4
4
  "description": "Spectrum UI components in React",
5
5
  "license": "Apache-2.0",
6
6
  "main": "dist/main.js",
@@ -22,16 +22,16 @@
22
22
  "url": "https://github.com/adobe/react-spectrum"
23
23
  },
24
24
  "dependencies": {
25
- "@react-aria/utils": "^3.24.0",
26
- "@react-types/shared": "^3.23.0",
25
+ "@react-aria/utils": "^3.25.0",
26
+ "@react-types/shared": "^3.24.0",
27
27
  "@swc/helpers": "^0.5.0",
28
28
  "use-sync-external-store": "^1.2.0"
29
29
  },
30
30
  "peerDependencies": {
31
- "react": "^16.8.0 || ^17.0.0-rc.1 || ^18.0.0"
31
+ "react": "^16.8.0 || ^17.0.0-rc.1 || ^18.0.0 || ^19.0.0"
32
32
  },
33
33
  "publishConfig": {
34
34
  "access": "public"
35
35
  },
36
- "gitHead": "f645f29edc1322153fd60af4640cbcab1d992dbd"
36
+ "gitHead": "86d80e3216bc32e75108831cf3a5a720bc849206"
37
37
  }
package/src/useLandmark.ts CHANGED
@@ -10,8 +10,8 @@
10
10
  * governing permissions and limitations under the License.
11
11
  */
12
12
 
13
- import {AriaLabelingProps, DOMAttributes, FocusableElement} from '@react-types/shared';
14
- import {RefObject, useCallback, useEffect, useState} from 'react';
13
+ import {AriaLabelingProps, DOMAttributes, FocusableElement, RefObject} from '@react-types/shared';
14
+ import {useCallback, useEffect, useState} from 'react';
15
15
  import {useLayoutEffect} from '@react-aria/utils';
16
16
  import {useSyncExternalStore} from 'use-sync-external-store/shim/index.js';
17
17
 
@@ -44,7 +44,7 @@ interface LandmarkManagerApi {
44
44
  // from an older version of useLandmark against a newer version of
45
45
  // LandmarkManager does not crash.
46
46
  interface Landmark {
47
- ref: RefObject<FocusableElement>,
47
+ ref: RefObject<FocusableElement | null>,
48
48
  role: AriaLandmarkRole,
49
49
  label?: string,
50
50
  lastFocused?: FocusableElement,
@@ -203,7 +203,7 @@ class LandmarkManager implements LandmarkManagerApi {
203
203
  }
204
204
  }
205
205
 
206
- private removeLandmark(ref: RefObject<Element>) {
206
+ private removeLandmark(ref: RefObject<Element | null>) {
207
207
  this.landmarks = this.landmarks.filter(landmark => landmark.ref !== ref);
208
208
  this.teardownIfNeeded();
209
209
  }
@@ -477,7 +477,7 @@ export function createLandmarkController(): LandmarkController {
477
477
  * @param props - Props for the landmark.
478
478
  * @param ref - Ref to the landmark.
479
479
  */
480
- export function useLandmark(props: AriaLandmarkProps, ref: RefObject<FocusableElement>): LandmarkAria {
480
+ export function useLandmark(props: AriaLandmarkProps, ref: RefObject<FocusableElement | null>): LandmarkAria {
481
481
  const {
482
482
  role,
483
483
  'aria-label': ariaLabel,