我们的志愿者还没有将这篇文章翻译为 中文 (简体)。加入我们帮助完成翻译！
您也可以阅读此文章的English (US)版。
Non-standard
This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.
The mozbrowsercaretstatechanged event is fired when the user selects content in a page loaded in a browser <iframe>. This is used by the embedder to show a context menu for clipboard actions.
General info
- Specification
- Non standard
- Interface
CustomEvent- Bubbles
- Yes
- Cancelable
- Yes
- Target
<iframe>- Default Action
- None
Properties
| Property | Type | Description |
|---|---|---|
target Read only |
EventTarget |
The browser iframe |
type Read only |
DOMString |
The type of event. |
bubbles Read only |
Boolean |
Whether the event normally bubbles or not |
cancelable Read only |
Boolean |
Whether the event is cancellable or not? |
details Read only |
object |
A custom object |
details
The details property returns an anonymous JavaScript object with the following properties:
- rect
- An object that defines information about the bounding rectangle of the current selection. Its properties are
width: The width of the bounding rectangle, in CSS pixels.height: The height of the bounding rectangle, in CSS pixels.top: The top position of the bounding rectangle, in CSS pixels.bottom: The bottom position of the bounding rectangle, in CSS pixels.left: The left position of the bounding rectangle, in CSS pixels.right: The right position of the bounding rectangle, in CSS pixels.
- commands
- An object that defines what commands can currently be executed in the browser
<iframe>. Its properties arecanSelectAll: ABooleanindicating whether theselectAllcommand is available (true) or not (false.)canCut: ABooleanindicating whether thecutcommand is available (true) or not (false.)canCopy: ABooleanindicating whether thecopycommand is available (true) or not (false.)canPaste: ABooleanindicating whether thepastecommand is available (true) or not (false.)
- reason
- A
DOMStringthat defines the reason for the state being changed. Possible values arevisibilitychange,updateposition,longpressonemptycontent,taponcaret,presscaret, andreleasecaret. - zoomFactor
- A number defining the current zoom factor in the browser
<iframe>. - collapsed
- A
Booleanindicating whether the current selection is collapsed (true) or not (false.) - caretVisible
- A
Booleanindicating whether the caret is currently visible (true) or not (false.) - selectionVisible
- A
Booleanindicating whether the current selection is visible (true) or not (false.) - selectionEditable
- A
Booleanindicating whether the current selection is editable (true) or not (false.) - selectedTextContext
- A
DOMStringcontaining the currently-selected text content. - sendDoCommandMsg
- A method allowing you to issue a command via an anonymouse function, i.e.
function(command). Possible values arecut,copy,pasteandselectAll.
Examples
var browser = document.querySelector("iframe");
browser.addEventListener("mozbrowsercaretstatechanged", function( event ) {
// do stuff with event.details
});
Related Events
mozbrowserclosemozbrowsercontextmenumozbrowsererrormozbrowsericonchangemozbrowserloadendmozbrowserloadstartmozbrowserlocationchangemozbrowseropenwindowmozbrowsersecuritychangemozbrowsertitlechangemozbrowserusernameandpasswordrequired