nsIHTMLEditor 编辑

editor/idl/nsIHTMLEditor.idlScriptable Please add a summary to this article. Inherits from: nsISupports Last changed in Gecko 5.0 (Firefox 5.0 / Thunderbird 5.0 / SeaMonkey 2.2)

Method overview

void addDefaultProperty(in nsIAtom aProperty, in AString aAttribute, in AString aValue);

void addInsertionListener(in nsIContentFilter inFilter);

void align(in AString aAlign);

boolean breakIsVisible(in nsIDOMNode aNode);

boolean canDrag(in nsIDOMEvent aEvent);

void checkSelectionStateForAnonymousButtons(in nsISelection aSelection);

nsIDOMElement createAnonymousElement(in AString aTag, in nsIDOMNode aParentNode, in AString aAnonClass, in boolean aIsCreatedHidden);

nsIDOMElement createElementWithDefaults(in AString aTagName);

void decreaseFontSize();

void doDrag(in nsIDOMEvent aEvent);

void getAlignment(out boolean aMixed, out short aAlign);

AString getBackgroundColorState(out boolean aMixed);

nsIDOMElement getElementOrParentByTagName(in AString aTagName, in nsIDOMNode aNode);

AString getFontColorState(out boolean aMixed);

AString getFontFaceState(out boolean aMixed);

AString getHeadContentsAsHTML();

AString getHighlightColorState(out boolean aMixed);

void getIndentState(out boolean aCanIndent, out boolean aCanOutdent);

void getInlineProperty(in nsIAtom aProperty, in AString aAttribute, in AString aValue, out boolean aFirst, out boolean aAny, out boolean aAll);

AString getInlinePropertyWithAttrValue(in nsIAtom aProperty, in AString aAttribute, in AString aValue, out boolean aFirst, out boolean aAny, out boolean aAll);

nsISupportsArray getLinkedObjects();

void getListItemState(out boolean aMixed, out boolean aLI, out boolean aDT, out boolean aDD);

void getListState(out boolean aMixed, out boolean aOL, out boolean aUL, out boolean aDL);

AString getParagraphState(out boolean aMixed);

nsIDOMElement getSelectedElement(in AString aTagName);

nsIDOMElement getSelectionContainer();

void ignoreSpuriousDragEvent(in boolean aIgnoreSpuriousDragEvent);

void increaseFontSize();

void indent(in AString aIndent);

void insertElementAtSelection(in nsIDOMElement aElement, in boolean aDeleteSelection);

void insertFromDrop(in nsIDOMEvent aEvent);

void insertHTML(in AString aInputString);

void insertHTMLWithContext(in AString aInputString, in AString aContextStr, in AString aInfoStr, in AString aFlavor, in nsIDOMDocument aSourceDoc, in nsIDOMNode aDestinationNode, in long aDestinationOffset, in boolean aDeleteSelection);

void insertLinkAroundSelection(in nsIDOMElement aAnchorElement);

boolean isAnonymousElement(in nsIDOMElement aElement);

void makeOrChangeList(in AString aListType, in boolean entireList, in AString aBulletType);

boolean nodeIsBlock(in nsIDOMNode node);

void pasteNoFormatting(in long aSelectionType);

void rebuildDocumentFromSource(in AString aSourceString);

void removeAllDefaultProperties();

void removeAllInlineProperties();

void removeDefaultProperty(in nsIAtom aProperty, in AString aAttribute, in AString aValue);

void removeInlineProperty(in nsIAtom aProperty, in AString aAttribute);

void removeInsertionListener(in nsIContentFilter inFilter);

void removeList(in AString aListType);

void replaceHeadContentsWithHTML(in AString aSourceToInsert);

void selectElement(in nsIDOMElement aElement);

void setBackgroundColor(in AString aColor);

void setBodyAttribute(in AString aAttr, in AString aValue);

void setCaretAfterElement(in nsIDOMElement aElement);

void setCSSInlineProperty(in nsIAtom aProperty, in AString aAttribute, in AString aValue);

void setDocumentTitle(in AString aTitle);

void setInlineProperty(in nsIAtom aProperty, in AString aAttribute, in AString aValue);

void setParagraphFormat(in AString aParagraphFormat);

void updateBaseURL();

Attributes

