---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideModal : client

# GlideModal : client {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes de lecture

L'API GlideModal fournit des méthodes pour afficher une superposition de contenu.

Utilisez ces méthodes dans les scripts partout où vous pouvez utiliser JavaScript côté client. Ces méthodes sont le plus souvent appelées à partir d'une action d'interface utilisateur avec la case Client cochée.  
Il s'agit d'un remplacement complet des API GlideWindow et GlideDialogWindow .Figure 1. Exemple de superposition

## GlideModal : GlideModal(ID de chaîne, booléen readOnly, largeur numérique) {#ariaid-title2}

Crée une instance de la classe GlideModalV3.
{#r_GMODV3-GlideModal_S_B_N__table_ups_b4s_3v__entry__3}

| Nom | Type | Description |
|-|-|-|
| id | Chaîne | Page d'interface utilisateur à charger dans le modal. |
| readOnly | Booléen | Marqueur indiquant s'il faut masquer le bouton Fermer dans le modal. Valeurs valides : * true : n'affiche pas le bouton Fermer dans la fenêtre modale. * false : affiche le bouton Fermer dans le modal. Valeur par défaut : false |
| largeur | Numéro | Largeur du modal en pixels. Par défaut : Largeur maximale : 900 pixels Remarque : Vous pouvez également définir la largeur de la fenêtre modale à l'aide de la [GlideModal : setWidth(largeur du nombre)](https://servicenow-prod.fluidtopics.net/a7T_lXmQ9ibLGdFo5BGh8g#r_GMODV3-setWidth_N "Définit la largeur du modal en pixels.") méthode. |
[Tableau 1. Paramètres]

{#r_GMODV3-GlideModal_S_B_N__table_ups_b4s_3v}

## GlideModal : obtenir (ID de chaîne) {#ariaid-title3}

Obtenir un objet GlideModal par ID.
{#r_GMODV3-get_S__table_vwy_xjz_3v__entry__3}

| Nom | Type | Description |
|-|-|-|
| id | Chaîne | ID d'élément de l'objet GlideModal. |
[Tableau 2. Paramètres]

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

| Type | Description |
|-|-|
| GlideModal | L'objet. |
[Tableau 3. Renvoie]

{#r_GMODV3-get_S__table_wwy_xjz_3v}

## GlideModal : getPreference(nom de la chaîne) {#ariaid-title4}

Renvoie la valeur de la préférence spécifiée (propriété).
L'invocation d'actions qui créent le modal crée généralement aussi les préférences nécessaires pour le modal à l'aide de la [GlideModal : setPreference(nom de chaîne, valeur de chaîne)](https://servicenow-prod.fluidtopics.net/a7T_lXmQ9ibLGdFo5BGh8g#r_GMODV3-setPreference_S_S "Définit le champ spécifié dans le formulaire actuel sur la valeur spécifiée.") méthode. Le script client de la page d'interface utilisateur utilise ensuite ces préférences à l'aide de cette méthode.
{#r_GMODV3-getPreference_S__table_r2h_mrs_3v__entry__3}

| Nom | Type | Description |
|-|-|-|
| nom | Chaîne | Nom de la valeur de préférence à récupérer. Cette valeur doit avoir été définie au préalable sur le modal à l'aide de la [GlideModal : setPreference(nom de chaîne, valeur de chaîne)](https://servicenow-prod.fluidtopics.net/a7T_lXmQ9ibLGdFo5BGh8g#r_GMODV3-setPreference_S_S "Définit le champ spécifié dans le formulaire actuel sur la valeur spécifiée.") méthode. |
[Tableau 4. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Valeur de la préférence spécifiée. |
[Tableau 5. Renvoie]

{#r_GMODV3-getPreference_S__table_s2h_mrs_3v}  
Cet exemple montre un cas simple de définition d'une préférence, puis de récupération de cette préférence à partir d'une fenêtre modale spécifiée.

    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}

Affiche la page d'interface utilisateur dans le modal.
{#r_GMODV3-render__table_zky_hpy_3v__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 6. Paramètres]

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

| Type | Description |
|-|-|
| nul |   |
[Tableau 7. Renvoie]

{#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}

Affichez une fenêtre modale avec le contenu HTML spécifié.
La méthode renderWithContent() remplace la méthode render() et ne demande pas qu'une page d'interface utilisateur s'affiche.
{#r_GMODV3-renderWithContent_O__table_n43_xhz_3v__entry__3}

| Nom | Type | Description |
|-|-|-|
| html | Objet | Contenu HTML à afficher dans le modal. |
[Tableau 8. Paramètres]

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

| Type | Description |
|-|-|
| nul |   |
[Tableau 9. Renvoie]

{#r_GMODV3-renderWithContent_O__table_o43_xhz_3v}

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

Affichez une fenêtre modale avec le contenu HTML spécifié.
La méthode renderWithContent() remplace la méthode render() et ne demande pas qu'une page d'interface utilisateur s'affiche.
{#r_GMODV3-renderWithContent_S__table_xss_3hz_3v__entry__3}

| Nom | Type | Description |
|-|-|-|
| html | Chaîne | Contenu HTML à afficher dans le modal. |
[Tableau 10. Paramètres]

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

| Type | Description |
|-|-|
| nul |   |
[Tableau 11. Renvoie]

{#r_GMODV3-renderWithContent_S__table_yss_3hz_3v}

## GlideModal : setPreference(nom de chaîne, valeur de chaîne) {#ariaid-title8}

Définit le champ spécifié dans le formulaire actuel sur la valeur spécifiée.
{#r_GMODV3-setPreference_S_S__table_cvd_zqs_3v__entry__3}

| Nom | Type | Description |
|-|-|-|
| nom | Chaîne | Nom du champ de formulaire à mettre à jour. Si ce champ n'existe pas sur le formulaire actuel, la demande est ignorée. |
| valide | Chaîne | Valeur à stocker dans le champ de formulaire spécifié. |
[Tableau 12. Paramètres]

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

| Type | Description |
|-|-|
| nul |   |
[Tableau 13. Renvoie]

{#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(Propriétés du tableau) {#ariaid-title9}

Définissez les propriétés et rechargez le modal.
{#r_GMODV3-setPrefAndReload_A__table_u3v_jqy_3v__entry__3}

| Nom | Type | Description |
|-|-|-|
| Propriétés de | Tableau | Un tableau de paires nom-valeur à définir. |
[Tableau 14. Paramètres]

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

| Type | Description |
|-|-|
| nul |   |
[Tableau 15. Renvoie]

{#r_GMODV3-setPrefAndReload_A__table_v3v_jqy_3v}

## GlideModal : setTitle (titre de la chaîne) {#ariaid-title10}

Définit le titre du modal.
{#r_GMODV3-setTitle_S__table_kxd_l5s_3v__entry__3}

| Nom | Type | Description |
|-|-|-|
| Titre | Chaîne | Titre à afficher |
[Tableau 16. Paramètres]

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

| Type | Description |
|-|-|
| nul |   |
[Tableau 17. Renvoie]

{#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(largeur du nombre) {#ariaid-title11}

Définit la largeur du modal en pixels.
Vous pouvez également définir la largeur d'un modal lorsque vous l'instanciez pour la première fois à l'aide de la [GlideModal : GlideModal(ID de chaîne, booléen readOnly, largeur numérique)](https://servicenow-prod.fluidtopics.net/a7T_lXmQ9ibLGdFo5BGh8g#r_GMODV3-GlideModal_S_B_N "Crée une instance de la classe GlideModalV3.") méthode.
{#r_GMODV3-setWidth_N__table_msx_wts_3v__entry__3}

| Nom | Type | Description |
|-|-|-|
| largeur | Numéro | Nombre de pixels à définir comme largeur du modal. Maximum : 900 pixels |
[Tableau 18. Paramètres]

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

| Type | Description |
|-|-|
| nul |   |
[Tableau 19. Renvoie]

{#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}

Changez la vue et rechargez la fenêtre modale.
{#r_GMODV3-switchView_S__table_ovv_5py_3v__entry__3}

| Nom | Type | Description |
|-|-|-|
| newView | Chaîne | Vue à utiliser. |
[Tableau 20. Paramètres]

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

| Type | Description |
|-|-|
| nul |   |
[Tableau 21. Renvoie]

{#r_GMODV3-switchView_S__table_pvv_5py_3v}