Primer Behaviors

Shared behaviors for JavaScript components

Documentation

• Anchored Position
• Focus Trap
• Focus Zone
• Scroll Into View

Installation

npm install @primer/behaviors

or

yarn add @primer/behaviors

@primer/behaviors

1.8.1

Patch Changes

• #473 d88c043 Thanks @TylerJDev! - Prevent duplicate sentinels from being added if some already exist in the container of the focus trap.

1.8.0

Minor Changes

• #462 62dc90a Thanks @camertron! - Ensure focusZone() clears all potential active descendants

1.7.2

Patch Changes

• #429 4b729b0 Thanks @TylerJDev! - Adds mutation observer to focus-trap to ensure sentinel elements are always in the correct position

1.7.1

Patch Changes

• #421 fd1419a Thanks @joshblack! - Remove optionalDependencies from npm package

1.7.0

Minor Changes

• #400 67215a5 Thanks @joshblack! - Update the output of the package to correctly map "import" conditions to ESM

1.6.0

Minor Changes

• #263 5d7e0b1 Thanks @TylerJDev! - Adjusts mutation observer to now track hidden and disabled attributes being applied or removed.

Patch Changes

• #399 3a3cd61 Thanks @JelloBagel! - Fix bug found when removing nodes in a focus zone with strict mode enabled

1.5.1

Patch Changes

• #245 caf30c4 Thanks @pksjce! - When zoomed in, an overlay floating element should anchor itself properly instead of getting the top part cut off in the process

1.5.0

Minor Changes

• #241 cb98837 Thanks @JelloBagel! - Add support for contenteditable to iterateFocusableElements

1.4.0

Minor Changes

• #235 7a7faa9 Thanks @JelloBagel! - Add IterateFocusableElements options to focusZone

1.3.6

Patch Changes

• #208 2042afc Thanks @EnixCoda! - Update anchored-position.ts to support handling elements outside of document.body in getClippingRect

1.3.5

Patch Changes

• #197 ac8ea59 Thanks @jonrohan! - Check if popover supported in isTopLayer

1.3.4

Patch Changes

• #195 bddd6c5 Thanks @keithamus! - Special case anchored-position calls on top-layer elements

1.3.3

Patch Changes

• #180 eca845b Thanks @colebemis! - FocusZone: If custom focusInStrategy is defined, use it to initialize tabIndexes

1.3.2

Patch Changes

• #176 5e74867 Thanks @jbrown1618! - Use a binary search to find the insertion index for new elements managed by the focus zone. For a use case with 1000 elements managed by the focus zone, added one at a time (by react), this takes us from 500,000 calls to compareDocumentPosition over 1000ms to 8,000 calls over 16ms.

1.3.1

Patch Changes

• #155 b14b5ac Thanks @colebemis! - focusZone: Add Backspace key to list of FocusKeys

1.3.0

Minor Changes

• #152 afaf380 Thanks @colebemis! - focusZone: Add preventScroll option

1.2.0

Minor Changes

• #134 cc5bf8e Thanks @jonrohan! - Add Dimensions behavior

1.1.3

Patch Changes

• #93 e5aaf68 Thanks @siddharthkp! - Anchored position: Add check for boundary collision on left side

1.1.2

Patch Changes

• #78 62e5459 Thanks @siddharthkp! - Anchored Position: Add alternative alignments to flip to if there isn't enough space

1.1.1

Patch Changes

• #73 a96d60f Thanks @dgreif! - Add import conditional export type to the package for better NodeJS ESM compatibility

1.1.0

Minor Changes

• #52 1aa3027 Thanks @owenniblock! - Update focusTrap to use new methodology after accessibility discussions

1.0.3

Patch Changes

• #42 41945a3 Thanks @dgreif! - Build both esm and cjs output for the package

1.0.2

Patch Changes

• #17 9194ba4 Thanks @dgreif! - Correct margin orientation for scrollIntoView

• #18 3b4dd41 Thanks @dgreif! - Export utils as submodule

1.0.1

Patch Changes

• #10 88b6f34 Thanks @dgreif! - Set up changesets