mirror/tiptap
1
0
Fork 0
mirror of https://github.com/ueberdosis/tiptap.git synced 2024-12-03 02:39:02 +08:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity
3d3dcdaf42
tiptap/docs/src/docPages/api/editor.md

42 lines
6.8 KiB
Markdown
Raw Normal View History

move some pages
2020-04-19 02:39:48 +08:00
# Editor
add more content everywhere
2020-09-16 03:07:16 +08:00
rename table of contents to keep the search results clean
2020-10-28 22:25:06 +08:00
## toc
add table of content support
2020-09-27 16:29:01 +08:00
add introduction to all pages, move under table of contents
2020-10-01 18:26:20 +08:00
## Introduction
This class is a central building block of tiptap. It does most of the heavy lifting of creating a working [ProseMirror](https://ProseMirror.net/) editor such as creating the [`EditorView`](https://ProseMirror.net/docs/ref/#view.EditorView), setting the initial [`EditorState`](https://ProseMirror.net/docs/ref/#state.Editor_State) and so on.
a ton of improvements
2020-09-23 18:03:03 +08:00
## Configuration
| Setting | Type | Default | Description |
| ------------------ | --------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
rename autoFocus to autofocus
2020-11-17 22:47:39 +08:00
| `autofocus` | `Boolean` | `false` | Focus the editor on init. |
a ton of improvements
2020-09-23 18:03:03 +08:00
| `content` | `Object|String` | `null` | The editor state object used by Prosemirror. You can also pass HTML to the `content` slot. When used both, the `content` slot will be ignored. |
| `editable` | `Boolean` | `true` | When set to `false` the editor is read-only. |
| `editorProps` | `Object` | `{}` | A list of [Prosemirror editorProps](https://prosemirror.net/docs/ref/#view.EditorProps). |
| `extensions` | `Array` | `[]` | A list of extensions used, by the editor. This can be `Nodes`, `Marks` or `Plugins`. |
| `parseOptions` | `Object` | `{}` | A list of [Prosemirror parseOptions](https://prosemirror.net/docs/ref/#model.ParseOptions). |
| `onBlur` | `Function` | `undefined` | Returns an object with the `event` and current `state` and `view` of Prosemirror on blur. |
| `onFocus` | `Function` | `undefined` | Returns an object with the `event` and current `state` and `view` of Prosemirror on focus. |
| `onInit` | `Function` | `undefined` | Returns an object with the current `state` and `view` of Prosemirror on init. |
update docs
2020-11-03 00:36:27 +08:00
| `onUpdate` | `Function` | `undefined` | Returns an object with the current `state` of Prosemirror, a `getJSON()` and `getHTML()` function and the `transaction` on every change. |
improve the editor page
2020-09-26 19:57:47 +08:00
## Methods
| Method | Parameters | Description |
| -------------------- | ----------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
update docs
2020-11-03 00:36:27 +08:00
| `getHTML()` | – | Returns the current content as HTML. |
| `getJSON()` | – | Returns the current content as JSON. |
improve the editor page
2020-09-26 19:57:47 +08:00
| `destroy()` | – | Stops the editor instance and unbinds all events. |
| `chain()` | - | Create a command chain to call multiple commands at once. |
update docs
2020-11-03 00:36:27 +08:00
| `can()` | - | Check if a command or a command chain can be executed. Without executing it. |
improve the editor page
2020-09-26 19:57:47 +08:00
| `setOptions()` | `options` A list of options | Update editor options. |
| `isEditable()` | - | Returns whether the editor is editable. |
| `state()` | - | Returns the editor state. |
| `registerCommands()` | `commands` A list of commands | Register a list of commands. |
| `registerCommand()` | `name` The name of your command<br>`callback` The method of your command | Register a command. |
| `registerPlugin()` | `plugin` A ProseMirror plugin<br>`handlePlugins` Control how to merge the plugin into the existing plugins. | Register a ProseMirror plugin. |
| `unregisterPlugin()` | `name` The plugins name | Unregister a ProseMirror plugin. |
| `createDocument()` | `content` EditorContent<br>`parseOptions` | Creates a ProseMirror document. |
| `getNodeAttrs()` | `name` Name of the node | Get attributes of the currently selected node. |
| `getMarkAttrs()` | `name` Name of the mark | Get attributes of the currently selected mark. |
| `isActive()` | `name` Name of the node or mark<br>`attrs` Attributes of the node or mark | Returns if the currently selected node or mark is active. |
update docs
2020-11-03 00:36:27 +08:00
| `isEmpty()` | - | Check if there is no content. |
Reference in New Issue Copy Permalink