Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

ember-popper-modifier

An Ember modifier for working with Popper.js.

ember-addon

readme

ember-popper-modifier

An Ember modifier for working with Popper.js.

Compatibility

  • Ember.js v4.8 or above
  • Ember CLI v4.8 or above
  • Node.js v18 or above

Installation

ember install ember-popper-modifier

Usage

This addon provides Ember modifiers that interfaces with the Popper.js library. It handles creating Popper instances as well as configuring them as options are updated.

Popper.js operates on two elements at the same time:

  1. The "reference" element, which is the one the tooltip is positioned relative to
  2. The "popper" element, which is the one that floats.

Two modifiers are provided, depending on which element you want to apply the modifier to and which you want to pass as a reference:

  • {{popper}} is applied on the reference element and given the tooltip as an argument
  • {{popper-tooltip}} is applied on the tooltip element and passed the reference as an argument

Aside from that difference, the modifiers are identical. Thus, the examples below will only show the usage of {{popper}}; know that all of the same principles and options work for {{popper-tooltip}} as well.

More information WIP.

Contributing

See the Contributing guide for details.

License

This project is licensed under the MIT License.

changelog

Changelog

All notable changes to this project will be documented in this file. See standard-version for commit guidelines.

v4.1.1 (2025-03-19)

:bug: Bug Fix

  • #940 allow reference and tooltip elements to be null in types (@jelhan)

:house: Internal

Committers: 1

v4.1.0 (2024-02-26)

:rocket: Enhancement

  • #840 Migrate to TypeScript and publish Glint types (@jelhan)

:house: Internal

Committers: 1

v4.0.0 (2023-11-05)

:boom: Breaking Change

:rocket: Enhancement

:house: Internal

  • #777 upgrade with Ember CLI v5.4 blueprints (@jelhan)
  • #610 Add '@ember/string' dev dependency to avoid deprecation warning (@pzubar)

Committers: 3

v3.0.0 (2023-01-17)

:boom: Breaking Change

  • #577 drop support for node < 14 and other node versions, which reached EOL (@jelhan)
  • #578 drop support for Ember < 3.28 (@jelhan)

:rocket: Enhancement

  • #594 support ember-modifier v4 (@jelhan)
  • #508 Refactor to use ember-modifier's modify hook and fix deprecation (@st-h)

:house: Internal

  • #595 add basic example in dummy app for manual testing (@jelhan)
  • #592 upgrade boilerplate files with Ember CLI 4.9 blueprints (@jelhan)
  • #587 use standard Prettier configuration in Ember ecosystem (@jelhan)
  • #586 upgrade boilerplate files with blueprints from Ember CLI 3.28 (@jelhan)
  • #581 Support releases and changelog generation using release-it (@jelhan)

Committers: 2

2.0.1 (2022-02-05)

2.0.0 (2022-02-02)

BREAKING CHANGE: ember-modifier no longer supports Ember versions lower than 3.24, so ember-popper-modifier does not either.

1.0.1 (2021-06-01)

1.0.0 (2021-02-17)

1.0.0-5 (2020-08-07)

1.0.0-4 (2020-08-05)

Features

  • support modifiers as positional params (7ab4a99), closes #13

1.0.0-3 (2020-08-05)

Features

  • add modifiers for Ember runloop integration (0cd6c45)

1.0.0-2 (2020-06-23)

Bug Fixes

  • destroy popper with modifier (37a637c)

1.0.0-1 (2020-06-22)

Features

  • add utility for finding popper instance for element (de01f8e)
  • allow passing config options as positional param (141c204)

1.0.0-0 (2020-06-22)

Features

  • add modifier for attaching popper from tooltip element (c7054a4)
  • add support for Popper modifiers (b0bee6f)
  • create basic popper modifier (318cd63)