Re: [css3-regions] more API for NameFlow

On Oct 16, 2011, at 11:57 PM, Alex Mogilevsky wrote:

I have ACTION 350 ( http://www.w3.org/Style/CSS/Tracker/actions/350 ) assigned to me, which is titled “Alexmog to add an api to find out which element is in a named flow”. I actually thought it is about another missing API – to get region from element, but I guess both are needed, so here we go:


[Supplemental] interface NamedFlow<http://dev.w3.org/csswg/css3-regions/Overview.html#dom-namedflow> {

  NodeList<http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-536297177> content;

  NodeList<http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-536297177> getRegionsByContent(Node<http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-1950641247> node);

};


‘content’ property returns an ordered collection of nodes that constitute the named flow. Note that this collection is life (general DOM rules for properties): every time it is queried it must return the same object, and the object is always up to date.

getRegionsByContent () gets a collection of regions that contain at least part of the target content. This can be used to navigate by bookmark in paginated view: the method returns regions containing the bookmarked element, which are then passed to pagination UI to show desired region or page.

How does this sound? Any better naming ideas?

This sounds good and it is good to have a live list of nodes in the flow.

In terms of naming, I am wondering if 'content' is too generic. May be 'flowNode' would be more specific, even though more verbose:

[Supplemental] interface NamedFlow {
NodeList flowNodes;
NodeList getRegionsByFlowNode(Node flowNode);
}

Cheers,
Vincent