Adicione um evento de caixa de diálogo não modal a um Construtor de IUpágina

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 5 min. de leitura
  • Saiba como adicionar e configurar um evento de caixa de diálogo não modal, como Abrir, fechar ou minimizar em Construtor de IU. Uma caixa de diálogo não modal é uma janela flutuante que contém conteúdo acima de uma página.

    Antes de Iniciar

    Função necessária: ui_builder_admin

    Procedimento

    1. Navegar até Tudo > Estrutura do Now Experience > Construtor de IU.
    2. Abra uma experiência para trabalhar ou crie uma experiência selecionando Criar > Experiência.
      Consulte Configure como os usuários interagem com suas aplicações no Construtor de IUpara obter mais informações sobre como criar experiências.
    3. Abra ou crie uma variante de página.
      Para obter mais informações sobre como criar uma página no Construtor de IU, consulte Crie uma página no Construtor de IU .
    4. Adicione uma caixa de diálogo não modal à página.
      Para obter mais informações sobre como criar uma caixa de diálogo não modal, consulte Adicione caixa de diálogo não modal a um Construtor de IUpágina.
    5. Adicione um componente à página, como um botão, para executar uma ação na caixa de diálogo não modal.
      Para obter mais informações sobre como criar um botão que interage com uma caixa de diálogo não modal, consulte Adicione caixa de diálogo não modal a um Construtor de IUpágina.
    6. Selecione o componente do botão na árvore de conteúdo ou na fase.
    7. No painel de configuração, selecione Eventos .
    8. Selecione - Adicionar manipulador de eventos .
      Painel de configuração simples do botão mostrado com uma seta preta apontando para a guia de eventos e uma segunda seta preta apontando para a opção Adicionar manipulador de eventos.
    9. Na janela de visualização do manipulador de eventos, selecione uma ação para atribuir ao botão.
      Há cinco manipuladores de eventos de caixa de diálogo não modal disponíveis.

      Seta preta apontando para os eventos da caixa de diálogo sem modelo listados na janela de visualização do manipulador de eventos.

      Nota:
      Para qualquer um dos manipuladores de eventos, selecione Script em Modo se você preferir trabalhar no editor de scripts.
      Para adicionar um manipulador de eventos de caixa de diálogo não modalFaça o seguinte
      Abrir caixa de diálogo não modal Abre uma caixa de diálogo não modal. Por exemplo, adicione um botão rotulado Compor e-mail e configure o botão para abrir uma caixa de diálogo não modal que contém o componente Compositor de e-mail (mini).
      • Título : Digite um título para a caixa de diálogo não modal.
      • Título minimizado : Digite um título que é exibido quando um usuário seleciona o ícone suspenso de caixas de diálogo minimizadas na página.
      • Categoria : Digite um nome de categoria para agrupar a caixa de diálogo não modal.
      • Caixa de diálogo não modal : Selecione a caixa de diálogo não modal a ser aberta.
      • Instância única : Selecione esta opção para permitir que os usuários abram apenas uma instância da caixa de diálogo não modal. Deixe esta opção desmarcada para permitir que os usuários abram várias instâncias da caixa de diálogo não modal. Por exemplo, se o botão abrir uma caixa de diálogo não modal que contém o componente Compositor de e-mail (mini) e você não selecionar a opção de instância única, os usuários poderão abrir várias janelas de diálogo não modal para compor mensagens de e-mail.
      • ID da instância da caixa de diálogo não modal : Se você selecionar Instância única Especifique o ID da instância da caixa de diálogo não modal que deve ser aberto ao clicar. Passe o mouse sobre o campo e selecione Vincular dados ícone. Em Tipos de dados selecione Caixa de diálogo não modal . Arraste a cápsula instanceID para a seção superior e selecione Aplicar .
      • Quando acionar (Opção avançada): Selecione Sempre para que o componente (neste exemplo, o botão) sempre abra a caixa de diálogo não modal. Selecione Condicionalmente para adicionar uma condição do manipulador de eventos. Para obter mais informações sobre condições do manipulador de eventos, consulte Funções compatíveis no Construtor de IUeditor de fórmulas de componente.
      Fechar caixa de diálogo não modal Fecha uma caixa de diálogo não modal. Use esta opção se você quiser configurar um componente, como um botão, para fechar a caixa de diálogo não modal de fora da janela de diálogo não modal.
      • ID da instância da caixa de diálogo não modal : Especifique o ID da instância da caixa de diálogo não modal que deve ser fechada ao clicar.
      • Quando acionar (Opção avançada): Selecione Sempre para que o componente (neste exemplo, o botão) sempre feche a caixa de diálogo não modal. Selecione Condicionalmente para adicionar uma condição do manipulador de eventos. Para obter mais informações sobre condições do manipulador de eventos, consulte Funções compatíveis no Construtor de IUeditor de fórmulas de componente.
      Minimizar caixa de diálogo não modal Minimiza uma caixa de diálogo não modal aberta. Use esta opção se você quiser configurar um componente, como um botão, para minimizar a caixa de diálogo não modal de fora da janela de diálogo não modal.
      • ID da instância da caixa de diálogo não modal : Especifique o ID da instância da caixa de diálogo não modal que deve ser minimizado ao clicar.
      • Quando acionar (Opção avançada): Selecione Sempre para que o componente (neste exemplo, o botão) sempre minimize a caixa de diálogo não modal. Selecione Condicionalmente para adicionar uma condição do manipulador de eventos. Para obter mais informações sobre condições do manipulador de eventos, consulte Funções compatíveis no Construtor de IUeditor de fórmulas de componente.
      Atualizar caixa de diálogo não modal Atualiza os campos especificados em uma caixa de diálogo não modal. Por exemplo, adicione um botão rotulado Atualizar título ao rodapé de uma caixa de diálogo não modal e configure o botão para atualizar o cabeçalho do componente na caixa de diálogo não modal.
      • Título : Digite o novo texto de título para a caixa de diálogo não modal que deve ser adicionada quando o botão for selecionado.
      • Título minimizado : Digite o novo texto de título minimizado que deve ser adicionado quando o botão for selecionado.
      • Categoria : Digite um novo nome de categoria que deve ser adicionado quando o botão for selecionado.
      • Caixa de diálogo não modal : Selecione a caixa de diálogo não modal a ser atualizada.
      • ID da instância da caixa de diálogo não modal : Especifique o ID da instância da caixa de diálogo não modal que deve ser atualizado ao clicar.
      • Está sujo : Selecione esta opção para marcar a caixa de diálogo não modal como suja.
      • Quando acionar (Opção avançada): Selecione Sempre para que o componente (neste exemplo, o botão) sempre atualize a caixa de diálogo não modal. Selecione Condicionalmente para adicionar uma condição do manipulador de eventos. Para obter mais informações sobre condições do manipulador de eventos, consulte Funções compatíveis no Construtor de IUeditor de fórmulas de componente.
      Caixa de diálogo não modal modificada Marca uma caixa de diálogo não modal como suja.
      • Em ID da instância da caixa de diálogo não modal , Especifique o ID da instância da caixa de diálogo não modal para marcar como sujo.
      • Quando acionar (Opção avançada): Selecione Sempre para ter o componente (neste exemplo, o botão) sempre marcado como sujo. Selecione Condicionalmente para adicionar uma condição do manipulador de eventos. Para obter mais informações sobre condições do manipulador de eventos, consulte Funções compatíveis no Construtor de IUeditor de fórmulas de componente.
    10. Selecione Adicionar.

    Resultado

    O manipulador de eventos configurado é exibido no painel de configuração Eventos para o componente.

    Seta preta que aponta para o manipulador de eventos da caixa de diálogo sem modelagem aberta na guia de eventos do painel de configuração para o componente simples do botão.