{"id":16701055,"url":"https://github.com/scriptex/html-head-component","last_synced_at":"2025-03-21T19:33:08.217Z","repository":{"id":43437276,"uuid":"287489746","full_name":"scriptex/html-head-component","owner":"scriptex","description":"A native web component for everything which might go in the \u003chead\u003e of your document.","archived":false,"fork":false,"pushed_at":"2025-03-11T04:23:17.000Z","size":102,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-18T04:42:43.147Z","etag":null,"topics":["head","metadata","web-component"],"latest_commit_sha":null,"homepage":"https://atanas.info/portfolio/open-source/html-head-component","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/scriptex.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["scriptex"],"patreon":"atanas","open_collective":null,"ko_fi":"scriptex","tidelift":null,"community_bridge":null,"liberapay":"scriptex","issuehunt":"scriptex","otechie":null,"custom":["paypal.me/scriptex","revolut.me/scriptex"]}},"created_at":"2020-08-14T08:59:49.000Z","updated_at":"2025-03-11T04:23:19.000Z","dependencies_parsed_at":"2023-02-16T14:16:12.476Z","dependency_job_id":"c7dc0925-c026-450c-a750-c39601184981","html_url":"https://github.com/scriptex/html-head-component","commit_stats":{"total_commits":86,"total_committers":4,"mean_commits":21.5,"dds":0.5232558139534884,"last_synced_commit":"8624cf9ee96c41231b96b343dafd065bcae19ba9"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scriptex%2Fhtml-head-component","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scriptex%2Fhtml-head-component/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scriptex%2Fhtml-head-component/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scriptex%2Fhtml-head-component/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/scriptex","download_url":"https://codeload.github.com/scriptex/html-head-component/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244855705,"owners_count":20521688,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["head","metadata","web-component"],"created_at":"2024-10-12T18:28:09.653Z","updated_at":"2025-03-21T19:33:07.806Z","avatar_url":"https://github.com/scriptex.png","language":"TypeScript","readme":"[![Travis CI](https://travis-ci.com/scriptex/html-head-component.svg?branch=master)](https://travis-ci.com/scriptex/html-head-component)\n[![Github Build](https://github.com/scriptex/html-head-component/workflows/Build/badge.svg)](https://github.com/scriptex/html-head-component/actions?query=workflow%3ABuild)\n[![Codacy Badge](https://app.codacy.com/project/badge/Grade/34d3d75710534dc6a38c3584a1dcd068)](https://www.codacy.com/gh/scriptex/html-head-component/dashboard?utm_source=github.com\u0026utm_medium=referral\u0026utm_content=scriptex/html-head-component\u0026utm_campaign=Badge_Grade)\n[![Codebeat Badge](https://codebeat.co/badges/d765a4c8-2c0e-44f2-89c3-fa364fdc14e6)](https://codebeat.co/projects/github-com-scriptex-html-head-component-master)\n[![CodeFactor Badge](https://www.codefactor.io/repository/github/scriptex/html-head-component/badge)](https://www.codefactor.io/repository/github/scriptex/html-head-component)\n[![DeepScan grade](https://deepscan.io/api/teams/3574/projects/5257/branches/40799/badge/grade.svg)](https://deepscan.io/dashboard#view=project\u0026tid=3574\u0026pid=5257\u0026bid=40799)\n[![Analytics](https://ga-beacon-361907.ew.r.appspot.com/UA-83446952-1/github.com/scriptex/html-head-component/README.md?pixel)](https://github.com/scriptex/html-head-component/)\n\n# Head Component\n\n\u003e A native web component for everything which might go in the `\u003chead\u003e` of your document.\n\n## Visitor stats\n\n![GitHub stars](https://img.shields.io/github/stars/scriptex/html-head-component?style=social)\n![GitHub forks](https://img.shields.io/github/forks/scriptex/html-head-component?style=social)\n![GitHub watchers](https://img.shields.io/github/watchers/scriptex/html-head-component?style=social)\n![GitHub followers](https://img.shields.io/github/followers/scriptex?style=social)\n\n## Code stats\n\n![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/scriptex/html-head-component)\n![GitHub repo size](https://img.shields.io/github/repo-size/scriptex/html-head-component?style=plastic)\n![GitHub language count](https://img.shields.io/github/languages/count/scriptex/html-head-component?style=plastic)\n![GitHub top language](https://img.shields.io/github/languages/top/scriptex/html-head-component?style=plastic)\n![GitHub last commit](https://img.shields.io/github/last-commit/scriptex/html-head-component?style=plastic)\n\n## Install\n\n```sh\nnpm i html-head-component\n\n# or\n\nyarn add html-head-component\n```\n\n## Usage\n\nIn your JavaScript/TypeScript entry point:\n\n```javascript\nimport 'html-head-component';\n```\n\nYou can also include the web component directly from **unpkg.com**:\n\n```javascript\nimport('https://unpkg.com/html-head-component');\n```\n\nor\n\n```html\n\u003cscript async src=\"https://unpkg.com/html-head-component\"\u003e\u003c/script\u003e\n```\n\nThen add the component in your HTML/JSX markup:\n\n**The custom component should be placed in the `\u003cbody\u003e` tag. If you try to place it in the `\u003chead\u003e` the browser will explicitly move it in the `\u003cbody\u003e` and you might experience [issues](https://github.com/scriptex/html-head-component/issues/12) with the rest of the elements in the `\u003chead\u003e`.**\n\n### Using the `data` attribute\n\n```html\n\u003chtml-head-component\n\tdata='\n[\n\t{\n\t\t\"tag\": \"title\",\n\t\t\"content\": \"Title\"\n\t},\n\t{\n\t\t\"tag\": \"meta\",\n\t\t\"name\": \"author\",\n\t\t\"content\": \"Scriptex\"\n\t},\n\t{\n\t\t\"tag\": \"link\",\n\t\t\"rel\": \"stylesheet\",\n\t\t\"href\": \"./style.css\"\n\t}\n]\n'\n\u003e\u003c/html-head-component\u003e\n```\n\n### Using the `src` attribute\n\n```html\n\u003chtml-head-component src=\"./data.json\"\u003e\u003c/html-head-component\u003e\n```\n\n## Usage details\n\nThe web component accepts two attributes:\n\n-   `src` which is a valid path to a JSON file containing array of objects.\n-   `data` which is a valid JSON string which represents an array of objects.\n\nOnly one of those attributes should be used. If both are used, the `src` attribute overwrites the `data` attribute.\n\nEach object in the JSON array should have a `tag` property which specifies the HTML element which will be rendered.\n\nThe rest of the properties in the object specify the attributes and their content in `key:value` pairs (`attribute`:`attribute-content`).\n\nThere are several exceptions:\n\n1. The document title's content is rendered as `innerHTML` of the `\u003ctitle\u003e` tag.\n2. Each `style` tag's content property will be rendered as `innerHTML` of the `\u003cstyle\u003e` tag.\n3. Each `script` tag's content property will be rendered as `innerHTML` of the `\u003cscript\u003e` tag.\n4. Each `noscript` tag's content property will be rendered as `innerHTML` of the `\u003cnoscript\u003e` tag.\n\n## React with TypeScript\n\nIf you're using React with TypeScript, you need to extends the JSX `IntrinsicElements` interface so TypeScript knows that the `html-head-component` element exists.\n\nYou 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`!\n\n```typescript\ndeclare namespace JSX {\n\tinterface IntrinsicElements {\n\t\thtml-head-component: any;\n\t}\n}\n```\n\n## Full example\n\nYou can check out the [demo usage using `data` attribute](https://github.com/scriptex/html-head-component/blob/master/demo/index-data.html).\n\nOr\n\nYou can check out the [demo usage using `src` attribute](https://github.com/scriptex/html-head-component/blob/master/demo/index-src.html).\n\nFull list of what can go in the `\u003chead\u003e` of your document, please check this [awesome repository](https://github.com/joshbuchea/HEAD)\n\n## LICENSE\n\nMIT\n\n---\n\n\u003cdiv align=\"center\"\u003e\n    Connect with me:\n\u003c/div\u003e\n\n\u003cbr /\u003e\n\n\u003cdiv align=\"center\"\u003e\n    \u003ca href=\"https://atanas.info\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/scriptex/socials/master/styled-assets/logo.svg\" height=\"20\" alt=\"\"\u003e\n    \u003c/a\u003e\n    \u0026nbsp;\n    \u003ca href=\"mailto:hi@atanas.info\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/scriptex/socials/master/styled-assets/email.svg\" height=\"20\" alt=\"\"\u003e\n    \u003c/a\u003e\n    \u0026nbsp;\n    \u003ca href=\"https://www.linkedin.com/in/scriptex/\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/scriptex/socials/master/styled-assets/linkedin.svg\" height=\"20\" alt=\"\"\u003e\n    \u003c/a\u003e\n    \u0026nbsp;\n    \u003ca href=\"https://github.com/scriptex\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/scriptex/socials/master/styled-assets/github.svg\" height=\"20\" alt=\"\"\u003e\n    \u003c/a\u003e\n    \u0026nbsp;\n    \u003ca href=\"https://gitlab.com/scriptex\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/scriptex/socials/master/styled-assets/gitlab.svg\" height=\"20\" alt=\"\"\u003e\n    \u003c/a\u003e\n    \u0026nbsp;\n    \u003ca href=\"https://twitter.com/scriptexbg\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/scriptex/socials/master/styled-assets/twitter.svg\" height=\"20\" alt=\"\"\u003e\n    \u003c/a\u003e\n    \u0026nbsp;\n    \u003ca href=\"https://www.npmjs.com/~scriptex\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/scriptex/socials/master/styled-assets/npm.svg\" height=\"20\" alt=\"\"\u003e\n    \u003c/a\u003e\n    \u0026nbsp;\n    \u003ca href=\"https://www.youtube.com/user/scriptex\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/scriptex/socials/master/styled-assets/youtube.svg\" height=\"20\" alt=\"\"\u003e\n    \u003c/a\u003e\n    \u0026nbsp;\n    \u003ca href=\"https://stackoverflow.com/users/4140082/atanas-atanasov\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/scriptex/socials/master/styled-assets/stackoverflow.svg\" height=\"20\" alt=\"\"\u003e\n    \u003c/a\u003e\n    \u0026nbsp;\n    \u003ca href=\"https://codepen.io/scriptex/\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/scriptex/socials/master/styled-assets/codepen.svg\" width=\"20\" alt=\"\"\u003e\n    \u003c/a\u003e\n    \u0026nbsp;\n    \u003ca href=\"https://profile.codersrank.io/user/scriptex\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/scriptex/socials/master/styled-assets/codersrank.svg\" height=\"20\" alt=\"\"\u003e\n    \u003c/a\u003e\n    \u0026nbsp;\n    \u003ca href=\"https://linktr.ee/scriptex\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/scriptex/socials/master/styled-assets/linktree.svg\" height=\"20\" alt=\"\"\u003e\n    \u003c/a\u003e\n\u003c/div\u003e\n\n---\n\n\u003cdiv align=\"center\"\u003e\nSupport and sponsor my work:\n\u003cbr /\u003e\n\u003cbr /\u003e\n\u003ca href=\"https://twitter.com/intent/tweet?text=Checkout%20this%20awesome%20developer%20profile%3A\u0026url=https%3A%2F%2Fgithub.com%2Fscriptex\u0026via=scriptexbg\u0026hashtags=software%2Cgithub%2Ccode%2Cawesome\" title=\"Tweet\"\u003e\n\t\u003cimg src=\"https://img.shields.io/badge/Tweet-Share_my_profile-blue.svg?logo=twitter\u0026color=38A1F3\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://paypal.me/scriptex\" title=\"Donate on Paypal\"\u003e\n\t\u003cimg src=\"https://img.shields.io/badge/Donate-Support_me_on_PayPal-blue.svg?logo=paypal\u0026color=222d65\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://revolut.me/scriptex\" title=\"Donate on Revolut\"\u003e\n\t\u003cimg src=\"https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/scriptex/scriptex/master/badges/revolut.json\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://patreon.com/atanas\" title=\"Become a Patron\"\u003e\n\t\u003cimg src=\"https://img.shields.io/badge/Become_Patron-Support_me_on_Patreon-blue.svg?logo=patreon\u0026color=e64413\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://ko-fi.com/scriptex\" title=\"Buy Me A Coffee\"\u003e\n\t\u003cimg src=\"https://img.shields.io/badge/Donate-Buy%20me%20a%20coffee-yellow.svg?logo=ko-fi\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://liberapay.com/scriptex/donate\" title=\"Donate on Liberapay\"\u003e\n\t\u003cimg src=\"https://img.shields.io/liberapay/receives/scriptex?label=Donate%20on%20Liberapay\u0026logo=liberapay\" /\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/scriptex/scriptex/master/badges/bitcoin.json\" title=\"Donate Bitcoin\"\u003e\n\t\u003cimg src=\"https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/scriptex/scriptex/master/badges/bitcoin.json\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/scriptex/scriptex/master/badges/etherium.json\" title=\"Donate Etherium\"\u003e\n\t\u003cimg src=\"https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/scriptex/scriptex/master/badges/etherium.json\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/scriptex/scriptex/master/badges/shiba-inu.json\" title=\"Donate Shiba Inu\"\u003e\n\t\u003cimg src=\"https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/scriptex/scriptex/master/badges/shiba-inu.json\" /\u003e\n\u003c/a\u003e\n\u003c/div\u003e\n","funding_links":["https://github.com/sponsors/scriptex","https://patreon.com/atanas","https://ko-fi.com/scriptex","https://liberapay.com/scriptex","https://issuehunt.io/r/scriptex","paypal.me/scriptex","revolut.me/scriptex","https://paypal.me/scriptex","https://liberapay.com/scriptex/donate"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscriptex%2Fhtml-head-component","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fscriptex%2Fhtml-head-component","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscriptex%2Fhtml-head-component/lists"}