0 results found

tinymce.Editor

Contribute to this page
Namespacetinymce
ClassEditor

This class contains the core logic for a TinyMCE editor.

Example

Public Properties

PropertyDefined By
baseURI : URI : URI object to current document that holds the TinyMCE editor instance.Editor
contentCSS : Array : Array with CSS files to load into the iframe.Editor
contentStyles : Array : Array of CSS styles to add to head of document when the editor loads.Editor
controlManager : ControlManager : Control manager instance for the editor.Editor
documentBaseURI : URI : URI object to document configured for the TinyMCE instance.Editor
dom : DOMUtils : DOM instance for the editor.Editor
formatter : Formatter : Formatter instance.Editor
id : String : Editor instance id, normally the same as the div/textarea that was replaced.Editor
initialized : Boolean : Is set to true after the editor instance has been initializedEditor
isNotDirty : Boolean : State to force the editor to return false on a isDirty call.Editor
parser : DomParser : HTML parser will be used when contents is inserted into the editor.Editor
plugins : Object : Name/Value object containting plugin instances.Editor
schema : Schema : Schema instance, enables you to validate elements and it's children.Editor
selection : Selection : Selection instance for the editor.Editor
serializer : Serializer : DOM serializer for the editor.Editor
settings : Object : Name/value collection with editor settings.Editor
theme : Theme : Reference to the theme instance that was used to generate the UI.Editor
undoManager : UndoManager : Undo manager instance, responsible for handling undo levels.Editor
windowManager : WindowManager : Window manager reference, use this to open new windows and dialogs.Editor

Public Methods

MethodDefined By
Editor(id:String, settings:Object) : Constructs a editor instance by id.Editor
addButton(name:String, settings:Object):void : Adds a button that later gets created by the ControlManager.Editor
addCommand(name:String, callback:tinymce.Editor.addCommandCallback, scope:Object):void : Adds a custom command to the editor, you can also override existing commands with this method.Editor
addQueryStateHandler(name:String, callback:tinymce.Editor.addQueryStateHandlerCallback, scope:Object):void : Adds a custom query state command to the editor, you can also override existing commands with this method.Editor
addQueryValueHandler(name:String, callback:tinymce.Editor.addQueryValueHandlerCallback, scope:Object):void : Adds a custom query value command to the editor, you can also override existing commands with this method.Editor
addShortcut(pa:String, desc:String, cmd_func:String/Function, sc:Object):Boolean : Adds a keyboard shortcut for some command or function.Editor
addVisual(elm:Element):void : Adds visual aid for tables, anchors etc so they can be more easily edited inside the editor.Editor
convertURL(url:string, name:string, elm:string/HTMLElement):string : URL converter function this gets executed each time a user adds an img, a or any other element that has a URL in it.Editor
destroy(s:Boolean):void : Destroys the editor instance by removing all events, element references or other resources that could leak memory.Editor
execCallback(n:String):Object : Executes a legacy callback.Editor
execCommand(cmd:String, ui:Boolean, val:mixed, a:Object):Boolean : Executes a command on the current instance.Editor
focus(skip_focus:Boolean):void : Focuses/activates the editor.Editor
getBody():Element : Returns the iframes body element.Editor
getContainer():Element : Returns the editors container element.Editor
getContent(args:Object):String : Gets the content from the editor instance, this will cleanup the content before it gets returned using the different cle...Editor
getContentAreaContainer():Element : Returns the editors content area container element.Editor
getDoc():Document : Returns the iframes document object.Editor
getElement():Element : Returns the target element/textarea that got replaced with a TinyMCE editor instance.Editor
getLang(n:String, dv:String):void : Returns a language pack item by name/key.Editor
getParam(n:String, dv:String, ty:String):String : Returns a configuration parameter by name.Editor
getWin():Window : Returns the iframes window object.Editor
hide():void : Hides the editor and shows any textarea/div that the editor is supposed to replace.Editor
init():void : Initializes the editor this will be called automatically when all plugins/themes and language packs are loaded by the re...Editor
initContentBody():void : This method get called by the init method ones the iframe is loaded.Editor
isDirty():Boolean : Returns true/false if the editor is dirty or not.Editor
isHidden():Boolean : Returns true/false if the editor is hidden or not.Editor
load(o:Object):String : Loads contents from the textarea or div element that got converted into an editor instance.Editor
nodeChanged(o:Object):void : Distpaches out a onNodeChange event to all observers.Editor
queryCommandState(cmd:string):Boolean : Returns a command specific state, for example if bold is enabled or not.Editor
queryCommandValue(c:string):Object : Returns a command specific value, for example the current font size.Editor
remove():void : Removes the editor from the dom and tinymce collection.Editor
render():void : Renderes the editor/adds it to the page.Editor
save(o:Object):String : Saves the contents from a editor out to the textarea or div element that got converted into an editor instance.Editor
setContent(content:String, args:Object):String : Sets the specified content to the editor instance, this will cleanup the content before it gets set using the different ...Editor
setProgressState(b:Boolean, ti:Number, o:Object):Boolean : Sets the progress state, this will display a throbber/progess for the editor.Editor
show():void : Shows the editor and hides any textarea/div that the editor is supposed to replace.Editor
translate(s:String):String : Translates the specified string by replacing variables with language pack items it will also check if there is a key mat...Editor

