---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# SpModal -- Client

# SpModal -- Client {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 Minuten Lesedauer

Zeigt Warnungen, Hinweismeldungen und Bestätigungsdialoge in an ServiceportalWidgets. Die SpModal Klasse ist in verfügbar ServiceportalClient-Skripts.

Die SpModal Klasse ist ein leichter Wrapper für Angular UI Bootstrap [$uibModal](https://angular-ui.github.io/bootstrap/#/modal). Sie können verwenden SpModal.Open() Methode zum Anzeigen eines Widgets in einem modalen Dialogfeld.

## SpModal -- Warnung(Zeichenfolgennachricht).then(FN) {#ariaid-title2}

Zeigt eine Warnung an.
{#SPM-alert_S__table_r1l_rmy_my__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Nachricht | Zeichenfolge | Die anzuzeigende Nachricht. |
[Tabelle : 1. Parameter]

{#SPM-alert_S__table_r1l_rmy_my} {#SPM-alert_S__table_s1l_rmy_my__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Die Zusage enthält ein einzelnes Argument, das „wahr" oder „falsch" enthält. |
[Tabelle : 2. Rückgaben]

{#SPM-alert_S__table_s1l_rmy_my}  

    // HTML template 
    <button ng-click="c.onAlert()" class="btn btn-default">
        Alert
      </button>

    // Client script
    function(spModal) {
        var c = this;
      c.onAlert = function () {
            spModal.alert('How do you feel today?').then(function (answer) {
                c.simple = answer;
            });
        }
     }

## SpModal -- Bestätigen(Zeichenfolgennachricht).then(FN) {#ariaid-title3}

Zeigt eine Bestätigungsnachricht an.
{#SPM-confirm_S__table_t3x_rty_my__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Nachricht | Zeichenfolge | Die anzuzeigende Nachricht. |
[Tabelle : 3. Parameter]

{#SPM-confirm_S__table_t3x_rty_my} {#SPM-confirm_S__table_u3x_rty_my__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Die Zusage enthält ein einzelnes Argument, das „wahr" oder „falsch" enthält. |
[Tabelle : 4. Rückgaben]

{#SPM-confirm_S__table_u3x_rty_my}  

    // HTML template 
     <button ng-click="c.onConfirm()" class="btn btn-default"> Confirm </button> 
    <span>{{c.confirmed}}</span>   

    // Client script
    function(spModal) {
      var c = this;
      c.onConfirm = function() {
            c.confirmed = "asking";
            spModal.confirm("Can you confirm or deny this?").then(function(confirmed) {
                c.confirmed = confirmed; // true or false
            })
        }
     } 

Mit HTML-Nachricht bestätigen:

    //HTML template 
    <button ng-click="c.onConfirmEx()" class="btn btn-default">
        Confirm - HTML message
      </button>
      <span>{{c.confirmed}}</span>

    // Client script
    function(spModal) {
      var c = this;
      // more control, passing options
        c.onConfirmEx = function() {
            c.confirmed = "asking";
            var warn = '<i class="fa fa-warning" aria-hidden="true"></i>';
            spModal.open({
                title: 'Delete this Thing?',
                message: warn + ' Are you <b>sure</b> you want to do that?'
            }).then(function(confirmed) {
                c.confirmed = confirmed;
            })
        }
    }

## SpModal -- Open(Object options).then(FN) {#ariaid-title4}

Öffnet ein modales Fenster mit den angegebenen Optionen.
{#SPM-open_O__table_trg_vwy_my__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Optionen | Objekt | Ein Objekt, das diese Eigenschaften haben kann. * Hintergrund: Boolescher Wert\|Zeichenfolge. Steuert das Vorhandensein eines Hintergrunds. Gültige Werte: * Wahr: Zeigt den Hintergrund an. * Falsch: Kein Hintergrund. * Statisch: Deaktiviert das Schließen des modalen Elements durch Auswahl des Hintergrunds. Standard: Wahr * Schaltflächen: Array. Schaltflächen, die im Dialogfeld angezeigt werden sollen. Der Standardwert ist „Abbrechen" und „OK". * Eingabe: Boolescher Wert. Bei „wahr" wird ein Eingabefeld im Dialogfeld angezeigt. Standard: Falsch * Tastatur: Boolescher Wert. Bei „wahr" wird angegeben, dass das Dialogfeld mit der ESC-Taste geschlossen werden kann.Standard: Wahr * Nachricht: Zeichenfolge. HTML, die in den Header eingefügt wird. Standard: Leer * NoDismiss: Boolescher Wert. Bei „wahr" wird angegeben, dass der Header-Abschnitt vorhanden ist, der das Symbol „Schließen" enthält.Standard: Falsch * Freigegeben: Clientseitiges Objekt. Gibt Daten für das Client-Skript des eingebetteten Widgets frei. * Größe: Zeichenfolge. Größe des Fensters. Gültige Werte: „sm" oder „lg". Standard: Leer * Titel: Zeichenfolge. HTML, die in den Header eingefügt wird. Standard: Leer * Wert: Zeichenfolge. Wert des Eingabefelds. Standard: Leer * Widget: Zeichenfolge. Widget-ID oder sys_ID, die in das Dialogfeld eingebettet werden soll. Standard: Leer * Widget-Eingabe: Objekt. Wird als Eingabe an das eingebettete Widget gesendet. Standard: Null |
[Tabelle : 5. Parameter]

{#SPM-open_O__table_trg_vwy_my} {#SPM-open_O__table_urg_vwy_my__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 6. Rückgaben]

{#SPM-open_O__table_urg_vwy_my}  
Das folgende Codebeispiel zeigt, wie Sie einen Prompt mit einer Bezeichnung erstellen.

    //HTML template
    <button ng-click="c.onOpen()" class="btn btn-default">
        Prompt with label
      </button>
      <div ng-show="c.name">
        You answered <span>{{c.name}}</span>
      </div>

    //Client code
    function(spModal) {
      var c = this;
      c.onOpen = function() {
            //ask the user for a string
            spModal.open({
                title: 'Give me a name',
                message: 'What would you like to name it?',
                input: true,
                value: c.name
            }).then(function(name) {
                c.name = name;
            })
        }
    }

Das folgende Codebeispiel zeigt, wie die Option „anwenderdefinierte Schaltflächen" verwendet wird.

    //HTML template
    <button ng-click="c.onAgree()" class="btn btn-default">
        Agree
      </button>
      <div ng-show="c.agree">
        You answered {{c.agree}}
      </div>

    //Client script
    function(spModal) {
      var c = this;
      c.onAgree = function() {
            // ask the user for a string
            // note embedded html in message
            var h = '<h4>Apple likes people to agree to lots of stuff</h4>'
            // Line feeds added to the following lines for presentation formatting.
            var m = 'Your use of Apple software or hardware products is based 
    on the software license and other terms and conditions in effect for the 
    product at the time of purchase. Your agreement to these terms is required 
    to install or use the product. '
            spModal.open({
                title: 'Do you agree?',
                message: h + m,
                buttons: [
                    {label:'✘ ${No}', cancel: true},
                    {label:'✔ ${Yes}', primary: true}
                ]
            }).then(function() {
                c.agree = 'yes';
            }, function() {
                c.agree = 'no';
            })
        }
    }

Das folgende Codebeispiel zeigt, wie die eingebettete Widget-Option verwendet wird.

    //HTML template
    <button ng-click="c.onWidget('widget-cool-clock')" class="btn btn-default">
        Cool Clock
      </button>

    //Client script
    function(spModal) {
      var c = this;
      c.onWidget = function(widgetId, widgetInput) {
            spModal.open({
                title: 'Displaying widget ' + widgetId,
                widget: widgetId, 
                widgetInput: widgetInput || {}
            }).then(function(){
                console.log('widget dismissed');
            })      
        }
    }

## SpModal -- Prompt(Zeichenfolgennachricht, Zeichenfolge, Standard).then(FN) {#ariaid-title5}

Zeigt eine Aufforderung für Anwendereingaben an.
{#SPM-prompt_S_S__table_mvh_5vy_my__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Nachricht | Zeichenfolge | Die anzuzeigende Nachricht. |
| Standard (optional) | Zeichenfolge | Ein Standardwert, der verwendet werden soll, wenn der Anwender keine Antwort bereitstellt. |
[Tabelle : 7. Parameter]

{#SPM-prompt_S_S__table_mvh_5vy_my} {#SPM-prompt_S_S__table_nvh_5vy_my__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Die Zusage enthält die Antwort des Anwenders oder den Standardwert, wenn der Anwender keine Antwort eingibt. |
[Tabelle : 8. Rückgaben]

{#SPM-prompt_S_S__table_nvh_5vy_my}  

    //HTML template
     <button ng-click="c.onPrompt()" class="btn btn-default">
        Prompt
      </button>
      <div ng-show="c.name">
        You answered <span>{{c.name}}</span>
      </div>

    // Client script
    function(spModal) {
      var c = this;
      c.onPrompt = function() {
            spModal.prompt("Your name please", c.name).then(function(name) {
                c.name = name;
            })
        }
    }


