Class YMarkdownCell

Shareable markdown cell.

Hierarchy

YAttachmentCell
- YMarkdownCell

Implements

ISharedMarkdownCell

Index

Constructors

constructor

new YMarkdownCell(ymodel: YMap<any>, ysource: YText, options?: SharedCell.IOptions, ymetadata?: YMap<any>): YMarkdownCell
Base cell constructor

Notes

Don't use the constructor directly - prefer using YNotebook.insertCell

The ysource is needed because ymodel.get('source') will not return the real source if the model is not yet attached to a document. Requesting it explicitly allows to introspect a non-empty source before the cell is attached to the document.
Parameters
- ymodel: YMap<any>
  
  Cell map
- ysource: YText
  
  Cell source
- options: SharedCell.IOptions = {}
  
  { notebook?: The notebook the cell is attached to }
- Optional ymetadata: YMap<any>
  
  Cell metadata
Returns YMarkdownCell
Inherited from YAttachmentCell.constructor
- Defined in src/ycell.ts:159

Properties

`Protected` _metadataChanged

_metadataChanged: Signal<YMarkdownCell, IMapChange<any>> = ...

`Protected` _notebook

_notebook: null | YNotebook = null

The notebook that this cell belongs to.

`Readonly` ymodel

ymodel: YMap<any>

Accessors

attachments

get attachments(): undefined | IAttachments
Cell attachments

Returns undefined | IAttachments
Implementation of ISharedMarkdownCell.attachments

Inherited from YAttachmentCell.attachments
- Defined in src/ycell.ts:955
set attachments(v: undefined | IAttachments): void
Cell attachments
Parameters
- v: undefined | IAttachments
Returns void
Implementation of ISharedMarkdownCell.attachments

Inherited from YAttachmentCell.attachments
- Defined in src/ycell.ts:958

awareness

get awareness(): null | Awareness
Cell notebook awareness or null if the cell is standalone.

Returns null | Awareness
Inherited from YAttachmentCell.awareness
- Defined in src/ycell.ts:192

cell_type

get cell_type(): "markdown"
String identifying the type of cell.

Returns "markdown"
Implementation of ISharedMarkdownCell.cell_type

Overrides YAttachmentCell.cell_type
- Defined in src/ycell.ts:1064

changed

get changed(): ISignal<this, CellChange>
The changed signal.

Returns ISignal<this, CellChange>
Implementation of ISharedMarkdownCell.changed

Inherited from YAttachmentCell.changed
- Defined in src/ycell.ts:206

disposed

get disposed(): ISignal<this, void>
Signal emitted when the cell is disposed.

Returns ISignal<this, void>
Implementation of ISharedMarkdownCell.disposed

Inherited from YAttachmentCell.disposed
- Defined in src/ycell.ts:213

id

get id(): string
Cell id

Returns string
Implementation of ISharedMarkdownCell.id

Inherited from YAttachmentCell.id
- Defined in src/ycell.ts:220

isDisposed

get isDisposed(): boolean
Whether the model has been disposed or not.

Returns boolean
Implementation of ISharedMarkdownCell.isDisposed

Inherited from YAttachmentCell.isDisposed
- Defined in src/ycell.ts:227

isStandalone

get isStandalone(): boolean
Whether the cell is standalone or not.

If the cell is standalone. It cannot be inserted into a YNotebook because the Yjs model is already attached to an anonymous Y.Doc instance.

Returns boolean
Implementation of ISharedMarkdownCell.isStandalone

Inherited from YAttachmentCell.isStandalone
- Defined in src/ycell.ts:238

metadata

get metadata(): Partial<Metadata>
Cell metadata.

Notes

You should prefer to access and modify the specific key of interest.

Returns Partial<Metadata>
Implementation of ISharedMarkdownCell.metadata

Inherited from YAttachmentCell.metadata
- Defined in src/ycell.ts:248
set metadata(v: Partial<Metadata>): void
Cell metadata.

Notes

You should prefer to access and modify the specific key of interest.
Parameters
- v: Partial<Metadata>
Returns void
Implementation of ISharedMarkdownCell.metadata

Inherited from YAttachmentCell.metadata
- Defined in src/ycell.ts:251

metadataChanged

get metadataChanged(): ISignal<this, IMapChange<any>>
Signal triggered when the cell metadata changes.

Returns ISignal<this, IMapChange<any>>
Implementation of ISharedMarkdownCell.metadataChanged

