1
0
mirror of https://github.com/ianstormtaylor/slate.git synced 2025-08-21 06:31:28 +02:00
Files
slate/docs/api/locations/point-ref.md
Deepak Kharah 5adb8ededf doc: add missing APIs in the doc (#5835)
* doc: add missing APIs in the doc

* refactor: apply lint
2025-04-03 22:10:34 -07:00

1.1 KiB

PointRef API

PointRef objects keep a specific point in a document synced over time as new operations are applied to the editor. It is created using the Editor.pointRef method. You can access their property current at any time for the up-to-date Point value. When you no longer need to track this location, call unref() to free the resources. The affinity refers to the direction the PointRef will go when a user inserts content at the current position of the Point.

interface PointRef {
  current: Point | null
  affinity: 'forward' | 'backward' | null
  unref(): Point | null
}

Instance methods

unref() => Point | null

Call this when you no longer need to sync this point. It also returns the current value.

Static methods

Transform methods

PointRef.transform(ref: PointRef, op: Operation)

Transform the point refs current value by an op. The editor calls this as needed, so normally you won't need to.