Initial commit

Author: bgirard

CONTRIBUTING.md

@@ -0,0 +1,23 @@
+# Web Platform Incubator Community Group
+
+This repository is being used for work in the Web Platform Incubator Community Group, governed by the [W3C Community License 
+Agreement (CLA)](http://www.w3.org/community/about/agreements/cla/). To contribute, you must join 
+the CG. 
+
+If you are not the sole contributor to a contribution (pull request), please identify all 
+contributors in the pull request's body or in subsequent comments.
+
+To add a contributor (other than yourself, that's automatic), mark them one per line as follows:
+
+```
++@github_username
+```
+
+If you added a contributor by mistake, you can remove them in a comment with:
+
+```
+-@github_username
+```
+
+If you are making a pull request on behalf of someone else but you had no part in designing the 
+feature, you can remove yourself with the above syntax.

LICENSE.md

@@ -0,0 +1,5 @@
+All Reports in this Repository are licensed by Contributors under the 
+[W3C Software and Document
+License](http://www.w3.org/Consortium/Legal/2015/copyright-software-and-document). Contributions to
+Specifications are made under the [W3C CLA](https://www.w3.org/community/about/agreements/cla/).
+

README.md

@@ -0,0 +1,41 @@
+# Boundary Scroll Action
+---
+
+# Problem
+
+Scroll chaining is the process of propagating the scroll to the the nearest scrollable parent element once an scrollable reaches its limit. Scroll chaining is not always desirable. For example consider a fixed/absolute position scroller whose scroll should not chain to parent scroller i.e., the document. You can find this UX pattern used in most chat boxes that live at the bottom of the page such as in Facebook or Gmail UI.
+
+To give you a sense of how popular preventing scroll chaining may be, according to my quick http-archive search -ms-scroll-chaining: none is used in 0.4% of top 300K pages despite being limited in functionality and only supported on IE/Edge.
+
+# Current Solution
+
+-ms-scroll-chaining is a vendor specific API. The CSS property provides a simple declarative way to prevent propagation of scroll gestures to parent containers but unfortunately it is only limited to touch/touchpad scrolls.
+
+This means that currently the best cross-browser compatible way to prevent scroll propagation is to have a combination of blocking wheel event listener (bad for performance), blocking keyboard listeners for all scroll inducing keys, carefully crafted touch-action values, and perhaps even -ms-scroll-chaining. These are rather ugly and complex hacks that "-ms-scroll-chaining" should have been able to replace but it cannot in its current form.
+
+# Proposal
+
+The current proposal is a summary of the public discussion from:
+https://github.com/w3c/csswg-drafts/issues/769
+
+Introduce a new CSS property to control the scrolling behavior once a scrollable element reaches the boundary of the scrollport. This property will allow the author to hint that the user agent should deny scrolling from being chained to any ancestor. Note that for certain input modes, particularly on devices with a limited screen size and limited alternative input modes, the user agent may ignore the hint and allow scroll chaining to some ancestor, like the document viewport, or all ancestor.
+
+The property can also hint at the overscroll behavior that the browser should take when at the boundary of the scrollport. The overscroll behavior is implementor defined. The property should provide a hint to either allow or disallow the overscroll behavior of the user agent.
+
+The proposal for the syntax is:
+```
+croll-boundary-behavior{-x,-y}: auto | contain | none
+```
+
+where:
+  auto - Allow the default behavior for the user agent.
+  contain - Hint to disable scroll chaining. The user agent may show an appropriate overscroll affordance. If the scroll chaining would trigger a non-scroll action, such as a navigation action, this property should be a hint to disable it.
+  none - Same as contain but also hint that no overscroll affordance should be triggered.
+
+This should apply to all, non-programatic, user scroll actions.
+
+# Issues to file
+
+Should the property disable scroll chaining through itself to an ancestor if scrolling is initiated from a children.
+What if the property is attached to a potentially scrollable element without a scrollbox?
+What if the property is attached to a non-potentially scrollable element?