# @wbe/metas-manager
Metas manager allow to inject new metas value in HTML metas tags on demand"
## Installation
```shell script
$ npm install -s @wbe/metas-manager
```
## How to use
First, if your html page don't have a `` meta tag, you need to set it.
MetasManager need a document title tag to create others.
```js
import { MetasManager } from "@wbe/metas-manager";
const values = {
title: "Hello world!",
description: "Custom description",
imageUrl: "Custom preview image URL",
siteName: "Custom site name",
pageUrl: "Custom page URL",
author: "Custom site Author",
keywords: "Custom, key, words",
}
MetasManager.inject({ values });
```
This will inject new metas data in theses meta tags:
```html
Hello world!
...
```
This meta markup can be extend by adding new properties to default meta tags:
ex:
```ts
import MetasManager, { TMetaTags, TTag } from "@wbe/metas-manager";
const robotsTag: TMetaTags = [
// allow to create
{ selectorAttr: "name", selectorValue: "robots", attr: "content" },
];
const tags = {
...MetasManager.DEFAULT_META_TAGS,
robotsTag,
};
const values = {
robots: "index,follow",
}
// will inject value in content attr:
MetasManager.inject({ values, tags });
```
## API
### `inject` (static)
```ts
MetasManager.inject({ values, tags, autoCreateMetaTag, autoRemoveMetaTag });
```
#### Parameters
Object:
- `values (TMetaTags)`: object of values to inject - default: `null`
- `tags (TMetaTags)`: object of meta tags struct - default: `MetasManager.DEFAULT_META_TAGS`
- `autoCreateMetaTag (boolean)`: auto create meta tag in document head if doesn't exist - default: `true`
- `autoRemoveMetaTag (boolean)`: auto remove meta tag in document head if value is "" - default: `true`
#### Returns
`(Void)`