Skip to content

Fork this repo if you want to start your own Web Component using VanillaJS

Notifications You must be signed in to change notification settings

rj33/element-boilerplate

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

42 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

<my-repo>

A bare minimum custom element starter-kit using VanillaJS.

Like Yeoman? Use the generator-element instead.

Looking for a working example? Check hello-world-element.

Demo

Check it live!

Install

Install the component using Bower:

$ bower install my-repo --save

Or download as ZIP.

Usage

  1. Import Web Components' polyfill:

    <script src="bower_components/webcomponentsjs/webcomponents.min.js"></script>
  2. Import Custom Element:

    <link rel="import" href="bower_components/my-repo/src/my-element.html">
  3. Start using it!

    <my-element></my-element>

Options

Attribute Options Default Description
foo string bar Lorem ipsum dolor.

Methods

Method Parameters Returns Description
unicorn() None. Nothing. Magic stuff appears.

Events

Event Description
onsomething Triggers when something happens.

Development

In order to run it locally you'll need to fetch some dependencies and a basic server setup.

  • Install Bower & Grunt:

    $ [sudo] npm install -g bower grunt-cli
  • Install local dependencies:

    $ bower install && npm install
  • To test your project, start the development server and open http://localhost:8000.

    $ grunt server
  • To provide a live demo, send everything to gh-pages branch.

    $ grunt deploy

Contributing

  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -m 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request :D

History

For detailed changelog, check Releases.

License

MIT License

About

Fork this repo if you want to start your own Web Component using VanillaJS

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • HTML 60.2%
  • JavaScript 39.8%