---
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


---

# cabrillo.modal - cliente

# cabrillo.modal - cliente {#ariaid-title1}

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

Cabrillo JS funções para apresentar conteúdo da Web dentro de modais nativos.

## cabrillo.modal - DispensaModal(Dados do objeto) {#ariaid-title2}

Use para descartar um modal que foi apresentado com a funçãopresentModal().
Um modal apresentado é responsável por descartar a si mesmo e passar todos os resultados de volta para o contexto de apresentação. A função DispensaModal() deve ser chamada a partir do contexto apresentado, não a partir do contexto de apresentação.
{#CM-dismissModal_O__table_wmf_jzm_wbb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| dados | Objeto | Opcional. Um objeto a ser passado de volta para o contexto de apresentação quando o contexto apresentado se descarta. |
[Tabela 1. Parâmetros]

{#CM-dismissModal_O__table_wmf_jzm_wbb} {#CM-dismissModal_O__table_xmf_jzm_wbb__entry__2}

| Tipo | Descrição |
|-|-|
| promessa | Se for bem-sucedido, um objeto não resolvido, caso contrário, um erro. |
[Tabela 2. Retorna]

{#CM-dismissModal_O__table_xmf_jzm_wbb}  

    // Any object can be passed back to the presenting context when the presented context dismisses itself.
    var results = {
        team: 'Mobile'
        company: 'ServiceNow'
    }

    cabrillo.modal.dismissModal(results).then(function() {
        console.log('Modal was dismissed and results were passed to presenting context.');
    }, function(error) {
        console.log(error);
    });

## cabrillo.modal -presentModal(cadeia de caracteres título, cadeia de caracteres URL, cadeia de caracteres closeButtonStyle, cadeia de caracteres modalPresentationStyle) {#ariaid-title3}

Apresenta conteúdo em uma interface modal nativa.
{#CM-presentModal_S_S_S_S__table_zcl_dxm_wbb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| título | Cadeia de caracteres | Título da interface modal. |
| URL | Cadeia de caracteres | O URL para abrir o modal. Deve ser uma URL de instância interna (totalmente qualificada ou relativa; uma URL relativa é preferencial). |
| closeButtonStyle | Cadeia de caracteres | Estilo do botão Fechar da interface modal. Valores possíveis: * cabrillo.modal.CLOSE_BUTTON_STYLE_CANCEL * cabrillo.modal.CLOSE_BUTTON_STYLE_CLOSE * cabrillo.modal.CLOSE_BUTTON_STYLE_DONE {#CM-presentModal_S_S_S_S__ul_sgf_hcm_pyb}Para obter mais informações, consulte [Constantes de Cabrillo JS - estilos do botão de fechar](https://servicenow-prod.fluidtopics.net/i89zJ0DKVCbgE3Sns0mpFA#cabrillo-close-button-styles "Constantes a serem usadas ao definir o estilo do botão Fechar de interfaces modais."). |
| EstiloDeApresentaçãomodal | Cadeia de caracteres | Estilo de apresentação da interface modal. Valores possíveis: * cabrillo.modal.MODAL_PRESENTATION_STYLE_FULL_SCREEN * cabrillo.modal.MODAL_PRESENTATION_STYLE_FORM_SHEET {#CM-presentModal_S_S_S_S__ul_ald_sbm_pyb}Para obter mais informações, consulte [Constantes de Cabrillo JS - estilos de apresentação modal](https://servicenow-prod.fluidtopics.net/i89zJ0DKVCbgE3Sns0mpFA#cabrillo-modal-present-styles "Constantes a serem usadas ao definir o estilo de apresentação de interfaces modais."). Nota: Este parâmetro só tem suporte em Apple iOS. |
[Tabela 3. Parâmetros]

{#CM-presentModal_S_S_S_S__table_zcl_dxm_wbb} {#CM-presentModal_S_S_S_S__table_adl_dxm_wbb__entry__2}

| Tipo | Descrição |
|-|-|
| promessa | Se for bem-sucedido, um objeto Cabrillo.ModalResponse, caso contrário, um erro. |
[Tabela 4. Retorna]

{#CM-presentModal_S_S_S_S__table_adl_dxm_wbb}  
Apresente um modal nativo que carregue uma URL personalizada. Apresenta uma página personalizada do Portal de serviços em um modal de estilo de folha de formulário. A promessa é cumprida quando o modal é descartado. Consulte a função DispensaModal() para obter capacidades de descarte personalizadas.

    cabrillo.modal.presentModal('Portal Page',
        '/$sp.do?id=my_modal_page',
        cabrillo.modal.CLOSE_BUTTON_STYLE_CLOSE,
        cabrillo.modal.MODAL_PRESENTATION_STYLE_FORM_SHEET
    ).then(function(response) {
        // The results from the modal are in a results key on the response object.
        var results = response && response.results ? response.results : null;

        if (results) {
            console.log('Modal dismissed with results.', results);
        } else {
            console.log('Modal dismissed without results.');
        }
    }, function(error) {
        console.log(error);
    });