Property details

baseURI

public baseURI : URI
URI object to current document that holds the TinyMCE editor instance.

Example

contentCSS

public contentCSS : Array
Array with CSS files to load into the iframe.

contentStyles

public contentStyles : Array
Array of CSS styles to add to head of document when the editor loads.

controlManager

public controlManager : ControlManager
Control manager instance for the editor. Will enables you to create new UI elements and change their states etc.

Example

documentBaseURI

public documentBaseURI : URI
URI object to document configured for the TinyMCE instance.

Example

dom

public dom : DOMUtils
DOM instance for the editor.

Example

formatter

public formatter : Formatter
Formatter instance.

id

public id : String
Editor instance id, normally the same as the div/textarea that was replaced.

initialized

public initialized : Boolean
Is set to true after the editor instance has been initialized

Example

isNotDirty

public isNotDirty : Boolean
State to force the editor to return false on a isDirty call.

Example

parser

public parser : DomParser
HTML parser will be used when contents is inserted into the editor.

plugins

public plugins : Object
Name/Value object containting plugin instances.

Example

schema

public schema : Schema
Schema instance, enables you to validate elements and it's children.

selection

public selection : Selection
Selection instance for the editor.

Example

serializer

public serializer : Serializer
DOM serializer for the editor. Will be used when contents is extracted from the editor.

Example

settings

public settings : Object
Name/value collection with editor settings.

Example

theme

public theme : Theme
Reference to the theme instance that was used to generate the UI.

Example

undoManager

public undoManager : UndoManager
Undo manager instance, responsible for handling undo levels.

Example

windowManager

public windowManager : WindowManager
Window manager reference, use this to open new windows and dialogs.

Example

Method details

Editor

public function Editor(id:String, settings:Object)
Constructs a editor instance by id.Author(s):Moxiecode

Parameters

ParamDetail
id:StringUnique id for the editor.
settings:ObjectOptional settings string for the editor.

addButton

public function addButton(name:String, settings:Object):void
Adds a button that later gets created by the ControlManager. This is a shorter and easier method of adding buttons without the need to deal with the ControlManager directly. But it's also less powerfull if you need more control use the ControlManagers factory methods instead.

Parameters

ParamDetail
name:StringButton name to add.
settings:ObjectSettings object with title, cmd etc.

Example

addCommand

public function addCommand(name:String, callback:tinymce.Editor.addCommandCallback, scope:Object):void
Adds a custom command to the editor, you can also override existing commands with this method. The command that you add can be executed with execCommand.

Parameters

ParamDetail
name:StringCommand name to add/override.
callback:tinymce.Editor.addCommandCallbackFunction to execute when the command occurs.
scope:ObjectOptional scope to execute the function in.

Example

addQueryStateHandler

public function addQueryStateHandler(name:String, callback:tinymce.Editor.addQueryStateHandlerCallback, scope:Object):void
Adds a custom query state command to the editor, you can also override existing commands with this method. The command that you add can be executed with queryCommandState function.

Parameters

ParamDetail
name:StringCommand name to add/override.
callback:tinymce.Editor.addQueryStateHandlerCallbackFunction to execute when the command state retrival occurs.
scope:ObjectOptional scope to execute the function in.

addQueryValueHandler

