1
0
mirror of https://github.com/ianstormtaylor/slate.git synced 2025-08-11 09:43:58 +02:00

docs: change Editor static methods to use fat arrows in method names

This commit is contained in:
Sunny Hirai
2021-05-26 00:06:46 -07:00
parent ced37b93c7
commit 2fbcb335bb

View File

@@ -39,7 +39,7 @@ interface Editor {
## Instantiation methods ## Instantiation methods
#### `createEditor(): Editor` #### `createEditor() => Editor`
Note: This method is imported directly from Slate and is not part of the Editor object. Note: This method is imported directly from Slate and is not part of the Editor object.
@@ -49,75 +49,75 @@ Creates a new, empty `Editor` object.
### Retrieval methods ### Retrieval methods
#### `Editor.above<T extends Ancestor>(editor: Editor, options?): NodeEntry<T> | undefined` #### `Editor.above<T extends Ancestor>(editor: Editor, options?) => NodeEntry<T> | undefined`
Get the ancestor above a location in the document. Get the ancestor above a location in the document.
Options: `{at?: Location, match?: NodeMatch, mode?: 'highest' | 'lowest', voids?: boolean}` Options: `{at?: Location, match?: NodeMatch, mode?: 'highest' | 'lowest', voids?: boolean}`
#### `Editor.after(editor: Editor, at: Location, options?): Point | undefined` #### `Editor.after(editor: Editor, at: Location, options?) => Point | undefined`
Get the point after a location. Get the point after a location.
Options: `{distance?: number, unit?: 'offset' | 'character' | 'word' | 'line' | 'block', voids?: boolean}` Options: `{distance?: number, unit?: 'offset' | 'character' | 'word' | 'line' | 'block', voids?: boolean}`
#### `Editor.before(editor: Editor, at: Location, options?): Point | undefined` #### `Editor.before(editor: Editor, at: Location, options?) => Point | undefined`
Get the point before a location. Get the point before a location.
Options: `{distance?: number, unit?: 'offset' | 'character' | 'word' | 'line' | 'block', voids?: boolean}` Options: `{distance?: number, unit?: 'offset' | 'character' | 'word' | 'line' | 'block', voids?: boolean}`
#### `Editor.edges(editor: Editor, at: Location): [Point, Point]` #### `Editor.edges(editor: Editor, at: Location) => [Point, Point]`
Get the start and end points of a location. Get the start and end points of a location.
#### `Editor.end(editor: Editor, at: Location): Point` #### `Editor.end(editor: Editor, at: Location) => Point`
Get the end point of a location. Get the end point of a location.
#### `Editor.first(editor: Editor, at: Location): NodeEntry` #### `Editor.first(editor: Editor, at: Location) => NodeEntry`
Get the first node at a location. Get the first node at a location.
#### `Editor.fragment(editor: Editor, at: Location): Descendant[]` #### `Editor.fragment(editor: Editor, at: Location) => Descendant[]`
Get the fragment at a location. Get the fragment at a location.
#### `Editor.last(editor: Editor, at: Location): NodeEntry` #### `Editor.last(editor: Editor, at: Location) => NodeEntry`
Get the last node at a location. Get the last node at a location.
#### `Editor.leaf(editor: Editor, at: Location, options?): NodeEntry` #### `Editor.leaf(editor: Editor, at: Location, options?) => NodeEntry`
Get the leaf text node at a location. Get the leaf text node at a location.
Options: `{depth?: number, edge?: 'start' | 'end'}` Options: `{depth?: number, edge?: 'start' | 'end'}`
#### `Editor.levels<T extends Node>(editor: Editor, options?): Generator<NodeEntry<T>, void, undefined>` #### `Editor.levels<T extends Node>(editor: Editor, options?) => Generator<NodeEntry<T>, void, undefined>`
Iterate through all of the levels at a location. Iterate through all of the levels at a location.
Options: `{at?: Location, match?: NodeMatch, reverse?: boolean, voids?: boolean}` Options: `{at?: Location, match?: NodeMatch, reverse?: boolean, voids?: boolean}`
#### `Editor.marks(editor: Editor): Omit<Text, 'text'> | null` #### `Editor.marks(editor: Editor) => Omit<Text, 'text'> | null`
Get the marks that would be added to text at the current selection. Get the marks that would be added to text at the current selection.
#### `Editor.next<T extends Descendant>(editor: Editor, options?): NodeEntry<T> | undefined` #### `Editor.next<T extends Descendant>(editor: Editor, options?) => NodeEntry<T> | undefined`
Get the matching node in the branch of the document after a location. Get the matching node in the branch of the document after a location.
Options: `{at?: Location, match?: NodeMatch, mode?: 'all' | 'highest' | 'lowest', voids?: boolean}` Options: `{at?: Location, match?: NodeMatch, mode?: 'all' | 'highest' | 'lowest', voids?: boolean}`
#### `Editor.node(editor: Editor, at: Location, options?): NodeEntry` #### `Editor.node(editor: Editor, at: Location, options?) => NodeEntry`
#### `Editor.nodes<T extends Node>(editor: Editor, options?): Generator<NodeEntry<T>, void, undefined>` #### `Editor.nodes<T extends Node>(editor: Editor, options?) => Generator<NodeEntry<T>, void, undefined>`
Get the node at a location. Get the node at a location.
Options: `depth?: number, edge?: 'start' | 'end'` Options: `depth?: number, edge?: 'start' | 'end'`
#### `Editor.nodes(editor: Editor, options?): Generator<NodeEntry<T>, void, undefined>` #### `Editor.nodes(editor: Editor, options?) => Generator<NodeEntry<T>, void, undefined>`
Iterate through all of the nodes in the Editor. Iterate through all of the nodes in the Editor.
@@ -129,45 +129,45 @@ Options: `{at?: Location | Span, match?: NodeMatch, mode?: 'all' | 'highest' | '
- `'highest'`: in a hierarchy of nodes, only return the highest level matching nodes - `'highest'`: in a hierarchy of nodes, only return the highest level matching nodes
- `'lowest'`: in a hierarchy of nodes, only return the lowest level matching nodes - `'lowest'`: in a hierarchy of nodes, only return the lowest level matching nodes
#### `Editor.parent(editor: Editor, at: Location, options?): NodeEntry<Ancestor>` #### `Editor.parent(editor: Editor, at: Location, options?) => NodeEntry<Ancestor>`
Get the parent node of a location. Get the parent node of a location.
Options: `{depth?: number, edge?: 'start' | 'end'}` Options: `{depth?: number, edge?: 'start' | 'end'}`
#### `Editor.path(editor: Editor, at: Location, options?): Path` #### `Editor.path(editor: Editor, at: Location, options?) => Path`
Get the path of a location. Get the path of a location.
Options: `{depth?: number, edge?: 'start' | 'end'}` Options: `{depth?: number, edge?: 'start' | 'end'}`
#### `Editor.pathRef(editor: Editor, path: Path, options?): PathRef` #### `Editor.pathRef(editor: Editor, path: Path, options?) => PathRef`
Create a mutable ref for a `Path` object, which will stay in sync as new operations are applied to the editor. Create a mutable ref for a `Path` object, which will stay in sync as new operations are applied to the editor.
Options: `{affinity?: 'backward' | 'forward' | null}` Options: `{affinity?: 'backward' | 'forward' | null}`
#### `Editor.pathRefs(editor: Editor): Set<PathRef>` #### `Editor.pathRefs(editor: Editor) => Set<PathRef>`
Get the set of currently tracked path refs of the editor. Get the set of currently tracked path refs of the editor.
#### `Editor.point(editor: Editor, at: Location, options?): Point` #### `Editor.point(editor: Editor, at: Location, options?) => Point`
Get the start or end point of a location. Get the start or end point of a location.
Options: `{edge?: 'start' | 'end'}` Options: `{edge?: 'start' | 'end'}`
#### `Editor.pointRef(editor: Editor, point: Point, options?): PointRef` #### `Editor.pointRef(editor: Editor, point: Point, options?) => PointRef`
Create a mutable ref for a `Point` object, which will stay in sync as new operations are applied to the editor. Create a mutable ref for a `Point` object, which will stay in sync as new operations are applied to the editor.
Options: `{affinity?: 'backward' | 'forward' | null}` Options: `{affinity?: 'backward' | 'forward' | null}`
#### `Editor.pointRefs(editor: Editor): Set<PointRef>` #### `Editor.pointRefs(editor: Editor) => Set<PointRef>`
Get the set of currently tracked point refs of the editor. Get the set of currently tracked point refs of the editor.
#### `Editor.positions(editor: Editor, options?): Generator<Point, void, undefined>` #### `Editor.positions(editor: Editor, options?) => Generator<Point, void, undefined>`
Iterate through all of the positions in the document where a `Point` can be placed. Iterate through all of the positions in the document where a `Point` can be placed.
@@ -177,31 +177,31 @@ Note: By default void nodes are treated as a single point and iteration will not
Options: `{at?: Location, unit?: 'offset' | 'character' | 'word' | 'line' | 'block', reverse?: boolean, voids?: boolean}` Options: `{at?: Location, unit?: 'offset' | 'character' | 'word' | 'line' | 'block', reverse?: boolean, voids?: boolean}`
#### `Editor.previous<T extends Node>(editor: Editor, options?): NodeEntry<T> | undefined` #### `Editor.previous<T extends Node>(editor: Editor, options?) => NodeEntry<T> | undefined`
Get the matching node in the branch of the document before a location. Get the matching node in the branch of the document before a location.
Options: `{at?: Location, match?: NodeMatch, mode?: 'all' | 'highest' | 'lowest', voids?: boolean}` Options: `{at?: Location, match?: NodeMatch, mode?: 'all' | 'highest' | 'lowest', voids?: boolean}`
#### `Editor.range(editor: Editor, at: Location, to?: Location): Range` #### `Editor.range(editor: Editor, at: Location, to?: Location) => Range`
Get a range of a location. Get a range of a location.
#### `Editor.rangeRef(editor: Editor, range: Range, options?): RangeRef` #### `Editor.rangeRef(editor: Editor, range: Range, options?) => RangeRef`
Create a mutable ref for a `Range` object, which will stay in sync as new operations are applied to the editor. Create a mutable ref for a `Range` object, which will stay in sync as new operations are applied to the editor.
Options: `{affinity?: 'backward' | 'forward' | 'outward' | 'inward' | null}` Options: `{affinity?: 'backward' | 'forward' | 'outward' | 'inward' | null}`
#### `Editor.rangeRefs(editor: Editor): Set<RangeRef>` #### `Editor.rangeRefs(editor: Editor) => Set<RangeRef>`
Get the set of currently tracked range refs of the editor. Get the set of currently tracked range refs of the editor.
#### `Editor.start(editor: Editor, at: Location): Point` #### `Editor.start(editor: Editor, at: Location) => Point`
Get the start point of a location. Get the start point of a location.
#### `Editor.string(editor: Editor, at: Location, options?): string` #### `Editor.string(editor: Editor, at: Location, options?) => string`
Get the text string content of a location. Get the text string content of a location.
@@ -209,7 +209,7 @@ Note: by default the text of void nodes is considered to be an empty string, reg
Options: : `{voids?: boolean}` Options: : `{voids?: boolean}`
#### `Editor.void(editor: Editor, options?): NodeEntry<Element> | undefined` #### `Editor.void(editor: Editor, options?) => NodeEntry<Element> | undefined`
Match a void node in the current branch of the editor. Match a void node in the current branch of the editor.
@@ -217,57 +217,57 @@ Options: `{at?: Location, mode?: 'highest' | 'lowest', voids?: boolean}`
### Manipulation methods ### Manipulation methods
#### `Editor.addMark(editor: Editor, key: string, value: any): void` #### `Editor.addMark(editor: Editor, key: string, value: any) => void`
Add a custom property to the leaf text nodes in the current selection. Add a custom property to the leaf text nodes in the current selection.
If the selection is currently collapsed, the marks will be added to the `editor.marks` property instead, and applied when text is inserted next. If the selection is currently collapsed, the marks will be added to the `editor.marks` property instead, and applied when text is inserted next.
#### `Editor.deleteBackward(editor: Editor, options?): void` #### `Editor.deleteBackward(editor: Editor, options?) => void`
Delete content in the editor backward from the current selection. Delete content in the editor backward from the current selection.
Options: `{unit?: 'character' | 'word' | 'line' | 'block'}` Options: `{unit?: 'character' | 'word' | 'line' | 'block'}`
#### `Editor.deleteForward(editor: Editor, options?): void` #### `Editor.deleteForward(editor: Editor, options?) => void`
Delete content in the editor forward from the current selection. Delete content in the editor forward from the current selection.
Options: `{unit?: 'character' | 'word' | 'line' | 'block'}` Options: `{unit?: 'character' | 'word' | 'line' | 'block'}`
#### `Editor.deleteFragment(editor: Editor): void` #### `Editor.deleteFragment(editor: Editor) => void`
Delete the content in the current selection. Delete the content in the current selection.
#### `Editor.insertBreak(editor: Editor): void` #### `Editor.insertBreak(editor: Editor) => void`
Insert a block break at the current selection. Insert a block break at the current selection.
#### `Editor.insertFragment(editor: Editor, fragment: Node[]): void` #### `Editor.insertFragment(editor: Editor, fragment: Node[]) => void`
Insert a fragment at the current selection. Insert a fragment at the current selection.
If the selection is currently expanded, it will be deleted first. If the selection is currently expanded, it will be deleted first.
#### `Editor.insertNode(editor: Editor, node: Node): void` #### `Editor.insertNode(editor: Editor, node: Node) => void`
Insert a node at the current selection. Insert a node at the current selection.
If the selection is currently expanded, it will be deleted first. If the selection is currently expanded, it will be deleted first.
#### `Editor.insertText(editor: Editor, text: string): void` #### `Editor.insertText(editor: Editor, text: string) => void`
Insert text at the current selection. Insert text at the current selection.
If the selection is currently expanded, it will be deleted first. If the selection is currently expanded, it will be deleted first.
#### `Editor.removeMark(editor: Editor, key: string): void` #### `Editor.removeMark(editor: Editor, key: string) => void`
Remove a custom property from all of the leaf text nodes in the current selection. Remove a custom property from all of the leaf text nodes in the current selection.
If the selection is currently collapsed, the removal will be stored on `editor.marks` and applied to the text inserted next. If the selection is currently collapsed, the removal will be stored on `editor.marks` and applied to the text inserted next.
#### `Editor.unhangRange(editor: Editor, range: Range, options?): Range` #### `Editor.unhangRange(editor: Editor, range: Range, options?) => Range`
Convert a range into a non-hanging one. Convert a range into a non-hanging one.
@@ -275,63 +275,63 @@ Options: `{voids?: boolean}`
### Check methods ### Check methods
#### `Editor.hasBlocks(editor: Editor, element: Element): boolean` #### `Editor.hasBlocks(editor: Editor, element: Element) => boolean`
Check if a node has block children. Check if a node has block children.
#### `Editor.hasInlines(editor: Editor, element: Element): boolean` #### `Editor.hasInlines(editor: Editor, element: Element) => boolean`
Check if a node has inline and text children. Check if a node has inline and text children.
#### `Editor.hasTexts(editor: Editor, element: Element): boolean` #### `Editor.hasTexts(editor: Editor, element: Element) => boolean`
Check if a node has text children. Check if a node has text children.
#### `Editor.isBlock(editor: Editor, value: any): value is Element` #### `Editor.isBlock(editor: Editor, value: any) => value is Element`
Check if a value is a block `Element` object. Check if a value is a block `Element` object.
#### `Editor.isEditor(value: any): value is Editor` #### `Editor.isEditor(value: any) => value is Editor`
Check if a value is an `Editor` object. Check if a value is an `Editor` object.
#### `Editor.isEnd(editor: Editor, point: Point, at: Location): boolean` #### `Editor.isEnd(editor: Editor, point: Point, at: Location) => boolean`
Check if a point is the end point of a location. Check if a point is the end point of a location.
#### `Editor.isEdge(editor: Editor, point: Point, at: Location): boolean` #### `Editor.isEdge(editor: Editor, point: Point, at: Location) => boolean`
Check if a point is an edge of a location. Check if a point is an edge of a location.
#### `Editor.isEmpty(editor: Editor, element: Element): boolean` #### `Editor.isEmpty(editor: Editor, element: Element) => boolean`
Check if an element is empty, accounting for void nodes. Check if an element is empty, accounting for void nodes.
#### `Editor.isInline(editor: Editor, value: any): value is Element` #### `Editor.isInline(editor: Editor, value: any) => value is Element`
Check if a value is an inline `Element` object. Check if a value is an inline `Element` object.
#### `Editor.isNormalizing(editor: Editor): boolean` #### `Editor.isNormalizing(editor: Editor) => boolean`
Check if the editor is currently normalizing after each operation. Check if the editor is currently normalizing after each operation.
#### `Editor.isStart(editor: Editor, point: Point, at: Location): boolean` #### `Editor.isStart(editor: Editor, point: Point, at: Location) => boolean`
Check if a point is the start point of a location. Check if a point is the start point of a location.
#### `Editor.isVoid(editor: Editor, value: any): value is Element` #### `Editor.isVoid(editor: Editor, value: any) => value is Element`
Check if a value is a void `Element` object. Check if a value is a void `Element` object.
### Normalization methods ### Normalization methods
#### `Editor.normalize(editor: Editor, options?): void` #### `Editor.normalize(editor: Editor, options?) => void`
Normalize any dirty objects in the editor. Normalize any dirty objects in the editor.
Options: `{force?: boolean}` Options: `{force?: boolean}`
#### `Editor.withoutNormalizing(editor: Editor, fn: () => void): void` #### `Editor.withoutNormalizing(editor: Editor, fn: () => void) => void`
Call a function, deferring normalization until after it completes. Call a function, deferring normalization until after it completes.