Attribute	Type	Description
isCSSEnabled	boolean	A boolean which is true is the HTMLEditor has been instantiated with CSS knowledge and if the CSS pref is currently checked.
returnInParagraphCreatesNewParagraph	boolean	A boolean indicating if a return key pressed in a paragraph creates another paragraph or just inserts a <br> at the caret.

Constants

Constant	Value	Description
eLeft	0
eCenter	1
eRight	2
eJustify	3

Methods

addDefaultProperty()

Registers a default style property with the editor.

void addDefaultProperty(
  in nsIAtom aProperty,
  in AString aAttribute,
  in AString aValue
);

Parameters

aProperty

The property to set by default.

aAttribute

The attribute of the property, if applicable. May be null. Example: aProperty="font", aAttribute="color"

aValue

If aAttribute is not null, the value of the attribute. Example: aProperty="font", aAttribute="color", aValue="0x00FFFF"

addInsertionListener()

Add listener for insertion override.

void addInsertionListener(
  in nsIContentFilter inFilter
);

Parameters

inFilter

Function which callers want called during insertion.

align()

Document me!

void align(
  in AString aAlign
);

Parameters

aAlign

 

breakIsVisible()

Checks whether a BR node is visible to the user.

boolean breakIsVisible(
  in nsIDOMNode aNode
);

Parameters

aNode

 

Return value

 

canDrag()

Decides if a drag should be started (for example, based on the current selection and mousepoint).

boolean canDrag(
  in nsIDOMEvent aEvent
);

Parameters

aEvent

 

Return value

 

checkSelectionStateForAnonymousButtons()

Checks if the anonymous nodes created by the HTML editor have to be refreshed or hidden depending on a possible new state of the selection.

void checkSelectionStateForAnonymousButtons(
  in nsISelection aSelection
);

Parameters

aSelection

A selection.

createAnonymousElement()

Returns an anonymous nsDOMElement of type aTag, child of aParentNode. If aIsCreatedHidden is true, the class "hidden" is added to the created element. If aAnonClass is not the empty string, it becomes the value of the attribute "_moz_anonclass"

nsIDOMElement createAnonymousElement(
  in AString aTag,
  in nsIDOMNode aParentNode,
  in AString aAnonClass,
  in boolean aIsCreatedHidden
);

Parameters

aTag

A string representing the desired type of the element to create.

aParentNode

The parent node of the created anonymous element.

aAnonClass

Contents of the _moz_anonclass attribute.

aIsCreatedHidden

A boolean specifying if the class "hidden" is to be added to the created anonymous element.

Return value

A DOM Element.

createElementWithDefaults()

Return a new element with default attribute values.

This does not rely on the selection, and is not sensitive to context.

Used primarily to supply new element for various insert element dialogs (Image, Link, Table, and HorizontalRule are the only returned elements as of 9/12/18); NamedAnchor was removed in Firefox 63.

nsIDOMElement createElementWithDefaults(
  in AString aTagName
);

Parameters

aTagName

The HTML tagname. Special input value for Links: Use "href" to get a link node (an "A" tag with the "href" attribute set)

Return value

The new element created.

decreaseFontSize()

Decrease font size for text in selection by 1 HTML unit All existing text is scanned for existing <FONT SIZE> attributes so they will be decreased instead of inserting new <FONT> tag.

void decreaseFontSize();

Parameters

None.

doDrag()

Transfers the relevant data (as appropriate) to a transferable so it can later be dropped.

void doDrag(
  in nsIDOMEvent aEvent
);

Parameters

aEvent

 

getAlignment()

Returns what alignment is in the selection.

void getAlignment(
  out boolean aMixed,
  out short aAlign
);

Parameters

aMixed

true if there is more than one type of list item, or if there is some list and non-list.

aAlign

Enum value for first encountered alignment (left/center/right)

getBackgroundColorState()

getFontColorState() returns what font face is in the selection.

AString getBackgroundColorState(
  out boolean aMixed
);

Parameters

aMixed

true if there is more than one font color.

Return value

Color string. "" is returned for none.

getElementOrParentByTagName()

Return the input node or a parent matching the given aTagName, starting the search at the supplied node. An example of use is for testing if a node is in a table cell given a selection anchor node.

