API > @blocksuite/store > Y > XmlElement

Class: XmlElement`<KV>`

An YXmlElement imitates the behavior of a Element.

An YXmlElement has attributes (key value pairs)
An YXmlElement has childElements that must inherit from YXmlElement

Extends

XmlFragment

Constructors

constructor

new XmlElement<KV>(nodeName?): XmlElement< KV >

Type parameters

Parameter	Default
`KV` extends {}	{}

Parameters

Parameter	Type
`nodeName`?	`string`

Returns

XmlElement< KV >

Overrides

XmlFragment.constructor

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlElement.d.ts:18

Properties

_dEH

_dEH: EventHandler< YEvent< any >[], Transaction >

Deep event handlers

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/AbstractType.d.ts:46

Inherited from

XmlFragment._dEH

_eH

_eH: EventHandler< YXmlEvent, Transaction >

Event handlers

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/AbstractType.d.ts:41

Inherited from

XmlFragment._eH

_item

_item: null | Item

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/AbstractType.d.ts:23

Inherited from

XmlFragment._item

_length

_length: number

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/AbstractType.d.ts:36

Inherited from

XmlFragment._length

_map

_map: Map< string, Item >

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/AbstractType.d.ts:27

Inherited from

XmlFragment._map

_prelimAttrs

_prelimAttrs: null | Map< string, any >

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlElement.d.ts:23

_prelimContent

_prelimContent: null | any[]

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlFragment.d.ts:68

Inherited from

XmlFragment._prelimContent

_searchMarker

_searchMarker: null | ArraySearchMarker[]

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/AbstractType.d.ts:50

Inherited from

XmlFragment._searchMarker

_start

_start: null | Item

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/AbstractType.d.ts:31

Inherited from

XmlFragment._start

doc

doc: null | Doc

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/AbstractType.d.ts:35

Inherited from

XmlFragment.doc

nodeName

nodeName: string

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlElement.d.ts:19

Accessors

_first

get _first(): null | Item

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/AbstractType.d.ts:81

Inherited from

XmlFragment._first

firstChild

get firstChild(): null | XmlText | XmlElement< {} >

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlFragment.d.ts:72

Inherited from

XmlFragment.firstChild

length

get length(): number

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlFragment.d.ts:91

Inherited from

XmlFragment.length

nextSibling

get nextSibling(): null | XmlText | XmlElement< {} >

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlElement.d.ts:27

parent

get parent(): null | AbstractType< any >

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/AbstractType.d.ts:54

Inherited from

XmlFragment.parent

prevSibling

get prevSibling(): null | XmlText | XmlElement< {} >

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlElement.d.ts:33

Methods

_callObserver

_callObserver(transaction, _parentSubs): void

Creates YEvent and calls all type observers. Must be implemented by each type.

Parameters

Parameter	Type	Description
`transaction`	`Transaction`	-
`_parentSubs`	`Set`< `null` \| `string` >	Keys changed on this type. `null` if list was modified.

Returns

void

Inherited from

XmlFragment._callObserver

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/AbstractType.d.ts:89

_copy

_copy(): XmlElement< {} >

Creates an Item with the same effect as this Item (without position effect)

Returns

XmlElement< {} >

Overrides

XmlFragment._copy

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlElement.d.ts:41

_integrate

_integrate(y, item): void

Integrate this type into the Yjs instance.

Save this struct in the os
This type is sent to other client
Observer functions are fired

Parameters

Parameter	Type	Description
`y`	`Doc`	The Yjs instance
`item`	`Item`	-

Returns

void

Inherited from

XmlFragment._integrate

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlFragment.d.ts:85

_write

_write(_encoder): void

Parameters

Parameter	Type
`_encoder`	`UpdateEncoderV1` \| `UpdateEncoderV2`

Returns

void

Inherited from

XmlFragment._write

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/AbstractType.d.ts:77

clone

clone(): XmlElement< KV >

Returns

XmlElement< KV >

Overrides

XmlFragment.clone

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlElement.d.ts:45

createTreeWalker

createTreeWalker(filter): YXmlTreeWalker

Create a subtree of childNodes.

Parameters

Parameter	Type	Description
`filter`	`function`	Function that is called on each child element and returns a Boolean indicating whether the child is to be included in the subtree.

Returns

YXmlTreeWalker

A subtree and a position within it.

Inherited from

XmlFragment.createTreeWalker

Example

const walker = elem.createTreeWalker(dom => dom.nodeName === 'div')
for (let node in walker) {
  // `node` is a div node
  nop(node)
}

const walker = elem.createTreeWalker(dom => dom.nodeName === 'div')
for (let node in walker) {
  // `node` is a div node
  nop(node)
}

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlFragment.d.ts:109

delete

delete(index, length?): void

Deletes elements starting from an index.

Parameters

Parameter	Type	Description
`index`	`number`	Index at which to start deleting elements
`length`?	`number`	The number of elements to remove. Defaults to 1.

