TldrawBaseProps

See source code
Table of contents

Extends TldrawUiProps, TldrawEditorBaseProps, TLExternalContentProps.

interface TldrawBaseProps
  extends TldrawUiProps,
    TldrawEditorBaseProps,
    TLExternalContentProps {}

Properties

acceptedImageMimeTypes

optional

The mime types of images that are allowed to be handled. Defaults to DEFAULT_SUPPORTED_IMAGE_TYPES.

acceptedImageMimeTypes?: readonly string[]

acceptedVideoMimeTypes

optional

The mime types of videos that are allowed to be handled. Defaults to DEFAULT_SUPPORT_VIDEO_TYPES.

acceptedVideoMimeTypes?: readonly string[]

assetUrls

optional

Asset URL override.


autoFocus

optional

Whether to automatically focus the editor when it mounts.

autoFocus?: boolean

bindingUtils

optional

An array of binding utils to use in the editor.

bindingUtils?: readonly TLAnyBindingUtilConstructor[]

cameraOptions

optional

Camera options for the editor.

cameraOptions?: Partial<TLCameraOptions>

children

optional

The component's children.

children?: ReactNode

className

optional

A classname to pass to the editor's container.

className?: string

components

optional
components?: TLComponents

optional

Options for syncing the editor's camera state with the URL.

deepLinks?: TLDeepLinkOptions | true

embeds

optional

forceMobile

optional

Whether to always should the mobile breakpoints.

forceMobile?: boolean

hideUi

optional

Whether to hide the user interface and only display the canvas.

hideUi?: boolean

inferDarkMode

optional

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

inferDarkMode?: boolean

initialState

optional

The editor's initial state (usually the id of the first active tool).

initialState?: string

licenseKey

optional

The license key.

licenseKey?: string

maxAssetSize

optional

The maximum size (in bytes) of an asset. Assets larger than this will be rejected. Defaults to 10mb (10 * 1024 * 1024).

maxAssetSize?: number

maxImageDimension

optional

The maximum dimension (width or height) of an image. Images larger than this will be rescaled to fit. Defaults to infinity.

maxImageDimension?: number

mediaMimeTypes

optional

Supported mime types for media files.

mediaMimeTypes?: string[]

onMount

optional

Called when the editor has mounted.


onUiEvent

optional

Callback for when an event occurs in the UI.

onUiEvent?: TLUiEventHandler

options

optional

Options for the editor.

options?: Partial<TldrawOptions>

overrides

optional

Overrides for the UI.


shapeUtils

optional

An array of shape utils to use in the editor.

shapeUtils?: readonly TLAnyShapeUtilConstructor[]

textOptions

optional

Text options for the editor.

textOptions?: Partial<TLTextOptions>

tools

optional

An array of tools to add to the editor's state chart.

tools?: readonly TLStateNodeConstructor[]

user

optional

The user interacting with the editor.

user?: TLUser

Methods

isShapeHidden

optional

Predicate for whether or not a shape should be hidden.

Hidden shapes will not render in the editor, and they will not be eligible for hit test via and . But otherwise they will remain in the store and participate in all other operations.

Parameters

NameDescription

shape

editor

Returns

boolean

renderDebugMenuItems

optional

Additional items to add to the debug menu (will be deprecated)


Prev
TLComponents
Next
TldrawFile