cabrillo.modal – Client

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 1 Minute Lesedauer
  • Cabrillo JS Funktionen zur Darstellung von Webinhalten in nativen Modalen.

    cabrillo.Modal – verwerfen Modal (Objektdaten)

    Verwenden Sie diese Option, um ein Modal zu entfernen, das mit der Funktion presentModal() angegeben wurde.

    Ein angegebenes Modal ist dafür zuständig, sich selbst zu schließen und die Ergebnisse an den präsentierenden Kontext zurückzugeben. Die Funktion dismissModal()-Funktion muss aus dem präsentierten Kontext und nicht aus dem Präsentationskontext aufgerufen werden.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    data Objekt Optional. Ein Objekt, das an den präsentierenden Kontext zurückgegeben werden soll, wenn sich der präsentierte Kontext selbst schließt.
    Tabelle : 2. Rückgaben
    Typ Beschreibung
    promise Wenn erfolgreich, ein ungelöstes Objekt, andernfalls ein Fehler.
    // 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äsentiert den Inhalt in einer nativen modalen Benutzeroberfläche.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    title Zeichenfolge Titel der modalen Schnittstelle.
    URL Zeichenfolge Die URL zum Öffnen des Modals. Dies muss eine interne Instanz-URL sein (vollständig qualifiziert oder relativ; eine relative URL wird bevorzugt).
    closeButtonStyle Zeichenfolge Stil der Schaltfläche „Schließen“ der modalen Schnittstelle.
    Mögliche Werte:
    • cabrillo.modal.CLOSE_BUTTON_STYLE_CANCEL
    • cabrillo.modal.CLOSE_BUTTON_STYLE_CLOSE
    • cabrillo.modal.CLOSE_BUTTON_STYLE_DONE
    Weitere Informationen finden Sie unter Cabrillo-JS-Konstanten: Stile der Schaltfläche „Schließen“.
    modalPresentationStyle Zeichenfolge Präsentationsstil der modalen Schnittstelle.
    Mögliche Werte:
    • cabrillo.modal.MODAL_PRESENTATION_STYLE_FULL_SCREEN
    • cabrillo.modal.MODAL_PRESENTATION_STYLE_FORM_SHEET
    Weitere Informationen finden Sie unter Cabrillo-JS-Konstanten: Modale Präsentationsstile.
    Hinweis:
    Dieser Parameter wird nur für unterstützt Apple iOS.
    Tabelle : 4. Rückgaben
    Typ Beschreibung
    promise Bei Erfolg ein Cabrillo.ModalResponse-Objekt, andernfalls ein Fehler.

    Präsentieren Sie ein natives Modal, das eine benutzerdefinierte URL lädt. Dies stellt eine benutzerdefinierte Service Portal-Seite in einem Formularblatt-Modal dar. Die Zusage ist erfüllt, wenn das Modal geschlossen wird. Siehe die Funktion dismissModal() für benutzerdefinierte Möglichkeiten zum Schließen.

    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);
    });