Skip to content
Render any child view somewhere else on the page.
TypeScript JavaScript HTML CSS
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
e2e
projects/ng-wormhole
src
.editorconfig
.gitignore
.travis.yml
CHANGELOG.md
LICENSE
README.md
angular.json
package.json
tsconfig.json
tslint.json
yarn.lock

README.md

NgWormhole

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 ng-wormhole

Import NgWormholeModule 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:

<my-popover *ngWormhole="'#wormhole-target'">...</my-popover>

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.

Inputs

ngWormhole: selector or element Which element to append to.

<div #targetElement id="my-target"></div>
<my-popover *ngWormhole="targetElement">...</my-popover>
<!-- or by id/selector -->
<my-popover *ngWormhole="'#my-target'">...</my-popover>

renderInPlace: boolean = false Should the component render its children in place?

<my-popover *ngWormhole="'#wormhole-target'; renderInPlace: true">...</my-popover>

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.

You can’t perform that action at this time.