Rich Text Resolver for new Strapi Field "Rich Text (Blocks)"

Strapi
December 23, 2023

Strapi's new "Rich Text (Blocks)" field in the Headless CMS introduces a new JSON based editor for writing content. This article focuses on a straightforward, dependency-free solution using vanilla JavaScript to resolve the rich text content.

Decoding the JSON Structure

Before looking into the code, let's grasp the JSON structure used by Strapi's "Rich Text (Blocks)" field. The TypeScript definition below outlines the key components:

TypeScript
type StrapiRichTextBlocks = {
  type:
    | 'text'
    | 'heading'
    | 'paragraph'
    | 'list'
    | 'list-item'
    | 'link'
    | 'quote'
    | 'code'
    | 'image';
  level?: 1 | 2 | 3 | 4 | 5 | 6;
  format?: 'unordered' | 'ordered';
  text?: string;
  url?: string;
  bold?: boolean;
  code?: boolean;
  italic?: boolean;
  strikethrough?: boolean;
  underline?: boolean;
  image?: {
    alternativeText: string;
    url: string;
    width?: number;
    height?: number;
    // ...
  };
  children?: StrapiRichTextNode[];
}[];

Rich Text Resolver

Let's jump straight into the code. The following JavaScript functions handle the conversion of Strapi's rich text nodes into their corresponding HTML representations:

JavaScript
function resolveRichText(nodes) {
  return nodes.map((c) => resolveRichTextNode(c)).join('');
}

function resolveRichTextNode(node) {
  let html = '';
  const children = node.children ? node.children.map((c) => resolveRichTextNode(c)).join('') : '';

  switch (node.type) {
    case 'heading':
      html = `<h${node.level}>${children}</h${node.level}>`;
      break;
    case 'text':
      if (node.text) {
        let tmp = node.text.replaceAll('\n', '<br />');

        if (node.bold) tmp = `<b>${tmp}</b>`;
        if (node.code) tmp = `<code>${tmp}</code>`;
        if (node.italic) tmp = `<i>${tmp}</i>`;
        if (node.strikethrough) tmp = `<s>${tmp}</s>`;
        if (node.underline) tmp = `<u>${tmp}</u>`;

        html = tmp;
      }
      break;
    case 'paragraph':
      html = `<p>${children}</p>`;
      break;
    case 'link':
      html = `<a href="${node.url}">${children}</a>`;
      break;
    case 'list':
      switch (node.format) {
        case 'ordered':
          html = `<ol>${children}</ol>`;
          break;
        case 'unordered':
          html = `<ul>${children}</ul>`;
          break;
      }
      break;
    case 'list-item':
      html = `<li>${children}</li>`;
      break;
    case 'quote':
      html = `<blockquote>${children}</blockquote>`;
      break;
    case 'code':
      html = `<pre>${children}</pre>`;
      break;
    case 'image':
      if (node.image) {
        html = `<img src="${node.image.url}" height="${node.image.height}" width="${node.image.width}" alt="${node.image.alternativeText}" />`;
      }
      break;
  }

  return html;
}

The resolveRichText function takes an array of nodes and maps through them, invoking another function, resolveRichTextNode, for each node. The results are then joined to form the complete HTML representation.

Use resolveRichText to resolve the JSON.

This solution offers a clean and flexible approach to handling Strapi's rich text content using vanilla JavaScript. Feel free to adapt and extend it based on your specific needs.