shareon/README.md

90 lines
3.0 KiB
Markdown
Raw Normal View History

2020-03-25 11:32:25 -04:00
# shareon
2020-03-25 19:38:54 -04:00
<img src="https://raw.githubusercontent.com/googlefonts/noto-emoji/master/png/128/emoji_u1f4ef.png" align="right" alt="Postal Horn emoji" width="96" height="96">
2020-03-25 11:32:25 -04:00
2020-03-25 11:45:04 -04:00
Lightweight, stylish and ethical share buttons.
2020-03-25 11:32:25 -04:00
2020-03-25 19:47:45 -04:00
- **Small.** Dependency-free. CSS+JS bundle is only 3.15 KB minified and gzipped.
- **Stylish.** Uses official vector logos and colors with no visual mess.
2020-06-26 11:32:02 -04:00
- **Ethical.** Embeds no tracking code. JS is required only for the setup.
2020-03-25 11:32:25 -04:00
2020-03-27 08:27:11 -04:00
<img src="https://raw.githubusercontent.com/NickKaramoff/shareon/master/docs/screen01@2x.png" height="100" width="570" alt="shareon example">
2020-03-25 19:38:54 -04:00
----
2020-03-26 17:01:29 -04:00
Observe the live demo here: [shareon.js.org](https://shareon.js.org)
2020-03-25 19:38:54 -04:00
## Install
Include the link to shareon's JS and CSS in your website:
```html
<link href="https://cdn.jsdelivr.net/npm/shareon@1/dist/shareon.min.css" rel="stylesheet">
<script src="https://cdn.jsdelivr.net/npm/shareon@1/dist/shareon.min.js" type="text/javascript"></script>
```
or install it via NPM use it in a JS file that you will bundle:
```sh
npm install shareon
# or
yarn add shareon
```
```js
require('shareon');
```
2020-03-25 19:44:31 -04:00
## Usage
2020-03-25 19:47:45 -04:00
> shareon was heavily inspired by [Likely](https://ilyabirman.net/projects/likely/),
and has a backwards-compatible API (excluding themes and sizes).
2020-03-25 19:44:31 -04:00
Create a container with class `shareon` and populate it with elements, whose
classes match the names of social networks:
2020-03-25 11:32:25 -04:00
2020-03-25 19:25:17 -04:00
```html
<div class="shareon">
<a class="facebook"></a>
2020-03-25 19:44:31 -04:00
<a class="messenger"></a>
2020-03-26 17:45:42 -04:00
<a class="odnoklassniki"></a>
2020-03-25 19:44:31 -04:00
<a class="pinterest"></a>
2020-06-26 11:27:59 -04:00
<button class="telegram"></button>
<button class="twitter"></button>
<button class="vkontakte"></button>
<button class="whatsapp"></button>
2020-03-25 19:44:31 -04:00
</div>
```
2020-03-25 20:43:16 -04:00
If you use `<a>`, the buttons will get a `href`-attribute to them. In other cases
they will get a listener on `click` event, so you can use `<button>`s if you wish.
2020-06-26 11:32:02 -04:00
By default, the URL and the title of the page will be used in sharing dialogs.
2020-03-25 19:44:31 -04:00
To change this, you can use the `data-url` and `data-title` attributes. Use them
2020-03-25 20:43:16 -04:00
on the whole container or on the specific buttons:
2020-03-25 19:44:31 -04:00
```html
<div class="shareon" data-url="https://example.com">
<a class="facebook" data-title="Custom Facebook title"></a>
<a class="twitter" data-title="Custom Twitter title"></a>
</div>
```
Apart from the URL and title, some networks support extra parameters:
2020-03-26 17:45:42 -04:00
- add `data-media` to an Odnoklassniki, Pinterest or VK button to customize the pinned picture
2020-03-25 20:43:16 -04:00
- add `data-text` to a WhatsApp or Telegram button to add custom message text
- add `data-via` to a Twitter button to mention a user
2020-03-25 19:44:31 -04:00
Here are all the custom parameters in their glory:
```html
<div class="shareon" data-url="https://example.com/custom-url">
<a class="facebook" data-title="Custom Facebook title"></a>
2020-03-25 19:25:17 -04:00
<a class="messenger" data-url="https://my-cool-website.com"></a>
<a class="pinterest" data-media="https://picsum.photos/500">Pin</a>
<a class="telegram" data-text="Check this out!"></a>
<a class="twitter" data-via="MyNickname"></a>
<a class="whatsapp">Send</a>
2020-03-25 11:32:25 -04:00
</div>
```