2013-12-17 14:12:33 +00:00
|
|
|
/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
|
|
|
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
|
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this file,
|
|
|
|
* You can obtain one at http://mozilla.org/MPL/2.0/.
|
|
|
|
*
|
|
|
|
* The origin of this IDL file is
|
|
|
|
* https://dvcs.w3.org/hg/editing/raw-file/tip/editing.html#concept-selection
|
|
|
|
*
|
|
|
|
* Copyright © 2012 W3C® (MIT, ERCIM, Keio), All Rights Reserved. W3C
|
|
|
|
* liability, trademark and document use rules apply.
|
|
|
|
*/
|
|
|
|
|
|
|
|
interface Selection {
|
2017-04-25 11:55:31 +00:00
|
|
|
readonly attribute Node? anchorNode;
|
2013-12-17 14:12:33 +00:00
|
|
|
readonly attribute unsigned long anchorOffset;
|
2017-04-25 11:55:31 +00:00
|
|
|
readonly attribute Node? focusNode;
|
2013-12-17 14:12:33 +00:00
|
|
|
readonly attribute unsigned long focusOffset;
|
2017-04-25 11:55:31 +00:00
|
|
|
readonly attribute boolean isCollapsed;
|
2018-03-27 04:35:22 +00:00
|
|
|
/**
|
|
|
|
* Returns the number of ranges in the selection.
|
|
|
|
*/
|
2013-12-17 14:12:33 +00:00
|
|
|
readonly attribute unsigned long rangeCount;
|
2017-08-03 14:13:24 +00:00
|
|
|
readonly attribute DOMString type;
|
2018-03-27 04:35:22 +00:00
|
|
|
/**
|
|
|
|
* Returns the range at the specified index. Throws if the index is
|
|
|
|
* out of range.
|
|
|
|
*/
|
2013-12-17 14:12:33 +00:00
|
|
|
[Throws]
|
2017-04-25 11:55:31 +00:00
|
|
|
Range getRangeAt(unsigned long index);
|
2018-03-27 04:35:22 +00:00
|
|
|
/**
|
|
|
|
* Adds a range to the current selection.
|
|
|
|
*/
|
2017-03-10 07:55:12 +00:00
|
|
|
[Throws, BinaryName="addRangeJS"]
|
2017-04-25 11:55:31 +00:00
|
|
|
void addRange(Range range);
|
2018-03-27 04:35:22 +00:00
|
|
|
/**
|
|
|
|
* Removes a range from the current selection.
|
|
|
|
*/
|
2013-12-17 14:12:33 +00:00
|
|
|
[Throws]
|
2017-04-25 11:55:31 +00:00
|
|
|
void removeRange(Range range);
|
2018-03-27 04:35:23 +00:00
|
|
|
/**
|
|
|
|
* Removes all ranges from the current selection.
|
|
|
|
*/
|
2013-12-17 14:12:33 +00:00
|
|
|
[Throws]
|
2017-04-25 11:55:31 +00:00
|
|
|
void removeAllRanges();
|
2017-04-25 12:49:27 +00:00
|
|
|
[Throws, BinaryName="RemoveAllRanges"]
|
|
|
|
void empty();
|
2017-04-25 11:55:31 +00:00
|
|
|
[Throws, BinaryName="collapseJS"]
|
|
|
|
void collapse(Node? node, optional unsigned long offset = 0);
|
2017-04-25 12:49:27 +00:00
|
|
|
[Throws, BinaryName="collapseJS"]
|
|
|
|
void setPosition(Node? node, optional unsigned long offset = 0);
|
2017-04-25 11:55:31 +00:00
|
|
|
[Throws, BinaryName="collapseToStartJS"]
|
|
|
|
void collapseToStart();
|
|
|
|
[Throws, BinaryName="collapseToEndJS"]
|
|
|
|
void collapseToEnd();
|
|
|
|
[Throws, BinaryName="extendJS"]
|
|
|
|
void extend(Node node, optional unsigned long offset = 0);
|
2017-03-10 07:55:12 +00:00
|
|
|
[Throws, BinaryName="setBaseAndExtentJS"]
|
2017-04-25 11:55:31 +00:00
|
|
|
void setBaseAndExtent(Node anchorNode,
|
|
|
|
unsigned long anchorOffset,
|
|
|
|
Node focusNode,
|
|
|
|
unsigned long focusOffset);
|
|
|
|
[Throws, BinaryName="selectAllChildrenJS"]
|
|
|
|
void selectAllChildren(Node node);
|
|
|
|
[CEReactions, Throws]
|
|
|
|
void deleteFromDocument();
|
|
|
|
[Throws]
|
|
|
|
boolean containsNode(Node node,
|
|
|
|
optional boolean allowPartialContainment = false);
|
|
|
|
stringifier DOMString ();
|
2013-12-17 14:12:33 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
// Additional methods not currently in the spec
|
|
|
|
partial interface Selection {
|
|
|
|
[Throws]
|
|
|
|
void modify(DOMString alter, DOMString direction,
|
|
|
|
DOMString granularity);
|
|
|
|
};
|
|
|
|
|
|
|
|
// Additional chrome-only methods from nsISelectionPrivate
|
|
|
|
interface nsISelectionListener;
|
|
|
|
partial interface Selection {
|
2018-05-08 17:52:37 +00:00
|
|
|
/**
|
|
|
|
* A true value means "selection after newline"; false means "selection before
|
|
|
|
* newline" when a selection is positioned "between lines".
|
|
|
|
*/
|
2013-12-17 14:12:33 +00:00
|
|
|
[ChromeOnly,Throws]
|
|
|
|
attribute boolean interlinePosition;
|
|
|
|
|
2015-05-22 04:37:16 +00:00
|
|
|
[Throws]
|
|
|
|
attribute short? caretBidiLevel;
|
|
|
|
|
2013-12-17 14:12:33 +00:00
|
|
|
[ChromeOnly,Throws]
|
|
|
|
DOMString toStringWithFormat(DOMString formatType, unsigned long flags, long wrapColumn);
|
2018-05-08 17:52:37 +00:00
|
|
|
[ChromeOnly]
|
2013-12-17 14:12:33 +00:00
|
|
|
void addSelectionListener(nsISelectionListener newListener);
|
2018-05-08 17:52:37 +00:00
|
|
|
[ChromeOnly]
|
2013-12-17 14:12:33 +00:00
|
|
|
void removeSelectionListener(nsISelectionListener listenerToRemove);
|
|
|
|
|
2016-06-11 02:06:37 +00:00
|
|
|
[ChromeOnly,BinaryName="rawType"]
|
2017-08-03 14:13:24 +00:00
|
|
|
readonly attribute short selectionType;
|
2013-12-17 14:12:33 +00:00
|
|
|
|
2018-05-08 17:52:38 +00:00
|
|
|
/**
|
|
|
|
* Return array of ranges intersecting with the given DOM interval.
|
|
|
|
*/
|
2013-12-17 14:12:33 +00:00
|
|
|
[ChromeOnly,Throws,Pref="dom.testing.selection.GetRangesForInterval"]
|
|
|
|
sequence<Range> GetRangesForInterval(Node beginNode, long beginOffset, Node endNode, long endOffset,
|
|
|
|
boolean allowAdjacent);
|
|
|
|
|
2018-05-08 17:52:38 +00:00
|
|
|
/**
|
|
|
|
* Scrolls a region of the selection, so that it is visible in
|
|
|
|
* the scrolled view.
|
|
|
|
*
|
|
|
|
* @param aRegion the region inside the selection to scroll into view
|
|
|
|
* (see selection region constants defined in
|
|
|
|
* nsISelectionController).
|
|
|
|
* @param aIsSynchronous when true, scrolls the selection into view
|
|
|
|
* before returning. If false, posts a request which
|
|
|
|
* is processed at some point after the method returns.
|
|
|
|
* @param aVPercent how to align the frame vertically.
|
|
|
|
* @param aHPercent how to align the frame horizontally.
|
|
|
|
*/
|
2013-12-17 14:12:33 +00:00
|
|
|
[ChromeOnly,Throws]
|
|
|
|
void scrollIntoView(short aRegion, boolean aIsSynchronous, short aVPercent, short aHPercent);
|
2017-05-10 14:48:50 +00:00
|
|
|
|
|
|
|
[ChromeOnly,Throws]
|
|
|
|
void setColors(DOMString aForegroundColor, DOMString aBackgroundColor,
|
|
|
|
DOMString aAltForegroundColor, DOMString aAltBackgroundColor);
|
|
|
|
|
|
|
|
[ChromeOnly,Throws]
|
|
|
|
void resetColors();
|
2013-12-17 14:12:33 +00:00
|
|
|
};
|