Menu ▾ ▴

Tree [3a5b38] main /
 History

HTTPS git://
HTTPS access

File Date Author Commit
 .idea 2024-05-25 isaacangello isaacangello [46519e] idea Webstorm files
 Files unknown
 dist 2024-05-25 isaacangello isaacangello [46519e] idea Webstorm files
 lib 2024-05-25 isaacangello isaacangello [46519e] idea Webstorm files
 .gitignore 2024-05-24 isaacangello isaacangello [d311c3] Npm push
 README.md 2024-05-26 Isaac Angelo Isaac Angelo [3a5b38] Update README.md
 index.html 2024-05-25 isaacangello isaacangello [46519e] idea Webstorm files
 main.js 2024-05-25 isaacangello isaacangello [46519e] idea Webstorm files
 package.json 2024-05-24 isaacangello isaacangello [d311c3] Npm push
 style.css 2024-05-25 isaacangello isaacangello [46519e] idea Webstorm files

Read Me

OpenModal

Open Modal is a pure Js module, which uses the animate.css library to create the modal effects.

https://github.com/isaacangello/openModal/assets/13286180/8b2cc536-6f23-460c-9316-eadd6661cf2c

install

  npm install open-modal

How to use?

To use Open Modal you need to have animate.css installed in your application, go to https://animate.style/ to configure it, then initialize Open Modal like this.

import OpenModal  from "./dist/open-modal.js"

const openModal = new OpenModal()

openModal.init()

After the Open modal is initialized, you will need a button with a defined ID that by default works with the ID "showModal", and you will also need a modal window with a css class to hide and show the modal elements, this class could be the class ".hide" of materialize.css
or the '.d-none" class from bootstrap, or you can define your own class to hide/show the modal elements.
You will need a Container div with the class ".open-modal" defined, or a class of its own defined in the cotainer, and a div with a class defined as modal-content, this step is important to activate the effects.

OBS

If you want to use the project's css, there is an open-modal css file in the same folder as the module

button code example
<button id="showModal" class="btn"> show modal</button>

    <div id="modal1" class="open-modal hide">
    <div class="modal-content">
        <div class="modal-body">
            <h4>Modal Header</h4>
            <p>
                Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt
                ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco
                laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate
                velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident,
                sunt in culpa qui officia deserunt mollit anim id est laborum
            </p>
        </div>
        <div class="modal-footer">
            <button id="cancelButton" class="btn-materialize">disAgree</button>
            <button  class="btn-materialize">Agree</button>
        </div>
    </div>
</div>

Open Modal Options

It is possible to configure some options to change the way Open Modal works, the configurable options are passed to the class constructor
as a literal object

Exemple

import OpenModal  from "./dist/open-modal.js"

const openModal = new OpenModal({
    optionKey1: "optionValue1",
    optionKey2: "optionValue2",
})

openModal.init()

### Options and standards values

   let options = {
            btnShowId : "showModal",            
            btnCancelId : "cancelButton",
            containerClass : 'open-modal',
            contentClass : 'modal-content',
            hideClass : 'hide',
            containerBackground : false,
            containerEffects : false,
            contentEffects : false,
  }
--- Options ---
Option key Standard value Option value description
btnShowId "showModal" Receives the id of the button responsible for opening the modal using the click event.
btnCancelId "cancelButton" Receives the id of the button responsible for closing the modal
containerClass "open-modal" Receives the Class of the modal container
contentClass 'modal-content' Receives the Class of the div in which the content is located
hideClass "hide" This css class that hides the elements, this class is applied together with the '.open-modal" class
containerBackground false this value receives the Rgb or Exadecimal code for a color,
containerEffects false This Key returns an array as values containing the classes necessary to activate the effects in the container div using the animate.css library
contentEffects false This Key returns an array as values containing the classes necessary to activate the effects in the content div using the animate.css library

Exemple of containerEffects & contentEffects

import OpenModal  from "./dist/open-modal.js";

const openModal = new OpenModal(
    {
        btnShowId:'botaoMostrar',
        containerBackground: "rgba(19, 247, 15, 0.471)",
        containerEffects:{
            containerInEffects:['animate__animated','animate__fadeInDown'],
            containerOutEffects:['animate__animated', 'animate__bounceOutUp']
        },
        contentEffects:{
            contentInEffects: ['animate__animated','animate__fadeInDown'],
            contentOutEffects: ['animate__animated','animate__bounceOutUp'],
        },


    }
)

openModal.init()

OBS:

If you decide to change the ID's of the container and content you will have to change your css, as changing their names will undo the references to the open-modal.css file, or you can change the names and use Tailwindcss, materializecss, Bootstrap if you prefer.