Inherited from YAttachmentCell.metadataChanged
- Defined in src/ycell.ts:258

notebook

get notebook(): null | YNotebook
The notebook that this cell belongs to.

Returns null | YNotebook
Implementation of ISharedMarkdownCell.notebook

Inherited from YAttachmentCell.notebook
- Defined in src/ycell.ts:265

source

get source(): string
Cell input content.

Returns string
Implementation of ISharedMarkdownCell.source

Inherited from YAttachmentCell.source
- Defined in src/ycell.ts:272
set source(v: string): void
Text
Parameters
- v: string
Returns void
Implementation of ISharedMarkdownCell.source

Inherited from YAttachmentCell.source
- Defined in src/ycell.ts:275

undoManager

get undoManager(): null | UndoManager
The cell undo manager.

Returns null | UndoManager
Inherited from YAttachmentCell.undoManager
- Defined in src/ycell.ts:282

ysource

get ysource(): YText
Returns YText
Inherited from YAttachmentCell.ysource
- Defined in src/ycell.ts:309

Methods

canRedo

canRedo(): boolean
Whether the object can redo changes.

Returns boolean
Implementation of ISharedMarkdownCell.canRedo

Inherited from YAttachmentCell.canRedo
- Defined in src/ycell.ts:323

canUndo

canUndo(): boolean
Whether the object can undo changes.

Returns boolean
Implementation of ISharedMarkdownCell.canUndo

Inherited from YAttachmentCell.canUndo
- Defined in src/ycell.ts:316

clearUndoHistory

clearUndoHistory(): void
Clear the change stack.

Returns void
Implementation of ISharedMarkdownCell.clearUndoHistory

Inherited from YAttachmentCell.clearUndoHistory
- Defined in src/ycell.ts:330

deleteMetadata

deleteMetadata(key: string): void
Delete a metadata cell.
Parameters
- key: string
  
  The key to delete
Returns void
Implementation of ISharedMarkdownCell.deleteMetadata

Inherited from YAttachmentCell.deleteMetadata
- Defined in src/ycell.ts:430

dispose

dispose(): void
Dispose of the resources.

Returns void
Implementation of ISharedMarkdownCell.dispose

Inherited from YAttachmentCell.dispose
- Defined in src/ycell.ts:351

getAttachments

getAttachments(): undefined | IAttachments
Gets the cell attachments.

Returns
The cell attachments.

Returns undefined | IAttachments
Implementation of ISharedMarkdownCell.getAttachments

Inherited from YAttachmentCell.getAttachments
- Defined in src/ycell.ts:967

`Protected` getChanges

getChanges(events: YEvent<any>[]): Partial<CellChange>
Extract changes from YJS events

Returns
Cell changes
Parameters
- events: YEvent<any>[]
  
  YJS events
Returns Partial<CellChange>
Inherited from YAttachmentCell.getChanges
- Defined in src/ycell.ts:992

getId

getId(): string
Get cell id.

Returns
Cell id

Returns string
Implementation of ISharedMarkdownCell.getId

Inherited from YAttachmentCell.getId
- Defined in src/ycell.ts:379

getMetadata

getMetadata(): Partial<IBaseCellMetadata>
Returns all or a single metadata associated with the cell.

Returns
cell's metadata.

Returns Partial<IBaseCellMetadata>
Implementation of ISharedMarkdownCell.getMetadata

Inherited from YAttachmentCell.getMetadata
- Defined in src/ycell.ts:460
getMetadata(key: string): undefined | PartialJSONValue
Returns a metadata associated with the cell.

Returns
Cell's metadata.
Parameters
- key: string
  
  Metadata key to get
Returns undefined | PartialJSONValue
Implementation of ISharedMarkdownCell.getMetadata

Inherited from YAttachmentCell.getMetadata
- Defined in src/ycell.ts:461

getSource

getSource(): string
Gets cell's source.

Returns
Cell's source.

Returns string
Implementation of ISharedMarkdownCell.getSource

Inherited from YAttachmentCell.getSource
- Defined in src/ycell.ts:388

redo

redo(): void
Redo an operation.

Returns void
Implementation of ISharedMarkdownCell.redo

Inherited from YAttachmentCell.redo
- Defined in src/ycell.ts:344

setAttachments

setAttachments(attachments: undefined | IAttachments): void
Sets the cell attachments
Parameters
- attachments: undefined | IAttachments
Returns void
Implementation of ISharedMarkdownCell.setAttachments

Inherited from YAttachmentCell.setAttachments
- Defined in src/ycell.ts:976

