Events
The plug-in exposes nine JavaScript events in the Oracle APEX page designer.
UC Froala CLOB updated
The plug-in triggers the event (ucfroalaclobdraftupdated) after the draft CLOB is updated in the plug-in collection.
| Property | Type | Description |
|---|---|---|
this.data.checksum | Number | The checksum of a draft CLOB |
this.data.length | Number | Length of the CLOB value. |
UC Froala CLOB reset
The plug-in triggers the event (ucfroalaclobonloadreset) after the Froala editor content is reset to ONLOAD CLOB.
| Property | Type | Description |
|---|---|---|
this.data.checksum | Number | The checksum of an onload CLOB |
this.data.length | Number | Length of the CLOB value. |
UC Froala Option Changed
The plug-in triggers the event (ucfroalaoptionchanged) after executing the following United Codes Rich Text Editor Pro (Extend) actions:
- Image Browser Parameters
- Upload Parameters
The event is triggered along with this.data object described below
| Property | Type | Description |
|---|---|---|
this.data.option | String | The Froala editor or the plug-in option name that has been changed. Possible values are: base64images, imageUploadParams, and imageManagerLoadParams |
this.data.before | String | JSON | Boolean | The option value before a change |
this.data.after | String| JSON | Boolean | The option value after a change |
this.data.triggeringElement | DOM node | The event triggering element, |
UC Froala Before Initialization
The plug-in triggers the event (ucfroalabeforeinitialize) in order to extend the Froala configuration with dynamic actions which implement the United Codes Rich Text Editor Pro (Extend) supporting plug-in.
The event can be used on the APEX global page to change the settings of all plug-in instances across all pages in an application.
The event is triggered along with the this.data JSON object described in the table below.
| Property | Type | Description |
|---|---|---|
this.data.options | JSON | The Froala option currently used by the plug-in |
UC Froala Initialized
The plug-in triggers the event (ucfroalacontentinitialized) right after the Froala editor is created.
The event is triggered along with the this.data JSON object described in the table below.
| Property | Type | Description |
|---|---|---|
this.data.options | JSON | The Froala option currently used by the plug-in |
UC Froala Content Changed
The plug-in event (ucfroalacontentchanged) is triggered when content within the Froala editor changes.
The event is triggered along with the this.data JSON object described in the table below.
| Property | Type | Description |
|---|---|---|
this.data.options | JSON | The Froala option currently used by the plug-in |
UC Froala Image Browser Error
The plug-in event (ucfroalaimagemanagererror) is triggered when the Froala Image Manager (image browser) raises an error.
The event is triggered along with the this.data JSON object described in the table below.
Learn more about codes and messages in the Froala documentation for the Froala event imageManager.error.
| Property | Type | Description |
|---|---|---|
this.data.options | JSON | The Froala option currently used by the plug-in |
this.data.errorCode | Number | The Froala error code |
this.data.errorMessage | String | The Froala error message |
this.data.response | String | The RESTful delete service output |
UC Froala Image Upload Error
The plug-in event (ucfroalaimageuploaderror) is triggered when an image upload fails.
The event is triggered along with the this.data JSON object described in the table below.
| Property | Type | Description |
|---|---|---|
this.data.options | JSON | The Froala option currently used by the plug-in |
this.data.errorCode | Number | The Froala error code |
this.data.errorMessage | String | The Froala error message |
this.data.response | String | The RESTful delete service output |
UC Froala Images In Collection
The plug-in event (ucfroalacollectionimageschanged) is triggered after:
- the plug-in is initialized on the page load
- an image is added to a rich HTML text
- an image is removed from a rich HTML text
The event is triggered along with the this.data JSON object described in the table below.
| Property | Type | Description |
|---|---|---|
seqId | Number | A sequence ID identifying an image in the plug-in collection. |
guiId | String | A temporary ID identifying an image in document DOM. |
dbId | Number | An ID identifying an image in database table. |
rest | Boolean | When true, an image was uploaded using the plug-in RESTful service. |
base64 | Boolean | When true, an image is added to rich HTML text as inline base64 image. |
onload | Boolean | When true, an image was present in a rich HTML text when plug-in was initialized. |
added | Boolean | When true an image was added to a rich HTML text. |
removed | Boolean | When true an image was removed from a rich HTML text. |
url | String | A current image URL. |
node | DOM node | A DOM node referencing an image. |