# Titanium.App.iOS.UserNotificationCategory
A set of notification actions to associate with a notification.
# Overview
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.
# Properties
# actionsForDefaultContext CREATION ONLY
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
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.
# categorySummaryFormat CREATION ONLY
A format string for the summary description used when the system groups the category's notifications.
# hiddenPreviewsBodyPlaceholder CREATION ONLY
The placeholder text to display when notification previews are disabled for the app.
# identifier CREATION ONLY
Identifier for this category.
When scheduling a notification, pass this value to the category
property.
# intentIdentifiers CREATION ONLY
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.
# options CREATION ONLY
Options for how to handle notifications of this type.
If not specified, defaults to USER_NOTIFICATION_CATEGORY_OPTION_NONE.
- Titanium.App.iOS.USER_NOTIFICATION_CATEGORY_OPTION_NONE
- Titanium.App.iOS.USER_NOTIFICATION_CATEGORY_OPTION_CUSTOM_DISMISS_ACTION
- Titanium.App.iOS.USER_NOTIFICATION_CATEGORY_OPTION_ALLOW_IN_CARPLAY
- Titanium.App.iOS.USER_NOTIFICATION_CATEGORY_OPTION_HIDDEN_PREVIEWS_SHOW_TITLE
- Titanium.App.iOS.USER_NOTIFICATION_CATEGORY_OPTION_HIDDEN_PREVIEWS_SHOW_SUBTITLE