public function addQueryValueHandler(name:String, callback:tinymce.Editor.addQueryValueHandlerCallback, scope:Object):void
Adds a custom query value command to the editor, you can also override existing commands with this method. The command that you add can be executed with queryCommandValue function.

Parameters

ParamDetail
name:StringCommand name to add/override.
callback:tinymce.Editor.addQueryValueHandlerCallbackFunction to execute when the command value retrival occurs.
scope:ObjectOptional scope to execute the function in.

addShortcut

public function addShortcut(pa:String, desc:String, cmd_func:String/Function, sc:Object):Boolean
Adds a keyboard shortcut for some command or function.

Parameters

ParamDetail
pa:StringShortcut pattern. Like for example: ctrl+alt+o.
desc:StringText description for the command.
cmd_func:String/FunctionCommand name string or function to execute when the key is pressed.
sc:ObjectOptional scope to execute the function in.

Returns
Boolean - true/false state if the shortcut was added or not.

addVisual

public function addVisual(elm:Element):void
Adds visual aid for tables, anchors etc so they can be more easily edited inside the editor.

Parameters

ParamDetail
elm:ElementOptional root element to loop though to find tables etc that needs the visual aid.

convertURL

public function convertURL(url:string, name:string, elm:string/HTMLElement):string
URL converter function this gets executed each time a user adds an img, a or any other element that has a URL in it. This will be called both by the DOM and HTML manipulation functions.

Parameters

ParamDetail
url:stringURL to convert.
name:stringAttribute name src, href etc.
elm:string/HTMLElementTag name or HTML DOM element depending on HTML or DOM insert.

Returns
string - Converted URL string.

destroy

public function destroy(s:Boolean):void
Destroys the editor instance by removing all events, element references or other resources that could leak memory. This method will be called automatically when the page is unloaded but you can also call it directly if you know what you are doing.

Parameters

ParamDetail
s:BooleanOptional state if the destroy is an automatic destroy or user called one.

execCallback

public function execCallback(n:String):Object
Executes a legacy callback. This method is useful to call old 2.x option callbacks. There new event model is a better way to add callback so this method might be removed in the future.

Parameters

ParamDetail
n:StringName of the callback to execute.

Returns
Object - Return value passed from callback function.

execCommand

public function execCommand(cmd:String, ui:Boolean, val:mixed, a:Object):Boolean
Executes a command on the current instance. These commands can be TinyMCE internal commands prefixed with "mce" or they can be build in browser commands such as "Bold". A compleate list of browser commands is available on MSDN or Mozilla.org. This function will dispatch the execCommand function on each plugin, theme or the execcommand_callback option if none of these return true it will handle the command as a internal browser command.

Parameters

ParamDetail
cmd:StringCommand name to execute, for example mceLink or Bold.
ui:BooleanTrue/false state if a UI (dialog) should be presented or not.
val:mixedOptional command value, this can be anything.
a:ObjectOptional arguments object.

Returns
Boolean - True/false if the command was executed or not.

focus

public function focus(skip_focus:Boolean):void
Focuses/activates the editor. This will set this editor as the activeEditor in the tinymce collection it will also place DOM focus inside the editor.

Parameters

ParamDetail
skip_focus:BooleanSkip DOM focus. Just set is as the active editor.

getBody

public function getBody():Element
Returns the iframes body element.

Returns
Element - Iframe body element.

getContainer

public function getContainer():Element
Returns the editors container element. The container element wrappes in all the elements added to the page for the editor. Such as UI, iframe etc.

Returns
Element - HTML DOM element for the editor container.

getContent

public function getContent(args:Object):String
Gets the content from the editor instance, this will cleanup the content before it gets returned using the different cleanup rules options.

Parameters

ParamDetail
args:ObjectOptional content object, this gets passed around through the whole get process.

Returns
String - Cleaned content string, normally HTML contents.

Example

getContentAreaContainer

public function getContentAreaContainer():Element
Returns the editors content area container element. The this element is the one who holds the iframe or the editable element.

Returns
Element - HTML DOM element for the editor area container.

getDoc

public function getDoc():Document
Returns the iframes document object.

Returns
Document - Iframe DOM document object.

getElement

public function getElement():Element
Returns the target element/textarea that got replaced with a TinyMCE editor instance.

Returns
Element - HTML DOM element for the replaced element.

getLang

