Yahoo! UI Library

editor  2.8.0r4

Yahoo! UI Library > editor > YAHOO.widget.Editor
Search:
 
Filters

Class YAHOO.widget.Editor - extends YAHOO.widget.SimpleEditor

The Rich Text Editor is a UI control that replaces a standard HTML textarea; it allows for the rich formatting of text content, including common structural treatments like lists, formatting treatments like bold and italic text, and drag-and-drop inclusion and sizing of images. The Rich Text Editor's toolbar is extensible via a plugin architecture so that advanced implementations can achieve a high degree of customization.

Constructor

YAHOO.widget.Editor ( el , attrs )
Parameters:
el <String/HTMLElement> The textarea element to turn into an editor.
attrs <Object> Object liternal containing configuration parameters.

Properties

_alwaysDisabled - private Object

The Toolbar items that should ALWAYS be disabled event if there is a selection present in the editor.

_alwaysEnabled - private Object

The Toolbar items that should ALWAYS be enabled event if there isn't a selection present in the editor.

_disabled - private Array

The Toolbar items that should be disabled if there is no selection present in the editor.

_undoCache - private Array

An Array hash of the Undo Levels.

_undoLevel - private Number

The index of the current undo state.

CLASS_HIDDEN - protected String

CSS class applied to the body when the hiddenelements button is pressed.

CLASS_LOCAL_FILE - protected String

CSS class applied to an element when it's found to have a local url.

EDITOR_PANEL_ID - String

HTML id to give the properties window in the DOM.

STR_BEFORE_EDITOR - String

The accessibility string for the element before the iFrame

STR_CLOSE_WINDOW - String

The Title of the close button in the Editor Window

STR_CLOSE_WINDOW_NOTE - String

A note appearing in the Editor Window to tell the user that the Escape key will close the window

STR_IMAGE_BORDER - String

The label string for the image border.

STR_IMAGE_BORDER_SIZE - String

The label string for the image border size.

STR_IMAGE_BORDER_TYPE - String

The label string for the image border type.

STR_IMAGE_COPY - String

The label string for the image copy and paste message for Opera and Safari

STR_IMAGE_ORIG_SIZE - String

The label string for Original Image Size

STR_IMAGE_PADDING - String

The label string for the image padding.

STR_IMAGE_PROP_TITLE - String

The title for the Image Property Editor Window

STR_IMAGE_SIZE - String

The label string for Image Size

STR_IMAGE_TEXTFLOW - String

The label string for the image text flow.

STR_IMAGE_TITLE - String

The label string for Image Description

STR_LINK_NEW_WINDOW - String

The string for the open in a new window label.

STR_LINK_PROP_REMOVE - String

The label string for the Remove link from text link inside the property editor.

STR_LINK_PROP_TITLE - String

The label string for the Link Property Editor Window.

STR_LINK_TITLE - String

The string for the link description.

STR_LOCAL_FILE_WARNING - String

The label string for the local file warning.

STR_NONE - String

The string for the word none.

Properties inherited from YAHOO.util.Element:

Properties inherited from YAHOO.util.AttributeProvider:

Methods

_checkUndo

private void _checkUndo ( )
Prunes the undo cache when it reaches the maxUndo config
Returns: void

_closeWindow

private void _closeWindow ( ev )
Close the currently open EditorWindow with the Escape key.
Parameters:
ev <Event> The keypress Event that we are trapping
Returns: void

_defaultImageToolbar

private void _defaultImageToolbar ( )
A reference to the Toolbar Object inside Image Editor Window.
Returns: void

_defaultImageToolbarConfig

private void _defaultImageToolbarConfig ( )
Config to be used for the default Image Editor Window.
Returns: void

_fixNodes

private void _fixNodes ( )
Fix href and imgs as well as remove invalid HTML.
Returns: void

_getUndo

private String _getUndo ( index )
Get's a level from the undo cache.
Parameters:
index <Number> The index of the undo level we want to get.
Returns: String

_handleCreateLinkWindowClose

