v-click-outside-x
    TypeScript icon, indicating that this package has built-in type declarations

    4.1.3 • Public • Published

    Travis status Dependency status devDependency status npm version jsDelivr hits bettercodehub score Coverage Status

    v-click-outside-x

    Vue V2 directive to react on clicks outside an element.

    Install

    $ npm install --save v-click-outside-x
    $ yarn add v-click-outside-x

    Use

    import Vue from 'vue';
    import * as vClickOutside from 'v-click-outside-x';
    
    Vue.use(vClickOutside);
    <script>
      export default {
        methods: {
          onClickOutside(event) {
            console.log('Clicked outside. Event: ', event);
          },
        },
      };
    </script>
    
    <template>
      <div v-click-outside="onClickOutside"></div>
    </template>

    Directive

    <script>
      export default {
        directives: {
          clickOutside: vClickOutside.directive,
        },
        methods: {
          onClickOutside(event) {
            console.log('Clicked outside. Event: ', event);
          },
        },
      };
    </script>
    
    <template>
      <div v-click-outside="onClickOutside"></div>
    </template>

    Event Modifiers

    It is not a very common need to call event.preventDefault(), event.stopPropagation() or event.stopImmediatePropagation() for click outside event handlers. Care should be taken when using these!

    The need for capture though, is reasonably common when you want menus or dropdown to behave more like their native elements.

    <template>
      <!-- the click event´s propagation will be stopped -->
      <div v-click-outside.stop="doThis"></div>
    
      <!-- the click event´s default will be stopped -->
      <div v-click-outside.prevent="doThat"></div>
    
      <!-- modifiers can be chained -->
      <div v-click-outside.stop.prevent="doThat"></div>
    
      <!-- use capture mode when adding the event listener -->
      <div v-click-outside.capture="doThis"></div>
    </template>

    Pointer Events Examples

    By default, if no argument is supplied then click will be used. You can specify the event type being bound by supplying an arguments, i.e. pointerdown.

    <script>
      export default {
        methods: {
          onClickOutside(event) {
            console.log('Clicked outside. Event: ', event);
          },
        },
      };
    </script>
    
    <template>
      <div v-click-outside:pointerdown="onClickOutside"></div>
    </template>

    For support of the PointerEvent API, consider loading the Pointer Events Polyfill.

    Multiple Events Examples

    <script>
      export default {
        methods: {
          onClickOutside1(event) {
            console.log('Clicked outside 1. Event: ', event);
          },
          onClickOutside2(event) {
            console.log('Clicked outside 2. Event: ', event);
          },
          onClickOutside3(event) {
            console.log('Clicked outside 3. Event: ', event);
          },
        },
      };
    </script>
    
    <template>
      <div
        v-click-outside.capture="onClickOutside1"
        v-click-outside:click="onClickOutside2"
        v-click-outside:pointerdown.capture="onClickOutside3"
      ></div>
    </template>

    License

    MIT License

    Install

    npm i v-click-outside-x

    DownloadsWeekly Downloads

    19,994

    Version

    4.1.3

    License

    MIT

    Unpacked Size

    92 kB

    Total Files

    13

    Last publish

    Collaborators

    • sergiocrisostomo