• This repository has been archived on 24/Nov/2017
  • Stars
    star
    114
  • Rank 308,031 (Top 7 %)
  • Language
    TypeScript
  • Created over 8 years ago
  • Updated about 6 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Simple popover control for your angular2 applications using bootstrap3. Does not depend of jquery.

This repository is for demonstration purposes of how it can be implemented in Angular and is not maintaned. Please fork and maintain your own version of this repository.

ngx-popover

Simple popover control for your angular2 applications using bootstrap3. Does not depend of jquery. If you don't want to use it without bootstrap - simply create proper css classes. Please star a project if you liked it, or create an issue if you have problems with it.

see DEMO.

angular 2 popover

Installation

  1. Install npm module:

    npm install ngx-popover --save

  2. If you are using system.js you may want to add this into map and package config:

    {
        "map": {
            "ngx-popover": "node_modules/ngx-popover"
        },
        "packages": {
            "ngx-popover": { "main": "index.js", "defaultExtension": "js" }
        }
    }

Usage

Import PopoverModule in your app and start using a component:

<div popover="content to be shown in the popover"
     popoverTitle="Popover header"
     popoverPlacement="top"
     [popoverOnHover]="false"
     [popoverCloseOnClickOutside]="true"
     [popoverCloseOnMouseOutside]="false"
     [popoverDisabled]="false"
     [popoverAnimation]="true"
     [popoverDismissTimeout]="1000">
    element on which this popover is applied.
</div>

Example of usage with dynamic html content:

<popover-content #myPopover 
                title="Popover title" 
                placement="left"
                [animation]="true" 
                [closeOnClickOutside]="true" >
    <b>Very</b> <span style="color: #C21F39">Dynamic</span> <span style="color: #00b3ee">Reusable</span>
    <b><i><span style="color: #ffc520">Popover With</span></i></b> <small>Html support</small>.
</popover-content>

<button [popover]="myPopover">element on which this popover is applied.</button>
  • <div popover>:
    • popover="string" The message to be shown in the popover.
    • popoverTitle="string" Popover title text.
    • popoverPlacement="top|bottom|left|right|auto|auto top|auto bottom|auto left|auto right" Indicates where the popover should be placed. When using "auto" modifier, will show in opposite direction if not enough room. Default is "bottom".
    • [popoverDisabled]="true|false" Indicates if popover should be disabled. If popover is disabled then it will not be shown. Default is false
    • [popoverAnimation]="true|false" Indicates if all popover should be shown with animation or not. Default is true.
    • [popoverOnHover]="true|false" If set to true then popover will open on mouse over instead of mouse click. Default is false.
    • [popoverCloseOnMouseOutside]="true|false" Indicates if popover should be closed when user mouse outside of it. Default is false.
    • [popoverCloseOnClickOutside]="true|false" Indicates if popover should be closed when user click outside of it. Default is false.
    • [popoverDismissTimeout]="number" Used to automatically dismiss popover after given amount of time. Default is 0, means disabled.
  • <popover-content>:
    • placement="top|bottom|left|right|auto|auto top|auto bottom|auto left|auto right" Indicates where the popover should be placed. When using "auto" modifier, will show in opposite direction if not enough room. Default is "bottom".
    • [animation]="true|false" Indicates if all popover should be shown with animation or not. Default is true.
    • [closeOnMouseOutside]="true|false" Indicates if popover should be closed when user mouse outside of it. Default is false.
    • [closeOnClickOutside]="true|false" Indicates if popover should be closed when you click outside of it. Default is false.

Sample

import {Component} from "@angular/core";
import {PopoverModule} from "ngx-popover";

@Component({
    selector: "app",
    template: `
<div class="container">

    <!-- regular popover -->
    <p>
        It is a long established <span popover="Hello fact!" popoverTitle="Fact #1"><b>click this fact</b></span> that a reader will be distracted by the readable content of a page when looking at its layout.
        The point of using Lorem Ipsum is that it has a more-or-less normal distribution of letters, as opposed to using 'Content here, content here', making it look like readable English.
        <span popover="many, but not all" popoverPlacement="left"><b>Many desktop</b></span> publishing packages and web page editors now use Lorem Ipsum as their default model text, and a search for 'lorem ipsum' will uncover many web sites still in their infancy.
        <span popover="various, but not all" popoverPlacement="right"><b>Various versions</b></span> have evolved over the years, sometimes by accident, <span popover="another hint" popoverPlacement="top"><b>sometimes on purpose</b></span> (injected humour and the like)
    </p>

    <br/>
    <button popover="Hello popover. Now click outside." [popoverCloseOnClickOutside]="true">
        click to open popover that will be closed when you click outside of it.
    </button>

    <!-- popover with dynamic html content -->
    <br/><br/>
    <div>
        <popover-content #myPopover
            title="this header can be omitted"
            [closeOnClickOutside]="true">
            <b>Very</b> <span style="color: #C21F39">Dynamic</span> <span style="color: #00b3ee">Reusable</span>
            <b><i><span style="color: #ffc520">Popover With</span></i></b> <small>Html support</small>.
            Click outside of this popover and it will be dismissed automatically.
        </popover-content>

        <button [popover]="myPopover">click this button to see a popover</button>
    </div>

    <!-- popover show on hover -->
    <br/>
    <div>
        <button popover="Hello popover" [popoverOnHover]="true">hover this button to see a popover</button>
    </div>

    <!-- popover show on hover and hide only when mouse over outside of the popover -->
    <br/>
    <div>
        <button popover="Hello popover"
                popoverPlacement="right"
                [popoverOnHover]="true"
                [popoverCloseOnMouseOutside]="true">
            hover this button to see a popover, allows to create interactive popovers
        </button>
    </div>

    <!-- popover show on hover -->
    <br/>
    <div>
        <button popover="Hello dismissible popover" [popoverDismissTimeout]="2000">click to see this popover. This popover will be dismissed in two seconds</button>
    </div>

</div>
`
})
export class App {

}

