kony.actionExtension Namespace

The kony.actionExtension Namespace provides support for the iOS Action extension, which is a kind of iOS app extension.

An Action extension helps users view or update content originating in a host app. For example, an Action extension might help users edit an image in a document that they're viewing in a document editor. For more information about what Action extensions are and what you can use them for, please see the Apple developer documentation.

You add an Action extension to your app in the same way that you add any other type of iOS app extension. For more details, refer App Extension API for iOS.

Before your Action extension can be used, your app must set the callback functions that provide the Action extension with its functionality. It does this by invoking the kony.actionExtension.setExtensionsCallbacks function.

The kony.actionExtension Namespace contains the following API elements.

Properties

The kony.actionExtensions Namespace provides the following properties.

Holds the current extension view.

Syntax

kony.actionExtensions.view;

Example

//Sample code
var myView = kony.actionExtensions.view;
myView.addSubView(button);

Type

UIView

Read/Write

Read only.

Platform Availability

iOS

Functions

The kony.actionExtension namespace contains the following functions.

Sets an Action Extension with callbacks for app extension state changes.

Syntax

kony.actionExtension.setExtensionsCallbacks(callbacks)

Input Parameters

callbacks

Contains an object with key-value pairs where the key specifies the extension state and the value is a callback function. The following are the possible keys.

Key Description
beginRequestWithExtensionContext The user has selected the action.
loadView Loads a view that the controller manages.
viewDidAppear A view was just displayed.
viewDidDisappear A view just removed from the view hierarchy.
viewDidLoad The view's controller was loaded into memory.
viewWillAppear A view is about to be displayed.
viewWillDisappear A view is about to be removed from the view hierarchy.

Example: beginRequestWithExtensionContext

function beginRequestWithExtensionContext(var ExtensionContext) {
    // Native bindings code
}
kony.actionExtension.setExtensionsCallbacks({
    "beginRequestWithExtensionContext": beginRequestWithExtensionContext
});

Example: loadView

function loadView() {
    // Native Function API code
}

kony.actionExtension.setExtensionsCallbacks({
    "loadView": loadView
});

Example: viewDidAppear

function viewDidAppear() {
    // Native Function API code
}

kony.actionExtension.setExtensionsCallbacks({
    "viewDidAppear": viewDidAppear
});

Example: viewDidLoad 

function viewDidLoad() {
    // Native Function API code
}

kony.actionExtension.setExtensionsCallbacks({
    "viewDidLoad": viewDidLoad
});

Example: viewDidDisappear

function viewDidDisappear() {
    // Native Function API code
}

kony.actionExtension.setExtensionsCallbacks({
    "viewDidDisappear": viewDidDisappear
});

Example: viewWillAppear

function viewWillAppear() {
    // Native Function API code
}

kony.actionExtension.setExtensionsCallbacks({
    "viewWillAppear": viewWillAppear
});

Example: viewWillDisappear

function viewWillDisappear() {
    // Native Function API code
}

kony.actionExtension.setExtensionsCallbacks({
    "viewWillDisappear": viewWillDisappear
});

Return Values

None.

Platform Availability

iOS