ee645c1eca
* Optionally delete full mention chip * Added documentation for deleteOnBackspace * rename all references of deleteOnBackspace to deleteTriggerWithBackspace
2.5 KiB
| description | icon |
|---|---|
| Ping all your people @marijn @kevin | at-line |
Mention
Honestly, the mention node is amazing. It adds support for @mentions, for example to ping users, and provides full control over the rendering.
Literally everything can be customized. You can pass a custom component for the rendering. All examples use .filter() to search through items, but feel free to send async queries to an API or add a more advanced library like fuse.js to your project.
Installation
npm install @tiptap/extension-mention
Dependencies
To place the popups correctly, we’re using tippy.js in all our examples. You are free to bring your own library, but if you’re fine with it, just install what we use:
npm install tippy.js
Since 2.0.0-beta.193 we marked the @tiptap/suggestion as a peer dependency. That means, you will need to install it manually.
npm install @tiptap/suggestion
Settings
HTMLAttributes
Custom HTML attributes that should be added to the rendered HTML tag.
Mention.configure({
HTMLAttributes: {
class: 'my-custom-class',
},
})
renderText
Define how a mention text should be rendered.
Mention.configure({
renderText({ options, node }) {
return `${options.suggestion.char}${node.attrs.label ?? node.attrs.id}`
}
})
renderHTML
Define how a mention html element should be rendered, this is useful if you want to render an element other than span (e.g a)
Mention.configure({
renderHTML({ options, node }) {
return [
"a",
mergeAttributes({ href: '/profile/1' }, options.HTMLAttributes),
`${options.suggestion.char}${node.attrs.label ?? node.attrs.id}`,
];
}
})
deleteTriggerWithBackspace
Toggle whether the suggestion character(s) should also be deleted on deletion of a mention node. Default is false.
Mention.configure({
deleteTriggerWithBackspace: true
})
suggestion
Mention.configure({
suggestion: {
// …
},
})