---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideModal : Client

# GlideModal : Client {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

Die GlideModal- API bietet Methoden zum Anzeigen einer Inhaltsüberlagerung.

Verwenden Sie diese 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.  
Dies ist ein vollständiger Ersatz für die APIs „ GlideWindow" und „GlideDialogWindow".Abbildung : 1. Beispielüberlagerung

## GlideModal: GlideModal (Zeichenfolgen-ID, boolescher Lesezugriff, Zahlenbreite) {#ariaid-title2}

Erstellt eine Instanz der GlideModalV3-Klasse.
{#r_GMODV3-GlideModal_S_B_N__table_ups_b4s_3v__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| id | Zeichenfolge | UI-Seite, die in das Modal geladen werden soll. |
| readOnly | Boolean | Kennzeichnung, die angibt, ob die Schaltfläche „Schließen" im Modal ausgeblendet werden soll. Gültige Werte: * „wahr": Schaltfläche „Schließen" im Modal nicht anzeigen. * false: Schaltfläche „Schließen" im Modal anzeigen. Standardwert: false |
| width | Nummer | Breite des Dialogfelds in Pixel. Standard: Maximale Breite: 900 Pixel Hinweis: Sie können die Breite des Dialogfelds auch mit der Methode [GlideModal -- setWidth (Zahlenbreite)](https://www.servicenow.com/docs/Y_5eOyijOldNViMtagvSUw#r_GMODV3-setWidth_N "Legt die Breite des Dialogfelds in Pixel fest.") festlegen. |
[Tabelle : 1. Parameter]

{#r_GMODV3-GlideModal_S_B_N__table_ups_b4s_3v}

## GlideModal -- get(String id) {#ariaid-title3}

Rufen Sie ein GlideModal-Objekt nach ID ab.
{#r_GMODV3-get_S__table_vwy_xjz_3v__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| id | Zeichenfolge | Element-ID des GlideModal-Objekts. |
[Tabelle : 2. Parameter]

{#r_GMODV3-get_S__table_vwy_xjz_3v} {#r_GMODV3-get_S__table_wwy_xjz_3v__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideModal | Objekt. |
[Tabelle : 3. Ergebnisse]

{#r_GMODV3-get_S__table_wwy_xjz_3v}

## GlideModal -- getPreference(String name) {#ariaid-title4}

Gibt den Wert der angegebenen Einstellung (Eigenschaft) zurück.
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)](https://www.servicenow.com/docs/Y_5eOyijOldNViMtagvSUw#r_GMODV3-setPreference_S_S "Legt das angegebene Feld im aktuellen Formular auf den angegebenen Wert fest.") erstellt. Das Clientskript der UI-Seite verbraucht diese Einstellungen dann mit dieser Methode.
{#r_GMODV3-getPreference_S__table_r2h_mrs_3v__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Name | Zeichenfolge | Name des abzurufenden Einstellungswerts. Dieser Wert muss zuvor im Modal mit der Methode [GlideModal -- setPreference(String name, String value)](https://www.servicenow.com/docs/Y_5eOyijOldNViMtagvSUw#r_GMODV3-setPreference_S_S "Legt das angegebene Feld im aktuellen Formular auf den angegebenen Wert fest.") festgelegt worden sein. |
[Tabelle : 4. Parameter]

{#r_GMODV3-getPreference_S__table_r2h_mrs_3v} {#r_GMODV3-getPreference_S__table_s2h_mrs_3v__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Wert der angegebenen Einstellung. |
[Tabelle : 5. Ergebnisse]

{#r_GMODV3-getPreference_S__table_s2h_mrs_3v}  
Dieses Beispiel zeigt einen einfachen Fall, bei dem eine Einstellung festgelegt und dann aus einem angegebenen modalen Element abgerufen wird.

    var gm = new GlideModal('UI_dialog_name');
    //Sets the dialog title
    gm.setTitle('Show title');

    //sets the value of the preference table
    gm.setPreference('table', 'incident');

    //gets the value of the preference table
    var title = gm.getPreference('table');

## GlideModal -- render() {#ariaid-title5}

Rendert die UI-Seite im Modal.
{#r_GMODV3-render__table_zky_hpy_3v__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 6. Parameter]

{#r_GMODV3-render__table_zky_hpy_3v} {#r_GMODV3-render__table_aly_hpy_3v__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 7. Ergebnisse]

{#r_GMODV3-render__table_aly_hpy_3v}  

    var gm = new GlideModal("UI_dialog_name");

    //Sets the dialog title
    gm.setTitle('Show title');		      	
    gm.setWidth(550);

    //Opens the dialog
    gm.render();

## GlideModal -- renderWithContent(Object HTML) {#ariaid-title6}

Zeigt ein Modal mit dem angegebenen HTML-Inhalt an.
Die renderWithContent()-Methode ersetzt die render()-Methode und fordert keine UI-Seite zum Rendern an.
{#r_GMODV3-renderWithContent_O__table_n43_xhz_3v__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| html | Objekt | HTML-Inhalt, der im Modal angezeigt werden soll. |
[Tabelle : 8. Parameter]

{#r_GMODV3-renderWithContent_O__table_n43_xhz_3v} {#r_GMODV3-renderWithContent_O__table_o43_xhz_3v__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 9. Ergebnisse]

{#r_GMODV3-renderWithContent_O__table_o43_xhz_3v}

## GlideModal -- renderWithContent(String html) {#ariaid-title7}

Zeigt ein Modal mit dem angegebenen HTML-Inhalt an.
Die renderWithContent()-Methode ersetzt die render()-Methode und fordert keine UI-Seite zum Rendern an.
{#r_GMODV3-renderWithContent_S__table_xss_3hz_3v__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| html | Zeichenfolge | HTML-Inhalt, der im Modal angezeigt werden soll. |
[Tabelle : 10. Parameter]

{#r_GMODV3-renderWithContent_S__table_xss_3hz_3v} {#r_GMODV3-renderWithContent_S__table_yss_3hz_3v__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 11. Ergebnisse]

{#r_GMODV3-renderWithContent_S__table_yss_3hz_3v}

## GlideModal -- setPreference(String name, String value) {#ariaid-title8}

Legt das angegebene Feld im aktuellen Formular auf den angegebenen Wert fest.
{#r_GMODV3-setPreference_S_S__table_cvd_zqs_3v__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Name | Zeichenfolge | Name des zu aktualisierenden Formularfelds. Wenn dieses Feld im aktuellen Formular nicht vorhanden ist, wird die Anforderung ignoriert. |
| Wert | Zeichenfolge | Wert, der im angegebenen Formularfeld gespeichert werden soll. |
[Tabelle : 12. Parameter]

{#r_GMODV3-setPreference_S_S__table_cvd_zqs_3v} {#r_GMODV3-setPreference_S_S__table_dvd_zqs_3v__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 13. Ergebnisse]

{#r_GMODV3-setPreference_S_S__table_dvd_zqs_3v}  

    var gm = new GlideModal('UI_dialog_name');
    //Sets the dialog title
    gm.setTitle('Show title'); 
    gm.setPreference('table', 'task'); 			
    gm.setPreference('name', 'value');        	

    //Opens the dialog
    gm.render();

## GlideModal -- setPreferenceAndReload(Array-Eigenschaften) {#ariaid-title9}

Legt die Eigenschaften fest und lädt das Modal erneut.
{#r_GMODV3-setPrefAndReload_A__table_u3v_jqy_3v__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Eigenschaften | Array | Array von Name-Wert-Paaren, die festgelegt werden sollen. |
[Tabelle : 14. Parameter]

{#r_GMODV3-setPrefAndReload_A__table_u3v_jqy_3v} {#r_GMODV3-setPrefAndReload_A__table_v3v_jqy_3v__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 15. Ergebnisse]

{#r_GMODV3-setPrefAndReload_A__table_v3v_jqy_3v}

## GlideModal -- setTitle(String-Titel) {#ariaid-title10}

Legt den Titel des Modals fest.
{#r_GMODV3-setTitle_S__table_kxd_l5s_3v__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| title | Zeichenfolge | Anzuzeigender Titel |
[Tabelle : 16. Parameter]

{#r_GMODV3-setTitle_S__table_kxd_l5s_3v} {#r_GMODV3-setTitle_S__table_lxd_l5s_3v__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 17. Ergebnisse]

{#r_GMODV3-setTitle_S__table_lxd_l5s_3v}  

    var dialog = new GlideModal('UI_dialog_name');

    //Sets the dialog title
    dialog.setTitle('Show title');
    dialog.setPreference('name', 'value');
     			      	        
    //Opens the dialogdialog.render(); 

## GlideModal -- setWidth (Zahlenbreite) {#ariaid-title11}

Legt die Breite des Dialogfelds in Pixel fest.
Sie können die Breite eines Modals auch festlegen, wenn Sie es zum ersten Mal mit der Methode [GlideModal: GlideModal (Zeichenfolgen-ID, boolescher Lesezugriff, Zahlenbreite)](https://www.servicenow.com/docs/Y_5eOyijOldNViMtagvSUw#r_GMODV3-GlideModal_S_B_N "Erstellt eine Instanz der GlideModalV3-Klasse.") instanziieren.
{#r_GMODV3-setWidth_N__table_msx_wts_3v__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| width | Nummer | Anzahl der Pixel, die als Breite des Modals festgelegt werden sollen. Maximum: 900 Pixel |
[Tabelle : 18. Parameter]

{#r_GMODV3-setWidth_N__table_msx_wts_3v} {#r_GMODV3-setWidth_N__table_nsx_wts_3v__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 19. Ergebnisse]

{#r_GMODV3-setWidth_N__table_nsx_wts_3v}  

    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) {#ariaid-title12}

Ändert die Ansicht und lädt das Modal erneut.
{#r_GMODV3-switchView_S__table_ovv_5py_3v__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| newView | Zeichenfolge | Uu verwendende Ansicht. |
[Tabelle : 20. Parameter]

{#r_GMODV3-switchView_S__table_ovv_5py_3v} {#r_GMODV3-switchView_S__table_pvv_5py_3v__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 21. Ergebnisse]

{#r_GMODV3-switchView_S__table_pvv_5py_3v}