Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

@bicou/directus-extension-tiptap

gbicou463MIT1.18.6

Tiptap rich text editor interface and display for directus

directus, directus-extension, directus-custom-bundle, directus-custom-interface, directus-custom-display, tiptap, prosemirror, wysiwg, editor

readme

Tiptap for Directus

npm version npm downloads License

This is a Directus extension that provides the Tiptap editor as a rich text field type.

The StarterKit tiptap bundle is already included and the other tiptap extensions are available in the directus interface options.

Requirements

This extension requires Directus 9 or higher to be installed.

Installation

Add @bicou/directus-extension-tiptap dependency to your directus project.

# Using pnpm
pnpm add @bicou/directus-extension-tiptap
# Using yarn
yarn add @bicou/directus-extension-tiptap
# Using npm
npm install @bicou/directus-extension-tiptap

Usage

Field

When creating a field in Directus choose TipTap.

field creation

Choosing Type allows you to store your content as a JSON object or as a good old HTML string

  • JSON : the JSON object of the ProseMirror nodes
  • Text : the HTML content as string

Editor

When editing content items, the Tiptap WYSIWG editor will show up :

editor

Field data and display

By default, the data is shown as raw JSON :

json render

Edit the field to select Tiptap as display ...

display

... to render the text of the field in content browsing :

text render

License

This extension is released under the MIT license. See the LICENSE file for more details.

changelog

1.11.0 (2023-08-17)

1.18.6 (2025-04-05)