private void _handleCreateLinkWindowClose ( )
Handles the closing of the Link Properties Window.
Returns: void

_handleInsertImageClick

private void _handleInsertImageClick ( )
Opens the Image Properties Window when the insert Image button is clicked or an Image is Double Clicked.
Returns: void

_handleInsertImageWindowClose

private void _handleInsertImageWindowClose ( )
Handles the closing of the Image Properties Window.
Returns: void

_handleKeyDown

private void _handleKeyDown ( ev )
Override method that handles some new keydown events inside the iFrame document.
Parameters:
ev <Event> The event we are working on.
Returns: void

_handleWindowInputs

void _handleWindowInputs ( disable )
Disables/Enables all fields inside Editor windows. Used in show/hide events to keep window fields from submitting when the parent form is submitted.
Parameters:
disable <Boolean> The state to set all inputs in all Editor windows to. Defaults to: false.
Returns: void

_hasUndoLevel

private _hasUndoLevel ( )
Checks to see if we have an undo level available

_putUndo

private void _putUndo ( str )
Puts the content of the Editor into the _undoCache. //TODO Convert the hash to a series of TEXTAREAS to store state in.
Parameters:
str <String> The content of the Editor
Returns: void

_renderCreateLinkWindow

private void _renderCreateLinkWindow ( )
Pre renders the CreateLink window so we get faster window opening.
Returns: void

_renderInsertImageWindow

private void _renderInsertImageWindow ( )
Pre renders the InsertImage window so we get faster window opening.
Returns: void

_renderPanel

private YAHOO.widget.Overlay _renderPanel ( )
Renders the panel used for Editor Windows to the document so we can start using it..

_storeUndo

private void _storeUndo ( )
Method to call when you want to store an undo state. Currently called from nodeChange and _handleKeyUp
Returns: void

_undoNodeChange

private void _undoNodeChange ( )
nodeChange listener for undo processing
Returns: void

_windows

private void _windows ( )
A reference to the HTML elements used for the body of Editor Windows.
Returns: void

closeWindow

void closeWindow ( )
Close the currently open EditorWindow.
Returns: void

cmd_heading

void cmd_heading ( value )
This is an execCommand override method. It is called from execCommand when the execCommand('heading') is used.
Parameters:
value <object> Value passed from the execCommand method
Returns: void

cmd_hiddenelements

void cmd_hiddenelements ( value )
This is an execCommand override method. It is called from execCommand when the execCommand('hiddenelements') is used.
Parameters:
value <object> Value passed from the execCommand method
Returns: void

cmd_indent

void cmd_indent ( value )
This is an execCommand override method. It is called from execCommand when the execCommand('indent') is used.
Parameters:
value <object> Value passed from the execCommand method
Returns: void

cmd_justify

void cmd_justify ( dir )
This is a factory method for the justify family of commands.
Parameters:
dir <object> The direction to justify
Returns: void

cmd_justifycenter

void cmd_justifycenter ( value )
This is an execCommand override method. It is called from execCommand when the execCommand('justifycenter') is used.
Parameters:
value <object> Value passed from the execCommand method
Returns: void

cmd_justifyleft

void cmd_justifyleft ( value )
This is an execCommand override method. It is called from execCommand when the execCommand('justifyleft') is used.
Parameters:
value <object> Value passed from the execCommand method
Returns: void

cmd_justifyright

void cmd_justifyright ( value )
This is an execCommand override method. It is called from execCommand when the execCommand('justifyright') is used.
Parameters:
value <object> Value passed from the execCommand method
Returns: void

cmd_outdent

void cmd_outdent ( value )
This is an execCommand override method. It is called from execCommand when the execCommand('outdent') is used.
Parameters:
value <object> Value passed from the execCommand method
Returns: void

cmd_redo

void cmd_redo ( value )
Pulls an item from the Undo stack and updates the Editor
Parameters:
value <object> Value passed from the execCommand method
Returns: void

cmd_removeformat

