mozbrowserselectionstatechanged 编辑

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 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 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

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: A Boolean Indicating whether the select all command can be issued (true) or not (false).
• canCut: A Boolean Indicating whether the cut command can be issued (true) or not (false).
• canCopy: A Boolean Indicating whether the copy command can be issued (true) or not (false).
• canPaste: A Boolean Indicating 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 Boolean Indicating whether the current selection is collapsed (true) or not (false).

visible

A Boolean Indicating 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

• mozbrowserasyncscroll
• mozbrowserclose
• mozbrowsercontextmenu
• mozbrowsererror
• mozbrowsericonchange
• mozbrowserloadend
• mozbrowserloadstart
• mozbrowserlocationchange
• mozbrowseropenwindow
• mozbrowsertitlechange
• mozbrowserusernameandpasswordrequired

See also

• Using the Browser API