What is react-share?
The react-share npm package provides a collection of social media share buttons and share counts for React applications. It supports a wide range of social media platforms and allows for easy integration of sharing functionalities.
What are react-share's main functionalities?
Facebook Share Button
This feature allows you to create a Facebook share button with a customizable icon. The button can be used to share a specified URL on Facebook.
import { FacebookShareButton, FacebookIcon } from 'react-share';
const FacebookShare = () => (
<FacebookShareButton url={'https://example.com'}>
<FacebookIcon size={32} round={true} />
</FacebookShareButton>
);
Twitter Share Button
This feature allows you to create a Twitter share button with a customizable icon. The button can be used to share a specified URL and title on Twitter.
import { TwitterShareButton, TwitterIcon } from 'react-share';
const TwitterShare = () => (
<TwitterShareButton url={'https://example.com'} title={'Check this out!'}>
<TwitterIcon size={32} round={true} />
</TwitterShareButton>
);
LinkedIn Share Button
This feature allows you to create a LinkedIn share button with a customizable icon. The button can be used to share a specified URL on LinkedIn.
import { LinkedinShareButton, LinkedinIcon } from 'react-share';
const LinkedinShare = () => (
<LinkedinShareButton url={'https://example.com'}>
<LinkedinIcon size={32} round={true} />
</LinkedinShareButton>
);
Share Count
This feature allows you to display the share count for a specified URL on Facebook. Similar components are available for other social media platforms.
import { FacebookShareCount } from 'react-share';
const FacebookShareCountExample = () => (
<FacebookShareCount url={'https://example.com'} />
);
Other packages similar to react-share
react-social-sharing
The react-social-sharing package provides a set of social media sharing buttons for React applications. It supports fewer platforms compared to react-share but offers a simpler API and easier customization options.
react-social-icons
The react-social-icons package offers a collection of social media icons that can be used for sharing purposes. It focuses more on providing a wide range of icons rather than the sharing functionality itself, making it a good complement to other sharing packages.
react-share-buttons
The react-share-buttons package provides a set of customizable share buttons for various social media platforms. It offers similar functionalities to react-share but with a different set of customization options and styling capabilities.
react-share
Easy social media share buttons and share counts.
Features
- no external script loading, i.e. no dependencies on SDKs
- opens a popup share-window
- sharing buttons for Facebook, Twitter, Google+, LinkedIn, Pinterest, VK
- share counts for Facebook, Google+, Linkedin and Pinterest
- share buttons with generated icons or custom icons of your choice
Demos:
- demos/demo0: Facebook, Twitter, Google+, Linkedin, Pinterest, VK
To run demos: clone repo and run npm install && npm run run-demos
and open http://localhost:8080/demo0/
.
Install
npm install react-share --save
Browser
ShareButtons work on all browsers.
ShareCounts works on all browsers, with the exception of Goolge Plus share count
working only on IE11 and newer (XHR CORS problem).
Compatibility
Compatible with React versions 0.13.x
, 0.14.x
and 15.x.x
.
API
import {
ShareButtons,
ShareCounts,
generateShareIcon
} from 'react-share';
Share buttons
const {
FacebookShareButton,
GooglePlusShareButton,
LinkedinShareButton,
TwitterShareButton,
PinterestShareButton,
VKShareButton
} = ShareButtons;
Share button props
| Required props | Optional props |
---|
All | children : A React node (e.g. string or element)
url : URL of the shared page (string) | disabled : Disables click action and adds disabled class (bool)
disabledStyle : Style when button is disabled (object, default = { opacity: 0.6 })
windowWidth , windowHeight : opened window dimensions (int, different defaults for all share buttons)
beforeOnClick : Takes a function that returns a Promise to be fulfilled before calling onClick |
FacebookShareButton | - | title : Title of the shared page (string)
description : Description of the shared page (string)
picture : An absolute link to the image that will be shared (string) |
GooglePlusShareButton | - | - |
LinkedinShareButton | - | title : Title of the shared page (string)
description : Description of the shared page (string) |
TwitterShareButton | - | title : Title of the shared page (string)
via : (string)
hashtags : (array) |
PinterestShareButton | media : An absolute link to the image that will be pinned (string) | description : Description for the shared media. |
VKShareButton | - | title : Title of the shared page (string)
description : Description of the shared page (string)
image : An absolute link to the image that will be shared (string) |
Share counts
const {
FacebookShareCount,
GooglePlusShareCount,
LinkedinShareCount,
PinterestShareCount
} = ShareCounts;
All share count components take in only one mandatory prop: url
, which is the
URL you are sharing. className
prop is optional.
Example:
<FacebookShareCount url={shareUrl} />
If you want to render anything else but the count,
you can provide a function as a child element that takes in shareCount
as an
argument and returns an element:
<FacebookShareCount url={shareUrl}>
{shareCount => (
<span className="myShareCountWrapper">{shareCount}</span>
)}
</FacebookShareCount>
Icons
const FacebookIcon = generateShareIcon('facebook');
const TwitterIcon = generateShareIcon('twitter');
const GooglePlusIcon = generateShareIcon('google');
const LinkedinIcon = generateShareIcon('linkedin');
const PinterestIcon = generateShareIcon('pinterest');
const VKIcon = generateShareIcon('vk');
Props:
-
size
: Icon size in pixels (number)
-
round
: Whether to show round or rect icons (bool)
-
iconBgStyle
: customize background style, e.g. fill
(object)
-
logoFillColor
: customize logo's fill color (string, default = 'white')
Example:
<TwitterIcon size={32} round={true} />
License
MIT
Icons
Icon paths provided by:
react-social-icons.