API Docs for: 1.8.0
Show:

photonui.Canvas Class

Extends photonui.Widget
Module: Visual
Parent Module: PhotonUI

Canvas.

Constructor

photonui.Canvas

(
  • params
)

Parameters:

  • params Object

    An object that can contain any property of the widget (optional).

Methods

__onContextMenu

(
  • event
)
private
Called when the context menu should be displayed.

Parameters:

__onLocaleChanged

() private

Inherited from photonui.Widget but overwritten in src/visual/canvas.js:268

Called when the locale is changed.

_bindEvent

(
  • id
  • element
  • evName
  • callback
  • [options]
)
private

Inherited from photonui.Base: src/base.js:229

Javascript event binding (for internal use).

Parameters:

  • id String
    An unique id for the event.
  • element DOMElement
    The element on which the event will be bind.
  • evName String
    The event name (e.g. "mousemove", "click",...).
  • callback Function
    The function that will be called when the event occured.
  • [options] Object optional
    options for addEventListener

_buildHtml

() private

Inherited from photonui.Widget but overwritten in src/visual/canvas.js:250

Build the widget HTML.

_callCallbacks

(
  • wEvent
  • params
)
private

Inherited from photonui.Base: src/base.js:292

Call all callbacks for the given wEvent. NOTE: the first argument passed to the callback is the current widget. NOTEĀ²: if the thisArg of the callback is null, this will be binded to the current widget.

Parameters:

  • wEvent String
    The widget event.
  • params Array
    Parametters that will be sent to the callbacks.

_registerWEvents

(
  • wEvents
)
private

Inherited from photonui.Base: src/base.js:276

Register available wEvent.

Parameters:

_unbindEvent

(
  • id
)
private

Inherited from photonui.Base: src/base.js:257

Unbind javascript event.

Parameters:

  • id String
    The id of the event.

_updateProperties

(
  • properties
)
deprecated private

Inherited from photonui.Base: src/base.js:209

Force the update of the given properties. This method is deprecated. One should use '@photonui-update' abitbol's annotation on concerned properties.

Parameters:

  • properties Array
    The properties to update.

_visibilityChanged

(
  • visibility
)
private
Called when the visibility changes.

Parameters:

  • visibility Boolean

    Current visibility state (otptional, defaut=this.visible)

addClass

(
  • className
)
Add a class to the outer HTML element of the widget.

Parameters:

  • className String
    The class to add.

destroy

()

Inherited from photonui.Base but overwritten in src/widget.js:367

Destroy the widget.

getContext

(
  • contextId
)

Returns a drawing context on the canvas.

Proxy of the native canvas method. For more informations see:

Parameters:

Returns:

The drawing context.

hide

()
Hide the widget (equivalent to widget.visible = false).

registerCallback

(
  • id
  • wEvent
  • callback
  • thisArg
)

Inherited from photonui.Base: src/base.js:169

Register a callback for any PhotonUI/Widget event (called wEvent). Callback signature: function (Object(Base/Widget) [, arg1 [, arg2 [, ...]]])

Parameters:

  • id String
    An unique id for the callback.
  • wEvent String
    the PhotonUI/Widget event name.
  • callback Function
    The callback function.
  • thisArg Object
    The value of this (optionnal, default = current widget).

removeCallback

(
  • id
)

Inherited from photonui.Base: src/base.js:193

Remove a registered callback.

Parameters:

  • id String
    The id of the callback.

removeClass

(
  • className
)
Remove a class from the outer HTML element of the widget.

Parameters:

  • className String
    The class to remove.

setContext

(
  • contextId
)

Changes the context the element is related to to the given one.

Proxy of the native canvas method if exists. For more informations see:

Parameters:

show

()
Display the widget (equivalent to widget.visible = true).

supportsContext

(
  • contextId
)
Boolean

Indicate if the given context is supported by this canvas.

Proxy of the native canvas method if exists. For more informations see:

Parameters:

Returns:

toBlob

(
  • type
)
Blob

Returns a Blob object representing the image contained in the canvas (at 96dpi).

Proxy of the native canvas method if exists. For more informations see:

Parameters:

  • type String

    The image format (optional, e.g: "image/png", "image/jpeg",..., default="image/png")

Returns:

Blob:

toBlobHD

(
  • type
)
Blob

Returns a Blob object representing the image contained in the canvas (at the native resolution of the canvas).

Proxy of the native canvas method if exists. For more informations see:

Parameters:

  • type String

    The image format (optional, e.g: "image/png", "image/jpeg",..., default="image/png")

Returns:

Blob:

toDataURL

(
  • type
)
String

Returns a "data:" URL containing a representation of the image (at 96dpi).

Proxy of the native canvas method. For more informations see:

Parameters:

  • type String

    The image format (optional, e.g: "image/png", "image/jpeg",..., default="image/png")

Returns:

String:

The data URL

toDataURLHD

(
  • type
)
String

Returns a "data:" URL containing a representation of the image (at the native resolution of the canvas).

Proxy of the native canvas method if exists. For more informations see:

Parameters:

  • type String

    The image format (optional, e.g: "image/png", "image/jpeg",..., default="image/png")

Returns:

String:

The data URL

transferControlToProxy

()

Gives back a proxy to allow the canvas to be used in another Worker.

Proxy of the native canvas method if exists. For more informations see:

unparent

()
Detache the widget from its parent.

Properties

__callbacks

Object private

Inherited from photonui.Base: src/base.js:142

Object containing references to registered callbacks.

__events

Object private

Inherited from photonui.Base: src/base.js:132

Object containing references javascript events binding (for widget internal use).

__html

Object private
Object containing references to the widget HTML elements

absolutePosition

Object
Absolute position of the widget on the page. {x: Number, y: Number}

canvas

HTMLElement

The Canvas HTML Element.

contextMenu

photonui.PopupWindow
The managed contextual menu.

Default: null (= no context menu)

contextMenuName

String
The name of the managed contextual menu (photonui.PopupWindow().name).

Default: null (= no context menu)

data

Object

Inherited from photonui.Base: src/base.js:113

Arbitrary data

Default: {}

height

Number default 150

Canvas height.

html

HTMLElement

Inherited from photonui.Widget but overwritten in src/visual/canvas.js:221

Html outer element of the widget (if any).

Default: null

interactiveNode

HTMLElement

The interactive HTML element (for event managers).

layoutOptions

Object
Layout options.

Default: {}

name

String
The unique name of the widget.

Default: "widget-" + uuid.v4()

offsetHeight

Number
Widget height (outer HTML element).

offsetWidth

Number
Widget width (outer HTML element).

parent

photonui.Widget
The parent widget.

Default: null (no parent)

parentName

String
The parent widget name.

Default: null (no parent)

tooltip

String
Tooltip.

Default: null

visible

Boolean
Is the widget visible or hidden.

Default: true

width

Number default 300

Canvas width.