[whatwg] Proposed updates for the command API's
dav.glass at yahoo.com
Wed Aug 13 07:46:26 PDT 2008
----- Original Message ----
From: Ian Hickson <ian at hixie.ch>
> > * ModifiedNodes - I think this would be better as a separate API, maybe
> > "queryCommandAffected()" or something, that returns the collection.
> > Also, maybe it should return a range rather than a collection. What is
> > the use case? (How and why would you actually use this?)
> The use case is outlined here:
> That's not a use case, it's an example of how it would work. By "use
> case", I mean, _why_ would you ever use this? What problem is it solving?
> The main issue with a range, is overlapping elements, that's why I would
> opt for a collection :)
> I don't understand, could you elaborate? Presumably which is more useful
> would depend primarily on the reason behind the feature, so maybe I need
> to have a clearer picture of the use case before I can really figure out
> whether a collection or a range is a better thing to return.
This would allow the developer the ability to easily add new functionality.
If I wanted to make a button that took the selection, and opened a more info window for extra data (just a simple example).
this method, I could add a class to the selection. Then open a more
info window, which would force the selection to be removed (that I
But I have access to all the items that it
modified, not just the range that it changed. Since I have access to
all of the nodes that changed, I can manipulate them after the
selection has been removed and focus has been lost.
Then when I am finished, I can use my cached data from the selection to create the selection again.
a selection object gives you the data about some of the elements, but
not all of the containing elements (especially in the situation I have
as an example on the site).
There is also the use case of
someone selecting part of a node (like in between tags) and executing a
command, some commands will auto select the node others won't.
The modifiedNodes command would allow us to get that data.
Does all that make sense?
More information about the whatwg