nsIDOMElement getElementOrParentByTagName(
  in AString aTagName,
  in nsIDOMNode aNode
);

Parameters

aTagName

The HTML tagname Special input values: Use "href" to get a link node (an "A" tag with the "href" attribute set) Use "list" to get an OL, UL, or DL list node Use "td" to get either a TD or TH cell node.

aNode

The node in the document to start the search. If it is null, the anchor node of the current selection is used.

Return value

NS_EDITOR_ELEMENT_NOT_FOUND if an element is not found (passes NS_SUCCEEDED macro)

getFontColorState()

Returns what font face is in the selection.

AString getFontColorState(
  out boolean aMixed
);

Parameters

aMixed

true if there is more than one font color.

Return value

Color string. "" is returned for none.

getFontFaceState()

Returns what font face is in the selection.

AString getFontFaceState(
  out boolean aMixed
);

Parameters

aMixed

true if there is more than one font face.

Return value

Name of face. Note: "tt" is returned for tt tag. "" is returned for none.

getHeadContentsAsHTML()

Output the contents of the <HEAD> section as text/HTML format.

AString getHeadContentsAsHTML();

Parameters

None.

Return value

 

getHighlightColorState()

Returns what the highlight color of the selection.

AString getHighlightColorState(
  out boolean aMixed
);

Parameters

aMixed

true if there is more than one font color.

Return value

Color string. "" is returned for none.

getIndentState()

Document me!

void getIndentState(
  out boolean aCanIndent,
  out boolean aCanOutdent
);

Parameters

aCanIndent

 

aCanOutdent

 

getInlineProperty()

Gets aggregate properties of the current selection. All object in the current selection are scanned and their attributes are represented in a list of Property object.

void getInlineProperty(
  in nsIAtom aProperty,
  in AString aAttribute,
  in AString aValue,
  out boolean aFirst,
  out boolean aAny,
  out boolean aAll
);

Parameters

aProperty

The property to get on the selection.

aAttribute

The attribute of the property, if applicable. May be null. Example: aProperty="font", aAttribute="color"

aValue

If aAttribute is not null, the value of the attribute. May be null. Example: aProperty="font", aAttribute="color", aValue="0x00FFFF"

aFirst

PR_TRUE if the first text node in the selection has the property.

aAny

PR_TRUE if any of the text nodes in the selection have the property.

aAll

PR_TRUE if all of the text nodes in the selection have the property.

getInlinePropertyWithAttrValue()

AString getInlinePropertyWithAttrValue(
  in nsIAtom aProperty,
  in AString aAttribute,
  in AString aValue,
  out boolean aFirst,
  out boolean aAny,
  out boolean aAll
);

Parameters

aProperty

 

aAttribute

 

aValue

 

aFirst

 

aAny

 

aAll

 

Return value

 

getLinkedObjects()

Find all the nodes in the document which contain references to outside URIs (for example a href, img src, script src, and so on.) The objects in the array will be type nsIURIRefObject.

nsISupportsArray getLinkedObjects();

Parameters

None.

Return value

ANodeList the linked nodes found.

getListItemState()

getListItemState returns what list item type is in the selection.

void getListItemState(
  out boolean aMixed,
  out boolean aLI,
  out boolean aDT,
  out boolean aDD
);

Parameters

aMixed

true if there is more than one type of list item, or if there is some list and non-list.

aLI

true if "li" list items are selected.

aDT

true if "dt" list items are selected.

aDD

true if "dd" list items are selected.

getListState()

Returns what list type is in the selection.

void getListState(
  out boolean aMixed,
  out boolean aOL,
  out boolean aUL,
  out boolean aDL
);

Parameters

aMixed

true if there is more than one type of list, or if there is some list and non-list.

aOL

The company that employs me. No, really, it is true if an "ol" list is selected.

aUL

true if an "ul" list is selected.

aDL

true if a "dl" list is selected.

getParagraphState()

Returns what block tag paragraph format is in the selection.

AString getParagraphState(
  out boolean aMixed
);

Parameters

aMixed

true if there is more than one format.

Return value

Name of block tag. "" is returned for none.

getSelectedElement()

