...

Objetivo

O objetivo deste guia é apresentar as características dos modos de visualização e edição de widgets.

Modo de visualização vs. modo de edição

No que poderíamos chamar de "camada de apresentação" de um widget (ou seja, as telas), existe a concepção inicial de que ela é formada por dois arquivos freemarker FreeMarker (.ftl): um para visualização e outro para edição. Geralmente faz parte dessa estrutura esta estrutura é composta por um único arquivo javascript JavaScript (.js). A seguir, veremos cada um dos componentes.

Modo de Visualização

Por padrão, o renderizador de páginas da plataforma fluig procura por um arquivo chamado Fluig seleciona o arquivo "view.ftl" dentro do widget. Caso exista a propriedade  para a renderização do modo de visualização. Caso o desenvolvedor deseje especificar um outro arquivo .ftl como padrão para o modo de visualização, é necessário informá-lo na propriedade view.file no arquivo application.info, então o arquivo informado como valor é o que será considerado pelo renderizador. Por exemplo:

view.file=visualizacao.ftl

...

Por padrão, o renderizador de páginas da plataforma fluig procura por um arquivo chamado Fluig seleciona o arquivo "edit.ftl" dentro do widget. Caso exista a para a renderização do modo de edição. Caso o desenvolvedor deseje especificar um outro arquivo .ftl como padrão para o modo de edição, é necessário informá-lo na propriedade edit.file no arquivo application.info, então o arquivo informado como valor é o que será considerado pelo renderizador. Por exemplo:

edit.file=edicao.ftl

Variáveis de ambiente FTL & JS

Quando é utilizada a extensão de Super Widget em seu um arquivo *.js  (javascriptJavaScript), existe uma função herdada chamada chamada "isEditMode". Veja o exemplo abaixo:

var MinhaWidget = SuperWidget.extend({
    init: function() {
    	if (this.isEditMode) {
			// código para ser executado quando estiver em modo de edição
		} else {
			// código para ser executado quando estiver em modo de exibição
		}
	},
	// restante do código omitido
});

Ou, Já no arquivo *.ftl (freemarkerFreeMarker), pode-se usar o seguinte código:

<div class="fluig-style-guide">
 
	<#if pageRender.isEditMode()=true>
		<!-- Execute uma ação quando estiver em modo de edição -->
	<#else>
		<!-- Execute outra quando estiver em modo de exibição -->
	</#if>

</div>

...