cabrillo.modal : client

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 1 minute de lecture
  • Cabrillo JS Fonctions de présentation de contenu Web à l’intérieur de modaux natifs.

    cabrillo.modal : dismissModal(données de l’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 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 celui-ci se rejette de lui-même.
    Tableau 2. Renvoie
    Type Description
    promesse En cas de réussite, 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( Titre de chaîne, URL de chaîne, Chaîne closeButtonStyle, Chaîne modalPresentationStyle)

    Présente du 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 permettant d’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 Bouton Fermer style 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 de fermeture.
    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 Cabrillo JS : styles de présentation des fenêtres modales.
    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 un modal natif qui charge une URL personnalisée. Cette section présente une page de Portail de services personnalisée dans une fenêtre modale de style de 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);
    });