GlideModal : Client

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 14 Minuten Lesedauer
  • Die GlideModal- API bietet Methoden zum Anzeigen einer Inhaltsüberlagerung, die als modales Element bezeichnet wird. Modale Elemente sind interaktive Fenster, die über einer Seite angezeigt und geschlossen werden, wenn ein Anwender eine Aktion ausführt. Sie können ein modales Element verwenden, um Informationen anzuzeigen, Fragen zu stellen oder Aktionen auszuführen.

    Verwenden Sie die GlideModal -Methoden in Skripts überall, wo Sie clientseitiges JavaScript verwenden können. Diese Methoden werden meistens aus einer UI Action mit ausgewählten Checkboxen Client aufgerufen.

    Mit der GlideModal -API können Sie anwenderdefinierte modale Elemente erstellen oder vorhandene modale Elemente des Basissystems nutzen.

    Hinweis:
    Dies ist ein vollständiger Ersatz für die APIs „GlideWindow“ und „GlideDialogWindow“.

    GlideModal funktioniert nicht im Arbeitsbereich. Verwenden Sie stattdessen die g_modal- API.

    Abbildung : 1. Beispiel-Modal
    Beispielüberlagerung
    Modale Elemente können verschiedene Arten von Inhalten enthalten, z. B.:
    • Statischer Text
    • Dynamischer Text
    • Formulare
    • Bilder
    • Schaltflächen
    Mit dieser API können Sie:
    • Rufen Sie ein Basissystem-Modal wie glide_confirm, glide_infooder glide_alertab.
    • Erstellen Sie modale Inhalte aus einer UI-Seite oder übergebenem HTML.
    • Legen Sie den Titel im Modal fest.
    • Legen Sie den Textinhalt des Modals fest.
    • Legen Sie die Breite des Modals fest.
    • Einstellungen abrufen und festlegen.
    • Modale Ansichten wechseln.
    Um ein modales Element in der Anwenderoberfläche anzuzeigen, müssen Sie eine der Rendermethoden aufrufen:
    Das folgende Codebeispiel zeigt, wie ein Modal mit der UI-Seite „my_modal“ erstellt und gerendert wird.
    var dialog = new GlideModal("my_modal");
    
    //Set the dialog title
    dialog.setTitle('Show title');
    
    //Set the dialog width		      	
    dialog.setWidth(550);
    
    //Display the modal
    dialog.render();

    Dieses Codebeispiel zeigt, wie Sie ein modales Element mit der renderWithContent()- Methode und HTML erstellen und rendern, um den Inhalt des modalen Elements zu definieren.

    function cancelDialog(){
    
      var dialog = new GlideModal('cancelTask');
      //Sets the dialog title
      dialog.setTitle('Cancel Task');
      //Set up valid custom HTML to display
      dialog.renderWithContent('<div style="padding:15px"><p>What action do you want to take?</p>
        <p><select name="cancellation" id="taskCancellation" class="form-control">
        <option value="cancelOnly" role="option">Cancel this task but keep the requested item open</option>
        <option value="cancelAll" role="option">Cancel this and all other tasks, closing the requested item</option>
        </select></p><div style="padding:5px;float:right"><button style="padding:5px;margin-right:10px"      onclick="window.changeTaskAction(this.innerHTML,jQuery(\'#taskCancellation\').val())"      class="btn btn-default">Abort</button><button style="padding:5px" class="btn btn-primary"      onclick="window.changeTaskAction(this.innerHTML,jQuery(\'#taskCancellation\').val())">Cancel Task</button></div></div>');
    
      //Use the windows object to ensure the code is accessible from the modal dialog
      window.changeTaskAction = function(thisButton, thisAction){
    
        //Close the GlideModal dialog window
        dialog.destroy();
    
        //Submit to the back-end
        if(thisButton=='Cancel Task'){
          if(thisAction=="cancelAll"){
            g_form.setValue('state',4); //Closed Incomplete -- will close the Requested Item and all other open tasks
          }else{
            g_form.setValue('state',7); //Closed Skipped -- will only close this task
          }
             //Regular ServiceNow form submission
             gsftSubmit(null, g_form.getFormElement(), 'cancel_sc_task');
          }
       };
       return false; //Prevents the form from submitting when the dialog first load
    }

    Modale Elemente des Basissystems

    Eine Basisinstanz ServiceNow stellt die folgenden modalen Elemente bereit, die als UI-Seiten definiert sind und die Sie beim Anzeigen eines modalen Elements mit GlideModalverwenden können:

    • glide_alert_standard: Ein Warnungsdialogfeld mit einer OK- Schaltfläche und einem Info- oder Warnsymbol.
      glide_alert_standard modal
    • glide_ask_standard: Ein Bestätigungsdialogfeld mit den Schaltflächen „Ja“ und „Nein“.
      glide_ask_standard modal
    • glide_confirm: Ein Bestätigungsdialogfeld mit den Schaltflächen „Nicht speichern“, „Abbrechen“und „Speichern“.
      glide_confirm-Modal
    • glide_confirm_basic: Ein Bestätigungsdialogfeld mit den Schaltflächen „OK“ und „ Abbrechen “ ohne Symbol.
      glide_confirm_basic modal
    • glide_confirm_standard: Ein Bestätigungsdialogfeld mit den Schaltflächen „OK“ und „ Abbrechen“ und einem Info- oder Warnsymbol.
      glide_confirm_standard modal
    • glide_info: Ein Informationsmodal mit einem Informationssymbol und einer OK -Schaltfläche in der Breite des modalen Fensters.
      Modal „glide_info“.
    • glide_progress_standard: Ein Informationsmodal mit einer Schaltfläche „Schließen“, einem Info- oder Warnsymbol und einem Fortschrittsbalken für Bildlauf. Der Fortschrittsbalken ist ein animiertes GIF-Bild und kann nicht als normaler Fortschrittsbalken aktualisiert werden.
      glide_progress_standard modal
    • glide_progress_no_button: Ein Informationsmodal mit einem Info- oder Warnsymbol und einem scrollenden Fortschrittsbalken. Der Fortschrittsbalken ist ein animiertes GIF-Bild und kann nicht als normaler Fortschrittsbalken aktualisiert werden.
      glide_progress_no_button modal
    • glide_prompt: Ein Modal mit einem Eingabeaufforderungstextfeld und einer OK- und einer Abbrechen -Schaltfläche.
      glide_prompt modal
    • glide_warn: Ein einfaches Modal mit einer OK- Schaltfläche, aber ohne Symbol.
      glide_warn-Modal

    Einstellungen

    Modale Einstellungen bieten eine Möglichkeit, Daten an das zu rendernde modale Fenster zu übergeben. Um einen Einstellungswert festzulegen, verwenden Sie die Methoden setPreference() oder setPrefAndReload(). Anschließend verwenden Sie die Methode GlideModal – getPreference(String name), um eine festgelegte Einstellung abzurufen.

    Um Einstellungen auf einer UI-Seite abzurufen, verwenden Sie die folgende Funktion: RP.getWindowProperties().get('preference_name').

    Einige der modalen Elemente des Basissystems unterstützen die folgenden systembasierten Einstellungen:
    • autoFocus: Kennzeichnung, die angibt, ob das Modal nach dem Rendern automatisch den Fokus erhält. Auf „true“ festlegen, wenn das Modal initialisiert wird.
    • Hauptteil: Legt den übergebenen Inhalt im Textkörper des Modals fest.
    • buttonClass: Legt die Schaltflächenklasse fest.
    • buttonClassCancel: Legt die Klasse für die Abbrechen-Schaltfläche im Modal fest.
    • buttonClassComplete: Legt die Klasse für die Schaltfläche „OK“ (Abschließen) im Modal fest.
    • buttonLabel Legt die Schaltflächenbezeichnung fest.
    • buttonLabelCancel: Legt die Bezeichnung für die Abbrechen-Schaltfläche im Modal fest.
    • buttonLabelComplete: Legt die Bezeichnung für die Schaltfläche „OK“ (Abschließen) im Modal fest.
    • callbackParam: Legt einen Rückrufparameter fest.
    • FokusTrap: Kennzeichnung, die angibt, ob alle Interaktionen außerhalb des Modals blockiert werden sollen, solange es geöffnet ist. Auf „false“ festlegen, wenn das Modal initialisiert wird.
    • modal_title: Legt den Titel des modalen Elements fest. Wird von der Methode setTitle() verwendet.
    • onPromptCancel: Definiert eine Funktion, die aufgerufen wird, wenn der Anwender die Schaltfläche „Abbrechen“ auswählt.
      Zum Beispiel:
      dialog.setPreference("onPromptCancel", function() {
        return false;
      });
    • onPromptComplete: Definiert eine Funktion, die aufgerufen werden soll, wenn der Anwender die Schaltfläche „OK“ auswählt.
      Zum Beispiel:
      dialog.setPreference("onPromptComplete", function () {
        gsftSubmit(null, g_form.getFormElement(), 'check_button');
      });

    GlideModal: GlideModal(String id, Boolean readOnly, Anzahl/Zeichenfolgebreite)

    Erstellt eine Instanz der GlideModal- Klasse.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    id Zeichenfolge Name derUI-Seite, die in das Modal geladen werden soll.

    Die Liste der verfügbaren UI-Seiten finden Sie unter System-UI > UI-Seiten

    readOnly Boolean Optional. Kennzeichnung, die angibt, ob der Inhalt im Modal schreibgeschützt ist.
    Gültige Werte:
    • wahr: Inhalt ist schreibgeschützt.
    • „falsch“: Der Anwender kann den Inhalt ändern.

    Standardwert: false

    width Zahl oder Zeichenfolge Optional. Breite des Modals in Pixel oder die CSS-Klasse des Modals. Wenn eine Pixelbreite übergeben wird, wird die angegebene Breite an der entsprechenden CSS-Klasse ausgerichtet.
    Mögliche modale CSS-Klassen:
    • modal-alert: (300 px) Wird zugewiesen, wenn die angegebene Breite 0 bis 349 Pixel beträgt.
    • modal-sm: (400 px) Wird zugewiesen, wenn die angegebene Breite 350 bis 449 Pixel beträgt.
    • modal-md: (600 px) Wird zugewiesen, wenn die angegebene Breite 450 bis 649 Pixel beträgt.
    • modal-lg: (900 px) Wird zugewiesen, wenn die angegebene Breite 650 bis 900 Pixel beträgt.

    Standard: modal-md

    Maximale Breite: 900 Pixel

    Hinweis:
    Sie können die Breite des Dialogfelds auch mit der Methode GlideModal – setWidth(Number/Stringbreite) festlegen.

    Das folgende Codebeispiel zeigt, wie Sie ein GlideModal-Objekt mit einer vorhandenen UI-Seite erstellen.

    var dialog = new GlideModal('UI_dialog_name');
    
    //Set the dialog title
    dialog.setTitle('Show title'); 
    
    //Set the desired preferences
    dialog.setPreference('table', 'task'); 			
    dialog.setPreference('name', 'value');        	
    
    //Opens the dialog
    dialog.render();

    Das folgende Codebeispiel zeigt, wie Sie mithilfe der Datei „glide_confirm“ ein GlideModal-Objekt erstellen.

    var dialog = new GlideModal('glide_confirm', true, 300);
    dialog.setTitle(new GwtMessage().getMessage('Confirmation'));
    dialog.setPreference('body', new GwtMessage().format("This will complete all update sets in the batch. Continue changing state to complete?"));
    dialog.setPreference('focusTrap', true);
    dialog.setPreference('onPromptComplete', doComplete);
    dialog.setPreference('onPromptCancel', doCancel);
    dialog.render();
    	
    function doComplete() {
      callback(true);
    }
    	
    function doCancel() {
      callback(false);
    }

    GlideModal – destrue()

    Schließt das aktuelle Dialogfeld.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 3. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Codebeispiel zeigt, wie Sie mit der created-Methode () ein modales Element schließen.

    function cancelDialog(){
    
    var gmod = new GlideModal('cancelTask');
      //Sets the dialog title
      gmod.setTitle('Cancel Task');
      //Set up valid custom HTML to be displayed
      gmod.renderWithContent('<div style="padding:15px"><p>What action do you want to take?</p>
        <p><select name="cancellation" id="taskCancellation" class="form-control">
        <option value="cancelOnly" role="option">Cancel this task but keep the requested item open</option>
        <option value="cancelAll" role="option">Cancel this and all other tasks, closing the requested item</option>
        </select></p><div style="padding:5px;float:right"><button style="padding:5px;margin-right:10px"      onclick="window.changeTaskAction(this.innerHTML,jQuery(\'#taskCancellation\').val())"      class="btn btn-default">Abort</button><button style="padding:5px"      class="btn btn-primary" onclick="window.changeTaskAction(this.innerHTML,jQuery(\'#taskCancellation\').val())">
        Cancel Task</button></div></div>');
    
      //Use the windows object to ensure our code is accessible from the modal dialog
      window.changeTaskAction = function(thisButton, thisAction){
    
        //Close the glide modal dialog window
        gmod.destroy();
    
        //Submit to the back-end
        if(thisButton=='Cancel Task'){
          if(thisAction=="cancelAll"){
            g_form.setValue('state',4); //Closed Incomplete -- closes the Requested Item and all other open tasks
          }else{
            g_form.setValue('state',7); //Closed Skipped -- only closes this task
          }
          //Regular ServiceNow form submission
          gsftSubmit(null, g_form.getFormElement(), 'cancel_sc_task');
        }
      };
      return false; //Prevents the form from submitting when the dialog first load
    }

    Das folgende Codebeispiel zeigt, wie Sie mit GlideModal.get().destroy() ein Modal schließen.

    // The following button should be declared somewhere in the UI page HTML.
    <button onclick="closeMe()">close</button>
    
    // The following code is in the client script.
    function closeGlideModal() {
      try {
        GlideModal.get().destroy();
      }catch(err){
        console.warn("closeGlideModal ERROR: "+err.message);
        var x = document.getElementById('THE_NAME_OF_YOUR_UI_PAGE' + '_closemodal');
        if (x) {
          x.click();
        } else {
          console.warn("No 'X' close button found!");
        }
      }
    }
    function closeMe() {
      setTimeout(function(){
        closeGlideModal();
      },100);
    }

    GlideModal – get(String id)

    Gibt das GlideModal-Objekt zurück, das durch den angegebenen UI-Seitennamen identifiziert wird.

    Verwenden Sie diese Methode, um das GlideModal-Objekt zur Verwendung in anderen GlideModal-Vorgängen abzurufen, z. B. GlideModal.get().destroy().

    Tabelle : 4. Parameter
    Name Typ Beschreibung
    id Zeichenfolge Name derUI-Seite, die dem Modal zugeordnet ist.

    Sie können auch die Basissystem-Modals angeben, die in einer Basisinstanz bereitgestellt werden.

    Die Liste der verfügbaren UI-Seiten finden Sie unter System-UI > UI-Seiten.

    Tabelle : 5. Rückgaben
    Typ Beschreibung
    GlideModal Angefordertes GlideModal-Objekt.

    In diesem Beispiel wird gezeigt, wie Sie mit der Methode „get()“ das Modal abrufen, das Sie mit der Methode „zerstören()“ schließen möchten.

    // If the modal was initially created like this:
    
    var dialog = new GlideModal("glide_confirm"); 
    dialog.render();
    
    // Some code using the modal
    .
    .
    .
    
    // Now use the get() and destroy() methods to close the modal
    var glideModal = new GlideModal().get("glide_confirm");
    glideModal.destroy();
    
    // You could also code it like this:
    GlideModal.prototype.get("glide_confirm").destroy();

    GlideModal – getPreference(String name)

    Gibt den Wert der angegebenen Einstellung (Eigenschaft) zurück. Verwenden Sie Einstellungen, um Daten an die zu rendernde Seite zu übergeben.

    Durch das Aufrufen von Aktionen, die das Modal erstellen, werden normalerweise auch die erforderlichen Einstellungen für das Modal mithilfe der Methode GlideModal – setPreference(String name, String value) erstellt. Das Clientskript der UI-Seite kann diese Einstellungen dann mit dieser Methode und der folgenden Funktion verarbeiten: RP.getWindowProperties().get('preference_name').

    Tabelle : 6. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Name des abzurufenden Einstellungswerts. Dieser Wert muss zuvor im Modal mit der Methode GlideModal – setPreference(String name, String value) festgelegt worden sein.
    Tabelle : 7. Rückgaben
    Typ Beschreibung
    Zeichenfolge Wert der angegebenen Einstellung.

    Dieses Beispiel zeigt einen einfachen -Fall, in dem eine Einstellung festgelegt und dann aus einem angegebenen modalen Element abgerufen wird.

    var dialog = new GlideModal('UI_dialog_name');
    // Sets the dialog title
    dialog.setTitle('Modal title');
    
    // Sets the value of the preference table
    dialog.setPreference('table', 'incident');
    
    // Gets the value of the preference table
    var title = dialog.getPreference('table');

    GlideModal – render()

    Rendert die UI-Seite, die angegeben wurde, als die API im Modal instanziiert wurde. Sie müssen diese Methode aufrufen, nachdem Sie das Modal definiert haben, damit es in der Anwenderoberfläche angezeigt wird.

    Rufen Sie diese Methode auf, wenn Sie eine UI-Seite verwenden, um den Inhalt in Ihrem Modal zu generieren. Wenn Sie HTML innerhalb eines Modals anzeigen möchten, rufen Sie entweder GlideModal – renderWithContent(Object HTML) oder GlideModal – renderWithContent(String html) auf, um das Modal zu rendern.

    Tabelle : 8. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 9. Ergebnisse
    Typ Beschreibung
    void

    Das folgende Codebeispiel zeigt, wie Sie ein GlideModal- Objekt mithilfe der UI-Seiten glide_confirm und glide_infoinstanziieren, verschiedene Einstellungen festlegen und dann das entsprechende Modal in der Anwenderoberfläche anzeigen (Rendern).

    var UpdateSetClient = Class.create({
    
      mergeConfirm: function () {
        var filterCriteriaMsg = "Please select filter criteria matching two or more update sets to merge";
        var messageMap = new GwtMessage().getMessages([filterCriteriaMsg, "Confirmation",
          "Are you sure you want to merge these {0} update sets? You will not be able to undo this action",
          "Invalid selection", "OK", "Cancel"]);
        var list = GlideList2.get('sys_update_set');
        var dialog;
        if (list.totalRows == 0 || list.totalRows == 1) {
          dialog = new GlideModal('glide_info', true, 300);
          dialog.setPreference('focusTrap', true);
          dialog.setTitle(messageMap["Invalid selection"]);
          dialog.setPreference('body', messageMap[filterCriteriaMsg]);
          dialog.setPreference('buttonLabel', messageMap["OK"]);
          dialog.render();
          return;
        }
        dialog = new GlideModal('glide_confirm', true, 300);
        dialog.setTitle(messageMap["Confirmation"]);
        dialog.setPreference('focusTrap', true);
        dialog.setPreference('body', new GwtMessage().format(
          messageMap["Are you sure you want to merge these {0} update sets? You will not be able to undo this action"],
          list.totalRows));
        dialog.setPreference('buttonLabelComplete', messageMap["OK"]);
        dialog.setPreference('onPromptComplete', this.merge);
        dialog.setPreference('buttonLabelCancel', messageMap["Cancel"]);
        dialog.setPreference('onPromptCancel', this.mergeExit);
        dialog.render();
      },
    
      merge: function () {
      var list = GlideList2.get('sys_update_set');
      var query = list.getQuery();
      var name = $('update_set_name').value;
      var comments = $('update_set_comments').value;
    
      var gurl = new GlideAjax('AngularProcessor','angular.do');
      gurl.addParam('sysparm_type', 'hub_client');
      gurl.addParam('type', 'merge_update_sets');
      gurl.addParam('name', name);
      gurl.addParam('comments', comments);
      gurl.addParam('query', query);
      gurl.getXML(function (response) {
          var data = response.responseText.evalJSON();
          var p = data.progress;
          if (p) {
            var progressId = p.progress_id;
            var map = new GwtMessage().getMessages(["Close", "Update Set Merge"]);
            var dialogClass = window.GlideModal ? GlideModal : GlideDialogWindow;
            var dd = new dialogClass("hierarchical_progress_viewer", false, "40em", "10.5em");
            dd.setPreference('focusTrap', true);
            dd.setTitle(map["Update Set Merge"]);
            dd.setPreference('sysparm_renderer_execution_id', progressId);
            dd.setPreference('sysparm_renderer_expanded_levels', '0'); // collapsed root node by default
            dd.setPreference('sysparm_button_close', map["Close"]);
            dd.render();
            //when all trackers are completed
            dd.on("executionComplete", function(trackerObj) {
              if (trackerObj.state == "2") {
                var redirectUrl = new GlideURL('sys_update_set_list.do');
                window.location.replace(redirectUrl.getURL());
                return;
              }
              var closeBtn = $("sysparm_button_close");
              if (closeBtn) {
                closeBtn.onclick = function() {
                  dd.destroy();
                };
              }
            });
          }
        });
      },
    
      mergeExit: function () {
        // Do nothing interesting...
      }
    });

    GlideModal – renderWithContent(Object HTML)

    Zeigt ein Modal mit dem angegebenen objektbasierten HTML-Inhalt an.

    Verwenden Sie die renderWithContent() -Methode anstelle der render()- Methode, wenn Sie den modalen Inhalt von HTML ableiten.

    Tabelle : 10. Parameter
    Name Typ Beschreibung
    html Objekt HTML-Inhalt, der im Modal angezeigt werden soll.
    Tabelle : 11. Rückgaben
    Typ Beschreibung
    void

    Das folgende Beispielzeigt, wie „Hello World“ im Modal angezeigt wird.

    var dialog = new GlideModal();
    dialog.renderWithContent('<div>Hello World</div>');

    GlideModal – renderWithContent(String html)

    Zeigt ein Modal mit dem angegebenen zeichenfolgenbasierten HTML-Inhalt an.

    Verwenden Sie die renderWithContent() -Methode anstelle der render()- Methode, wenn Sie den modalen Inhalt von HTML ableiten.

    Tabelle : 12. Parameter
    Name Typ Beschreibung
    html Zeichenfolge HTML-Inhalt, der im Modal angezeigt werden soll.
    Tabelle : 13. Rückgaben
    Typ Beschreibung
    void

    Dieses Codebeispiel zeigt, wie ein Modal angezeigt wird, das mit der übergebenen HTML-Zeichenfolge erstellt wurde, die eine Liste von Auswahlmöglichkeiten enthält, aus denen der Anwender auswählen kann.

    function cancelDialog(){
    
      var dialog = new GlideModal('cancelTask');
      //Sets the dialog title
      dialog.setTitle('Cancel Task');
      //Set up valid custom HTML to display
      dialog.renderWithContent('<div style="padding:15px"><p>What action do you want to take?</p>
        <p><select name="cancellation" id="taskCancellation" class="form-control">
        <option value="cancelOnly" role="option">Cancel this task but keep the requested item open</option>
        <option value="cancelAll" role="option">Cancel this and all other tasks, closing the requested item</option>
        </select></p><div style="padding:5px;float:right"><button style="padding:5px;margin-right:10px"      onclick="window.changeTaskAction(this.innerHTML,jQuery(\'#taskCancellation\').val())"      class="btn btn-default">Abort</button><button style="padding:5px" class="btn btn-primary"      onclick="window.changeTaskAction(this.innerHTML,jQuery(\'#taskCancellation\').val())">Cancel Task</button></div></div>');
    
      //Use the windows object to ensure the code is accessible from the modal dialog
      window.changeTaskAction = function(thisButton, thisAction){
    
        //Close the GlideModal dialog window
        dialog.destroy();
    
        //Submit to the back-end
        if(thisButton=='Cancel Task'){
          if(thisAction=="cancelAll"){
            g_form.setValue('state',4);//Closed Incomplete -- will close the Requested Item and all other open tasks
          }else{
            g_form.setValue('state',7);//Closed Skipped -- will only close this task
          }
             //Regular ServiceNow form submission
             gsftSubmit(null, g_form.getFormElement(), 'cancel_sc_task');
          }
       };
       return false;//Prevents the form from submitting when the dialog first load
    }

    GlideModal – setPreference(String name, String value)

    Legt den Wert der angegebenen Einstellung (Eigenschaft) fest. Verwenden Sie Einstellungen, um Daten an die zu rendernde Seite zu übergeben.

    Um Einstellungen auf einer UI-Seite abzurufen, verwenden Sie die folgende Funktion: RP.getWindowProperties().get('preference_name'). Weitere Informationen zu Einstellungen finden Sie unter GlideModal : Client.

    Tabelle : 14. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Name der Einstellung, deren Wert festgelegt werden soll.
    Wert Zeichenfolge Wert, der in der angegebenen Einstellung gespeichert werden soll.
    Tabelle : 15. Rückgaben
    Typ Beschreibung
    void

    Das folgende Codebeispiel zeigt, wie Sie die Einstellung table auf „task“ und die Einstellung name auf „value“ festlegen.

    var dialog = new GlideModal('UI_dialog_name');
    
    //Set the dialog title
    dialog.setTitle('Show title'); 
    
    //Set the desired preferences
    dialog.setPreference('table', 'task'); 			
    dialog.setPreference('name', 'value');        	
    
    //Opens the dialog
    dialog.render();

    Das folgende Beispiel zeigt, wie Basiseinstellungen in einem glide_confirm-Modal festgelegt werden.

    var dialog = new GlideModal('glide_confirm', true, 300);
      dialog.setTitle('Example Title');
      dialog.setPreference('body', 'Example Body');
      dialog.setPreference('focusTrap', true);
      dialog.setPreference('callbackParam', 'exampleParameter');
      dialog.setPreference('buttonClassComplete', 'btn-primary');
      dialog.setPreference('onPromptComplete', function(param) {
        console.log('Prompt completed with param: ' + param);
      });
    
      dialog.setPreference('onPromptCancel', function(param) {
        console.log('Prompt cancelled with param: ' + param);
      });
    
    dialog.render();

    GlideModal – setPreferenceAndReload(Array-Eigenschaften)

    Legt die angegebenen Einstellungen fest und lädt dann das Modal neu.

    Tabelle : 16. Parameter
    Name Typ Beschreibung
    Eigenschaften Array Als Einstellungen festzulegende Name-Wert-Paare.
    Tabelle : 17. Rückgaben
    Typ Beschreibung
    void

    In diesem Beispiel wird gezeigt, wie Sie ein modales Element erstellen und rendern, anschließend die Textkörpereinstellung aktualisieren und das modale Element neu laden.

    var dialog = new GlideModal('glide_confirm');
    dialog.setPreference('body', 'This is a test modal body');
    dialog.setTitle('This is a test modal title');
    dialog.render();
    
    ...
    
    dialog.setPreferenceAndReload({'body': 'this is another body'})

    GlideModal – setTitle(String-Titel)

    Legt den Titel des Modals fest.

    Tabelle : 18. Parameter
    Name Typ Beschreibung
    title Zeichenfolge Text, der im Titel des Modals angezeigt werden soll.
    Tabelle : 19. Rückgaben
    Typ Beschreibung
    void

    Das folgende Codebeispiel zeigt, wie der modale Titel auf „Zu aktualisierende Tabelle“ festgelegt wird.

    var dialog = new GlideModal('UI_dialog_name');
    
    //Sets the dialog title
    dialog.setTitle('Table to update'); 
    dialog.setPreference('table', 'task'); 			      	
    dialog.setWidth(550);
    
    //Opens the dialog
    dialog.render();

    GlideModal – setWidth(Number/Stringbreite)

    Legt die Breite des Modalsfest.

    Sie können die Breite eines Modals auch festlegen, wenn Sie die API zum ersten Mal mit der Methode GlideModal: GlideModal(String id, Boolean readOnly, Anzahl/Zeichenfolgebreite) instanziieren.

    Tabelle : 20. Parameter
    Name Typ Beschreibung
    width Zahl oder Zeichenfolge Breite des Modals in Pixel oder die CSS-Klasse des Modals. Wenn eine Pixelbreite übergeben wird, wird die angegebene Breite an der entsprechenden CSS-Klasse ausgerichtet.
    Mögliche modale CSS-Klassen:
    • modal-alert: (300 px) Wird zugewiesen, wenn die angegebene Breite 0 bis 349 Pixel beträgt.
    • modal-sm: (400 px) Wird zugewiesen, wenn die angegebene Breite 350 bis 449 Pixel beträgt.
    • modal-md: (600 px) Wird zugewiesen, wenn die angegebene Breite 450 bis 649 Pixel beträgt.
    • modal-lg: (900 px) Wird zugewiesen, wenn die angegebene Breite 650 bis 900 Pixel beträgt.

    Maximale Breite: 900 Pixel

    Tabelle : 21. Rückgaben
    Typ Beschreibung
    void

    Das folgende Codebeispiel zeigt, wie Sie die Breite des Dialogfelds auf 550 Pixel festlegen.

    var dialog = new GlideModal('UI_dialog_name');
    
    //Sets the dialog title
    dialog.setTitle('Show title'); 
    dialog.setPreference('name', 'value'); 			      	
    dialog.setWidth(550);
    
    //Opens the dialog
    dialog.render();

    GlideModal – SwitchView(String NewView)

    Ändern Sie die Ansicht , und laden Sie das Modal neu.

    Tabelle : 22. Parameter
    Name Typ Beschreibung
    newView Zeichenfolge Zu verwendende Ansicht.
    Tabelle : 23. Rückgaben
    Typ Beschreibung
    void

    In diesem Beispielgeht es um a