Class YRawCell

Shareable raw cell.

Hierarchy

YAttachmentCell
- YRawCell

Implements

ISharedRawCell

Index

Constructors

constructor

new YRawCell(ymodel: YMap<any>, ysource: YText, options?: SharedCell.IOptions, ymetadata?: YMap<any>): YRawCell
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 YRawCell
Inherited from YAttachmentCell.constructor
- Defined in src/ycell.ts:158

Properties

`Protected` _metadataChanged

_metadataChanged: Signal<YRawCell, 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 ISharedRawCell.attachments

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

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

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:191

cell_type

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

Returns "raw"
Implementation of ISharedRawCell.cell_type

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

changed

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

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

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

disposed

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

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

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

id

get id(): string
Cell id

Returns string
Implementation of ISharedRawCell.id

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

isDisposed

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

Returns boolean
Implementation of ISharedRawCell.isDisposed

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

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 ISharedRawCell.isStandalone

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

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 ISharedRawCell.metadata

Inherited from YAttachmentCell.metadata
- Defined in src/ycell.ts:247
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 ISharedRawCell.metadata

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

metadataChanged

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

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

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

notebook

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

Returns null | YNotebook
Implementation of ISharedRawCell.notebook

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

source

get source(): string
Cell input content.

Returns string
Implementation of ISharedRawCell.source

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

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

undoManager

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

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

ysource

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

Methods

canRedo

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

Returns boolean
Implementation of ISharedRawCell.canRedo

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

canUndo

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

Returns boolean
Implementation of ISharedRawCell.canUndo

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

clearUndoHistory

clearUndoHistory(): void
Clear the change stack.

Returns void
Implementation of ISharedRawCell.clearUndoHistory

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

deleteMetadata

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

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

dispose

dispose(): void
Dispose of the resources.

Returns void
Implementation of ISharedRawCell.dispose

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

getAttachments

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

Returns
The cell attachments.

Returns undefined | IAttachments
Implementation of ISharedRawCell.getAttachments

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

`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:885

getId

getId(): string
Get cell id.

Returns
Cell id

Returns string
Implementation of ISharedRawCell.getId

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

getMetadata

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

Returns
cell's metadata.

Returns Partial<IBaseCellMetadata>
Implementation of ISharedRawCell.getMetadata

Inherited from YAttachmentCell.getMetadata
- Defined in src/ycell.ts:459
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 ISharedRawCell.getMetadata

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

getSource

getSource(): string
Gets cell's source.

Returns
Cell's source.

Returns string
Implementation of ISharedRawCell.getSource

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

redo

redo(): void
Redo an operation.

Returns void
Implementation of ISharedRawCell.redo

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

setAttachments

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

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

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 ISharedRawCell.setMetadata

Inherited from YAttachmentCell.setMetadata
- Defined in src/ycell.ts:488
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 ISharedRawCell.setMetadata

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

setSource

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

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

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:294

toJSON

toJSON(): IRawCell
Serialize the model to JSON.

Returns IRawCell
Implementation of ISharedRawCell.toJSON

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

transact

transact(f: (() => void), undoable?: boolean): 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)
Returns void
Implementation of ISharedRawCell.transact

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

undo

undo(): void
Undo an operation.

Returns void
Implementation of ISharedRawCell.undo

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

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 ISharedRawCell.updateSource

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

`Static` create

create(id?: string): YRawCell
Create a new YRawCell 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 YRawCell
Overrides YAttachmentCell.create
- Defined in src/ycell.ts:913

Class YRawCell

Hierarchy

Implements

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Notes

Parameters

ymodel: YMap<any>

ysource: YText

options: SharedCell.IOptions = {}

Optional ymetadata: YMap<any>

Returns YRawCell

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 "raw"

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