Interface: Component

Defined in: types/desktop-engine.d.ts:644

Basic view component (a Yoga layout container)

Extends

• ComponentBase<ComponentEventMap>

Properties

children

readonly children: AnyComponent[];

Defined in: types/desktop-engine.d.ts:597

Array of child components (each read returns a new array)

Inherited from

ComponentBase.children

---

height

readonly height: number;

Defined in: types/desktop-engine.d.ts:595

Height after layout (reading triggers layout first)

Inherited from

ComponentBase.height

---

identifier

readonly identifier: string;

Defined in: types/desktop-engine.d.ts:588

Unique identifier of the native component (a pointer string)

Inherited from

ComponentBase.identifier

---

onclick

onclick: 
  | EventHandler<Component, ClickPayload>
  | null
  | undefined;

Defined in: types/desktop-engine.d.ts:608

click callback

Inherited from

ComponentBase.onclick

---

ondbclick

ondbclick: 
  | EventHandler<Component, ClickPayload>
  | null
  | undefined;

Defined in: types/desktop-engine.d.ts:610

dbclick (double-click) callback

Inherited from

ComponentBase.ondbclick

---

onframechange

onframechange: 
  | EventHandler<Component, FrameChangePayload>
  | null
  | undefined;

Defined in: types/desktop-engine.d.ts:606

framechange callback

Inherited from

ComponentBase.onframechange

---

onmousedown

onmousedown: 
  | EventHandler<Component, MousePayload>
  | null
  | undefined;

Defined in: types/desktop-engine.d.ts:612

mousedown callback

Inherited from

ComponentBase.onmousedown

---

onmouseenter

onmouseenter: 
  | EventHandler<Component, MousePayload>
  | null
  | undefined;

Defined in: types/desktop-engine.d.ts:616

mouseenter callback

Inherited from

ComponentBase.onmouseenter

---

onmouseleave

onmouseleave: 
  | EventHandler<Component, MousePayload>
  | null
  | undefined;

Defined in: types/desktop-engine.d.ts:618

mouseleave callback

Inherited from

ComponentBase.onmouseleave

---

onmousemove

onmousemove: 
  | EventHandler<Component, MousePayload>
  | null
  | undefined;

Defined in: types/desktop-engine.d.ts:620

mousemove callback, also while a press that began on the component is dragged, unless the press moves the window (see Window.dragRegion)

Inherited from

ComponentBase.onmousemove

---

onmouseup

onmouseup: 
  | EventHandler<Component, MousePayload>
  | null
  | undefined;

Defined in: types/desktop-engine.d.ts:614

mouseup callback

Inherited from

ComponentBase.onmouseup

---

onwheel

onwheel: 
  | EventHandler<Component, WheelPayload>
  | null
  | undefined;

Defined in: types/desktop-engine.d.ts:622

wheel callback

Inherited from

ComponentBase.onwheel

---

width

readonly width: number;

Defined in: types/desktop-engine.d.ts:593

Width after layout (reading triggers layout first)

Inherited from

ComponentBase.width

Accessors

style

Get Signature

get style(): ComponentStyle;

Defined in: types/desktop-engine.d.ts:590

Reading returns the style object; assigning an object replaces the whole style

Returns

ComponentStyle

Set Signature

set style(value): void;

Defined in: types/desktop-engine.d.ts:591

Parameters

Parameter	Type
value	StyleProperties

Returns

void

Inherited from

ComponentBase.style

Methods

addEventListener()

addEventListener<K>(type, listener): void;

Defined in: types/desktop-engine.d.ts:128

Adds an event listener; type may be given with or without the on prefix

Type Parameters

Type Parameter
K extends | "framechange" | "click" | "dbclick" | "mousedown" | "mouseup" | "mouseenter" | "mouseleave" | "mousemove" | "wheel"

Parameters

Parameter	Type
type	K | `on${K}`
listener	EventHandler<Component, ComponentEventMap[K]>

Returns

void

Inherited from

ComponentBase.addEventListener

---

appendChild()

appendChild(child, index?): void;

Defined in: types/desktop-engine.d.ts:599

Adds a child component at index (0 to the number of children); omit it or pass -1 to append at the end. Throws a RangeError for other indexes; a Window can't be a child

Parameters

Parameter	Type
child	AnyComponent
index?	number

Returns

void

Inherited from

ComponentBase.appendChild

---

destroy()

destroy(): void;

Defined in: types/desktop-engine.d.ts:132

Clears all event listeners and on callbacks so the object can be garbage-collected; components also process their children recursively

Returns

void

Inherited from

ComponentBase.destroy

---

offclick()

offclick(): void;

Defined in: types/desktop-engine.d.ts:626

Removes the onclick callback

Returns

void

Inherited from

ComponentBase.offclick

---

offdbclick()

offdbclick(): void;

Defined in: types/desktop-engine.d.ts:628

Removes the ondbclick callback

Returns

void

Inherited from

ComponentBase.offdbclick

---

offframechange()

offframechange(): void;

Defined in: types/desktop-engine.d.ts:624

Removes the onframechange callback

Returns

void

Inherited from

ComponentBase.offframechange

---

offmousedown()

offmousedown(): void;

Defined in: types/desktop-engine.d.ts:630

Removes the onmousedown callback

Returns

void

Inherited from

ComponentBase.offmousedown

---

offmouseenter()

offmouseenter(): void;

Defined in: types/desktop-engine.d.ts:634

Removes the onmouseenter callback

Returns

void

Inherited from

ComponentBase.offmouseenter

---

offmouseleave()

offmouseleave(): void;

Defined in: types/desktop-engine.d.ts:636

Removes the onmouseleave callback

Returns

void

Inherited from

ComponentBase.offmouseleave

---

offmousemove()

offmousemove(): void;

Defined in: types/desktop-engine.d.ts:638

Removes the onmousemove callback

Returns

void

Inherited from

ComponentBase.offmousemove

---

offmouseup()

offmouseup(): void;

Defined in: types/desktop-engine.d.ts:632

Removes the onmouseup callback

Returns

void

Inherited from

ComponentBase.offmouseup

---

offwheel()

offwheel(): void;

Defined in: types/desktop-engine.d.ts:640

Removes the onwheel callback

Returns

void

Inherited from

ComponentBase.offwheel

---

remove()

remove(): void;

Defined in: types/desktop-engine.d.ts:603

Removes this component from its parent

Returns

void

Inherited from

ComponentBase.remove

---

removeChild()

removeChild(child): void;

Defined in: types/desktop-engine.d.ts:601

Removes a child component; throws if it isn't a child of this component

Parameters

Parameter	Type
child	AnyComponent

Returns

void

Inherited from

ComponentBase.removeChild

---

removeEventListener()

removeEventListener<K>(type, listener): void;

Defined in: types/desktop-engine.d.ts:130

Removes the given event listener

Type Parameters

Type Parameter
K extends | "framechange" | "click" | "dbclick" | "mousedown" | "mouseup" | "mouseenter" | "mouseleave" | "mousemove" | "wheel"

Parameters

Parameter	Type
type	K | `on${K}`
listener	EventHandler<Component, ComponentEventMap[K]>

Returns

void

Inherited from

ComponentBase.removeEventListener