SEB Magic Iframe

Install with npm

npm install @sebgroup/ng-magic-iframe --save

Add to app.modules

import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';

import { AppComponent } from './app.component';
import { NgMagicIframeModule } from '@sebgroup/ng-magic-iframe';

@NgModule({
  declarations: [
    AppComponent
  ],
  imports: [
    BrowserModule,
    NgMagicIframeModule
  ],
  providers: [],
  bootstrap: [AppComponent]
})
export class AppModule { }

Allow synthetic default imports

If you run into the following error: @types/element-resize-detector/index"' has no default export you need to allow synthetic default imports as the type definitions for element-resize-detector, which this library depends on, has no default export declared. In tsconfig.json in your root project folder, set allowSyntheticDefaultImports to true:

{
  "compileOnSave": false,
  "compilerOptions": {
    "allowSyntheticDefaultImports" : true,
    ...
}

Usage

Basic

<seb-ng-magic-iframe [source]="'/assets/first-page.html'"></seb-ng-magic-iframe>

Advanced

<seb-ng-magic-iframe [source]="'/assets/first-page.html'"
                     [styles]="'body { background: white; }'"
                     [styleUrls]="['/assets/css/external-stylesheet.css', '/assets/css/fonts.css']"
                     [autoResize]="false"
                     [resizeDebounceMillis]="0"
                     (iframeEvent)="foo($event)">
                     <!-- PLACEHOLDER FOR LOADING CONTENT -->
</seb-ng-magic-iframe>

Configuration and options

@Inputs

|@Input|Description|Default| |:-----|:-----------|:-------------------| |source| Path to iframe content source.| n/a | |styles| Apply/inject inline styles to the iframe (Optional).| n/a | |styleUrls| Add one or more stylesheets to the iframe, note that the iframe won't be visible until they've loaded (Optional).| n/a | |autoResize| Auto resize the iframe when the inner content changes height (Optional).| true | |resizeDebounceMillis| Debounce time in milliseconds for resize event to prevent race condition (Optional).| 50 |

@Outputs

|@Output|Description| |:-----|:-----------| |iframeEvent| Listen for state changes in iframe, see list of events below.|

Iframe events

|@Input |Description| |:--------------------------------|:-----------| | iframe-click | Event emitted when element inside iframe has been clicked. | iframe-keyup | Event emitted when keyup event emitted inside iframe. | iframe-unloaded | Event emitted when iframe triggers unload event (url in iframe changes). | iframe-styles-added | Emitted when styles have been added. | iframe-stylesheet-load | Emitted when external stylesheets start loading. | iframe-stylesheet-loaded | Emitted when external stylesheets have finished loading. | iframe-all-stylesheets-loaded | Emitted when all external stylesheets have finished loading (only emitted if more than one external stylesheets). | iframe-loaded | Emitted when iframe has finished loading (including optional styles and/or stylesheets). | iframe-loaded-with-errors | Emitted when iframe has encountered errors after loading (usually related to CORS and inability to access iframe content). | iframe-resized | Emitted when the iframe changes size.

Custom content loader

SEB Magic iframe uses content projection together with ng-content to show custom content while the iframe is loading. Simply add your own component or markup like this:

<seb-ng-magic-iframe [source]="'/assets/first-page.html'">
  <div class="skeleton-loader"></div> <!-- replace with your own code -->
</seb-ng-magic-iframe>

Run locally

• Clone the repository
• Run npm install
• Run npm start and navigate to http://localhost:4200/. The app will automatically reload if you change any of the source files.