W3C home > Mailing lists > Public > www-style@w3.org > October 2011

[css3-regions] more API for NameFlow

From: Alex Mogilevsky <alexmog@microsoft.com>
Date: Mon, 17 Oct 2011 03:57:09 +0000
To: www-style list <www-style@w3.org>
Message-ID: <D51C9E849DDD0D4EA38C2E5398569284122AE6B8@TK5EX14MBXC218.redmond.corp.microsoft.com>
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?

Thanks
Alex
Received on Monday, 17 October 2011 03:57:42 GMT

This archive was generated by hypermail 2.3.1 : Tuesday, 26 March 2013 17:20:45 GMT