Configurar componentes automaticamente usando predefinições

Use predefinições de componente para configurar automaticamente componentes em páginas compatíveis.

Use as predefinições de componente para aplicar valores de configuração predefinidos e mapeamentos de eventos aos componentes. Construtor de IU modelos de página contêm controladores que as predefinições usam para definir valores de configuração de componente.

As predefinições aplicam configurações pré-criadas às propriedades do componente e manipuladores de eventos e estão disponíveis somente para determinados componentes. Eles são baseados em casos de uso comuns para componentes, como configurar um componente de formulário com campos que normalmente são incluídos em uma página de registro.

A aplicação de uma predefinição configura automaticamente os componentes para funcionarem imediatamente, simplificando a criação e a manutenção de páginas para os autores de páginas.

As predefinições oferecem os seguintes benefícios aos autores de páginas:

• Manipulação de dados complexos e vinculação de eventos para componentes
• Custo reduzido de propriedade e manutenção devido à definição externa às páginas

No painel Configuração, você pode selecionar se deseja aplicar uma predefinição ao componente selecionado ou configurá-lo manualmente. As predefinições padrão são aplicadas automaticamente aos componentes quando uma página é criada a partir de um modelo ou o controlador necessário para a predefinição já está adicionado à página. Todas as propriedades ou eventos configurados pela predefinição são exibidos como somente leitura quando uma predefinição é aplicada.

Você pode substituir valores configurados por uma predefinição, mas ao fazer isso, você assume a propriedade da configuração e manutenção do componente.

As subpáginas não herdam controladores e não podem usar predefinições em Xanadu.

Figura 1. Predefinição aplicada a um componente

Vinculações de dados e eventos

As predefinições podem incluir vinculações a:

• Propriedades de saída do controlador (@data)
• Cargas do evento (@payload)
• Contexto da sessão (@context.session)
• Fórmulas complexas (transformações do cliente)

As predefinições também podem incluir mapeamentos de eventos para eventos manipulados de um controlador. Para obter mais informações, consulte Gerenciar ações nas páginas do Construtor de IU (recurso avançado).

Controladores

As predefinições conectam componentes a mapeamentos de dados e eventos usando um controlador. Se o controlador exigido por uma predefinição ainda não estiver na página, a predefinição solicitará que você configure as propriedades necessárias do controlador e adicione o controlador. Depois que um controlador é adicionado a uma página, os componentes que têm predefinições associadas ao controlador aparecem realçados na lista de componentes. Para obter mais informações, consulte Vincular dados a Construtor de IU páginas usando controladores (recurso avançado).

Figura 2. Componentes com predefinições

Selecione uma predefinição de componente

Escolha uma predefinição de componente ao adicionar um componente à sua página.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Navegar até Todos > 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 IU para obter mais informações sobre como criar experiências.
3. Crie ou abra uma página ou variante de página.
   Para obter mais informações sobre como criar uma página no Construtor de IU, consulte Criação de uma página no Construtor de IU.
4. Abra a caixa de ferramentas.
5. Adicione um componente destacado em verde à sua página.

   Os componentes destacados em verde têm predefinições disponíveis.

   
6. O componente é configurado automaticamente com a predefinição padrão.
   
7. Opcional: Selecione uma predefinição diferente na lista do painel de configuração.
   Você pode configurar um componente para não usar uma predefinição selecionando Remover.
   1. Selecione Continuar para substituir a predefinição existente.
   
8. Clique em Salvar.

Substitua uma predefinição de componente

Substitua uma predefinição de componente para inserir seus próprios valores personalizados.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Selecione um componente com uma predefinição.
   
2. Encontre o valor de dados que você deseja substituir no painel de configuração.
3. Clique no ícone de cadeado no campo de dados.
4. Insira o valor dos dados que você deseja substituir o valor predefinido.
5. Selecione Salvar.
   

Resultado

O painel de configuração exibe o valor personalizado no campo.

Redefinir um componente

Redefina as predefinições de componente para seus valores padrão.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Selecione o componente que você deseja redefinir na árvore de conteúdo.
   
2. Selecione o nome do componente no painel de configuração.
   
3. Clique em Redefinir componente.
   
4. Clique em Redefinir.

Resultado

A predefinição do componente é redefinida para os valores padrão.