void cmd_removeformat ( value )
This is an execCommand override method. It is called from execCommand when the execCommand('removeformat') is used.
Parameters:
value <object> Value passed from the execCommand method
Returns: void

cmd_script

void cmd_script ( action , value )
This is a combined execCommand override method. It is called from the cmd_superscript and cmd_subscript methods.
Parameters:
action <object> action passed from the execCommand method
value <object> Value passed from the execCommand method
Returns: void

cmd_subscript

void cmd_subscript ( value )
This is an execCommand override method. It is called from execCommand when the execCommand('subscript') is used.
Parameters:
value <object> Value passed from the execCommand method
Returns: void

cmd_superscript

void cmd_superscript ( value )
This is an execCommand override method. It is called from execCommand when the execCommand('superscript') is used.
Parameters:
value <object> Value passed from the execCommand method
Returns: void

cmd_undo

void cmd_undo ( value )
Pulls an item from the Undo stack and updates the Editor
Parameters:
value <object> Value passed from the execCommand method
Returns: void

init

void init ( )
The Editor class' initialization method
Returns: void

initAttributes

void initAttributes ( attr )
Initializes all of the configuration attributes used to create the editor.
Parameters:
attr <Object> Object literal specifying a set of configuration attributes used to create the editor.
Returns: void

moveWindow

void moveWindow ( force )
Realign the window with the currentElement and reposition the knob above the panel.
Parameters:
force <Boolean> Boolean to tell it to move but not use any animation (Usually done the first time the window is loaded.)
Returns: void

openWindow

void openWindow ( win )
Opens a new "window/panel"
Parameters:
win <YAHOO.widget.EditorWindow> A YAHOO.widget.EditorWindow instance
Returns: void

toString

String toString ( )
Returns a string representing the editor.
Returns: String

Methods inherited from YAHOO.widget.SimpleEditor:

_checkKey, _checkLoaded, _cleanClassName, _cleanIncomingHTML, _closeWindow, _createCurrentElement, _createIframe, _createInsertElement, _disableEditor, _fixListDupIds, _fixNodes, _focusWindow, _getBlankImage, _getDoc, _getDomPath, _getRange, _getSelectedElement, _getSelection, _getWindow, _handleAfterNodeChange, _handleAlign, _handleAutoHeight, _handleBlur, _handleClick, _handleColorPicker, _handleCreateLinkClick, _handleCreateLinkWindowClose, _handleDoubleClick, _handleFocus, _handleFontSize, _handleFormButtonClick, _handleFormSubmit, _handleInsertImageClick, _handleInsertImageWindowClose, _handleKeyDown, _handleKeyPress, _handleKeyUp, _handleMouseDown, _handleMouseUp, _handleToolbarClick, _hasParent, _hasSelection, _initEditor, _initEditorEvents, _isElement, _isLocalFile, _isNonEditable, _listFix, _nodeChange, _removeEditorEvents, _render, _selectNode, _setCurrentEvent, _setDesignMode, _setEditorStyle, _setInitialContent, _setMarkupType, _setupAfterElement, _setupDD, _setupResize, _swapEl, _toggleDesignMode, _updateMenuChecked, _writeDomPath, cleanHTML, clearEditorDoc, closeWindow, cmd_backcolor, cmd_bold, cmd_createlink, cmd_fontname, cmd_fontsize, cmd_forecolor, cmd_inserthtml, cmd_insertimage, cmd_insertorderedlist, cmd_insertunorderedlist, cmd_italic, cmd_list, cmd_underline, cmd_unlink, destroy, execCommand, filter_all_rgb, filter_internals, filter_invalid_lists, filter_msword, filter_rgb, filter_safari, focus, getEditorHTML, hide, init, initAttributes, moveWindow, nodeChange, openWindow, post_filter_linebreaks, pre_filter_linebreaks, render, saveHTML, setEditorHTML, show, toString

Events

afterOpenWindow

afterOpenWindow ( win , panel )
Event fires after an Editor Window is opened. See Element.addListener for more information on listening for this event.
Parameters:
win <EditorWindow> The EditorWindow object
panel <Overlay> The Overlay object that is used to create the window.

