@embedded-enterprises/ng6-golden-layout

[![Downloads](https://img.shields.io/npm/dm/@embedded-enterprises/ng6-golden-layout.svg)](https://www.npmjs.com/package/@embedded-enterprises/ng6-golden-layout) [![NPM Version](https://img.shields.io/npm/v/@embedded-enterprises/ng6-golden-layout.svg)](htt

Stats

StarsIssuesVersionUpdatedCreatedSize
@embedded-enterprises/ng6-golden-layout
0.0.123 years ago3 years agoMinified + gzip package size for @embedded-enterprises/ng6-golden-layout in KB

Readme

ng6-golden-layout

Downloads NPM Version NPM Size Liberapay

This project aims to provide a complete solution for embedding golden-layout within an angular 6 application.

Thanks to the awesome people at BrowserStack which make testing for IE/Edge possible!

Usage

Install via npm:

$ npm install --save @embedded-enterprises/ng6-golden-layout

A manual install of package dependencies will be necessary, too

$ npm install --save golden-layout@1.5.7 jquery
$ npm install --save-dev @types/jquery

Importing and configuration:

import { GoldenLayoutModule, GoldenLayoutConfiguration } from '@embedded-enterprises/ng6-golden-layout';
import * as $ from 'jquery';

// It is required to have JQuery as global in the window object.
window['$'] = $;

const config: GoldenLayoutConfiguration = { /* TODO */ };

@NgModule({
  imports: [
    //...
    GoldenLayoutModule.forRoot(config),
  ],
  declarations: [
    // Add your components here
  ],
  entryComponents: [
    // TODO Add your components which are used as panels in golden-layout also here.
  ],
})
export class AppModule {}

In the @NgModule decorator, under entryComponents list all the components that should be rendered within golden layout.

Define the GoldenLayoutConfiguration object:

Add <golden-layout-root></golden-layout-root> to your HTML.

Finally import GoldenLayout styles into styles.css

@import "~golden-layout/src/css/goldenlayout-base.css";
@import "~golden-layout/src/css/goldenlayout-light-theme.css";

body, html {
  width: 100vw;
  height: 100vh;
  padding: 0;
  margin: 0;
}

After that it should work right away out of the box.

Accessing the underlying GoldenLayout API

The original GoldenLayout API may be obtained through the Angular dependency injection mechanism in any of the components rendered with GoldenLayout.

import * as GoldenLayout from 'golden-layout';
import { Component, Inject } from '@angular/core';
import { GoldenLayoutContainer } from '@embedded-enterprises/ng6-golden-layout';

@Component({})
export class TestComponent {

  constructor(
    private goldenLayout: GoldenLayout,
    @Inject(GoldenLayoutContainer) private container: GoldenLayout.Container
  ) { }
}

These objects can then be used to manipulate the GoldenLayout.

Synchronizing your services across multiple browser windows

All services used within your app can be chosen to be either scoped to the current window (default) or to be the same instance across all windows (like a singleton).

To use services across multiple windows, you need to initialize the multi-window compatibility layer.

// in main.ts
import { MultiWindowInit } from '@embedded-enterprises/ng6-golden-layout';

// call MultiWindowInit before bootstrapModule().
MultiWindowInit();

To synchronize a service, use the @MultiWindowService() decorator:

@MultiWindowService<YourService>()
@Injectable()
class YourService {
  // implementation
}

NOTE: This only works once per service instance, it will destroy scoped services!

Provide a fallback for invalid component configurations

If you want to remove a component type, but don't want your users to clear the entire state, you can use the fallback component.

It works by creating a component, like this:

import { FailedComponent } from '@embedded-enterprises/ng6-golden-layout';
@Component({
  selector: `app-invalid`,
  template: `<h1>Component {{componentName}} couldn't be found`,
})
class InvalidComponent {
  // The InjectionToken `FailedComponent` provides the name of the failed component.
  // You can use this to implement arbitrarily complex error pages.
  constructor(@Inject(FailedComponent) public componentName: string) { }
}

After that, you inject the previously created component into the GoldenLayout binding like this:

// In your main NgModule
import { FallbackComponent } from '@embedded-enterprises/ng6-golden-layout';
@NgModule({
  providers: [
    //...
    {
      provide: FallbackComponent,
      useValue: InvalidComponent, // DON'T USE `useClass` or `useFactory` here!
    },
  ],
  declarations: [
    //...
    InvalidComponent,
  ],
  entryComponents: [
    //...
    InvalidComponent,
  ],
})
export class MyModule { }

When you have setup this, the binding will automatically create this component whenever a panel type couldn't be found.

Current state

This binding is stable but by far not feature complete.

Roadmap

  • Automatic service Injection
  • Make Configuration more robust (it currently fails if it can't find a pane)
  • Provide possibility to spawn and register new Panes on the fly
  • Improve redocking algorithm

Hacking

  1. Fork the repository
  2. Create a feature/bugfix branch
  3. If you want to work on the binding, use build.sh or npm run build to create the npm package and link it into the example project.
  4. If you want to work on the example project, just use ng serve to have the dev-server.
  5. If you are happy, make a PR.

Contributions are welcome!

If you find any bugs or have a feature request, please open an issue on github!

The npm package download data comes from npm's download counts api and package details come from npms.io.