Skip to content
Tiny javascript library for creating accessible modal dialogs
JavaScript HTML CSS
Branch: master
Clone or download

Latest commit

Latest commit 4d03e7e Mar 26, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/workflows Updated CI workflow Mar 26, 2020
docs Added github logo Mar 26, 2020
lib v0.4.6 Mar 26, 2020
tests Updated workflow Mar 26, 2020
.editorconfig Added editor config Sep 5, 2019
.eslintrc Init next Sep 5, 2019
.gitignore Added test for test server Mar 21, 2020
CHANGELOG.md Updated changelog Mar 26, 2020
LICENSE.md Added essential markdown files Sep 5, 2019
README.md Update README.md Sep 6, 2019
package.json Update package.json Mar 26, 2020
yarn.lock Updated yarn.lock Mar 25, 2020

README.md

Micromodal.js

Made with love License Package version Build Status

Tiny, dependency-free javascript library for creating accessible modal dialogs


The aim of this library is to make modal dialogs accessible and easy to include in your project with minimum configuration. It's only ~1.8kb minified and gzipped - A tiny library for big change.

Demo and documentation

 

Features

Toggles relevant aria attributes on open and close

Closes modal on overlay click

Closes modal on pressing the esc key

Traps tab focus within the modal

Focuses on the first focusable element within the modal

Retains the focused element state after closing the modal

 

Installation

via npm

npm install micromodal --save

via yarn

yarn add micromodal

via CDN direct link

<script src="https://cdn.jsdelivr.net/npm/micromodal/dist/micromodal.min.js"></script>
<!-- or -->
<script src="https://unpkg.com/micromodal/dist/micromodal.min.js"></script>

direct download

curl -o https://unpkg.com/micromodal/dist/micromodal.min.js

 

IE 11 and below

Please use this pollyfill suggested here.

 

Changelog

Find the latest changelog here.

 

Contributing

We are always open and invite developers to contribute to Micromodal. We have kept the guidelines and process dead simple, so you invest more time in making modals accessible to all.

Micromodal follows the standardjs coding standard and is part of our package.json file. It will help us to maintain consistency in the code base.

Development setup

  1. Clone Github repo $ git clone https://github.com/ghosh/micromodal.git
  2. Install yarn package manager (Read installation guide)
  3. Run yarn install in the root folder to install all dependencies
  4. Run yarn dev to start a dev server. This serves the example directory and live reloads when any files are changed
  5. [Optional] Run yarn build to build the files for distribution. This is run automatically as a pre-commit hook as well.
  6. Send us pull request and chill

 

Licensing

This project is licensed under MIT license.

 

Related

  • Microtip - Modern, lightweight, accessible css tooltip library. Just 1kb.

 

Contact

You can mention us on Twitter for any questions, suggestions or just send us funny GIF. We ♥️ GIFs.

Tweet some love

Tweet about Micromodal and help us to spread the message about the importance of Web accessibility and Inclusive design.

 

Created and maintained by

Indrashish Ghosh – @_ighosh 🇮🇳

Kalpesh Singh - @knowkalpesh 🇮🇳

Darpan Kakadia - @kakadiadarpan 🇩🇪

Contributors - list 🌐

You can’t perform that action at this time.