Returns

void

Inherited from

XmlFragment.delete

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlFragment.d.ts:188

forEach

forEach(f): void

Executes a provided function on once on overy child element.

Parameters

Parameter	Type	Description
`f`	`function`	A function to execute on every element of this YArray.

Returns

void

Inherited from

XmlFragment.forEach

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlFragment.d.ts:227

get

get(index): XmlText | XmlElement< {} >

Returns the i-th element from a YArray.

Parameters

Parameter	Type	Description
`index`	`number`	The index of the element to return from the YArray

Returns

XmlText | XmlElement< {} >

Inherited from

XmlFragment.get

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlFragment.d.ts:213

getAttribute

getAttribute<KEY_1>(attributeName): undefined | KV[KEY_1]

Returns an attribute value that belongs to the attribute name.

Type parameters

Parameter
`KEY_1` extends `string`

Parameters

Parameter	Type	Description
`attributeName`	`KEY_1`	The attribute name that identifies the queried value.

Returns

undefined | KV[KEY_1]

The queried attribute value.

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlElement.d.ts:76

getAttributes

getAttributes(snapshot?): { [Key in string]?: KV[Key] }

Returns all attribute name/value pairs in a JSON Object.

Parameters

Parameter	Type
`snapshot`?	`Snapshot`

Returns

{ [Key in string]?: KV[Key] }

A JSON Object that describes the attributes.

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlElement.d.ts:94

hasAttribute

hasAttribute(attributeName): boolean

Returns whether an attribute exists

Parameters

Parameter	Type	Description
`attributeName`	`string`	The attribute name to check for existence.

Returns

boolean

whether the attribute exists.

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlElement.d.ts:85

insert

insert(index, content): void

Inserts new content at an index.

Parameters

Parameter	Type	Description
`index`	`number`	The index to insert content at
`content`	(`XmlText` \| `XmlElement`< {} >)[]	The array of content

Returns

void

Inherited from

XmlFragment.insert

Example

// Insert character 'a' at position 0
 xml.insert(0, [new Y.XmlText('text')])

// Insert character 'a' at position 0
 xml.insert(0, [new Y.XmlText('text')])

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlFragment.d.ts:170

insertAfter

insertAfter(ref, content): void

Inserts new content at an index.

Parameters

Parameter	Type	Description
`ref`	`null` \| `Item` \| `XmlText` \| `XmlElement`< {} >	The index to insert content at
`content`	(`XmlText` \| `XmlElement`< {} >)[]	The array of content

Returns

void

Inherited from

XmlFragment.insertAfter

Example

// Insert character 'a' at position 0
 xml.insert(0, [new Y.XmlText('text')])

// Insert character 'a' at position 0
 xml.insert(0, [new Y.XmlText('text')])

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlFragment.d.ts:181

observe

observe(f): void

Observe all events that are created on this type.

Parameters

Parameter	Type	Description
`f`	`function`	Observer function

Returns

void

Inherited from

XmlFragment.observe

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/AbstractType.d.ts:95

observeDeep

observeDeep(f): void

Observe all events that are created by this type and its children.

Parameters

Parameter	Type	Description
`f`	`function`	Observer function

Returns

void

Inherited from

XmlFragment.observeDeep

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/AbstractType.d.ts:101

push

push(content): void

Appends content to this YArray.

Parameters

Parameter	Type	Description
`content`	(`XmlText` \| `XmlElement`< {} >)[]	Array of content to append.

Returns

void

Inherited from

XmlFragment.push

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlFragment.d.ts:200

querySelector

querySelector(query): null | XmlText | XmlHook | XmlElement< {} >

Returns the first YXmlElement that matches the query. Similar to DOM's querySelector.

Query support:

tagname TODO:
id
attribute

Parameters

Parameter	Type	Description
`query`	`string`	The query on the children.

Returns

null | XmlText | XmlHook | XmlElement< {} >

The first element that matches the query or null.

Inherited from

XmlFragment.querySelector

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlFragment.d.ts:125

querySelectorAll

querySelectorAll(query): (null | XmlText | XmlHook | XmlElement< {} >)[]

Returns all YXmlElements that match the query. Similar to Dom's querySelectorAll.

Parameters

Parameter	Type	Description
`query`	`string`	The query on the children

Returns

(null | XmlText | XmlHook | XmlElement< {} >)[]

The elements that match this query.

Inherited from

XmlFragment.querySelectorAll

Todo

Does not yet support all queries. Currently only query by tagName.

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlFragment.d.ts:137

removeAttribute

removeAttribute(attributeName): void

Removes an attribute from this YXmlElement.

Parameters

Parameter	Type	Description
`attributeName`	`string`	The attribute name that is to be removed.

Returns

void

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlElement.d.ts:53

setAttribute

setAttribute<KEY>(attributeName, attributeValue): void

