Função

O componente Frame é utilizado para renderizar uma página dentro de outra página, podendo também ser utilizado para inserir mídias, como vídeos. 

Figura 1 - Componente Frame em execução.

Principais propriedades

Na tabela abaixo estão descritas as principais propriedades do componente.

Origem

É possível renderizar no componente Frame páginas internas do projeto ou mídias externas (iframe). Veja abaixo como configurar esta propriedade.

Seleção de página interna

Na figura 1.1 exibimos os passos para adicionar uma página interna do projeto ao componente Frame.

Figura 1.1 - Adicionando uma página interna do projeto.

1. Arraste o componente Frame até a área de edição e selecione-o;
2. Acesse a propriedade Origem;
3. Selecione uma das páginas do projeto web ou mobile, dependendo da aplicação que esteja trabalhando.

4. A propriedade Tipo é utilizada em conjunto com a propriedade Origem, informando o modo de exibição do frame, selecione o tipo inclusão, ele é utilizado quando a propriedade Origem faz referência a uma página interna do projeto.

Seleção de mídia externa (iframe)

Para exibir uma mídia externa no componente Frame, precisamos obter o link de incorporação. No exemplo da figura abaixo, estamos obtendo o link do vídeo Construindo uma Aplicação em 6 Passos com o Cronapp, mas sinta-se livre para utilizar uma mídia de sua escolha.

Figura 1.2 - Adicionando uma mídia externa ao componente Frame.

Siga os próximos passos para adicionar o link incorporado do YouTube ao componente:

1. No vídeo, clique em Compartilhar;
2. Em seguida clique em Incorporar (<>);
3. Copie o link do atributo src, como mostra a figura 1.2;
4. Cole o link copiado na propriedade Origem do componente Frame.
5. Selecione o Tipo como Frame, ele é  utilizado quando a propriedade Origem recebe um iframe externo ao Cronapp, por exemplo, um vídeo.

Exemplo de uso: Inclusão

No exemplo de Inclusão, temos 2 páginas e iremos renderizar uma dentro da outra. Colocamos o componente Frame na página inicial (home) e iremos renderizar outra página do projeto, a página "minha_pagina" que possui um componente visual título e uma paragráfo.

Figura 2 - Página Minha Página

Seguindo os passos da figura 1.1, basta arrastar o componente Frame até a área de edição e na propriedade Origem, selecionar a página que será renderizada, neste exemplo usamos "minha_pagina". A propriedade Tipo também necessita de configuração e, nesse caso, como é uma inserção de uma página interna do projeto, a propriedade Tipo tem que ser inclusão.

Figura 2.1 - Componente Frame renderizando a página Minha Página na Home.

Exemplo de uso: Frame

Agora vamos demonstrar o resultado da inserção de um iframe na propriedade Origem, siga os passos da figura 1.2 para obter o link incorporado, neste exemplo, de um vídeo do YouTube. Altere a propriedade Tipo para Frame.

Figura 2.2 - Componente Frame renderizando um vídeo na página Home.

Além de vídeos, o Tipo iframe também permite adicionar uma página de outro site ao componente Frame, confira na figura abaixo. 

Figura 2.3 - Componente Frame renderizando o site da Wikipédia.

Drag and Drop da árvore de recursos

Outra forma de gerar o componente Frame é a partir do recurso de Drag and Drop (arrastar e soltar). Selecione o relatório da árvore de recursos e arraste-o para a área de edição do formulário, em seguida, selecione a opção Formulário (destaque 2 da figura 3).