Gestion des actions-JavaScript

Le kit de développement logiciel (SDK) JavaScript introduit une base Action et un ensemble de classes d’action dédiées (toutes étendent Action ) qui mappent aux différents types d’actions définis dans le schéma de carte adaptative : | Nom du type de schéma | Classe JavaScript | | --- | --- | | Action. OpenURL | OpenUrlAction | | Action. ShowCard | ShowCardAction | | Action. ToggleVisibility | ToggleVisibilityAction | | Action. Submit | SubmitAction |

Gestion des actions lorsque les utilisateurs cliquent sur des boutons d’action

Pour gérer l’exécution des actions avec le kit de développement logiciel (SDK) JavaScript, une application doit fournir un gestionnaire pour l’événement global AdaptiveCard.onExecuteAction ou pour l’événement par carte adaptiveCardInstance.onExecuteAction . Le gestionnaire d’événements est appelé quel que soit le type d’action en cours d’exécution, et il est de la responsabilité de l’application de tester le type d’action en cours d’exécution et d’exécuter le code approprié. En règle générale, les applications doivent uniquement gérer SubmitAction explicitement, car d’autres types d’actions sont gérés automatiquement par le kit de développement logiciel (SDK).

Exemple

// Create an AdaptiveCard instance
let adaptiveCard = new AdaptiveCard();

// Parse a card payload - this is just a very simple example
adaptiveCard.parse(
    {
        "type": "AdaptiveCard",
        "version": "1.0",
        "actions": [
            {
                "type": "Action.Submit",
                "id": "clickMe",
                "title": "Click me!"
            }
        ]
    }
)

// Provide an onExecuteAction handler to handle the Action.Submit
adaptiveCard.onExecuteAction = (action: Action) => {
    if (action instanceof SubmitAction) {
        // If you copy this code sample, remove the alert statement
        // and provide your own custom handling code
        alert("You clicked " + action.title);
    }
}

document.body.appendChild(adaptiveCard.render());

Exécution d’actions dans le code

Le kit de développement logiciel (SDK) JavaScript vous permet d’exécuter des actions dans le code si nécessaire via la Action.execute() méthode.

Exemple

function triggerAction(card: AdaptiveCard, actionId: string) {
    let action = card.getActionById(actionId);

    if (action !== undefined) {
        // Executing an action in code will trigger the
        // onExecuteAction event
        action.execute();
    }
}