Socket
Socket
Sign inDemoInstall

html-head-component

Package Overview
Dependencies
0
Maintainers
1
Versions
4
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

    html-head-component

A native web component for everything which might go in the <head> of your document.


Version published
Weekly downloads
118
decreased by-0.84%
Maintainers
1
Install size
20.2 kB
Created
Weekly downloads
 

Readme

Source

Travis CI Github Build Codacy Badge Codebeat Badge CodeFactor Badge DeepScan grade Analytics

Head Component

A native web component for everything which might go in the <head> of your document.

Visitor stats

GitHub stars GitHub forks GitHub watchers GitHub followers

Code stats

GitHub code size in bytes GitHub repo size GitHub language count GitHub top language GitHub last commit

Install

npm i html-head-component

# or

yarn add html-head-component

Usage

In your JavaScript/TypeScript entry point:

import 'html-head-component';

You can also include the web component directly from unpkg.com:

import('https://unpkg.com/html-head-component');

or

<script async src="https://unpkg.com/html-head-component"></script>

Then add the component in your HTML/JSX markup:

The custom component should be placed in the <body> tag. If you try to place it in the <head> the browser will explicitly move it in the <body> and you might experience issues with the rest of the elements in the <head>.

Using the data attribute

<html-head-component
	data='
[
	{
		"tag": "title",
		"content": "Title"
	},
	{
		"tag": "meta",
		"name": "author",
		"content": "Scriptex"
	},
	{
		"tag": "link",
		"rel": "stylesheet",
		"href": "./style.css"
	}
]
'
></html-head-component>

Using the src attribute

<html-head-component src="./data.json"></html-head-component>

Usage details

The web component accepts two attributes:

  • src which is a valid path to a JSON file containing array of objects.
  • data which is a valid JSON string which represents an array of objects.

Only one of those attributes should be used. If both are used, the src attribute overwrites the data attribute.

Each object in the JSON array should have a tag property which specifies the HTML element which will be rendered.

The rest of the properties in the object specify the attributes and their content in key:value pairs (attribute:attribute-content).

There are several exceptions:

  1. The document title's content is rendered as innerHTML of the <title> tag.
  2. Each style tag's content property will be rendered as innerHTML of the <style> tag.
  3. Each script tag's content property will be rendered as innerHTML of the <script> tag.
  4. Each noscript tag's content property will be rendered as innerHTML of the <noscript> tag.

React with TypeScript

If you're using React with TypeScript, you need to extends the JSX IntrinsicElements interface so TypeScript knows that the html-head-component element exists.

You can do so in a custom.d.ts file in your project's root folder. Don't forget to add that file in your tsconfig.json!

declare namespace JSX {
	interface IntrinsicElements {
		html-head-component: any;
	}
}

Full example

You can check out the demo usage using data attribute.

Or

You can check out the demo usage using src attribute.

Full list of what can go in the <head> of your document, please check this awesome repository

LICENSE

MIT


Connect with me:


Support and sponsor my work:

Keywords

FAQs

Last updated on 07 Nov 2022

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc