thisdotname/vue-share-it

A Vue.js component for sharing links to social networks

vue-share-it

A highly customizable Vue.js component for sharing links on social networks.

Features

• Easy install
• Highly customizable
• Extensive documentation & examples
• Developer support
• SEO friendly

Examples

Live demo

Docs

Installation

# Yarn 
yarn add vue-share-it

# NPM 
npm install vue-share-it --save

Usage

Browserify / Webpack

import shareIt from 'vue-share-it';

Vue.use(shareIt);

HTML

<script src="https://unpkg.com/[email protected]/dist/vue-share-it.js"></script>

Supported social-media platforms

Platform	Value
Twitter	twitter
LinkedIn	linkedin
Facebook	facebook
Whatsapp	whatsapp
Reddit	reddit

API

Props

Prop	Data type	Default	Description
text	String	''	Caption
url	String	''	URL to share
width	Number	600	Width of the share window
height	Number	600	Height of the share window
dense	Boolean	false	Dense button styling
dark	Boolean	false	Dark button styling
targets	Array	[]	Specify social media targets, defaults to all available targets
icons	Boolean	false	Use icons as buttons
outline	Boolean	false	Outline button styling
round	Boolean	false	Round button styling for icons
iconSize	String	lg	Specify icon size. See size chart below
shareConfig	Object	{ linkedin: {}, twitter: {}, facebook: {}, whatsapp: {}, reddit: {}, }	Advanced configuration for target specific styling

Events

Name	Description	Value
clicked	Event that is emitted when a share button is clicked	Returns social media platform which was clicked. E.g. ["twitter"]

Slots

Name	Description
${platform}-icon	Custom icon for platform
${platform}-label	Custom label for platform

Examples

Using vue-share-it component

Default

<share-it />

---

Global configs

<share-it text="This is sample text" url="https://www.google.com" :height="600" :width="600" />

---

Targets

<share-it :targets="['twitter', 'facebook']" />

---

Dark

<share-it dark />

---

Dense

<share-it dense />

---

Outlined

<share-it outline />

---

Button configs

const share = {
  twitter: {
    size: "2x",
    label: "Custom label!",
    round: true,
  },
  linkedin: {
    size: "2x",
    color: "#333",
    backgroundColor: "yellow",
  },
  facebook: {
    size: "3x",
    dark: true
  },
  whatsapp: {
    size: "2x",
    dense: true,
    outline: true,
    color: 'green',
  },
}

<share-it :shareConfig="share" />

---

Icons

<share-it icons />

---

Outlined icons

<share-it icons outline />

---

Rounded icons

<share-it icons outline round />

---

Icon configs

const iconConfig ={
  twitter: {
    icon: true,
    size: "sm",
    color: "#333",
    round: true,
    backgroundColor: 'yellow'
  },
  linkedin: {
    icon: true,
    size: "lg",
    outline: true,
    round: true,
    
  },
  facebook: {
    icon: true,
    size: "2x",
    outline: true,
    round: true
  },
  whatsapp: {
    icon: true,
    size: "3x",
    outline: true,
    round: true
  },
  reddit: {
    icon: true,
    size: "4x",
    outline: true,
    round: true
  },
}

<share-it :shareConfig="iconConfig" />

---

Using slots

<share-it>
  <template v-slot:twitter-icon>
    <v-icon>mdi-twitter</v-icon>
  </template>
  <template v-slot:twitter-label>
    <em>Tweet it!</em>
  </template>
  <template v-slot:whatsapp-icon>
    <v-icon>mdi-whatsapp</v-icon>
  </template>
  <template v-slot:whatsapp-label>
    <em>Share on Whatsapp</em>
  </template>
</share-it>

Size chart

Code	Size
xs	.75em
sm	.875em
lg	1.33em
2x	2em
3x	3em
4x	4em
5x	5em
6x	6em
7x	7em
8x	8em
9x	9em
10x	10em

vue-share-it's Issues

about:blank tab opens up in addition to pop-up for the social share

Hi there - great library.

One issue (tested in both Edge and Chrome) is that when user clicks one of the share links, in addition to the expected pop-up for the social site, an empty "about:blank" tab also opens up. Is there a way around this?

Using this in a gridsome project.

Thanks

Key should be placed on the template tag

Nuxt3 :key should be on template

Vue3 support

app.use() ?

Text not working

Text to be share not working, the caption is empty.

https://codesandbox.io/s/vue-share-it-examples-hsmp4?file=/src/App.vue:688-702