setMetadata

setMetadata(metadata: Partial<IBaseCellMetadata>): void
Sets all or a single cell metadata.

If only one argument is provided, it will override all cell metadata. Otherwise a single key will be set to a new value.
Parameters
- metadata: Partial<IBaseCellMetadata>
  
  Cell's metadata key or cell's metadata.
Returns void
Implementation of ISharedMarkdownCell.setMetadata

Inherited from YAttachmentCell.setMetadata
- Defined in src/ycell.ts:489
setMetadata(metadata: string, value: PartialJSONValue): void
Sets a cell metadata.
Parameters
- metadata: string
  
  Cell's metadata key.
- value: PartialJSONValue
  
  Metadata value
Returns void
Implementation of ISharedMarkdownCell.setMetadata

Inherited from YAttachmentCell.setMetadata
- Defined in src/ycell.ts:490

setSource

setSource(value: string): void
Sets cell's source.
Parameters
- value: string
Returns void
Implementation of ISharedMarkdownCell.setSource

Inherited from YAttachmentCell.setSource
- Defined in src/ycell.ts:397

setUndoManager

setUndoManager(): void
Defer setting the undo manager as it requires the cell to be attached to the notebook Y document.

Returns void
Inherited from YAttachmentCell.setUndoManager
- Defined in src/ycell.ts:295

toJSON

toJSON(): IMarkdownCell
Serialize the model to JSON.

Returns IMarkdownCell
Implementation of ISharedMarkdownCell.toJSON

Overrides YAttachmentCell.toJSON
- Defined in src/ycell.ts:1071

transact

transact(f: (() => void), undoable?: boolean, origin?: any): void
Perform a transaction. While the function f is called, all changes to the shared document are bundled into a single event.
Parameters
- f: (() => void)
  
  Transaction to execute
  - - (): void
    - Returns void
- undoable: boolean = true
  
  Whether to track the change in the action history or not (default true)
- origin: any = null
Returns void
Implementation of ISharedMarkdownCell.transact

Inherited from YAttachmentCell.transact
- Defined in src/ycell.ts:568

undo

undo(): void
Undo an operation.

Returns void
Implementation of ISharedMarkdownCell.undo

Inherited from YAttachmentCell.undo
- Defined in src/ycell.ts:337

updateSource

updateSource(start: number, end: number, value?: string): void
Replace content from start' to endwithvalue`.
Parameters
- start: number
- end: number
- value: string = ''
Returns void
Implementation of ISharedMarkdownCell.updateSource

Inherited from YAttachmentCell.updateSource
- Defined in src/ycell.ts:415

`Static` create

create(id?: string): YMarkdownCell
Create a new YMarkdownCell that works standalone. It cannot be inserted into a YNotebook because the Yjs model is already attached to an anonymous Y.Doc instance.
Parameters
- Optional id: string
Returns YMarkdownCell
Overrides YAttachmentCell.create
- Defined in src/ycell.ts:1057

Class YMarkdownCell

Hierarchy

Implements

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Notes

Parameters

ymodel: YMap<any>

ysource: YText

options: SharedCell.IOptions = {}

Optional ymetadata: YMap<any>

Returns YMarkdownCell

Properties

Protected _metadataChanged

Protected _notebook

Readonly ymodel

Accessors

attachments

Returns undefined | IAttachments

Parameters

v: undefined | IAttachments

Returns void

awareness

Returns null | Awareness

cell_type

Returns "markdown"

changed

Returns ISignal<this, CellChange>

disposed

Returns ISignal<this, void>

id

Returns string

isDisposed

Returns boolean

isStandalone

Returns boolean

metadata

Notes

Returns Partial<Metadata>

Notes

Parameters

v: Partial<Metadata>

Returns void

metadataChanged

Returns ISignal<this, IMapChange<any>>

notebook

Returns null | YNotebook

source

Returns string

Parameters

v: string

Returns void

undoManager

Returns null | UndoManager

ysource

Returns YText

Methods

canRedo

Returns boolean

canUndo

Returns boolean

clearUndoHistory

Returns void

deleteMetadata

Parameters

key: string

Returns void

dispose

Returns void

getAttachments

Returns

Returns undefined | IAttachments

Protected getChanges

Returns

Parameters

`Optional` ymetadata: YMap<any>

`Protected` _metadataChanged

`Protected` _notebook

`Readonly` ymodel

`Protected` getChanges

`Static` create

`Optional` id: string