TLEditorOptions

See source code
Table of contents
interface TLEditorOptions {}

Properties

autoFocus

optional

Whether to automatically focus the editor when it mounts.

autoFocus?: boolean;

bindingUtils

An array of bindings to use in the editor. These will be used to create and manage bindings in the editor.

bindingUtils: readonly TLAnyBindingUtilConstructor[];

cameraOptions

optional

Deprecated: Use options.cameraOptions instead. This will be removed in a future release.

Options for the editor's camera.

cameraOptions?: Partial<TLCameraOptions>;

fontAssetUrls

optional
fontAssetUrls?: {
  [key: string]: string | undefined;
};

inferDarkMode

optional

Whether to infer dark mode from the user's system preferences. Defaults to false.

inferDarkMode?: boolean;

initialState

optional

The editor's initial active tool (or other state node id).

initialState?: string;

licenseKey

optional
licenseKey?: string;

options

optional
options?: Partial<TldrawOptions>;

shapeUtils

An array of shapes to use in the editor. These will be used to create and manage shapes in the editor.

shapeUtils: readonly TLAnyShapeUtilConstructor[];

store

The Store instance to use for keeping the editor's data. This may be prepopulated, e.g. by loading from a server or database.

store: TLStore;

textOptions

optional

Deprecated: Use options.text instead. This prop will be removed in a future release.

Text options for the editor.

textOptions?: TLTextOptions;

tools

An array of tools to use in the editor. These will be used to handle events and manage user interactions in the editor.

tools: readonly TLStateNodeConstructor[];

user

optional

A user defined externally to replace the default user.

user?: TLCurrentUser;

Methods

getContainer

Should return a containing html element which has all the styles applied to the editor. If not given, the body element will be used.


getShapeVisibility

optional

Provides a way to hide shapes.

Example

getShapeVisibility={(shape, editor) => shape.meta.hidden ? 'hidden' : 'inherit'}
  • 'inherit' | undefined - (default) The shape will be visible unless its parent is hidden. - 'hidden' - The shape will be hidden. - 'visible' - The shape will be visible.

Parameters

NameDescription

shape

TLShape;

The shape to check.

editor

Editor;

The editor instance.

Returns

"hidden" | "inherit" | "visible" | null | undefined;

Prev
TLEditorComponents
Next
TLEditorRunOptions