MessageAction
Interface
The interface for all message actions. Message action executes when a matched message is received.
Properties
id
id: stringThe unique id of the action. For actions provided by a widget, the id is: widgetId + actionName.
label
label: stringThe action label. To support i18n, use _action_${actionName} as the string key.
name optional
name: stringThe action name.
widgetId optional
widgetId: stringThe widget id that provides the action. If a widget id is not provided, the action is provided by the Jimu framework.
Methods
destroy
destroy(): voidWhen a widget is removed, actions provided by this widget will be destroyed.
Returns
voidfilterMessage
filterMessage(message: Message): booleanThis indicates whether a specific message can trigger the filter message action. This method is used to filter messages in the message manager.
Parameters
- message: Message
Returns
booleanfilterMessageType
filterMessageType(messageType: MessageType, messageWidgetId?: string): booleanThis indicates whether or not the type of message can trigger the filter message action. This method is used in builder to filter the available actions.
Parameters
- messageType: MessageType
- messageWidgetId: stringoptional
the widget id that will publish the message.
Returns
booleangetSettingComponentUri optional
getSettingComponentUri(messageType: MessageType, messageWidgetId?: string): stringThis returns the action setting component uri. The returned value should match thesettingUri from the widget manifest. If no setting is required, null is returned.
This method is required for framework actions but optional for widget actions.
This setting component is used to configure the action according to the message.
Parameters
- messageType: MessageType
- messageWidgetId: stringoptional
Returns
stringonExecute
onExecute(message: Message, actionConfig?: any): boolean | Promise<boolean>The execution of the action when the message is matched.
Parameters
- message: Message
- actionConfig: anyoptional
Returns
boolean | Promise<boolean>onRemoveListen
onRemoveListen(messageType: MessageType, messageWidgetId?: string): voidWhen an action is removed from a message's listener, this function will be invoked.
Parameters
- messageType: MessageType
- messageWidgetId: stringoptional
Returns
void