ti.webdialog

The WebDialog module provides Titanium access to the native SFSafariViewController (iOS) and ChromeTabs (Android). This enables you to deliver interactive web content in your app just like the built-in browser, including the native UI elements already familiar to your users.

Requirements

The WebDialog module is available with the Titanium SDK starting with Release 7.1.0. This module only works with devices running iOS 9 / Android 4.1 and later. Please make sure you have at least Xcode 7 to build to the required iOS sources.

Getting Started

Add the module as a dependency to your application by adding a <module> item to the [modules](api:Modules) element of your tiapp.xml file:

<ti:app>
  <!-- ... -->
  [modules](api:Modules)
    <module platform="iphone">ti.webdialog</module>
  </modules>
  <!-- ... -->
</ti:app>

Use require() to access the module from JavaScript:

var dialog = require('ti.webdialog');

The dialog variable is a reference to the module. Make API calls using this reference:

if (dialog.isSupported()) {
    dialog.open({
        url: 'https://titaniumsdk.com'
    });
}

Sample Application

The module contains a sample application in the <TITANIUM_SDK_HOME>/modules/iphone/ti.webdialog/<VERSION>/example/ folder.

var dialog = require('ti.webdialog');
if (dialog.isOpen()) {
    dialog.close();
}

var dialog = require('ti.webdialog');
if (dialog.isSupported()) {
    dialog.open({
        url: 'https://titaniumsdk.com',
        tintColor: 'red'
    });
}

The AuthenticationSession puts the user in control of whether they want to use their existing logged-in session from Safari. The app provides a URL that points to the authentication webpage. The page will be loaded in a secure view controller. From the webpage, the user can authenticate herself and grant access to the app. On completion, the service will send a callback URL with an authentication token, and this URL will be passed to the app by the callback.

The callback URL usually has a custom URL scheme. For the app to receive the callback URL, it needs to either register the custom URL scheme in its Info.plist, or set the scheme to scheme argument in the initializer.

If the user has already logged into the web service in Safari or other apps via the AuthenticationSession, it is possible to share the existing login information. An alert will be presented to get the user's consent for sharing their existing login information. If the user cancels the alert, the session will be canceled, and the callback will be called.

If the user taps Cancel when showing the login webpage for the web service, the session will be canceled, and the callback will be called as well.

The app can cancel the session by calling cancel(). This will also dismiss the window that is showing the web service's login page.

Requirements

The AuthenticationSession API is available with the Titanium SDK starting with Release 7.1.0. This module only works with devices running iOS 11.0 and later. Please make sure you have at least Xcode 9 to build to the required sources.

Getting Started

Create a new authentication session by providing a url and scheme, create an event-listener and start:

var WebDialog = require('ti.webdialog');

var authSession = WebDialog.createAuthenticationSession({
  url: 'https://example.com/oauth?callbackURL=myapp://',
  scheme: 'myapp://'
});

authSession.addEventListener('callback', function(e) {
  if (!e.success) {
      Ti.API.error('Error authenticating: ' + e.error);
      return;
  }
  
  Ti.API.info('Callback URL: ' + e.callbackURL);
});

authSession.start(); // Or cancel() to cancel it manually.