├── .gitignore ├── assets └── size_matter.png ├── src ├── nano.html ├── annotator.html ├── nano-bootstrap.html ├── nano-lib.html └── annotations.html ├── LICENSE.md ├── README.md ├── annotations.html └── nano.html /.gitignore: -------------------------------------------------------------------------------- 1 | node_modules/ 2 | -------------------------------------------------------------------------------- /assets/size_matter.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/googlearchive/nano/HEAD/assets/size_matter.png -------------------------------------------------------------------------------- /src/nano.html: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | -------------------------------------------------------------------------------- /LICENSE.md: -------------------------------------------------------------------------------- 1 | # License 2 | 3 | Everything in this repository is BSD style license unless otherwise specified. 4 | 5 | Copyright (c) 2016 The Polymer Authors. All rights reserved. 6 | 7 | Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 8 | 9 | * Redistributions of source code must retain the above copyright 10 | notice, this list of conditions and the following disclaimer. 11 | * Redistributions in binary form must reproduce the above 12 | copyright notice, this list of conditions and the following disclaimer 13 | in the documentation and/or other materials provided with the 14 | distribution. 15 | * Neither the name of Google Inc. nor the names of its 16 | contributors may be used to endorse or promote products derived from 17 | this software without specific prior written permission. 18 | 19 | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -------------------------------------------------------------------------------- /src/annotator.html: -------------------------------------------------------------------------------- 1 | 10 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | _Preliminary, experimental, incomplete, undocumented, and generally unsuitable for anything. Expect everything to change._ 2 | 3 | # nano library 4 | 5 | Tiny function library useful for Custom Elements. 6 | 7 | ![relative sizes](assets/size_matter.png) 8 | 9 | Custom Elements depend on bits of the Web Components standard platform itself. Specifically, CustomElements and HTMLImports feature support is expected. 10 | 11 | These features are natively available in Chrome, and otherwise supported by [web-componentsjs polyfills](https://github.com/webcomponents/webcomponentsjs). These elements do not depend on ShadowDOM, so [webcomponents-lite](https://polygit.org/components/webcomponentsjs/webcomponents.min.js) is sufficient. 12 | 13 | # Nano Manifesto 14 | 15 | ## Web Components are Good and True 16 | 17 | In all their aspects, including shadow-dom and the new recruit, css property-bags. 18 | 19 | ## Mindshare is Success 20 | 21 | Nuf said. 22 | 23 | ## Foundations 24 | 25 | ### Interoperability 26 | Large-scale reuse and sharing, utilize existing DOM contract. 27 | 28 | ### Platformophilia 29 | Use the Web Platform, embrace the DOM, avoid abstracting the surface or using as render-target. 30 | 31 | ## (Web) App Needs 32 | 33 | ### Performance 34 | 35 | - Payload Size 36 | - Time To First Paint (TTFP) 37 | - RAIL 38 | 39 | ### Other Features 40 | 41 | - Deep linking 42 | - i18n 43 | - a11y 44 | - Polish 45 | - Animation 46 | - Offline/Progressive/Applike (Fizzy) 47 | 48 | ### Code Cost Cutting 49 | 50 | - KISS 51 | - DRY 52 | - Reuse 53 | 54 | ### Maintenance Cost Cutting 55 | 56 | - KISS 57 | - Be nimble 58 | - Be expressive 59 | - Be readable 60 | - Be robust 61 | 62 | ## Can't Know What I Want Until I Have What I Need 63 | 64 | #### Platformophilia Can Satisfy Needs 65 | 66 | Custom Elements exposes DOM's fundamental power as a component-model. Component power enables us to surmount the Web App needs in a satisfying manner. 67 | 68 | #### Interoperability Will Fulfill Wants 69 | 70 | Once _making scoping work_ is less of a burden, it'll be easier to grasp the usefulness of the deep interoperability afforded by Shadow DOM. At that time the large-scale sharing afforded by the pure element interface will be attractive. 71 | 72 | 73 | 74 | 75 | 76 | 77 | -------------------------------------------------------------------------------- /src/nano-bootstrap.html: -------------------------------------------------------------------------------- 1 | 10 | 83 | -------------------------------------------------------------------------------- /annotations.html: -------------------------------------------------------------------------------- 1 | 10 | 11 | -------------------------------------------------------------------------------- /src/nano-lib.html: -------------------------------------------------------------------------------- 1 | 10 | 11 | 104 | -------------------------------------------------------------------------------- /nano.html: -------------------------------------------------------------------------------- 1 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | -------------------------------------------------------------------------------- /src/annotations.html: -------------------------------------------------------------------------------- 1 | 10 | --------------------------------------------------------------------------------