beforeHiddencssChange

beforeHiddencssChange ( event )
Fires before the value for the configuration attribute 'hiddencss' changes. Return false to cancel the attribute change.
Parameters:
event <{oldValue: any, newValue: any}> An object containing the previous attribute value and the new value.

beforeLocalFileWarningChange

beforeLocalFileWarningChange ( event )
Fires before the value for the configuration attribute 'localFileWarning' changes. Return false to cancel the attribute change.
Parameters:
event <{oldValue: any, newValue: any}> An object containing the previous attribute value and the new value.

beforeOpenWindow

beforeOpenWindow ( win , panel )
Event fires before an Editor Window is opened. See Element.addListener for more information on listening for this event.
Parameters:
win <EditorWindow> The EditorWindow object
panel <Overlay> The Overlay object that is used to create the window.

closeWindow

closeWindow ( win )
Event fires after an Editor Window is closed. See Element.addListener for more information on listening for this event.
Parameters:
win <EditorWindow> The EditorWindow object

hiddencssChange

hiddencssChange ( event )
Fires when the value for the configuration attribute 'hiddencss' changes.
Parameters:
event <{oldValue: any, newValue: any}> An object containing the previous attribute value and the new value.

localFileWarningChange

localFileWarningChange ( event )
Fires when the value for the configuration attribute 'localFileWarning' changes.
Parameters:
event <{oldValue: any, newValue: any}> An object containing the previous attribute value and the new value.

windowCMDClose

windowCMDClose ( win , panel )
Dynamic event fired when an EditorWindow is closed.. The dynamic event is based on the name of the window. Example Window: createlink, opening this window would fire the windowcreatelinkClose event. See Element.addListener for more information on listening for this event.
Parameters:
win <EditorWindow> The EditorWindow object
panel <Overlay> The Overlay object that is used to create the window.

windowCMDOpen

windowCMDOpen ( win , panel )
Dynamic event fired when an EditorWindow is opened.. The dynamic event is based on the name of the window. Example Window: createlink, opening this window would fire the windowcreatelinkOpen event. See Element.addListener for more information on listening for this event.
Parameters:
win <EditorWindow> The EditorWindow object
panel <Overlay> The Overlay object that is used to create the window.

windowCreateLinkRender

windowCreateLinkRender ( panel , body )
Event fired when the pre render of the Create Link window has finished.
Parameters:
panel <Overlay> The Overlay object that is used to create the window.
body <HTMLElement> The HTML element used as the body of the window..

windowInsertImageRender

windowInsertImageRender ( panel , body , toolbar )
Event fired when the pre render of the Insert Image window has finished.
Parameters:
panel <Overlay> The Overlay object that is used to create the window.
body <HTMLElement> The HTML element used as the body of the window..
toolbar <Toolbar> A reference to the toolbar object used inside this window.

windowRender

windowRender ( win , panel )
Event fired when the initial Overlay is rendered. Can be used to manipulate the content of the panel.
Parameters:
win <EditorWindow> The EditorWindow object
panel <Overlay> The Overlay object that is used to create the window.

Configuration Attributes

hiddencss - String

The CSS used to show/hide hidden elements on the page, these rules must be prefixed with the class provided in this.CLASS_HIDDEN
Default Value:
.yui-hidden font, .yui-hidden strong, .yui-hidden b, .yui-hidden em, .yui-hidden i, .yui-hidden u,
.yui-hidden div, .yui-hidden p, .yui-hidden span, .yui-hidden img, .yui-hidden ul, .yui-hidden ol,
.yui-hidden li, .yui-hidden table {
border: 1px dotted #ccc;
}
.yui-hidden .yui-non {
border: none;
}
.yui-hidden img {
padding: 2px;
}

localFileWarning - Boolean

Should we throw the warning if we detect a file that is local to their machine?
Default Value: true


Copyright © 2009 Yahoo! Inc. All rights reserved.