@NgModule({
    imports: [
        // ...
        PopoverModule
    ],
    declarations: [
        App
    ],
    bootstrap: [
        App
    ]
})
export class AppModule {

}

Take a look on samples in ./sample for more examples of usages.

More Repositories

1

gulpclass

Make a beautiful class-based gulpfiles with TypeScript and Gulpclass.
TypeScript
158
star
2

ngx-modal

Open modal window (dialog box) for your angular2 applications using bootstrap3.
TypeScript
107
star
3

ngx-tooltip

Simple tooltip control for your angular2 applications using bootstrap3. Does not depend of jquery.
TypeScript
85
star
4

ngx-dropdown

Simple dropdown for your angular2 applications using bootstrap3.
TypeScript
65
star
5

ngx-rating

Simple rating control for your angular2 applications using bootstrap3
TypeScript
55
star
6

ngx-select-controls

Checkbox group and radio group control for your angular2 applications using bootstrap3.
TypeScript
45
star
7

event-dispatch

Dispatching and listening for application events in Typescript
TypeScript
44
star
8

routing-controllers-express-demo

Example of express + typescript project using routing-controllers
TypeScript
41
star
9

ngx-accordion

Simple accordion control for your angular2 applications using bootstrap3.
TypeScript
39
star
10

ngx-tabs

Simple tabs control for your angular2 applications using bootstrap3
TypeScript
36
star
11

routing-controllers-koa-demo

Example of koa + typescript project using routing-controllers
TypeScript
36
star
12

ngx-paginator

Simple pagination control for your angular2 applications using bootstrap3
TypeScript
30
star
13

angular-disable-all

Angular directive that allows to disable any element (for example DIV) contents and disable clicks on the given element
JavaScript
21
star
14

ngx-progress-bar

Simple progress bar control for your angular2 applications using bootstrap3.
TypeScript
21
star
15

framework

TypeScript
16
star
16

frameworkx

TypeScript
14
star
17

ngx-loading-bar

Angular 2 loading bar on the top of the page to indicate page loading process.
TypeScript
13
star
18

typeodm

MongoDB ODM for Typescript
TypeScript
11
star
19

routing-controllers-angular2-demo

Example of angular2 + express + typescript project using routing-controllers
TypeScript
7
star
20

ngx-prevent-parent-scroll

Prevents scrolling in the parent container when child container already has a scroll.
TypeScript
4
star
21

configuration-manager

Allows to manage configuration files in your project
TypeScript
3
star
22

class-transformer-demo

Example how to use class-transformer with Angular 2
TypeScript
3
star
23

ngx-notification-center

Allows to globally dispatch notification messages.
TypeScript
3
star
24

microframework-express

Express.js integration with microframework
TypeScript
2
star
25

no-need-in-di

An example why there is no DI need in JavaScript/TypeScript.
TypeScript
2
star
26

gulp-parameters-generator

Asks user to input paramaters from your configuration file
JavaScript
2
star
27

angular-select-options

A special angular directive that works like angular's ng-options but can be used in along with any element and has several specific abilities
JavaScript
2
star
28

angular-auto-grow-input

This directive allows your inputs to grow as soon as user types. The input's width always fit the text user typed in the input.
JavaScript
2
star
29

microframework-winston

Winston logging tool to use it with microframework
TypeScript
1
star
30

angular-open-dropdown

A directive that allows to open dropdown when user clicks on button or anything else
JavaScript
1
star
31

angular-select-autocomplete

Angular autocomplete
JavaScript
1
star
32

rabbit.ts

Wrapper over rabbit.js library that provides some extra convinent functionality to work with rabbit.js in Typescript
TypeScript
1
star
33

select-items

This component allows to use ng-model with multiple checkboxes and radio boxes in an angular-way.
JavaScript
1
star
34

angular-select-dropdown

A special angular directive that allows to select items from the dropdown
JavaScript
1
star
35

microframework-redis

Redis integration with microframework
TypeScript
1
star
36

angular-select-items

A special angular directive used with input to make input to grow as soon as user types text.
JavaScript
1
star
37

ng2-days-slider

Simple days calendar slider control for your angular2 applications using bootstrap3.
TypeScript
1
star
38

angular-tags-input

Angular directive that allows to type into input small tags and store their values in ng-model.
JavaScript
1
star
39

angular-select-tags

A directive that allows user to add a tokens in the input box and select items from the dropdown
JavaScript
1
star