Return an element only if it is the only node selected, such as an image, horizontal rule, and so on. The exception is a link, which is more like a text attribute: The Anchor tag is returned if the selection is within the textnode(s) that are children of the "A" node. This could be a collapsed selection, that is, a caret within the link text.

nsIDOMElement getSelectedElement(
  in AString aTagName
);

Parameters

aTagName

The HTML tagname or and empty string to get any element (but only if it is the only element selected). Special input values for Links: Use "href" to get a link node (an "A" tag with the "href" attribute set).

Return value

NS_EDITOR_ELEMENT_NOT_FOUND if an element is not found (passes NS_SUCCEEDED macro)

getSelectionContainer()

Returns the deepest container of the selection.

nsIDOMElement getSelectionContainer();

Parameters

None.

Return value

A DOM Element.

ignoreSpuriousDragEvent()

Used to suppress spurious drag/drop events to workaround bug 50703. Do not use this method! It will go away after first release!

void ignoreSpuriousDragEvent(
  in boolean aIgnoreSpuriousDragEvent
);

Parameters

aIgnoreSpuriousDragEvent

 

increaseFontSize()

Increase font size for text in selection by 1 HTML unit All existing text is scanned for existing <FONT SIZE> attributes so they will be incremented instead of inserting new <FONT> tag.

void increaseFontSize();

Parameters

None.

indent()

Document me!

void indent(
  in AString aIndent
);

Parameters

aIndent

 

insertElementAtSelection()

Insert an element, which may have child nodes, at the selection Used primarily to insert a new element for various insert element dialogs, but it enforces the HTML 4.0 DTD "CanContain" rules, so it should be useful for other elements.

void insertElementAtSelection(
  in nsIDOMElement aElement,
  in boolean aDeleteSelection
);

Parameters

aElement

The element to insert.

aDeleteSelection

Delete the selection before inserting If aDeleteSelection is PR_FALSE, then the element is inserted after the end of the selection for all element except Named Anchors, which insert before the selection.

insertFromDrop()

Looks for a dragsession and inserts the relevant data in response to a drop.

void insertFromDrop(
  in nsIDOMEvent aEvent
);

Parameters

aEvent

 

insertHTML()

Insert some HTML source at the current location.

void insertHTML(
  in AString aInputString
);

Parameters

aInputString

The string to be inserted.

insertHTMLWithContext()

Insert some HTML source, interpreting the string argument according to the given context.

void insertHTMLWithContext(
  in AString aInputString,
  in AString aContextStr,
  in AString aInfoStr,
  in AString aFlavor,
  in nsIDOMDocument aSourceDoc,
  in nsIDOMNode aDestinationNode,
  in long aDestinationOffset,
  in boolean aDeleteSelection
);

Parameters

aInputString

The string to be inserted.

aContextStr

Context of insertion.

aInfoStr

Related info to aInputString.

aFlavor

Transferable flavor, can be ""

aSourceDoc

Document where input was dragged from (may be null)

aDestinationNode

Location for insertion (such as when dropped)

aDestinationOffset

Used with aDestNode to determine insert location.

aDeleteSelection

Used with aDestNode during drag&drop.

insertLinkAroundSelection()

Insert an link element as the parent of the current selection.

void insertLinkAroundSelection(
  in nsIDOMElement aAnchorElement
);

Parameters

aAnchorElement

 

isAnonymousElement()

boolean isAnonymousElement(
  in nsIDOMElement aElement
);

Parameters

aElement

 

Return value

 

makeOrChangeList()

void makeOrChangeList(
  in AString aListType,
  in boolean entireList,
  in AString aBulletType
);

Parameters

aListType

 

entireList

 

aBulletType

 

nodeIsBlock()

Tests if a node is a BLOCK element according the the HTML 4.0 DTD. This does NOT consider CSS effect on display type.

boolean nodeIsBlock(
  in nsIDOMNode node
);

Parameters

node

 

Return value

 

pasteNoFormatting()

Paste the text in the OS clipboard at the cursor position, replacing the selected text (if any), but strip out any HTML styles and formatting.

void pasteNoFormatting(
  in long aSelectionType
);

Parameters

aSelectionType

 

rebuildDocumentFromSource()

Rebuild the entire document from source HTML Needed to be able to edit HEAD and other outside-of-BODY content.

void rebuildDocumentFromSource(
  in AString aSourceString
);

