glaze-ng-helmet
v2.0.4
Published
A document head manager for Angular
Downloads
3
Maintainers
Readme
Angular Helmet
Angular Helmet is a simple and intuitive document head manager for Angular applications. Inspired by React Helmet.
Installation
npm:
npm install --save ng-helmet
Yarn:
yarn add ng-helmet
Compatibility
| Version | Angular Version |
| ------- | --------------- |
| 1.x.x
| >=9 <13
|
| 2.x.x
| >=13 <15
|
Features
- Supports the following head tags:
title
andmeta
. - Supports server-side rendering out of the box.
- Nested components override duplicate head changes.
Usage
Import the NgHelmetModule
into your AppModule
to access the ng-helmet
component in your components. This module can be optionally configured with the forRoot
method:
import { NgHelmetModule } from "glaze-ng-helmet";
@NgModule({
imports: [
NgHelmetModule.forRoot({
baseTitle: "| Replay Value",
}),
],
})
export class AppModule {}
The supported configuration parameters are:
| Property | Requirement | Description | | --------- | ----------- | ------------------------------------------------------------------------- | | baseTitle | Optional | An optional fixed portion of the browser title, usually the website name. |
Example
In a component template:
<div class="application">
<ng-helmet>
<title>My Title</title>
<meta charset="utf-8" />
</ng-helmet>
...
</div>
Nested or latter components will override duplicate changes, and meta
elements without a content
attribute will be removed for the document head:
<div class="parent">
<ng-helmet>
<title>My Title</title>
<meta name="description" content="NgHelmet application" />
<meta name="some-property" content="some-value" />
</ng-helmet>
<div class="child">
<ng-helmet>
<title>Nested Title</title>
<meta name="description" content="Nested component" />
<meta name="some-property" />
</ng-helmet>
</div>
</div>
outputs:
<head>
<title>Nested Title</title>
<meta name="description" content="Nested component" />
</head>
License
MIT