Skip to main content
Version: v2

ReferenceType Enum

Flags enum that dictates behavior of a ReferencePosition

This API is provided for existing users, but is not recommended for new users.

To use, import via @fluidframework/merge-tree/legacy.

For more information about our API support guarantees, see here.

Signature​

export declare enum ReferenceType

Flags​

FlagAlertsDescription
RangeBeginBetaDenotes that this reference begins the start of an interval. This is generally not meaningful outside the context of interval collections on SharedString.
RangeEndBetaDenotes that this reference is the end of an interval. This is generally not meaningful outside the context of interval collections on SharedString.
SimpleBeta
SlideOnRemoveBetaWhen a segment is marked removed (locally or with ack), this reference will slide to the first valid option of: 1. the start of the next furthest segment 2. the end of the next nearest segment 3. DetachedReferencePosition
StayOnRemoveBetaWhen a segment is marked removed (locally or with ack), this reference will remain on that segment.
TileBetaAllows this reference to be located using the searchForMarker API on merge-tree.
TransientBetaSpecifies that the reference position should never be added to the segment it refers to. This is useful for comparison/iteration purposes

RangeBegin​

Denotes that this reference begins the start of an interval. This is generally not meaningful outside the context of interval collections on SharedString.

This API is provided for existing users, but is not recommended for new users.

For more information about our API support guarantees, see here.

Signature​

RangeBegin = 16

RangeEnd​

Denotes that this reference is the end of an interval. This is generally not meaningful outside the context of interval collections on SharedString.

This API is provided for existing users, but is not recommended for new users.

For more information about our API support guarantees, see here.

Signature​

RangeEnd = 32

Simple​

This API is provided for existing users, but is not recommended for new users.

For more information about our API support guarantees, see here.

Signature​

Simple = 0

SlideOnRemove​

When a segment is marked removed (locally or with ack), this reference will slide to the first valid option of: 1. the start of the next furthest segment 2. the end of the next nearest segment 3. DetachedReferencePosition

This API is provided for existing users, but is not recommended for new users.

For more information about our API support guarantees, see here.

Signature​

SlideOnRemove = 64

StayOnRemove​

When a segment is marked removed (locally or with ack), this reference will remain on that segment.

This API is provided for existing users, but is not recommended for new users.

For more information about our API support guarantees, see here.

Signature​

StayOnRemove = 128

Tile​

Allows this reference to be located using the searchForMarker API on merge-tree.

This API is provided for existing users, but is not recommended for new users.

For more information about our API support guarantees, see here.

Signature​

Tile = 1

Transient​

Specifies that the reference position should never be added to the segment it refers to. This is useful for comparison/iteration purposes

This API is provided for existing users, but is not recommended for new users.

For more information about our API support guarantees, see here.

Signature​

Transient = 256