Obsolete
This feature is obsolete. Although it may still work in some browsers, its use is discouraged since it could be removed at any time. Try to avoid using it.
Non-standard
This feature is not on a current W3C standards track, but it is supported on the Firefox OS platform. Although implementations may change in the future and it is not supported widely across browsers, it is suitable for use in code dedicated to Firefox OS apps.
The mozbrowserselectionstatechanged event is fired when the text selected inside the browser <iframe> content changes. Note that this is deprecated, and current implementations should use mozbrowsercaretstatechanged instead.
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 |
Does the event normally bubble? |
cancelable Read only |
boolean |
Is it possible to cancel the event? |
details Read only |
object |
A custom object |
details
The details property returns an anonymous JavaScript object with the following properties:
- rect
- An object that represents the bounding rectangle of the selection. Its properties are:
width: The width of the selection, in CSS pixels.height: The height of the selection, in CSS pixels.top: The Y coordinate of the top of the bounding box, in CSS pixels.bottom: The Y coordinate of the bottom of the bounding box, in CSS pixels.left: The X coordinate of the left of the bounding box, in CSS pixels.right: The X coordinate of the right of the bounding box, in CSS pixels.
- commands
- An object that stores information about what commands can be executed on the current selection. Its properties are:
canSelectAll: ABooleanIndicating whether the select all command can be issued (true) or not (false).canCut: ABooleanIndicating whether the cut command can be issued (true) or not (false).canCopy: ABooleanIndicating whether the copy command can be issued (true) or not (false).canPaste: ABooleanIndicating whether the paste command can be issued (true) or not (false).
- zoomFactor
- A number representing the current zoom factor in the child frame. This is unitless and represents a percentage increase/decrease, e.g. 1.1 is a 10% zoom in, and 0.9% is a 10% zoom out.
- isCollapsed
- A
BooleanIndicating whether the current selection is collapsed (true) or not (false). - visible
- A
BooleanIndicating whether the current selection is visible (true) or not (false). - states
- The current state of the selection.
Example
var browser = document.querySelector("iframe");
browser.addEventListener("mozbrowserselectionstatechanged", function( event ) {
if(event.details.visible) {
console.log("The current selection is visible.");
} else {
console.log("The current selection is not visible.");
}
});
Related Events
mozbrowserasyncscrollmozbrowserclosemozbrowsercontextmenumozbrowsererrormozbrowsericonchangemozbrowserloadendmozbrowserloadstartmozbrowserlocationchangemozbrowseropenwindowmozbrowsertitlechangemozbrowserusernameandpasswordrequired