fzn-angular-popover
v2.2.6
Published
An easy to customize popover written in angular
Downloads
62
Maintainers
Readme
ngPopover
An elegant, easily customizable generic popover in Angular that transcludes custom HTML
Description
- An angular directive for generic popovers.
- Popovers can contain simple text to complex html templates.
- Popovers can have callback functions for opening and closing.
- Popovers can have custom directions.
- The script also provides a factory to close all or specific directives manually.
- Works well with/without Bootstrap/Foundation.
Dependecies
- Angular.js
Installation
- Copy ngPopover.js and ngPopover.css from the repository and use it the way you like.
Usage
- Make sure you include the '''ngPopover''' module in you angular app:
angular.module('myApp', ['ngPopover']);
- once you've added the module in your app. Use the code below to get the popover up and running:
<ng-popover
trigger="popover-trigger" // ID of the (trigger) element that'll open/close the popover
direction="left" // The direction in which the popover hould appear can be equal to top, bottom, left & right. bottom is the default value
popover-class="custom-popover" // CSS Class of your popover. Ideally you should define the styles of your HTML under this class
on-open="openCallback()" // Function to be called when the popover is shown
on-close="closeCallback()"> // Function to be called when the popover is hidden
<!--- Your custom HTML goes here --->
</ng-popover>
- The trigger element for above popover would look like this:
<span
id="popover-trigger" // Notice the same ID is provided in the trigger attribute of the popover
class="ng-popover-trigger"> // Add this class to your trigger elements
Open Popover
</span>
Ideally all your popovers should be present at the bottom of the body
To manually close a popover use
ngPopoverFactory
Inject
ngPopoverFactory
in you controller :
angular.module("myApp").controller("myController", function(ngPopoverFactory){
});
- Once you've injected the factory you can manually close the dropdown by calling the closePopover function of the factory:
ngPopoverFactory.closePopover(triggerId)
- You can also close all the popovers at the same time by calling closeAll function of thr factory:
ngPopoverFactory.closeAll();
###Customization You can easily customize the look and feel of the popover by changing the following variables in the ngPopover.scss file as per your requirement:
$background-color: #FFF; // Background color of the popovers
$border-color: #EAEAEA; // Border color of the popovers
###Demo visit http://fauzankhan.github.io/angular-popover/ to see the popover in action