mirror of
https://github.com/ueberdosis/tiptap.git
synced 2024-12-04 19:59:02 +08:00
569aa15c4f
# Conflicts: # docs/experiments/collaboration-annotation.md # docs/experiments/global-drag-handle.md
51 lines
2.8 KiB
Markdown
51 lines
2.8 KiB
Markdown
# Link
|
||
[](https://www.npmjs.com/package/@tiptap/extension-link)
|
||
[](https://npmcharts.com/compare/@tiptap/extension-link?minimal=true)
|
||
|
||
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
|
||
```bash
|
||
# with npm
|
||
npm install @tiptap/extension-link
|
||
|
||
# with Yarn
|
||
yarn add @tiptap/extension-link
|
||
```
|
||
|
||
## Settings
|
||
| Option | Type | Default | Description |
|
||
| -------------- | --------- | ----------------------------------------------------------- | -------------------------------------------------------------------------------- |
|
||
| HTMLAttributes | `Object` | `{ target: '_blank', rel: 'noopener noreferrer nofollow' }` | Custom HTML attributes that should be added to the rendered HTML tag. |
|
||
| openOnClick | `Boolean` | `true` | If enabled, links will be opened on click. |
|
||
| linkOnPaste | `Boolean` | `true` | Adds a link to the current selection if the pasted content only contains an url. |
|
||
|
||
## Commands
|
||
| Command | Parameters | Description |
|
||
| ---------- | ------------------ | -------------------------------------------- |
|
||
| setLink | `href`<br>`target` | Link the selected text. |
|
||
| toggleLink | `href`<br>`target` | Add or remove a link from the selected text. |
|
||
| unsetLink | – | Removes a link. |
|
||
|
||
## 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`](/api/editor#methods) to find out which attributes, for example which href, is currently set? Don’t confuse it with a [command](/api/commands) (which changes the state), it’s just a method. Here is how that could look like:
|
||
|
||
```js
|
||
this.editor.getAttributes('link').href
|
||
```
|
||
|
||
## Source code
|
||
[packages/extension-link/](https://github.com/ueberdosis/tiptap/blob/main/packages/extension-link/)
|
||
|
||
## Usage
|
||
<tiptap-demo name="Marks/Link"></tiptap-demo>
|