Skip to content

Egorvah/vudal

Repository files navigation

Vudal

Modal window component based on Semantic UI design. (Does not require semantic ui, it is completely independent)

Demo

Install plugin

import { VudalPlugin } from 'vudal';

Vue.use(VudalPlugin);

Possible options:

  • hideModalsOnDimmerClick (defaults to true) lets control whether clicking on dimmer will hide opened modals

Inside your component make preparations

import Vudal from 'vudal';

...
components: { Vudal }
...

Component usage example

<vudal name="myModal">
  <div class="header">
    <i class="close icon"></i>
    Title
  </div>
  <div class="content">
    Content
  </div>
  <div class="actions">
    <div class="ui cancel button">Cancel</div>
    <div class="ui button">Ok</div>
  </div>
</vudal>

Params:

  • name modal name
  • parent parent modal name (if any)
  • close-by-esc close by ESC button (true by default)
  • stickyHeader set sticky header block (class .header) (false by default)
  • stickyActions set sticky actions block (class .actions) (false by default)

Parent-child relationship is needed when second (child) modals is opened, but you close first modal (parent), child should also be closed. Also parent modal is blurred when child is opened.

Events:

  • show fired when modal is starting to show
  • hide fired when modal is starting to hide
  • hidden fired when modal finished hiding animation
  • visible fired when modal finished show animation

Methods:

  • $toggle toggle visibility
  • $show self explanatory
  • $hide self explanatory
  • $isActive check whether modal is visible
  • $remove destroy modal

Selector '.actions .cancel' call method $hide on click.

Also global $modals object is available to control modals.

You can access modals by name, for example this.$modals.myModal.

Example: this.$modals.myModal.$show() to show modal.

Use this.$modals.hideAll() to hide all active modals.

Custom modals

If you need to create your own custom looking modal, you can use modalMixin that will drive your modal.

It adds everything specified above, except .actions selector thing.

It also adds .vudal class to root element and .show, .hide and .mobile class for visible, hidden and opened on mobile device accordingly.

About

Modal window for vue.js

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published