NgWormholeApp
This component allows rendering all of its content to be rendered elsewhere on the page.
Why?
Sometimes a dialog or tooltip has to be rendered outside of an element, as CSS stacking contexts may interfere with positioning.
Installation
$ yarn add angular-wormhole
Import AngularWormholeModule
in your app:
import { NgModule } from '@angular/core';
import { NgWormholeModule } from 'ng-wormhole';
@NgModule({
imports: [
NgWormholeModule
]
})
export class AppModule {}
Example usage
index.html
<body>
<my-angular-app></my-angular-app>
<div id="wormhole-target"></div>
</body>
In a component template:
<ng-wormhole to="#wormhole-target">
<my-popover>...</my-popover>
</ng-wormhole>
The <my-popover>
component will then be rendered in the #wormhole-target
element, it will also automatically cleaned up once your component will be
destroyed.
Attributes
to: selector Which element to append to.
<ng-wormhole to="#wormhole-target">
<my-popover>...</my-popover>
</ng-wormhole>
Inputs
to: selector Which element to append to.
<ng-wormhole [to]="'#wormhole-target'">
<my-popover>...</my-popover>
</ng-wormhole>
renderInPlace: boolean = false Should the component render its children in place?
<ng-wormhole to="#wormhole-target" [renderInPlace]="true">
<my-popover>...</my-popover>
</ng-wormhole>
Development server
Run ng serve
for a dev server. Navigate to http://localhost:4200/
. The app will automatically reload if you change any of the source files.
Code scaffolding
Run ng generate component component-name
to generate a new component. You can also use ng generate directive|pipe|service|class|guard|interface|enum|module
.
Build
Run ng build
to build the project. The build artifacts will be stored in the dist/
directory. Use the --prod
flag for a production build.
Running unit tests
Run ng test
to execute the unit tests via Karma.
Running end-to-end tests
Run ng e2e
to execute the end-to-end tests via Protractor.
Further help
To get more help on the Angular CLI use ng help
or go check out the Angular CLI README.
Credits
This component is heavily inspired by ember-wormhole. Contributions from @stefanpenner, @krisselden, @chrislopresto, @lukemelia, @raycohen and others.