Sets or updates an attribute.

Type parameters

Parameter
`KEY` extends `string`

Parameters

Parameter	Type	Description
`attributeName`	`KEY`	The attribute name that is to be set.
`attributeValue`	`KV`[`KEY`]	The attribute value that is to be set.

Returns

void

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlElement.d.ts:64

slice

slice(start?, end?): (XmlText | XmlElement< {} >)[]

Transforms this YArray to a JavaScript Array.

Parameters

Parameter	Type
`start`?	`number`
`end`?	`number`

Returns

(XmlText | XmlElement< {} >)[]

Inherited from

XmlFragment.slice

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlFragment.d.ts:221

toArray

toArray(): (XmlText | XmlHook | XmlElement< {} >)[]

Transforms this YArray to a JavaScript Array.

Returns

(XmlText | XmlHook | XmlElement< {} >)[]

Inherited from

XmlFragment.toArray

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlFragment.d.ts:194

toDOM

toDOM( _document?, hooks?, binding?): Node

Creates a Dom Element that mirrors this YXmlElement.

Parameters

Parameter	Type	Description
`_document`?	`Document`	The document object (you must define this when calling this method in nodejs)
`hooks`?	`object`	Optional property to customize how hooks are presented in the DOM
`binding`?	`any`	You should not set this property. This is used if DomBinding wants to create a association to the created DOM type.

Returns

Node

The Element

Inherited from

XmlFragment.toDOM

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlFragment.d.ts:157

toJSON

toJSON(): string

Returns

string

Inherited from

XmlFragment.toJSON

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlFragment.d.ts:141

unobserve

unobserve(f): void

Unregister an observer function.

Parameters

Parameter	Type	Description
`f`	`function`	Observer function

Returns

void

Inherited from

XmlFragment.unobserve

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/AbstractType.d.ts:107

unobserveDeep

unobserveDeep(f): void

Unregister an observer function.

Parameters

Parameter	Type	Description
`f`	`function`	Observer function

Returns

void

Inherited from

XmlFragment.unobserveDeep

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/AbstractType.d.ts:113

unshift

unshift(content): void

Preppends content to this YArray.

Parameters

Parameter	Type	Description
`content`	(`XmlText` \| `XmlElement`< {} >)[]	Array of content to preppend.

Returns

void

Inherited from

XmlFragment.unshift

Defined In

node_modules/.pnpm/yjs@13.6.10/node_modules/yjs/dist/src/types/YXmlFragment.d.ts:206

Class: XmlElement<KV> ​

Extends ​

Constructors ​

constructor ​

Type parameters ​

Parameters ​

Returns ​

Overrides ​

Defined In ​

Properties ​

_dEH ​

Defined In ​

Inherited from ​

_eH ​

Defined In ​

Inherited from ​

_item ​

Defined In ​

Inherited from ​

_length ​

Defined In ​

Inherited from ​

_map ​

Defined In ​

Inherited from ​

_prelimAttrs ​

Defined In ​

_prelimContent ​

Defined In ​

Inherited from ​

_searchMarker ​

Defined In ​

Inherited from ​

_start ​

Defined In ​

Inherited from ​

doc ​

Defined In ​

Inherited from ​

nodeName ​

Defined In ​

Accessors ​

_first ​

Defined In ​

Inherited from ​

firstChild ​

Defined In ​

Inherited from ​

length ​

Defined In ​

Inherited from ​

nextSibling ​

Defined In ​

parent ​

Defined In ​

Inherited from ​

prevSibling ​

Defined In ​

Methods ​

_callObserver ​

Parameters ​

Returns ​

Inherited from ​

Defined In ​

_copy ​

Returns ​

Overrides ​

Defined In ​

_integrate ​

Parameters ​

Returns ​

Inherited from ​

Defined In ​

_write ​

Parameters ​

Returns ​

Inherited from ​

Defined In ​

clone ​

Returns ​

Class: XmlElement`<KV>`

Extends

Constructors

constructor

Type parameters

Parameters

Returns

Overrides

Defined In

Properties

_dEH

Defined In

Inherited from

_eH

Defined In

Inherited from

_item

Defined In

Inherited from

_length

Defined In

Inherited from

_map

Defined In

Inherited from

_prelimAttrs

Defined In

_prelimContent

Defined In

Inherited from

_searchMarker

Defined In

Inherited from

_start

Defined In

Inherited from

doc

Defined In

Inherited from

nodeName

Defined In

Accessors

_first

Defined In

Inherited from

firstChild

Defined In

Inherited from

length

Defined In

Inherited from

nextSibling

Defined In

parent

Defined In

Inherited from

prevSibling

Defined In

Methods

_callObserver

Parameters

Returns

Inherited from

Defined In

_copy

Returns

Overrides

Defined In

_integrate

Parameters

Returns

Inherited from

Defined In

_write

Parameters

Returns

Inherited from

Defined In

clone

Returns