@contentful/rich-text-types

What is @contentful/rich-text-types?

@contentful/rich-text-types is a TypeScript library that provides type definitions for the Contentful Rich Text field type. It allows developers to work with Contentful's rich text data in a type-safe manner, ensuring that the data structures are correctly handled and manipulated.

What are @contentful/rich-text-types's main functionalities?

Type Definitions for Rich Text Nodes

This feature provides type definitions for different types of rich text nodes, such as blocks, inlines, and marks. The code sample demonstrates how to define a paragraph block with bold text.

import { BLOCKS, INLINES, MARKS } from '@contentful/rich-text-types';

const node = {
  nodeType: BLOCKS.PARAGRAPH,
  content: [
    {
      nodeType: 'text',
      value: 'Hello, world!',
      marks: [{ type: MARKS.BOLD }],
      data: {}
    }
  ],
  data: {}
};

Type Definitions for Rich Text Document

This feature provides type definitions for the entire rich text document structure. The code sample shows how to define a simple document with a single paragraph.

import { Document } from '@contentful/rich-text-types';

const document: Document = {
  nodeType: 'document',
  data: {},
  content: [
    {
      nodeType: 'paragraph',
      content: [
        {
          nodeType: 'text',
          value: 'This is a paragraph.',
          marks: [],
          data: {}
        }
      ],
      data: {}
    }
  ]
};

Type Definitions for Rich Text Marks

This feature provides type definitions for text marks such as bold and italic. The code sample demonstrates how to use these type definitions.

import { MARKS } from '@contentful/rich-text-types';

const boldMark = MARKS.BOLD;
const italicMark = MARKS.ITALIC;

Other packages similar to @contentful/rich-text-types

draft-js

Draft.js is a JavaScript rich text editor framework, built for React. It provides a set of immutable models and helper functions for working with rich text content. Unlike @contentful/rich-text-types, which focuses on type definitions, Draft.js offers a full-fledged editor with extensive customization options.

slate

Slate is a completely customizable framework for building rich text editors. It provides a set of tools and plugins to create complex editors with various features. Slate is more focused on the editor experience, whereas @contentful/rich-text-types is focused on type safety for Contentful's rich text data.

prosemirror

ProseMirror is a toolkit for building rich text editors with a focus on performance and flexibility. It provides a set of core modules and plugins to create highly customizable editors. ProseMirror is similar to Slate in its focus on the editor experience, while @contentful/rich-text-types is more about type definitions for Contentful's rich text.

README

rich-text-types

Type Definition and constants for Contentful Rich Text.

Block constants partially taken from markup-it.

Releases flow (Atomatic Releases)

Automatic releases are possible thanks to semantic release, which publishes the code automatically on npm and generates a changelog.

We follow angular commit format to generate a changelog.

You'll need to use npm run commit, to create conventional commits.

Changelog

15.1.0 (2021-08-02)

Features

• 🎸 add RT html renderer tables support (ce81375)
• 🎸 add RT react renderer tables support (fddfb8a)
• add rowspan (e0264fb)