122580 - No documentation for selection object

Status: RESOLVED FIXED

(Documentation Graveyard :: Web Developer, defect)

Description

[Robert Kieffer]

There's no documentation for the selection object.  Specific questions to answer:

- What do I get when I call window.getSelection()? (What's the API?)
- How do I get the html of the current selection?  (ala IE's
document.selection.createRange().htmlText)
- How do I set the HTML for the selection? (ala IE's
document.selection.createRange().pasteHTML())

See http://lxr.mozilla.org/seamonkey/source/content/base/public/nsISelection.idl
Note that the JavaDoc in the IDL file for getRangeAt() aren't clear enough? 
Index? Index of what?

See also IE's
http://msdn.microsoft.com/workshop/author/dhtml/reference/objects/obj_selection.asp

See also IE's

Comment 1

[rudman]

Reassigning to oeschger.

Ian, is this covered in the DOM documentation? Could you provide a pointer? Thanks.

Comment 2

[Ian Oeschger (gone)]

Dylan is working on Selection interface descriptions. Dylan--hope you don't mind
me assigning this to you. Trying to clean up my bug list a little

Comment 3

[Dylan Schiemann]

Accepted.  I'll be able to start on this once I finish the Range docs, likely 
within two weeks.

Comment 4

[Chris Casciano]

Dylan, Have you done anything with this?

Comment 5

[Daniel Wang]

-> Doron

Comment 6

[Dylan Schiemann]

Sorry for the late reply... was travelling for much of the past two months. 
There was talk of redoing the format and structure of the domref, so I had been
holding off until that had been decided, and never got back to it.  I can help
with this now if wanted/needed.

Comment 7

[Florian Scholz (Open Web Docs)]

https://developer.mozilla.org/en/DOM/window.getSelection
https://developer.mozilla.org/en/DOM/Selection
https://developer.mozilla.org/en/DOM/range