Head

The <head> tag is a very important point of customization for your app. You are going to want to add things like a custom title, favicons, social open graph meta, etc.

However, the <head> tag is not a Custom Element. Furthermore it cannot contain Custom Elements. There are only a subset of existing pre-defined HTML tags that can be included in the <head> tag.

As Custom Elements are elements that you the user define they are not included in this pre-defined set of HTML tags.

💀

Default head component

To help you with customizing your <head> element, Enhance projects come with basic default head content to get you started. The default head content below is the bare minimum and should be the basis for your own customizations.

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title></title>
  <link rel="stylesheet" href="/_static/styles.css">
  <link rel="icon" href="/_static/favicon.svg">
</head>

Override the default

To supply your own custom head content add a file /app/head.mjs to your project.

Since the <head> tag is not a Custom Element, nor can it be the arguments passed to head.mjs are not the same as Elements in your Enhance project.

Since the html function passed to Elements is used to expand Custom Elements, which are not allowed inside the <head> tag there is no reason to pass it as an argument. Instead your head.mjs template will be passed a state object containing:

store: The API data mapped to the current page
req: A standard request Object
error: An error message if an error has occurred so you can message your site’s users
status: A status code to enable you to do the correct handling

export default function Head(state) {
  const { store, status, req, error } = state
  const { path } = req
  const title = `My app — ${path}`
  return `
    <!DOCTYPE html>
    <html lang="en">
    <head>
      <meta charset="utf-8">
      <meta name="viewport" content="width=device-width, initial-scale=1">
      <title>${title}</title>
      <link rel="stylesheet" href="/_static/styles.css">
      <link rel="icon" href="/_static/favicon.svg">
    </head>
  `
}

🚏

Templates that are not Custom Elements

You are not limited to using Custom Elements when rendering your document server-side. You can define a template for pre-defined HTML tags as follows:

export default function TwitterMeta(state) {
  const { title, description, image, card } = state
  return `
<meta name="twitter:title" content="${title}">
<meta name="twitter:description" content="${description}">
<meta name="twitter:image" content="${image}">
<meta name="twitter:card" content="${card}">
  `
}

You can then use this meta content template in your head.mjs like so:

import TwitterMeta from './templates/twitter-meta.mjs'
export default function Head(state) {
  const { store, status, req, error } = state
  const { path } = req
  const title = `My app — ${path}`
  return `
    <!DOCTYPE html>
    <html lang="en">
    <head>
      <meta charset="utf-8">
      <meta name="viewport" content="width=device-width, initial-scale=1">
      ${TwitterMeta(store)}
      <title>${title}</title>
      <link rel="stylesheet" href="/_static/styles.css">
      <link rel="icon" href="/_static/favicon.svg">
    </head>
  `
}

Enhance Docs

Head

Default head component

Override the default

Templates that are not Custom Elements