trust-html
TypeScript icon, indicating that this package has built-in type declarations

1.0.0 • Public • Published

trust-html

  1. Description
  2. Installation
  3. Usage
  4. Methods
  5. Git repository
  6. Build
  7. Publish to npm
  8. Version

1. Description

TrustHtmlModule is a module for angular2+ projects which allows you to inject the HTML content into your templates.

2. Installation

Install the module into your application and save it as a dev dependency in your package.json file

npm install trust-html --save-dev

3. Usage

In order to use the TrustHtmlPipe you have to include/import the TrustHtmlModule into your application:

import {TrustHtmlModule} from 'trust-html';
 
@NgModule({
  //...
  imports: [
    //...
    TrustHtmlModule
  ],
  //...
})

Or you can include the pipe directly in your components declarations list in your @NgModule(...):

import {TrustHtmlPipe} from "trust-html";
 
@NgModule({
  //...
  declarations: [TrustHtmlPipe],
  //...
})

Use it in your template to "inject" trusted HTML content:

<div [innerHTML]="'<strong>test html content</strong>' | trustHtml"></div>

Output:

<div>
  <strong>test html content</strong>
</div>

4. Methods

transform(htmlString: string): any

Bypass security and trust the given value to be safe HTML. The sanitizer will leave safe HTML intact.
WARNING: in Angular version 2.x, calling this method with untrusted user data exposes your application to XSS security risks!

Parameters:
htmlString - HTML string which should not be escaped.

Return:
Method returns the intact HTML string.

5. Git repository

https://github.com/tvicpe/trust-html

6. Build

To build the final package run this command:

ng build trust-html

The build process will generate the packed sources into the dist folder.

7. Publish to npm

To publish the new version to npm, go into the dist folder:

cd ./dist/trust-html

and publish it to npm:

npm publish

8. Version

1.0.0

Dependents (2)

Package Sidebar

Install

npm i trust-html

Weekly Downloads

138

Version

1.0.0

License

none

Unpacked Size

30 kB

Total Files

23

Last publish

Collaborators

  • kageoni