A NativeScript plugin to use the native social sharing widget on Android and iOS. Currently this module supports image and text sharing.
Run the following command from the root of your project:
$ tns plugin add nativescript-social-share
This command automatically installs the necessary files, as well as stores nativescript-social-share as a dependency in your project's package.json file.
To use the social share module you must first require() it. After you require() the module you have access to its APIs.
// ------------ JavaScript ------------------
var SocialShare = require("nativescript-social-share");
// ------------- TypeScript ------------------
import * as SocialShare from "nativescript-social-share";The shareImage() method expects an ImageSource object. The code below loads an image from the app and invokes the share widget with it:
// ------------ JavaScript ------------------
var SocialShare = require("nativescript-social-share");
var imageSourceModule = require("image-source");
var image = imageSourceModule.fromFile("~/path/to/myImage.jpg");
SocialShare.shareImage(image);
// ------------- TypeScript ------------------
import * as SocialShare from "nativescript-social-share";
import { ImageSource } from "image-source";
let image = ImageSource.fromFile("~/path/to/myImage.jpg");
SocialShare.shareImage(image);You can optionally provide a second argument to configure the subject on Android:
SocialShare.shareImage(image, "How would you like to share this image?");The shareText() method expects a simple string:
SocialShare.shareText("I love NativeScript!");Like shareImage(), you can optionally pass shareText() a second argument to configure the subject on Android:
SocialShare.shareText("I love NativeScript!", "How would you like to share this text?");The shareUrl() method excepts a url and a string.
SocialShare.shareUrl("https://www.nativescript.org/", "Home of NativeScript");You can optionally pass shareUrl() a second argument to configure the subject on Android:
SocialShare.shareUrl("https://www.nativescript.org/", "Home of NativeScript", "How would you like to share this url?");Looking for some extra help getting social sharing working in your mobile application? Check out these resources:
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent