4f:I[314491,["/_next/static/immutable/chunks/3arlv5bvukoo2.js","/_next/static/immutable/chunks/39v64hmfyo-sr.js","/_next/static/immutable/chunks/2nvof3-29tvc3.js","/_next/static/immutable/chunks/3tjobt77z_9dj.js","/_next/static/immutable/chunks/04j_o97cgxn2x.js","/_next/static/immutable/chunks/3upr08c9vtj8w.js","/_next/static/immutable/chunks/1ww0328si-u8x.js","/_next/static/immutable/chunks/11mfl5ymqld9-.js","/_next/static/immutable/chunks/2xxcqy6ppds3l.js","/_next/static/immutable/chunks/3j06ow7w40nxu.js","/_next/static/immutable/chunks/31nn7jwsjvqii.js","/_next/static/immutable/chunks/43_s7jweyypoh.js","/_next/static/immutable/chunks/0p6vao205o1jc.js","/_next/static/immutable/chunks/1_kyvgkyokw92.js","/_next/static/immutable/chunks/1lo-zn37dolb5.js","/_next/static/immutable/chunks/1v8k6yxw1rg0u.js"],"FilesView"] 50:T29b0,--- title: Path description: API reference for paths in Plate. --- A Path is a list of indexes that describe a node's exact position in a Plate node tree. Although they are usually relative to the root `Editor` object, they can be relative to any `Node` object. ```ts type Path = number[]; ``` ## `PathApi` ### `operationCanTransformPath` Check if an operation can affect paths (used as an optimization for dirty-path updates during normalization). The operation to check. `true` if the operation is an insert, merge, move, remove, or split operation. ### `transform` Transform a path by an operation. The path to transform. The operation to apply. Options for transforming a path. The affinity of the transform. The transformed path, or `null` if the path was deleted. ### `ancestors` Get a list of ancestor paths for a given path. The path to get ancestors for. Options for ancestor retrieval. If true, returns paths in reverse (deepest to shallowest). An array of paths sorted from shallowest to deepest ancestor (unless reversed). ### `child` Get a path to a child at the given index. The parent path. The child index. The path to the child node. ### `common` Get the common ancestor path of two paths. The first path. The second path. The common ancestor path. ### `compare` Compare a path to another, returning an integer indicating whether the path was before, at, or after the other. The first path to compare. The second path to compare. `-1` if before, `0` if at the same location, `1` if after. ### `endsAfter` Check if a path ends after one of the indexes in another. The path to check. The path to compare against. `true` if `path` ends after `another`. ### `endsAt` Check if a path ends at one of the indexes in another. The path to check. The path to compare against. `true` if `path` ends at the same index as `another`. ### `endsBefore` Check if a path ends before one of the indexes in another. The path to check. The path to compare against. `true` if `path` ends before `another`. ### `equals` Check if a path is exactly equal to another. The first path. The second path. `true` if the paths are exactly equal. ### `firstChild` Get a path to the first child of a path. The parent path. The path to the first child node. ### `hasPrevious` Check if the path of a previous sibling node exists. The path to check. `true` if a previous sibling exists. ### `isAfter` Check if a path is after another. The path to check. The path to compare against. `true` if the first path is after the second. ### `isAncestor` Check if a path is an ancestor of another. The potential ancestor path. The potential descendant path. `true` if `path` is an ancestor of `another`. ### `isBefore` Check if a path is before another. The path to check. The path to compare against. `true` if the first path is before the second. ### `isChild` Check if a path is a child of another. The potential child path. The potential parent path. `true` if `path` is a child of `another`. ### `isCommon` Check if a path is equal to or an ancestor of another. The path to check. The path to compare against. `true` if `path` is equal to or an ancestor of `another`. ### `isDescendant` Check if a path is a descendant of another. The potential descendant path. The potential ancestor path. `true` if `path` is a descendant of `another`. ### `isParent` Check if a path is the parent of another. The potential parent path. The potential child path. `true` if `path` is the parent of `another`. ### `isPath` Check if a value implements the `Path` interface. The value to check. `true` if the value is a path. ### `isSibling` Check if a path is a sibling of another. The path to check. The path to compare against. `true` if the paths share the same parent. ### `lastIndex` Get the last index of a path. The path to check. The last index, or -1 if the path is empty. ### `levels` Get a list of paths at every level down to a path. The path to get levels for. Options for levels retrieval. If true, returns paths in reverse (deepest to shallowest). An array of paths including the path itself and all its ancestors. ### `next` Get the path to the next sibling node. The current path. The path to the next sibling. ### `parent` Get the path to the parent node. The current path. The path to the parent node. ### `previous` Get the path to the previous sibling node. The current path. The path to the previous sibling, or `undefined` if there is none. ### `relative` Get a path relative to an ancestor. The path to make relative. The ancestor path. The relative path. ## Types ### `Path` An array of numbers representing the indexes to traverse to reach a specific node in the document tree.4e:["$","div",null,{"className":"mt-3 flex min-h-0 min-w-0 flex-1 flex-col gap-3","children":[null,["$","$L4f",null,{"files":[{"path":"../../content/docs/api/slate/path.mdx","content":"$50","type":"registry:file","target":"content/docs/plate/api/slate/path.mdx"}],"className":"h-[70svh] min-h-80"}]]}]