facebook-button

Web Component wrapper for Facebook's button using Polymer.


Keywords
polymer, web-components
License
MIT
Install
bower install facebook-button

Documentation

<facebook-button>

Web Component wrapper for Facebook's button using Polymer.

Demo

Facebook Element

Check it live.

Install

Install the component using Bower:

$ bower install facebook-button --save

Or download as ZIP.

Usage

  1. Import Web Components' polyfill:

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

    <link rel="import" href="bower_components/facebook-button/dist/facebook-button.html">
  3. Start using it!

    <facebook-button></facebook-button>

Options

Attribute Options Default Description
action like, recommend like The verb to display in the button
colorscheme light, dark light The color scheme for the like button
font arial, lucida grande, segoe ui, tahoma, trebuchet ms, verdana arial The font to display in the button
href string http://customelements.io The URL to like/recommend
layout standard, button_count, box_count button_count Determines the size and amount of social context next to the button
showfaces true, false false Specifies whether to display profile photos below the button (standard layout only)
height int 20 The height of the button
width int 120 The width of the button

See Facebook's official documentation.

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 build the distribution files before releasing a new version.

    $ grunt build
  • 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 © Zeno Rocha