├── CONTRIBUTING.md ├── LICENSE └── README.md /CONTRIBUTING.md: -------------------------------------------------------------------------------- 1 | # Contribution Guidelines 2 | 3 | Search previous suggestions before making a new one. 4 | 5 | Please ensure your pull request adheres to the following guidelines: 6 | 7 | - Use the following format: [Website Name](Link to website) - Brief description of what it is and, preferably, why it is awesome. 8 | - Use [title-casing](https://capitalizemytitle.com/). 9 | - Drop `A`/`An` from the beginning of a description. 10 | - Link additions should be added to the relevant category in **alphabetical order**. 11 | - New categories or improvements to the existing categorization are welcome. 12 | - Check your spelling and grammar. 13 | - The pull request and commit should have a useful title. 14 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | Creative Commons Legal Code 2 | 3 | CC0 1.0 Universal 4 | 5 | CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE 6 | LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN 7 | ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS 8 | INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES 9 | REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS 10 | PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM 11 | THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED 12 | HEREUNDER. 13 | 14 | Statement of Purpose 15 | 16 | The laws of most jurisdictions throughout the world automatically confer 17 | exclusive Copyright and Related Rights (defined below) upon the creator 18 | and subsequent owner(s) (each and all, an "owner") of an original work of 19 | authorship and/or a database (each, a "Work"). 20 | 21 | Certain owners wish to permanently relinquish those rights to a Work for 22 | the purpose of contributing to a commons of creative, cultural and 23 | scientific works ("Commons") that the public can reliably and without fear 24 | of later claims of infringement build upon, modify, incorporate in other 25 | works, reuse and redistribute as freely as possible in any form whatsoever 26 | and for any purposes, including without limitation commercial purposes. 27 | These owners may contribute to the Commons to promote the ideal of a free 28 | culture and the further production of creative, cultural and scientific 29 | works, or to gain reputation or greater distribution for their Work in 30 | part through the use and efforts of others. 31 | 32 | For these and/or other purposes and motivations, and without any 33 | expectation of additional consideration or compensation, the person 34 | associating CC0 with a Work (the "Affirmer"), to the extent that he or she 35 | is an owner of Copyright and Related Rights in the Work, voluntarily 36 | elects to apply CC0 to the Work and publicly distribute the Work under its 37 | terms, with knowledge of his or her Copyright and Related Rights in the 38 | Work and the meaning and intended legal effect of CC0 on those rights. 39 | 40 | 1. Copyright and Related Rights. A Work made available under CC0 may be 41 | protected by copyright and related or neighboring rights ("Copyright and 42 | Related Rights"). Copyright and Related Rights include, but are not 43 | limited to, the following: 44 | 45 | i. the right to reproduce, adapt, distribute, perform, display, 46 | communicate, and translate a Work; 47 | ii. moral rights retained by the original author(s) and/or performer(s); 48 | iii. publicity and privacy rights pertaining to a person's image or 49 | likeness depicted in a Work; 50 | iv. rights protecting against unfair competition in regards to a Work, 51 | subject to the limitations in paragraph 4(a), below; 52 | v. rights protecting the extraction, dissemination, use and reuse of data 53 | in a Work; 54 | vi. database rights (such as those arising under Directive 96/9/EC of the 55 | European Parliament and of the Council of 11 March 1996 on the legal 56 | protection of databases, and under any national implementation 57 | thereof, including any amended or successor version of such 58 | directive); and 59 | vii. other similar, equivalent or corresponding rights throughout the 60 | world based on applicable law or treaty, and any national 61 | implementations thereof. 62 | 63 | 2. Waiver. To the greatest extent permitted by, but not in contravention 64 | of, applicable law, Affirmer hereby overtly, fully, permanently, 65 | irrevocably and unconditionally waives, abandons, and surrenders all of 66 | Affirmer's Copyright and Related Rights and associated claims and causes 67 | of action, whether now known or unknown (including existing as well as 68 | future claims and causes of action), in the Work (i) in all territories 69 | worldwide, (ii) for the maximum duration provided by applicable law or 70 | treaty (including future time extensions), (iii) in any current or future 71 | medium and for any number of copies, and (iv) for any purpose whatsoever, 72 | including without limitation commercial, advertising or promotional 73 | purposes (the "Waiver"). Affirmer makes the Waiver for the benefit of each 74 | member of the public at large and to the detriment of Affirmer's heirs and 75 | successors, fully intending that such Waiver shall not be subject to 76 | revocation, rescission, cancellation, termination, or any other legal or 77 | equitable action to disrupt the quiet enjoyment of the Work by the public 78 | as contemplated by Affirmer's express Statement of Purpose. 79 | 80 | 3. Public License Fallback. Should any part of the Waiver for any reason 81 | be judged legally invalid or ineffective under applicable law, then the 82 | Waiver shall be preserved to the maximum extent permitted taking into 83 | account Affirmer's express Statement of Purpose. In addition, to the 84 | extent the Waiver is so judged Affirmer hereby grants to each affected 85 | person a royalty-free, non transferable, non sublicensable, non exclusive, 86 | irrevocable and unconditional license to exercise Affirmer's Copyright and 87 | Related Rights in the Work (i) in all territories worldwide, (ii) for the 88 | maximum duration provided by applicable law or treaty (including future 89 | time extensions), (iii) in any current or future medium and for any number 90 | of copies, and (iv) for any purpose whatsoever, including without 91 | limitation commercial, advertising or promotional purposes (the 92 | "License"). The License shall be deemed effective as of the date CC0 was 93 | applied by Affirmer to the Work. Should any part of the License for any 94 | reason be judged legally invalid or ineffective under applicable law, such 95 | partial invalidity or ineffectiveness shall not invalidate the remainder 96 | of the License, and in such case Affirmer hereby affirms that he or she 97 | will not (i) exercise any of his or her remaining Copyright and Related 98 | Rights in the Work or (ii) assert any associated claims and causes of 99 | action with respect to the Work, in either case contrary to Affirmer's 100 | express Statement of Purpose. 101 | 102 | 4. Limitations and Disclaimers. 103 | 104 | a. No trademark or patent rights held by Affirmer are waived, abandoned, 105 | surrendered, licensed or otherwise affected by this document. 106 | b. Affirmer offers the Work as-is and makes no representations or 107 | warranties of any kind concerning the Work, express, implied, 108 | statutory or otherwise, including without limitation warranties of 109 | title, merchantability, fitness for a particular purpose, non 110 | infringement, or the absence of latent or other defects, accuracy, or 111 | the present or absence of errors, whether or not discoverable, all to 112 | the greatest extent permissible under applicable law. 113 | c. Affirmer disclaims responsibility for clearing rights of other persons 114 | that may apply to the Work or any use thereof, including without 115 | limitation any person's Copyright and Related Rights in the Work. 116 | Further, Affirmer disclaims responsibility for obtaining any necessary 117 | consents, permissions or other rights required for any use of the 118 | Work. 119 | d. Affirmer understands and acknowledges that Creative Commons is not a 120 | party to this document and has no duty or obligation with respect to 121 | this CC0 or use of the Work. 122 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Awesome Web Components [![Awesome](https://awesome.re/badge.svg)](https://awesome.re) 2 | 3 | A curated list of awesome Web Components resources. 4 | 5 | > **Note** 6 | > This project was previously named "Web Components the Right Way" 7 | 8 | [Web Components](https://developer.mozilla.org/en-US/docs/Web/Web_Components) — a suite of different technologies allowing you to create reusable custom elements — with their functionality encapsulated away from the rest of your code — and utilize them in your web apps. 9 | 10 | ## Contents 11 | 12 | - [Introduction](#introduction) 13 | - [Standards](#standards) 14 | - [Custom Elements](#custom-elements) 15 | - [Shadow DOM](#shadow-dom) 16 | - [HTML Templates](#html-templates) 17 | - [CSS Shadow Parts](#css-shadow-parts) 18 | - [Guides](#guides) 19 | - [Accessibility](#accessibility) 20 | - [Best Practices](#best-practices) 21 | - [Codelabs](#codelabs) 22 | - [Examples](#examples) 23 | - [Articles](#articles) 24 | - [Architecture](#architecture) 25 | - [Interoperability](#interoperability) 26 | - [Limitations](#limitations) 27 | - [Styling](#styling) 28 | - [Real World](#real-world) 29 | - [Case Studies](#case-studies) 30 | - [Components](#components) 31 | - [Component Libraries](#component-libraries) 32 | - [Design Systems](#design-systems) 33 | - [Use Cases](#use-cases) 34 | - [Libraries](#libraries) 35 | - [Class Based](#class-based) 36 | - [Functional](#functional) 37 | - [Integrations](#integrations) 38 | - [Benchmarks](#benchmarks) 39 | - [Frameworks](#frameworks) 40 | - [Angular](#angular) 41 | - [React](#react) 42 | - [Vue](#vue) 43 | - [Svelte](#svelte) 44 | - [Ecosystem](#ecosystem) 45 | - [Meta Frameworks](#meta-frameworks) 46 | - [Starter Kits](#starter-kits) 47 | - [Testing Solutions](#testing-solutions) 48 | - [Tools](#tools) 49 | - [Books](#books) 50 | - [Tutorials](#tutorials) 51 | - [Insights](#insights) 52 | - [Podcasts](#podcasts) 53 | - [Presentations](#presentations) 54 | - [Talks](#talks) 55 | - [Usage Metrics](#usage-metrics) 56 | - [Proposals](#proposals) 57 | - [Form-associated Custom Elements](#form-associated-custom-elements) 58 | - [Constructable Stylesheet Objects](#constructable-stylesheet-objects) 59 | - [Custom State Pseudo Class](#custom-state-pseudo-class) 60 | - [Miscellaneous](#miscellaneous) 61 | - [Archive](#archive) 62 | - [Polyfills](#polyfills) 63 | - [History](#history) 64 | - [Who To Follow](#who-to-follow) 65 | - [Maintainers](#maintainers) 66 | 67 | ## Introduction 68 | 69 | - [An Introduction to Web Components](https://css-tricks.com/an-introduction-to-web-components/) 70 | - [Intro to Web Components](https://developer.salesforce.com/blogs/2020/01/intro-to-web-components.html) 71 | - [The Holy Grail Of Reusable Components: Custom Elements, Shadow DOM, And NPM](https://www.smashingmagazine.com/2018/07/reusable-components-custom-elements-shadow-dom-npm/) 72 | - [The Motivation For Using Web Components, an Introduction](https://www.thinktecture.com/web-components/introduction-and-motivation/) 73 | - [The Power of Web Components](https://hacks.mozilla.org/2018/11/the-power-of-web-components/) 74 | - [Web Components 101](https://nhswd.com/blog/web-components-101-what-are-web-components/) 75 | - [Web Components: From the orbital height](https://javascript.info/webcomponents-intro) 76 | - [What are browser-native web components?](https://gomakethings.com/what-are-browser-native-web-components/) 77 | - [Why Web Components?](https://www.fast.design/docs/resources/why-web-components/) 78 | 79 | ## Standards 80 | 81 | ### Custom Elements 82 | 83 | Custom Elements provide a way for authors to build their own fully-featured DOM elements. 84 | 85 | - [A Guide to Custom Elements for React Developers](https://css-tricks.com/a-guide-to-custom-elements-for-react-developers/) 86 | - [All about HTML Custom Elements](https://github.com/shawnbot/custom-elements) 87 | - [Custom elements](https://javascript.info/custom-elements) 88 | - [Custom Elements v1: Reusable Web Components](https://web.dev/custom-elements-v1/) 89 | - [Handling properties in custom element upgrades](https://nolanlawson.com/2021/08/03/handling-properties-in-custom-element-upgrades/) 90 | - [Handy Custom Elements' Patterns](https://gist.github.com/WebReflection/ec9f6687842aa385477c4afca625bbf4) 91 | - [HTML Living Standard: Custom elements](https://html.spec.whatwg.org/multipage/custom-elements.html) 92 | - [MDN - Using Custom Elements](https://developer.mozilla.org/en-US/docs/Web/Web_Components/Using_custom_elements) 93 | - [web-platform-tests](https://github.com/web-platform-tests/wpt/tree/master/custom-elements) 94 | 95 | ### Shadow DOM 96 | 97 | Shadow DOM describes a method of combining multiple DOM trees into one hierarchy and how these trees interact with each other within a document, thus enabling better composition of the DOM. 98 | 99 | - [A complete guide on shadow DOM and event propagation](https://pm.dartus.fr/blog/a-complete-guide-on-shadow-dom-and-event-propagation/) 100 | - [DOM Living Standard: Shadow tree](https://dom.spec.whatwg.org/#shadow-trees) 101 | - [MDN - Using Shadow DOM](https://developer.mozilla.org/en-US/docs/Web/Web_Components/Using_shadow_DOM) 102 | - [Mind the document.activeElement!](https://dev.to/open-wc/mind-the-document-activeelement-2o9a) 103 | - [Open vs. Closed Shadow DOM](https://blog.revillweb.com/open-vs-closed-shadow-dom-9f3d7427d1af) 104 | - [Shadow DOM](https://javascript.info/shadow-dom) 105 | - [Shadow DOM and events](https://javascript.info/shadow-dom-events) 106 | - [Shadow DOM in depth](https://github.com/praveenpuglia/shadow-dom-in-depth) 107 | - [Shadow DOM slots, composition](https://javascript.info/slots-composition) 108 | - [Shadow DOM styling](https://javascript.info/shadow-dom-style) 109 | - [Shadow DOM v1: Self-Contained Web Components](https://web.dev/shadowdom-v1/) 110 | - [The Rise of Shadow DOM](https://medium.com/front-end-hacking/the-rise-of-shadow-dom-84aa1f731e82) 111 | - [Understanding Slot Updates with Web Components](https://coryrylan.com/blog/understanding-slot-updates-with-web-components) 112 | - [What is the Shadow DOM?](https://bitsofco.de/what-is-the-shadow-dom/) 113 | - [Who doesn't love some slots?](https://dev.to/westbrook/who-doesnt-love-some-s-3de0) 114 | - [Your Content in Shadow DOM Portals](https://dev.to/westbrook/your-content-in-shadow-dom-portals-3cdb) 115 | - [web-platform-tests](https://github.com/web-platform-tests/wpt/tree/master/shadow-dom) 116 | 117 | ### HTML Templates 118 | 119 | `