Bug Fixes

  • deps: update tiptap monorepo to v2.11.6 (#266) (dfb668a)
  • deps: update tiptap monorepo to v2.11.7 (#270) (341d299)

1.18.5 (2025-03-07)

Bug Fixes

1.18.4 (2025-03-07)

Bug Fixes

  • deps: update tiptap monorepo to v2.11.2 (b5c9372)
  • deps: update tiptap monorepo to v2.11.2 (e89c242)
  • deps: update tiptap monorepo to v2.11.3 (7a1b9e1)
  • deps: update tiptap monorepo to v2.11.3 (7ef84ee)
  • deps: update tiptap monorepo to v2.11.5 (563b452)
  • deps: update tiptap monorepo to v2.11.5 (2e696f9)

1.18.3

Patch Changes

  • #186 1f616a4 Thanks @renovate! - Updated dependency @tiptap-pro/extension-mathematics to 2.17.2.

  • #185 def23ee Thanks @renovate! - Updated dependency @tiptap-pro/extension-invisible-characters to 2.17.2.

  • #184 229893c Thanks @renovate! - Updated dependency @tiptap-pro/extension-emoji to 2.17.2.

  • #192 5b638d1 Thanks @renovate! - Updated dependency @tiptap/core to 2.11.0. Updated dependency @tiptap/extension-character-count to 2.11.0. Updated dependency @tiptap/extension-focus to 2.11.0. Updated dependency @tiptap/extension-highlight to 2.11.0. Updated dependency @tiptap/extension-link to 2.11.0. Updated dependency @tiptap/extension-placeholder to 2.11.0. Updated dependency @tiptap/extension-subscript to 2.11.0. Updated dependency @tiptap/extension-superscript to 2.11.0. Updated dependency @tiptap/extension-table to 2.11.0. Updated dependency @tiptap/extension-table-cell to 2.11.0. Updated dependency @tiptap/extension-table-header to 2.11.0. Updated dependency @tiptap/extension-table-row to 2.11.0. Updated dependency @tiptap/extension-task-item to 2.11.0. Updated dependency @tiptap/extension-task-list to 2.11.0. Updated dependency @tiptap/extension-text-align to 2.11.0. Updated dependency @tiptap/extension-typography to 2.11.0. Updated dependency @tiptap/extension-underline to 2.11.0. Updated dependency @tiptap/pm to 2.11.0. Updated dependency @tiptap/starter-kit to 2.11.0. Updated dependency @tiptap/suggestion to 2.11.0. Updated dependency @tiptap/vue-3 to 2.11.0.

  • #187 7effc2e Thanks @renovate! - Updated dependency @tiptap-pro/extension-unique-id to 2.17.2.

  • #190 4c2303a Thanks @renovate! - Updated dependency packageManager to `pnpm@9.15.3+sha512.1f79bc245a66eb0b07c5d4d83131240774642caaa86ef7d0434ab47c0d16f66b04e21e0c086eb61e62c77efc4d7f7ec071afad3796af64892fae66509173893a`.

1.18.2

Patch Changes

1.18.1

Patch Changes

1.18.0

Minor Changes

1.17.0

Minor Changes

1.16.1

Patch Changes

  • #117 03bf321 Thanks @renovate! - chore(deps): update dependency @tiptap-pro/extension-invisible-characters to v2.10.4

  • #111 7cf8f27 Thanks @renovate! - fix(deps): update tiptap monorepo to v2.5.6

  • #119 a411a26 Thanks @renovate! - chore(deps): update dependency @tiptap-pro/extension-unique-id to v2.10.4

  • #116 b2b34b4 Thanks @renovate! - chore(deps): update dependency @tiptap-pro/extension-emoji to v2.10.4

  • #118 8d542cd Thanks @renovate! - chore(deps): update dependency @tiptap-pro/extension-mathematics to v2.10.4

1.16.0

Minor Changes

Patch Changes

1.15.0

Minor Changes

1.14.0

Minor Changes

  • 1188002 Thanks @gbicou! - dependencies upgrade : tiptap 2.2, directus

1.13.1

Patch Changes

1.13.0

Minor Changes

1.12.0

Minor Changes

1.11.4

Patch Changes

1.11.3

Patch Changes

1.11.2

Patch Changes

1.11.1

Patch Changes

Features

1.10.4 (2023-08-11)

Bug Fixes

  • inline rendering of display (d1e5315)

1.10.3 (2023-08-03)

Bug Fixes

  • avoid content reset before model update (2d3a723)

1.10.2 (2023-05-12)

Bug Fixes

  • use ESM build format thanks to directus/directus#18351 (40dc069)

1.10.1 (2023-05-02)

Bug Fixes

1.10.0 (2023-04-28)

Features

1.9.2 (2023-04-26)

Bug Fixes

1.9.1 (2023-04-25)

Bug Fixes

  • configurable image filename (e751b72)

1.9.0 (2023-04-25)

Features

  • use a custom image tiptap extension for directus files #16 (3c2ce9c)

1.8.0 (2023-04-24)

Bug Fixes

Features

1.8.0-alpha.3 (2023-04-24)

Bug Fixes

1.8.0-alpha.2 (2023-04-24)

Bug Fixes

1.8.0-alpha.1 (2023-04-21)

Features

1.7.1-alpha.2 (2023-04-21)

Bug Fixes

  • clear format without clearing nodes (9f20ae4)

1.7.1-alpha.1 (2023-04-21)

Bug Fixes

  • toolbar disabled buttons (08aabb8)

1.7.0 (2023-04-20)

Bug Fixes

Features

1.7.0-alpha.6 (2023-04-20)

Features

1.7.0-alpha.5 (2023-04-20)

Features

1.7.0-alpha.4 (2023-04-20)

Bug Fixes

Features

1.7.0-alpha.3 (2023-04-20)

Features

1.7.0-alpha.2 (2023-04-20)

Bug Fixes

  • paragraph keyboard shortcut (e4072e6)

Features

1.7.0-alpha.1 (2023-04-20)

Features

1.6.0 (2023-04-20)

Bug Fixes

  • blank editor editable area (0c2bcb1)
  • code and codeblock inverted style (d8528d4)
  • display empty doc as empty string (39a6a79)
  • handle autofocus (35ac9f8)
  • load extension only once (51ede66)

Features

1.6.0-alpha.8 (2023-04-19)

Features

1.6.0-alpha.7 (2023-04-19)

Features

  • options for character count extension (eed17c3)

1.6.0-alpha.6 (2023-04-13)

Features

1.6.0-alpha.5 (2023-04-13)

Features

1.6.0-alpha.4 (2023-04-12)

Bug Fixes

  • display empty doc as empty string (39a6a79)

1.6.0-alpha.3 (2023-04-12)

Bug Fixes

1.6.0-alpha.2 (2023-04-12)

Bug Fixes

  • code and codeblock inverted style (d8528d4)

1.6.0-alpha.1 (2023-04-12)

Features

1.5.0 (2023-04-12)

Features

1.4.0 (2023-04-07)

Bug Fixes

  • editor content height (73d91ae)
  • show buttons of loaded extensions (9995e4a)

Features

  • highlight extension (4e3fb32)
  • subscript and superscript extensions (88f2db7)

1.3.0 (2023-04-06)

Features

  • characters and words count in info bar (13e4c57)

1.2.0 (2023-04-06)

Features

1.1.5 (2023-04-06)

Bug Fixes

  • display: overflow tooltip placement (11ebd6f)

1.1.4 (2023-03-31)

Bug Fixes

1.1.3 (2023-03-31)

Bug Fixes

  • paragraph, break and clear tools (16bcbcd)
  • watch disabled prop (167f66a)

1.1.2 (2023-03-30)

Bug Fixes

1.1.1 (2023-03-30)

Bug Fixes

1.1.0 (2023-03-30)

Features

  • include a custom display rendering content as text (a99e873)

1.0.1 (2023-03-30)

Bug Fixes

  • rearrange toolbar icons by marks, nodes and history (1841fef)

1.0.0 (2023-03-30)

Bug Fixes

Features

1.0.0-alpha.4 (2023-03-29)

Bug Fixes

Features

1.0.0-alpha.3 (2023-03-29)

Features

  • allow to store content as HTML string #4 (60a8c6f)

1.0.0-alpha.2 (2023-03-28)

Bug Fixes

1.0.0-alpha.1 (2023-03-28)

Features