Editor for ContentArea to be able to edit my content area property in forms mode This should be a simple, non WYSIWYG listing of the inner content blocks with possibilities to add, remove and rearrange the content.











Path to a blank 1x1 image. Used by <img> nodes in templates that really get their image via CSS background-image.






A fallback to preserve the 1.0 - 1.3 behavior of children in templates having their startup called before the parent widget fires postCreate. Defaults to 'false', causing child widgets to have their .startup() called immediately before a parent widget .startup(), but always after the parent .postCreate(). Set to 'true' to re-enable to previous, arguably broken, behavior.








startup() has completed.



The resource of actions link


True if mouse was pressed while over this widget, and hasn't been released yet


Deprecated. Instead of attributeMap, widget should have a _setXXXAttr attribute for each XXX attribute to be mapped to the DOM.

attributeMap sets up a "binding" between attributes (aka properties) of the widget and the widget's DOM. Changes to widget attributes listed in attributeMap will be reflected into the DOM.

For example, calling set('title', 'hello') on a TitlePane will automatically cause the TitlePane's DOM to update with the new title.

attributeMap is a hash where the key is an attribute of the widget, and the value reflects a binding to a:

  • DOM node attribute

    focus: {node: "focusNode", type: "attribute"} Maps this.focus to this.focusNode.focus

  • DOM node innerHTML

    title: { node: "titleNode", type: "innerHTML" } Maps this.title to this.titleNode.innerHTML

  • DOM node innerText

    title: { node: "titleNode", type: "innerText" } Maps this.title to this.titleNode.innerText

  • DOM node CSS class

    myClass: { node: "domNode", type: "class" } Maps this.myClass to this.domNode.className

If the value is an array, then each element in the array matches one of the formats of the above list.

There are also some shorthands for backwards compatibility:

  • string --> { node: string, type: "attribute" }, for example:
"focusNode" ---> { node: "focusNode", type: "attribute" }
  • "" --> { node: "domNode", type: "attribute" }


The widget's base CSS class.




Designates where children of the source DOM node will be placed. "Children" in this case refers to both DOM nodes and widgets. For example, for myWidget:

<div data-dojo-type=myWidget>
    <b> here's a plain DOM node
    <span data-dojo-type=subWidget>and a widget</span>
    <i> and another plain DOM node </i>

containerNode would point to:

<b> here's a plain DOM node
<span data-dojo-type=subWidget>and a widget</span>
<i> and another plain DOM node </i>

In templated widgets, "containerNode" is set via a data-dojo-attach-point assignment.

containerNode must be defined for any widget that accepts innerHTML (like ContentPane or BorderContainer or even Button), and conversely is null for widgets that don't, like TextBox.



List of sub-nodes within the widget that need CSS classes applied on mouse hover/press and focus

Each entry in the hash is a an attachpoint names (like "upArrowButton") mapped to a CSS class names (like "dijitUpArrowButton"). Example:

    "upArrowButton": "dijitUpArrowButton",
    "downArrowButton": "dijitDownArrowButton"

The above will set the CSS class dijitUpArrowButton to the this.upArrowButton DOMNode when it

is hovered, etc.


Bi-directional support, as defined by the HTML DIR attribute. Either left-to-right "ltr" or right-to-left "rtl". If undefined, widgets renders in page's default direction.


This is our visible representation of the widget! Other DOM Nodes may by assigned to other properties, usually through the template system's data-dojo-attach-point syntax, but the domNode property is the canonical "top level" node in widget UI.


Flags to detect page edit mode (On page edit or Form edit mode or Create content mode)


This widget or a widget it contains has focus, or is "active" because it was recently clicked.


True if cursor is over this widget


A unique, opaque ID string that can be assigned by users or by the system. If the developer passes an ID which is known not to be unique, the specified ID is ignored and the system-generated ID is used instead.



Inherited from editor interface


Indicates whether a child dialog window is currently being displayed.


Rarely used. Overrides the default Dojo locale used to render this widget, as defined by the HTML LANG attribute. Value must be among the list of locales specified during by the Dojo bootstrap, formatted according to RFC 3066 (like en-us).



Content area editor view model


Value must be true, otherwise dijit.Form will trea the value as an object instead of an array


Source overlay of the content area in on page edit mode


The document this widget belongs to. If not specified to constructor, will default to srcNodeRef.ownerDocument, or if no sourceRef specified, then to dojo/_base/window::doc


Editor wrapper object containe the editor



Language resource


pointer to original DOM node


HTML style attributes as cssText string or name/value hash


Path to template (HTML file) for this widget relative to dojo.baseUrl. Deprecated: use templateString with require([... "dojo/text!..."], ...) instead


UI template for content area editor


Bi-directional support, the main variable which is responsible for the direction of the text. The text direction can be different than the GUI direction by using this parameter in creation of a widget.

Allowed values:

  1. "ltr"
  2. "rtl"
  3. "auto" - contextual the direction of a text defined by first strong letter.

By default is as the page direction.


The text with link area


HTML title attribute.

For form widgets this specifies a tooltip to display when hovering over the widget (just like the native HTML title attribute).

For TitlePane or for when this widget is a child of a TabContainer, AccordionContainer, etc., it's used to specify the tab label, accordion pane title, etc.


