As a developer I would like documentation on how to create a Web Component

[thescientist13]

Type of Change

• [ ] New Feature Request
• [x] Documentation
• [ ] Future Spec
• [ ] Improvement / Suggestion
• [ ] Bug
• [ ] Other (please clarify below)

Summary

Some documentation on how to create a component. Topics to cover (link out where appropriate to keep it DRY):

• event handling (Custom Events)
• data binding
• props / state
• attributes / properties
• Shadow DOM
• custom elements
• sub classing (LitElement, HTMLElement)
• how to design a good component API

Use Case

Developers looking to create their first web component.

Code Sample

N / A

Pros / Cons

No cons, other than the usual risk with documentation that it can get out dated easily.

[thescientist13]

Links / References:

• https://twitter.com/justinfagnani/status/1035279790767452160
• https://github.com/Polymer/lit-element/issues/37
• https://43081j.com/2018/08/future-of-polymer

[thescientist13]

Provide documentation here? https://github.com/Polymer/lit-element/issues/37

[thescientist13]

@hutchgrant You may be interested in this issue.

[hutchgrant]

Added a basic hello world style guide. The topics you want covered should perhaps be on separate pages with separate examples.