tiptap/docs/api/extensions/character-count.md

1.7 KiB
Raw Blame History

description icon
Limit the number of characters in your editor, or at least count them. calculator-line

CharacterCount

Version Downloads

The CharacterCount extension limits the number of allowed character to a specific length. Thats it, thats all.

Installation

npm install @tiptap/extension-character-count

Settings

limit

The maximum number of characters that should be allowed.

Default: null

CharacterCount.configure({
  limit: 240,
})

mode

The mode by which the size is calculated.

Default: 'textSize'

CharacterCount.configure({
  mode: 'nodeSize',
})

Storage

characters()

Get the number of characters for the current document.

editor.storage.characterCount.characters()

// Get the size of a specific node.
editor.storage.characterCount.characters({ node: someCustomNode })

// Overwrite the default `mode`.
editor.storage.characterCount.characters({ mode: 'nodeSize' })

words()

Get the number of words for the current document.

editor.storage.characterCount.words()

// Get the number of words for a specific node.
editor.storage.characterCount.words({ node: someCustomNode })

Source code

packages/extension-character-count/

Usage

https://embed.tiptap.dev/preview/Extensions/CharacterCount