Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/LukaszWatroba/v-modal
Simple, flexible and beautiful modal dialogs in AngularJS.
https://github.com/LukaszWatroba/v-modal
Last synced: 3 months ago
JSON representation
Simple, flexible and beautiful modal dialogs in AngularJS.
- Host: GitHub
- URL: https://github.com/LukaszWatroba/v-modal
- Owner: LukaszWatroba
- License: mit
- Created: 2015-01-08T20:17:01.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2016-09-14T08:51:46.000Z (about 8 years ago)
- Last Synced: 2024-04-24T14:29:21.670Z (7 months ago)
- Language: JavaScript
- Homepage: http://lukaszwatroba.github.io/v-modal/
- Size: 123 KB
- Stars: 148
- Watchers: 6
- Forks: 31
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# AngularJS modal component
Simple, flexible and beautiful modal dialogs in AngularJS.
## Demo
- [GitHub](http://lukaszwatroba.github.io/v-modal)
- [CodePen](http://codepen.io/LukaszWatroba/pen/MYOBKb)
## Installation
- If you use [bower](http://bower.io/) or [npm](https://www.npmjs.com/), just `bower/npm install v-modal`. If not, download files [from the github repo](https://github.com/LukaszWatroba/v-modal/tree/master/dist)
- Reference `v-modal.css` and `v-modal.js` in your index.html file
- Reference the module in your app: `angular.module('myApp', [ 'vModal' ])`
## Usage
> app.js
```javascript
angular.module('myApp', ['vModal'])
.factory('myModal', function (vModal) {
return vModal({
controller: 'MyModalController',
controllerAs: 'myModalCtrl',
templateUrl: 'my-modal.html'
});
})
.controller('MyModalController', function (myModal) {
this.close = myModal.deactivate;
})
.controller('AppController', function (myModal) {
this.show = myModal.activate;
});
```
> index.html
```html
Show
```
> my-modal.html
```html
My modal
OK
```
## Configuration
#### Sizes
- `small`
- `medium`
- `large`
- `fit`
```html
```
#### Positions
- `center` (default)
- `middle`
```html
```
#### Container
To change the default container selector, use `modalConfig` provider in your app config, like so:
```javascript
angular
.module('myApp', ['vAccordion'])
.config(function (modalConfig) {
modalConfig.containerSelector = 'body';
});
```
#### SCSS
If you are using SASS, you can import vModal.scss file and override the following variables:
```scss
$v-modal-default-theme: true !default;
$v-modal-use-flexbox: true !default;
$v-modal-spacing: 20px !default;
$v-modal-zindex: 1000 !default;
$v-modal-backdrop: rgba(0,0,0, 0.5) !default;
$v-dialog-background: white !default;
$v-dialog-border-radius: 2px !default;
$v-dialog-sm-width: 340px !default;
$v-dialog-md-width: 560px !default;
$v-dialog-lg-width: 780px !default;
$v-close-color: #2196F3 !default;
$v-close-hover-color: #F44336 !default;
$v-close-hover-duration: 0.25s !default;
$v-modal-fade-animation-duration: 0.25s !default;
$v-dialog-enter-animation-duration: 0.5s !default;
```
## Accessibility
By default, vModal manages keyboard focus and adds some common ARIA attributes to improve accessibility of your dialogs.
## Credits
`vModal` service is based [angular-modal](https://github.com/btford/angular-modal) by Brian Ford.