GlideModal - Cliente

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 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
    Exemplo de sobreposição

    GlideModal – GlideModal (Identificador de cadeia de caracteres, Booliano somente leitura, Largura numérica)

    Cria uma instância da classe GlideModalV3.

    Tabela 1. Parâmetros
    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).

    GlideModal – get(ID da cadeia de caracteres)

    Obtenha um objeto GlideModal por ID.

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    ID Cadeia de caracteres O ID do elemento do objeto GlideModal.
    Tabela 3. Retorna
    Tipo Descrição
    GlideModal O objeto.

    GlideModal – getPreference(String name)

    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). O client script da página de IU consome essas preferências usando este método.

    Tabela 4. Parâmetros
    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).
    Tabela 5. Retorna
    Tipo Descrição
    Cadeia de caracteres Valor da preferência especificada.

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

    Renderiza a página de IU no modal.

    Tabela 6. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 7. Retorna
    Tipo Descrição
    vazio
    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)

    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.

    Tabela 8. Parâmetros
    Nome Tipo Descrição
    html Objeto O conteúdo HTML a ser mostrado no modal.
    Tabela 9. Retorna
    Tipo Descrição
    vazio

    GlideModal – renderWithContent(cadeia de caracteres html)

    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.

    Tabela 10. Parâmetros
    Nome Tipo Descrição
    html Cadeia de caracteres O conteúdo HTML a ser mostrado no modal.
    Tabela 11. Retorna
    Tipo Descrição
    vazio

    GlideModal – setPreference(cadeia de caracteres nome, cadeia de caracteres valor)

    Define o campo especificado no formulário atual com o valor especificado.

    Tabela 12. Parâmetros
    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 13. Retorna
    Tipo Descrição
    vazio
    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)

    Defina as propriedades e recarregue o modal.

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

    GlideModal – setTitle(cadeia de caracteres título)

    Define o título do modal.

    Tabela 16. Parâmetros
    Nome Tipo Descrição
    título Cadeia de caracteres Título a ser exibido
    Tabela 17. Retorna
    Tipo Descrição
    vazio
    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)

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

    Tabela 18. Parâmetros
    Nome Tipo Descrição
    largura Número Número de pixels a serem definidos como a largura do modal.

    Máximo: 900 pixels

    Tabela 19. Retorna
    Tipo Descrição
    vazio
    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)

    Mude a exibição e recarregue o modal.

    Tabela 20. Parâmetros
    Nome Tipo Descrição
    novaExibição Cadeia de caracteres A exibição a ser usada.
    Tabela 21. Retorna
    Tipo Descrição
    vazio