cabrillo.modal : client

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 1 minute de lecture

    • Cabrillo JS Fonctions de présentation de contenu Web à l’intérieur de modaux natifs.

    cabrillo.modal : dismissModal(données d’objet)

    Utilisez cette fonction pour ignorer un modal qui a été présenté avec la fonction presentModal( ).

    Un modal présenté est chargé de se rejeter lui-même et de renvoyer tous les résultats au contexte de présentation. La fonction dismissModal() doit être appelée à partir du contexte présenté et non à partir du contexte de présentation.

    Tableau 1. Paramètres
    Nom Type Description
    données Objet Facultatif. Objet à renvoyer au contexte de présentation lorsque le contexte présenté se rejette de lui-même.
    Tableau 2. Renvoie
    Type Description
    Promesse En cas de succès, un objet non résolu, sinon une erreur. 
    // Any object can be passed back to the presenting context when the presented context dismisses itself.
var results = {
    team: 'Mobile'
    company: 'ServiceNow'
}

cabrillo.modal.dismissModal(results).then(function() {
    console.log('Modal was dismissed and results were passed to presenting context.');
}, function(error) {
    console.log(error);
});

    cabrillo.modal : presentModal( String title, String url, String closeButtonStyle, String modalPresentationStyle)

    Présente le contenu dans une interface modale native.

    Tableau 3. Paramètres
    Nom Type Description
    Titre Chaîne Titre de l’interface modale.
    URL Chaîne L’URL pour ouvrir le modal. Il doit s’agir d’une URL d’instance interne (complète ou relative ; une URL relative est préférable).
    closeButtonStyle Chaîne Style de bouton de fermeture de l’interface modale.
    Valeurs possibles :
    • cabrillo.modal.CLOSE_BUTTON_STYLE_CANCEL
    • cabrillo.modal.CLOSE_BUTTON_STYLE_CLOSE
    • cabrillo.modal.CLOSE_BUTTON_STYLE_DONE
    Pour plus d'informations, consultez Constantes Cabrillo JS : styles des boutons Fermer.
    modalPresentationStyle Chaîne Style de présentation de l’interface modale.
    Valeurs possibles :
    • cabrillo.modal.MODAL_PRESENTATION_STYLE_FULL_SCREEN
    • cabrillo.modal.MODAL_PRESENTATION_STYLE_FORM_SHEET
    Pour plus d'informations, consultez Constantes JS Cabrillo : styles de présentation du modal.
    Remarque :
    Ce paramètre n’est pris en charge que sur Apple iOS.
    Tableau 4. Renvoie
    Type Description
    Promesse En cas de réussite, un objet Cabrillo.ModalResponse, sinon une erreur.

    Présentez une fenêtre modale native qui charge une URL personnalisée. Cette option présente une page Portail de services personnalisée dans une fenêtre modale de style feuille de formulaire. La promesse est tenue lorsque le modal est rejeté. Consultez la fonction dismissModal() pour les options de rejet personnalisées.

    cabrillo.modal.presentModal('Portal Page',
    '/$sp.do?id=my_modal_page',
    cabrillo.modal.CLOSE_BUTTON_STYLE_CLOSE,
    cabrillo.modal.MODAL_PRESENTATION_STYLE_FORM_SHEET
).then(function(response) {
    // The results from the modal are in a results key on the response object.
    var results = response && response.results ? response.results : null;

    if (results) {
        console.log('Modal dismissed with results.', results);
    } else {
        console.log('Modal dismissed without results.');
    }
}, function(error) {
    console.log(error);
});