3d68981b47
* wip * WIP * add autolink implementation * refactoring * set keepOnSplit to false * refactoring * improve changed ranges detection * move some helpers into core Co-authored-by: Philipp Kühn <philippkuehn@MacBook-Pro-von-Philipp.local>
2.6 KiB
| description | icon |
|---|---|
| Link it, link it good, link it real good (and don’t forget the href). | link |
Link
The Link extension adds support for <a> tags to the editor. The extension is headless too, there is no actual UI to add, modify or delete links. The usage example below uses the native JavaScript prompt to show you how that could work.
In a real world application, you would probably add a more sophisticated user interface.
Pasted URLs will be transformed to links automatically.
Installation
npm install @tiptap/extension-link
Settings
autolink
If enabled, it adds links as you type.
Default: true
Link.configure({
autolink: false,
})
openOnClick
If enabled, links will be opened on click.
Default: true
Link.configure({
openOnClick: false,
})
linkOnPaste
Adds a link to the current selection if the pasted content only contains an url.
Default: true
Link.configure({
linkOnPaste: false,
})
HTMLAttributes
Custom HTML attributes that should be added to the rendered HTML tag.
Link.configure({
HTMLAttributes: {
class: 'my-custom-class',
},
})
Commands
setLink()
Links the selected text.
editor.commands.setLink({ href: 'https://example.com' })
editor.commands.setLink({ href: 'https://example.com', target: '_blank' })
toggleLink()
Adds or removes a link from the selected text.
editor.commands.toggleLink({ href: 'https://example.com' })
editor.commands.toggleLink({ href: 'https://example.com', target: '_blank' })
unsetLink()
Removes a link.
editor.commands.unsetLink()
Keyboard shortcuts
:::warning Doesn’t have a keyboard shortcut
This extension doesn’t bind a specific keyboard shortcut. You would probably open your custom UI on Mod-k though.
:::
Get the current value
Did you know that you can use getAttributes to find out which attributes, for example which href, is currently set? Don’t confuse it with a command (which changes the state), it’s just a method. Here is how that could look like:
this.editor.getAttributes('link').href