Talk:DOM:Selection

From MDC

Any reason this is called DOM:Selection_Class rather than simply DOM:Selection? --Maian 07:33, 15 October 2005 (PDT)

I'm not sure what the policy on method naming is for interfaces, but be warned that pages like DOM:Selection:toString may be moved to DOM:Selection.toString (":" => "."). --Maian 09:37, 18 October 2005 (PDT)

I filled in all but one page. One nit-pick. toString() is a method that returns a value. The "syntax" is shown like this:

returnValue = methodName(argument);

and the "Parameters" section describes returnValue. Is this appropriate? Is this better than the way I did all other methods that return a value? I'll change my pages as needed.--Jonnyq 07:20, 19 October 2005 (PDT)

The only other applicable page is getRangeAt(), and I changed that.

Many of the pages use the same terms such as "anchor", "focus" and "range". It might help if these terms are defined somewhere, such as the Summary of this page. Note that the term "range" is not exactly the same as a range object. "Anchor" refers to the beginning of a selection - the caret point when the user began the selection. "Focus" refers to the end point where the user ended the selection. Where should these terms be defined for clarity? Are there other terms? --Jonnyq 07:32, 19 October 2005 (PDT)

Under description or maybe a new "Glossary" or "Terminology" section below description. --Maian 08:01, 19 October 2005 (PDT)

[edit] deleteFromDocument

"Deletes the actual text..." isn't exactly correct. The nodes and parts of nodes that are selected are deleted. This can include text, images, and other bits. What sounds better? "Deletes the content of the selected ranges..."?--Jonnyq 13:58, 19 October 2005 (PDT)

How about "Deletes the selection's content from the document, including both text and element nodes." --Maian 21:00, 19 October 2005 (PDT)

How about "Deletes the selection's content from the document."? --Jonnyq

That'll do. --Maian 06:06, 20 October 2005 (PDT)

[edit] Category Information

There is currently no category information for this article. Am I right that this should be {{DomRef}}? --Andreas Wuest 13:36, 12 February 2006 (PST)

I think so --Nickolay 01:46, 13 February 2006 (PST)

Done. --Andreas Wuest 07:39, 13 February 2006 (PST)