tiptap/docs/api/commands/focus.md

34 lines
1012 B
Markdown
Raw Normal View History

2021-04-21 17:03:33 +08:00
# focus
This command sets the focus back to the editor.
2021-04-21 17:03:33 +08:00
When a user clicks on a button outside the editor, the browser sets the focus to that button. In most scenarios you want to focus the editor then again. Thats why youll see that in basically every demo here.
2021-06-23 03:28:20 +08:00
See also: [setTextSelection](/api/commands/set-text-selection), [blur](/api/commands/blur)
## Parameters
`position: 'start' | 'end' | 'all' | number | boolean | null (false)`
By default, its restoring the cursor position (and text selection). Pass a position to move the cursor too.
2021-05-27 16:53:34 +08:00
`options: { scrollIntoView: boolean }`
Defines whether to scroll to the cursor when focusing. Defaults to `true`.
2021-05-27 16:53:34 +08:00
## Usage
```js
// Set the focus to the editor
editor.commands.focus()
// Set the cursor to the first position
editor.commands.focus('start')
// Set the cursor to the last position
editor.commands.focus('end')
// Selects the whole document
editor.commands.focus('all')
// Set the cursor to position 10
editor.commands.focus(10)
2021-05-27 16:53:34 +08:00
```