When this widget's title attribute is used to for a tab label, accordion pane title, etc., this specifies the tooltip to appear when the mouse is hovered over that text.


Value of the content area


Should we parse the template to find widgets that might be declared in markup inside it? (Remove for 2.0 and assume true)


protected method _compareUris ( obj1 , obj2 )

Checks if the URI:s are equal


protected method _fillContent ( source )

Relocate source contents to templated container node. this.containerNode must be able to receive children, or exceptions will be thrown.


public method _handleModelChange ( value )

Called when the value in the model changes.


protected method _isContentContext ( ctx )

Verifies that the context has content data


protected method _isSameAsCurrentContentContext ( ctx )

Checks if the content context has Id and PreferredLanguage the same as the already loaded current content context.


protected method _isSameAsCurrentContext ( uri )

Checks if the URI is the same as the already loaded context.


protected method _onBlur ( )

Override base to prevent the onBlur from being called when the _preventOnBlur flag is set.

protected method _onFocus ( )

This is where widgets do processing for when they are active, such as changing CSS classes. See onFocus() for more details.

protected method _setStyleAttr ( value )

Sets the style attribute of the widget according to value, which is either a hash like {height: "5px", width: "3px"} or a plain string


protected method applyTextDir ( element , text )

The function overridden in the _BidiSupport module, originally used for setting element.dir according to this.textDir. In this case does nothing.


protected method connect ( obj , event , method )

Deprecated, will be removed in 2.0, use this.own(on(...)) or this.own(aspect.after(...)) instead.

Connects specified obj/event to specified method of this object and registers for disconnect() on widget destroy.

Provide widget-specific analog to dojo.connect, except with the implicit use of this widget as the target object. Events connected with this.connect are disconnected upon destruction.

var btn = new Button();
// when is called, call the listener we're going to
// provide in the scope of btn
btn.connect(foo, "bar", function(){

protected method contentContextChanged ( ctx , callerData )

Called when the currently loaded content changes. I.e. a new content data object is loaded into the preview area.


protected method contentContextUpdated ( ctx , callerData )

Called when the currently loaded content updated.


protected method defer ( fcn , delay )

Wrapper to setTimeout to avoid deferred functions executing after the originating widget has been destroyed. Returns an object handle with a remove method (that returns null) (replaces clearTimeout).


protected method destroyRendering ( preserveDom )

Destroys the DOM nodes associated with this widget


protected method disconnect ( handle )

Deprecated, will be removed in 2.0, use handle.remove() instead.

Disconnects handle created by connect.


protected method emit ( type , eventObj , callbackArgs )

Used by widgets to signal that a synthetic event occurred, ex:

myWidget.emit("attrmodified-selectedChildWidget", {}).

Emits an event on this.domNode named type.toLowerCase(), based on eventObj. Also calls onType() method, if present, and returns value from that method. By default passes eventObj to callback, but will pass callbackArgs instead, if specified. Modifies eventObj by adding missing parameters (bubbles, cancelable, widget).


public method executeAction ( actionName )

Overridden mixin class executing click actions from textWithLinks widget


public method focus ( )

Focus the tree if there is a value, else focus the create block text.

protected method getCurrentContent ( )

Returns either the current content or a deferred which will resolve a content data as soon as it becomes available.

protected method getTemplateString ( )

Them template string to build actions area

protected method getTextDir ( text , originalDir )

Return direction of the text. The function overridden in the _BidiSupport module, its main purpose is to calculate the direction of the text, if was defined by the programmer through textDir.


protected method isCreateLinkVisible ( )

Overidden mixin class, depend on currentMode will show/not create link

protected method isLeftToRight ( )

Return this widget's explicit or implicit orientation (true for LTR, false for RTL)

protected method isValid ( )

Check if widget's value is valid.

public inherited method itemChanged ( id , item )

Notification event when an item has been patched or reloaded.


public inherited method onBlur ( )

Called when the widget stops being "active" because focus moved to something outside of it, or the user clicked somewhere outside of it, or the widget was hidden.

public method onChange ( value )

Called when the value in the widget changes.


public inherited method onFocus ( )

Called when the widget becomes "active" because it or a widget inside of it either has focus, or has recently been clicked.

protected method own ( )

Track specified handles and remove/destroy them when this instance is destroyed, unless they were already removed/destroyed manually.

public inherited method setupActionLinks ( container )

Initial new text with action links of content area, and depend on context are create will show template without create, otherwise


protected method subscribe ( t , method )

Deprecated, will be removed in 2.0, use this.own(topic.subscribe()) instead.

Subscribes to the specified topic and calls the specified method of this object and registers for unsubscribe() on widget destroy.

Provide widget-specific analog to dojo.subscribe, except with the implicit use of this widget as the target object.

var btn = new Button();
// when /my/topic is published, this button changes its label to
// be the parameter of the topic.
btn.subscribe("/my/topic", function(v){
    this.set("label", v);

protected method uninitialize ( )

Deprecated. Override destroy() instead to implement custom widget tear-down behavior.

protected method unsubscribe ( handle )

Deprecated, will be removed in 2.0, use handle.remove() instead.

Unsubscribes handle created by this.subscribe. Also removes handle from this widget's list of subscriptions