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

Package detail

ember-click-outside-modifier

lifeart873MIT4.1.2TypeScript support: included

Ember modifier to catch events outside marked DOM element

ember-addon, ember-modifier

readme

ember-click-outside-modifier

Ember modifier to react on clicks outside an element without stopping the event propagation. Great for closing dialogues, menus among other things.

If you need more control on click outside - take a look at ember-click-outside

Inspired by v-click-outside

Compatibility

  • Ember.js v3.20 or above
  • Embroider or ember-auto-import v2 (this is v2 addon)

Installation

ember install ember-click-outside-modifier

Usage

<div {{click-outside this.onClickOutside}}></div>

You can also provide specific events that you want to bind to with the event or events named arguments.

<div {{click-outside this.onClickOutside event='mouseup'}}></div>
<div {{click-outside this.onClickOutside events=(array 'click' 'mouseup')}}></div>

Usage with Glint

ember-click-outside-modifier is a glint enabled addon. Add this to your types/global.d.ts file:

import '@glint/environment-ember-loose';

import type EmberClickOutsideRegistry from 'ember-click-outside-modifier/template-registry';

declare module '@glint/environment-ember-loose/registry' {
  export default interface Registry extends EmberClickOutsideRegistry, /* other addon registries */ {
    // local entries
  }
}

For the entire guide, please refer to Using Addons section on the glint handbook.

Types are made available through package.json exports field.

Usage with <template> tag

For usage in gts or gjs files, modifier are exported from the index:

import { clickOutside } from 'ember-click-outside-modifier';

<template>
  <div {{clickOutside this.handleClickOutside}}>
    Lorem ipsum.
  </div>
</template>

Contributing

See the Contributing guide for details.

License

This project is licensed under the MIT License.

changelog

Changelog

v4.1.2 (2025-05-12)

:bug: Bug Fix

Committers: 1

v4.1.1 (2025-03-22)

:bug: Bug Fix

:house: Internal

Committers: 1

v4.1.0 (2023-08-09)

:rocket: Enhancement

:memo: Documentation

:house: Internal

Committers: 1

v4.0.0 (2022-04-08)

:boom: Breaking Change

:rocket: Enhancement

:memo: Documentation

:house: Internal

Committers: 1

v3.0.2 (2022-03-17)

:rocket: Enhancement

Committers: 1

v3.0.1 (2022-03-17)

:house: Internal

Committers: 1

v3.0.0 (2021-12-11)

:boom: Breaking Change

  • #9 Update multiple dependencies and bump minimum node version (@mayatron)

:bug: Bug Fix

Committers: 1

v2.0.1 (2021-11-09)

:bug: Bug Fix

Committers: 1

v2.0.0 (2021-06-08)

:rocket: Enhancement

:house: Internal

Committers: 2

v1.0.0 (2020-08-02)

:rocket: Enhancement

:house: Internal

Committers: 2