Parameters

aSourceString

HTML source string of the entire new document.

removeAllDefaultProperties()

Unregisters all default style properties with the editor.

void removeAllDefaultProperties();

Parameters

None.

removeAllInlineProperties()

Deletes all the inline properties from all text in the current selection.

void removeAllInlineProperties();

Parameters

None.

removeDefaultProperty()

Unregisters a default style property with the editor.

void removeDefaultProperty(
  in nsIAtom aProperty,
  in AString aAttribute,
  in AString aValue
);

Parameters

aProperty

The property to remove from defaults.

aAttribute

The attribute of the property, if applicable. May be null. Example: aProperty="font", aAttribute="color"

aValue

If aAttribute is not null, the value of the attribute. Example: aProperty="font", aAttribute="color", aValue="0x00FFFF"

removeInlineProperty()

Deletes the properties from all text in the current selection. If aProperty is not set on the selection, nothing is done.

void removeInlineProperty(
  in nsIAtom aProperty,
  in AString aAttribute
);

Parameters

aProperty

The property to remove from the selection All atoms are for normal HTML tags (for example nsIEditorProperty.font()) except when you want to remove just links and not named anchors. For that, use nsIEditorProperty.href().

aAttribute

The attribute of the property, if applicable. May be null. Example: aProperty=nsIEditorProptery.font(), aAttribute="color" nsIEditProperty.allAttributes() is special. It indicates that all content-based text properties are to be removed from the selection.

removeInsertionListener()

Remove listener for insertion override.

void removeInsertionListener(
  in nsIContentFilter inFilter
);

Parameters

inFilter

Function which callers do not want called during insertion.

removeList()

Document me!

void removeList(
  in AString aListType
);

Parameters

aListType

 

replaceHeadContentsWithHTML()

Replace all children of <HEAD> with string of HTML source.

void replaceHeadContentsWithHTML(
  in AString aSourceToInsert
);

Parameters

aSourceToInsert

 

selectElement()

Set the selection at the suppled element.

void selectElement(
  in nsIDOMElement aElement
);

Parameters

aElement

An element in the document.

setBackgroundColor()

Set the value of the "bgcolor" attribute on the document's <body> element.

void setBackgroundColor(
  in AString aColor
);

Parameters

aColor

The HTML color string, such as "#ffccff" or "yellow"

setBodyAttribute()

Set an attribute on the document's <body> element such as text, link, background colors.

void setBodyAttribute(
  in AString aAttr,
  in AString aValue
);

Parameters

aAttr

The attribute to be set.

aValue

The value of the attribute.

setCaretAfterElement()

Create a collapsed selection just after aElement.

The selection is set to parent-of-aElement with an offset 1 greater than aElement's offset but it enforces the HTML 4.0 DTD "CanContain" rules, so it should be useful for other elements.

void setCaretAfterElement(
  in nsIDOMElement aElement
);

Parameters

aElement

An element in the document.

setCSSInlineProperty()

SetInlineProperty() sets the aggregate properties on the current selection.

void setCSSInlineProperty(
  in nsIAtom aProperty,
  in AString aAttribute,
  in AString aValue
);

Parameters

aProperty

The property to set on the selection.

aAttribute

The attribute of the property, if applicable. May be null. Example: aProperty="font", aAttribute="color"

aValue

If aAttribute is not null, the value of the attribute. May be null. Example: aProperty="font", aAttribute="color", aValue="0x00FFFF"

setDocumentTitle()

Set the documents title.

void setDocumentTitle(
  in AString aTitle
);

Parameters

aTitle

 

setInlineProperty()

void setInlineProperty(
  in nsIAtom aProperty,
  in AString aAttribute,
  in AString aValue
);

Parameters

aProperty

 

aAttribute

 

aValue

 

setParagraphFormat()

Insert a block paragraph tag around selection.

void setParagraphFormat(
  in AString aParagraphFormat
);

Parameters

aParagraphFormat

"p", "h1" to "h6", "address", "pre", or "blockquote"

updateBaseURL()

Set the BaseURL for the document to the current URL but only if the page doesn't have a <base> tag This should be done after the document URL has changed, such as after saving a file This is used as base for relativizing link and image urls.

void updateBaseURL();

Parameters

None.