Natural Potato Magnet

    TypeScript icon, indicating that this package has built-in type declarations

    1.8.0 • Public • Published


    What is it?

    stencil-click-outside is a Stencil @ClickOutside decorator that allows you to call component method as the user clicks outside of the host component. Obviously it's very easy. Why then import it as external library? First, because it does not make sense write this boilerplate code in each project. Second, because decorator solution is elegant and convenient.


    In your Stencil project, add stencil-click-outside to your package.json:

    npm i stencil-click-outside

    How to use it?

    It's very simple: you just need to anotate your method with @ClickOutside and it will be called when user clicks outside of component area.

    import { Component, h } from "@stencil/core";
    import { ClickOutside } from "stencil-click-outside";
    @Component({ tag: "my-component", shadow: true })
    export class MyComponent {
      someMethod() {
          "someMethod was called because user just clicked outside of MyComponent"
      render() {
        return <div>Hello, World!</div>;

    It may sometimes happen that you would like monitor for outside clicks not the whole component's HTMLElement but only some part, a div which you render. This is also possible the API then is as follows:

    import { Component, h } from '@stencil/core';
    import { registerClickOutside } from 'stencil-click-outside';
    @Component({ tag: 'my-component', shadow: true })
    export class MyComponent {
      someMethod() {
          console.log("someMethod was called because user just clicked outside of span html element in render method of MyComponent");
      render() {
        return (
              ref={spanEl => registerClickOutside(this, spanEl, () => this.someMethod())}>
                Hello, World!


    You may pass some optional parameters to decorator (or util function):

        exclude: 'button .exclude-click-outside-class'
    Property name Type Default Description
    triggerEvents string 'click' A comma-separated list of events to cause the trigger
    exclude string A comma-separated string of DOM element queries to exclude when clicking outside of the element. Example: [exclude]="'button .btn-primary'".


    npm i stencil-click-outside

    DownloadsWeekly Downloads






    Unpacked Size

    13.3 kB

    Total Files


    Last publish


    • jarrvis