---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideModal - Cliente

# GlideModal - Cliente {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 min. de leitura

A API GlideModal fornece métodos para exibir uma sobreposição de conteúdo.

Use esses métodos em scripts em qualquer lugar em que você possa usar JavaScript do lado do cliente. Esses métodos são chamados com mais frequência a partir de uma ação de IU com a caixa de seleção Cliente marcada.  
Esta é uma substituição com todos os recursos das APIs GlideWindow e GlideDialogWindow.Figura 1. Exemplo de sobreposição

## GlideModal -- GlideModal (Identificador de cadeia de caracteres, Booliano somente leitura, Largura numérica) {#ariaid-title2}

Cria uma instância da classe GlideModalV3.
{#r_GMODV3-GlideModal_S_B_N__table_ups_b4s_3v__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| ID | Cadeia de caracteres | Página de IU a ser carregada no modal. |
| readOnly | Booliano | Sinalizador que indica se o botão Fechar deve ser ocultado no modal. Valores válidos: * verdadeiro: não exibe o botão Fechar no modal. * falso: exibe o botão Fechar no modal. Padrão: falso |
| largura | Número | Largura do modal em pixels. Padrão: Largura máxima: 900 pixels Nota: Você também pode definir a largura do modal usando o método [GlideModal -- setWidth(largura do número)](https://servicenow-prod.fluidtopics.net/JlYMvzrSg495XDgCziTWCA#r_GMODV3-setWidth_N "Define a largura do modal em pixels."). |
[Tabela 1. Parâmetros]

{#r_GMODV3-GlideModal_S_B_N__table_ups_b4s_3v}

## GlideModal -- get(ID da cadeia de caracteres) {#ariaid-title3}

Obtenha um objeto GlideModal por ID.
{#r_GMODV3-get_S__table_vwy_xjz_3v__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| ID | Cadeia de caracteres | O ID do elemento do objeto GlideModal. |
[Tabela 2. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| GlideModal | O objeto. |
[Tabela 3. Retorna]

{#r_GMODV3-get_S__table_wwy_xjz_3v}

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

Retorna o valor da preferência especificada (propriedade).
Invocar ações que criam o modal normalmente também cria as preferências necessárias para o modal usando o método [GlideModal -- setPreference(cadeia de caracteres nome, cadeia de caracteres valor)](https://servicenow-prod.fluidtopics.net/JlYMvzrSg495XDgCziTWCA#r_GMODV3-setPreference_S_S "Define o campo especificado no formulário atual com o valor especificado."). O client script da página de IU consome essas preferências usando este método.
{#r_GMODV3-getPreference_S__table_r2h_mrs_3v__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | Nome do valor preferencial a ser recuperado. Este valor deve ter sido definido anteriormente no modal usando o método [GlideModal -- setPreference(cadeia de caracteres nome, cadeia de caracteres valor)](https://servicenow-prod.fluidtopics.net/JlYMvzrSg495XDgCziTWCA#r_GMODV3-setPreference_S_S "Define o campo especificado no formulário atual com o valor especificado."). |
[Tabela 4. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Valor da preferência especificada. |
[Tabela 5. Retorna]

{#r_GMODV3-getPreference_S__table_s2h_mrs_3v}  
Este exemplo mostra um caso simples de configuração de uma preferência e recuperação dessa preferência de um modal especificado.

    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 -- renderizar() {#ariaid-title5}

Renderiza a página de IU no modal.
{#r_GMODV3-render__table_zky_hpy_3v__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 6. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 7. Retorna]

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

Exibir um modal com o conteúdo HTML especificado.
O método renderWithContent() substitui o método render() e não solicita a renderização de uma página de IU.
{#r_GMODV3-renderWithContent_O__table_n43_xhz_3v__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| html | Objeto | O conteúdo HTML a ser mostrado no modal. |
[Tabela 8. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 9. Retorna]

{#r_GMODV3-renderWithContent_O__table_o43_xhz_3v}

## GlideModal -- renderWithContent(cadeia de caracteres html) {#ariaid-title7}

Exibir um modal com o conteúdo HTML especificado.
O método renderWithContent() substitui o método render() e não solicita a renderização de uma página de IU.
{#r_GMODV3-renderWithContent_S__table_xss_3hz_3v__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| html | Cadeia de caracteres | O conteúdo HTML a ser mostrado no modal. |
[Tabela 10. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 11. Retorna]

{#r_GMODV3-renderWithContent_S__table_yss_3hz_3v}

## GlideModal -- setPreference(cadeia de caracteres nome, cadeia de caracteres valor) {#ariaid-title8}

Define o campo especificado no formulário atual com o valor especificado.
{#r_GMODV3-setPreference_S_S__table_cvd_zqs_3v__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | Nome do campo de formulário a ser atualizado. Se este campo não existir no formulário atual, a solicitação será ignorada. |
| valor | Cadeia de caracteres | Valor a ser armazenado no campo de formulário especificado. |
[Tabela 12. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 13. Retorna]

{#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(propriedades de matriz) {#ariaid-title9}

Defina as propriedades e recarregue o modal.
{#r_GMODV3-setPrefAndReload_A__table_u3v_jqy_3v__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| propriedades | Matriz | Uma matriz de pares de nome-valor a serem definidos. |
[Tabela 14. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 15. Retorna]

{#r_GMODV3-setPrefAndReload_A__table_v3v_jqy_3v}

## GlideModal -- setTitle(cadeia de caracteres título) {#ariaid-title10}

Define o título do modal.
{#r_GMODV3-setTitle_S__table_kxd_l5s_3v__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| título | Cadeia de caracteres | Título a ser exibido |
[Tabela 16. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 17. Retorna]

{#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(largura do número) {#ariaid-title11}

Define a largura do modal em pixels.
Você também pode definir a largura de um modal ao instanciá-lo pela primeira vez usando o método [GlideModal -- GlideModal (Identificador de cadeia de caracteres, Booliano somente leitura, Largura numérica)](https://servicenow-prod.fluidtopics.net/JlYMvzrSg495XDgCziTWCA#r_GMODV3-GlideModal_S_B_N "Cria uma instância da classe GlideModalV3.").
{#r_GMODV3-setWidth_N__table_msx_wts_3v__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| largura | Número | Número de pixels a serem definidos como a largura do modal. Máximo: 900 pixels |
[Tabela 18. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 19. Retorna]

{#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(cadeia de caracteres newView) {#ariaid-title12}

Mude a exibição e recarregue o modal.
{#r_GMODV3-switchView_S__table_ovv_5py_3v__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| novaExibição | Cadeia de caracteres | A exibição a ser usada. |
[Tabela 20. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 21. Retorna]

{#r_GMODV3-switchView_S__table_pvv_5py_3v}