Skip to content

Titanium.App.iOS.UserNotificationCategory

A set of notification actions to associate with a notification.

To create a notification category, use the Titanium.App.iOS.createUserNotificationCategory method.

A notification category represents a collection of Titanium.App.iOS.UserNotificationAction to associate with a specific notification. The notification category allows the application to customize the notification options based on which notification style is used. For alert dialogs, only four notification actions can be displayed, while all other notifications can only display two actions.

To use a local interactive notification, you need to register the notification category using the Titanium.App.iOS.registerUserNotificationSettings method and send a notification using the Titanium.App.iOS.scheduleLocalNotification and pass the category identifier to the category property.

Extends: Titanium.Proxy · Since: 3.4.0 · Platforms: iphone, ipad, macos

Properties #

actionsForDefaultContext#

creation only

Type: Array<Titanium.App.iOS.UserNotificationAction>

Array of notification actions to associate with the group.

Note that only the first four actions can be displayed for an alert dialog and on the Apple Watch.
The first two actions can be displayed for all other notifications.

actionsForMinimalContext#

creation only

Type: Array<Titanium.App.iOS.UserNotificationAction>

Array of notification actions to display for non-dialog-style notification.

If not specified, the first two actions from actionsForDefaultContent are displayed.
Note: This property has been removed in iOS 10. iOS 10+ will handle the actions internally.

apiName#

extended

Type: String

The name of the API that this proxy corresponds to.

The value of this property is the fully qualified name of the API. For example, Button
returns Ti.UI.Button.

categorySummaryFormat#

creation only

Type: String

A format string for the summary description used when the system groups the category's notifications.

hiddenPreviewsBodyPlaceholder#

creation only

Type: String

The placeholder text to display when notification previews are disabled for the app.

identifier#

creation only

Type: String

Identifier for this category.

When scheduling a notification, pass this value to the category property.

intentIdentifiers#

creation only

Type: Array<String>

The intents related to notifications of this category.

When a notification is delivered, the presence of an intent identifier
lets the system know that the notification is potentially related to the
handling of a request made through Siri.

lifecycleContainer#

extended

Type: Titanium.UI.Window, Titanium.UI.TabGroup

The Window or TabGroup whose Activity lifecycle should be triggered on the proxy.

If this property is set to a Window or TabGroup, then the corresponding Activity lifecycle event callbacks
will also be called on the proxy. Proxies that require the activity lifecycle will need this property set
to the appropriate containing Window or TabGroup.

options#

creation only

Type: Array<Number>

Options for how to handle notifications of this type.

Titanium SDK Documentation