Web Sharing: Difference between revisions

From NSB App Studio
Jump to navigation Jump to search
No edit summary
Line 14: Line 14:


=== Triggering the Web Share Dialog ===
=== Triggering the Web Share Dialog ===
Triggering the share dialog is surprisingly easy. All that's needed is to call the navigator.share() function with the data we want to pass. S
Some Notes:
* Check if the browser supports the navigator.share function before calling it, otherwise you'll get an error.
* You can put any string you want into the arguments
* The only valid properties for the argument are title, text and url.
* Android doesn't support url, so it will add it to text when calling the selection.


==== Sample Code ====
==== Sample Code ====

Revision as of 14:00, 18 June 2019

Web Sharing using the Web Share API to use the native sharing mechanism of the OS to send data between apps.

You probably used these icons in your apps:

to get these pickers for iOS and Android respectively:

In this Tech Note, we'll show how trigger the web share picker from your app. We'll also show how you can add your own app as an option in the web share picker.

Triggering the Web Share Dialog

Triggering the share dialog is surprisingly easy. All that's needed is to call the navigator.share() function with the data we want to pass. S

Some Notes:

  • Check if the browser supports the navigator.share function before calling it, otherwise you'll get an error.
  • You can put any string you want into the arguments
  • The only valid properties for the argument are title, text and url.
  • Android doesn't support url, so it will add it to text when calling the selection.

Sample Code

if (!navigator.share) NSB.MsgBox("Web Sharing not supported in this browser.");

navigator.share({
  title: 'WebShare Title',
  text: 'Here's some text',
  url: 'https://appstudio.dev',
})
  .then(() => console.log('Successful share'))
  .catch((error) => NSB.MsgBox('Error sharing', error));

if !navigator.share Then MsgBox "Web Sharing not supported in this browser." 

function Button1_onclick()
  Dim args = {}
  args.title = "WebShare Title"
  args.text = "Here's some text"
  args.url = "https://appstudio.dev"
  
  navigator.share(args).then(successCB).catch(failCB)
End function

function successCB()
  ' success - Sharing slip should display
End function

function failCB(error)
  MsgBox error
End function

Acting as a Web Share Target

Sample Code