public function getLang(n:String, dv:String):void
Returns a language pack item by name/key.

Parameters

ParamDetail
n:StringName/key to get from the language pack.
dv:StringOptional default value to retrive.

getParam

public function getParam(n:String, dv:String, ty:String):String
Returns a configuration parameter by name.

Parameters

ParamDetail
n:StringConfigruation parameter to retrive.
dv:StringOptional default value to return.
ty:StringOptional type parameter.

Returns
String - Configuration parameter value or default value.

Example

getWin

public function getWin():Window
Returns the iframes window object.

Returns
Window - Iframe DOM window object.

hide

public function hide():void
Hides the editor and shows any textarea/div that the editor is supposed to replace.

init

public function init():void
Initializes the editor this will be called automatically when all plugins/themes and language packs are loaded by the rendered method. This method will setup the iframe and create the theme and plugin instances.

initContentBody

public function initContentBody():void
This method get called by the init method ones the iframe is loaded. It will fill the iframe with contents, setups DOM and selection objects for the iframe. This method should not be called directly.

isDirty

public function isDirty():Boolean
Returns true/false if the editor is dirty or not. It will get dirty if the user has made modifications to the contents.

Returns
Boolean - True/false if the editor is dirty or not. It will get dirty if the user has made modifications to the contents.

Example

isHidden

public function isHidden():Boolean
Returns true/false if the editor is hidden or not.

Returns
Boolean - True/false if the editor is hidden or not.

load

public function load(o:Object):String
Loads contents from the textarea or div element that got converted into an editor instance. This method will move the contents from that textarea or div into the editor by using setContent so all events etc that method has will get dispatched as well.

Parameters

ParamDetail
o:ObjectOptional content object, this gets passed around through the whole load process.

Returns
String - HTML string that got set into the editor.

nodeChanged

public function nodeChanged(o:Object):void
Distpaches out a onNodeChange event to all observers. This method should be called when you need to update the UI states or element path etc.

Parameters

ParamDetail
o:ObjectOptional object to pass along for the node changed event.

queryCommandState

public function queryCommandState(cmd:string):Boolean
Returns a command specific state, for example if bold is enabled or not.

Parameters

ParamDetail
cmd:stringCommand to query state from.

Returns
Boolean - Command specific state, for example if bold is enabled or not.

queryCommandValue

public function queryCommandValue(c:string):Object
Returns a command specific value, for example the current font size.

Parameters

ParamDetail
c:stringCommand to query value from.

Returns
Object - Command specific value, for example the current font size.

remove

public function remove():void
Removes the editor from the dom and tinymce collection.

render

public function render():void
Renderes the editor/adds it to the page.

save

public function save(o:Object):String
Saves the contents from a editor out to the textarea or div element that got converted into an editor instance. This method will move the HTML contents from the editor into that textarea or div by getContent so all events etc that method has will get dispatched as well.

Parameters

ParamDetail
o:ObjectOptional content object, this gets passed around through the whole save process.

Returns
String - HTML string that got set into the textarea/div.

setContent

public function setContent(content:String, args:Object):String
Sets the specified content to the editor instance, this will cleanup the content before it gets set using the different cleanup rules options.

Parameters

ParamDetail
content:StringContent to set to editor, normally HTML contents but can be other formats as well.
args:ObjectOptional content object, this gets passed around through the whole set process.

Returns
String - HTML string that got set into the editor.

Example

setProgressState

public function setProgressState(b:Boolean, ti:Number, o:Object):Boolean
Sets the progress state, this will display a throbber/progess for the editor. This is ideal for asycronous operations like an AJAX save call.

Parameters

ParamDetail
b:BooleanBoolean state if the progress should be shown or hidden.
ti:NumberOptional time to wait before the progress gets shown.
o:ObjectOptional object to pass to the progress observers.

Returns
Boolean - Same as the input state.

Example

show

public function show():void
Shows the editor and hides any textarea/div that the editor is supposed to replace.

translate

public function translate(s:String):String
Translates the specified string by replacing variables with language pack items it will also check if there is a key mathcin the input.

Parameters

ParamDetail
s:StringString to translate by the language pack data.

Returns
String - Translated string.

Except as otherwise noted, the content of this page is licensed under the Creative Commons BY-NC-SA 3.0 License, and code samples are licensed under the Apache 2.0 License.