- Version: 2.0.1
- GitHub: https://github.com/NativeScript/plugins
- Downloads:
- Last Day: 23
- Last Week: 83
- Last Month: 326
Nativescript social-share
ns plugin add @nativescript/social-share
Usage
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";
API
shareImage(ImageSource image, [optional] String subject)
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("@nativescript/core");
var image = imageSourceModule.fromFile("~/path/to/myImage.jpg");
SocialShare.shareImage(image);
// ------------- TypeScript ------------------
import * as SocialShare from "@nativescript/social-share";
import { ImageSource } from "@nativescript/core";
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?");
shareText(String text, [optional] String subject)
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?");
shareUrl(String url, String text, [optional] String subject)
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?");
Tutorials
Looking for some extra help getting social sharing working in your mobile application? Check out these resources:
- Social Media Sharing in a Vanilla NativeScript Application
- Social Media Sharing in a NativeScript with Angular Application
License
Apache License Version 2.0