Atributos da Biblioteca de Tags de Agregação
A biblioteca de tags de agregação é utilizada para agregar vários portlets em uma página.
Os argumentos suportados incluem:
- init
- Essa tag inicializa a estrutura do portlet e precisa ser utilizada no início da JSP. Todas as outras tags descritas nesta seção são apenas válidas no corpo dessa tag, portanto, a tag init normalmente envolve o corpo inteiro de uma JSP. No caso da URL atual conter um sinalizador de ação, o método do portlet correspondente será chamado.
As tags state e insert são sub-tags
da tag init.A tag init tem os seguintes atributos:
- portletURLPrefix=”<any string>”
Essa URL define o prefixo utilizado para URLs de Portlet. As URLs de Portlet são criadas pela tag state ou em um método de renderização do portlet, que é chamado usando a tag insert. Esse é um atributo requerido.
- portletURLSuffix=”<any string>”
Essa URL define o sufixo utilizado para URLs de Portlet. As URLs de Portlet são criadas pela tag state ou em um método de renderização do portlet, que é chamado usando a tag insert. Esse é um atributo opcional.
- portletURLQueryParams=”<any string>”
Essa URL define os parâmetros de consulta utilizados para URLs de Portlet. As URLs de Portlet são criadas pela tag state ou em um método de renderização do portlet, que é chamado usando a tag insert. Esse é um atributo opcional.
- portletURLPrefix=”<any string>”
- escopo, portlet
- As tags de escopo e de portlet são utilizadas para fornecer informações que são
necessárias quando um aplicativo de portlet é instalado em uma raiz de contexto de várias
partes, por exemplo, /context1/context2. Essas
tags também definem quais janelas de portlet devem participar
na coordenação do portlet por meio de parâmetros de renderização públicos, e incluir um parâmetro
de renderização na URL recém-criada.A tag urlParam tem os seguintes atributos:
- context = "/<context1>/<context2>"
Especifica a raiz de contexto do aplicativo de portlet no qual o portlet é implementado. Esse atributo é obrigatório.
- portletname = "<portlet-name>"
Especifica o nome do portlet. Esse atributo é obrigatório.
- windowId=”<any string>”
Define o ID de janela para a instância de portlet concreto. Esse atributo é obrigatório.
Segue um exemplo de como utilizar as tags de escopo e de portlet:<%@ taglib uri="http://ibm.com/portlet/aggregation" prefix="portlet" %> <portlet:scope> <portlet:portlet context="/myportletcontext1/myportletcontext2” portletname="MyPortlet" windowId="sample"/> </portlet:scope> <portlet:init portletURLPrefix="/myportalcontext/ "> …. </portlet:init>
- context = "/<context1>/<context2>"
- state
- A tag state cria uma URL que aponta para o portlet determinado utilizando o estado fornecido. É possível colocar essa URL em uma variável especificada pelo atributo var ou pode escrevê-la diretamente no fluxo de saída.
Essa tag é útil para criar URLs para botões, imagens e outros itens HTML de forma que quando a URL é chamada, as alterações de estado definidas na URL são aplicadas no portlet fornecido.A tag state tem os seguintes atributos:
- url=”<context>/<portlet-name>”
Identifica o portlet para essa tag utilizando o contexto e o nome do portlet para endereçar o portlet. Esse atributo é obrigatório.
- windowId=”<any string>”
Define o ID da janela para a URL de portlet criada por essa tag. Esse é um atributo opcional.
- var=”<any string>”
Se definido, a URL é escrita em uma variável com o escopo e nome fornecidos, não no fluxo de saída. Esse é um atributo opcional.
- scope = ”page|request|session|application”
Este atributo será válido somente se o atributo var for especificado. Se definido, a URL não será escrita no fluxo de saída, mas uma variável será criada no escopo fornecido com o nome fornecido. O padrão é page. Esse é um atributo opcional.
- portletMode=”view|help|edit|<custom>”
Esse atributo configura o modo do portlet.
- portletWindowState=”maximized|minimized|normal|<custom>”
Esse atributo configura o estado da janela.
- action = ”true/false”
Esse atributo define se essa é uma URL de ação. Esse é um atributo opcional. O padrão é falso.
- url=”<context>/<portlet-name>”
- urlParam
- Inclui um parâmetro de renderização na URL recém-criada.A tag urlParam tem os seguintes atributos:
- name=”<any string>”
Indica o nome do parâmetro. Esse é um atributo obrigatório.
- value=”<any string>”
Indica o valor do parâmetro. Esse é um atributo obrigatório.
- name=”<any string>”
- insert
- Essa tag chama o método de renderização do portlet e recupera o conteúdo, bem como o título. É possível opcionalmente colocar o conteúdo e o título do portlet especificado nas variáveis utilizando os atributos contentVar e titleVar.A tag insert tem os seguintes atributos:
- url=”<context>/<portlet-name>” (obrigatório) Identifica o portlet
para essa tag utilizando o contexto e o nome do portlet para endereçar o portlet
Esse é um atributo obrigatório.
- windowId=”<any string>”
Define o ID de janela do portlet. Esse é um atributo opcional.
- contentVar=”<any string>”
Se definido, o conteúdo do portlet não será gravado no fluxo de saída, mas em uma variável com o escopo e o nome especificados. Esse é um atributo opcional.
- contentScope = ”page|request|session|application”
Este atributo será válido somente se a tag contentVar for utilizada. Se definido, o conteúdo do portlet será gravado em uma variável com o escopo e o nome especificados, não no fluxo de saída. O padrão é page. Esse é um atributo opcional.
- titleVar=”<any string>”
Se definido, o título do portlet será gravado em uma variável com o escopo e o nome especificados. Se não for definido, o título será ignorado e não será escrito no fluxo de saída. Esse é um atributo opcional.
- titleScope = ”page|request|session|application”
Este atributo será válido somente se a tag titleVar for utilizada. Se definido, o título do portlet será gravado em uma variável com o escopo e o nome especificados, não no fluxo de saída. O padrão é page. Esse é um atributo opcional.
- url=”<context>/<portlet-name>” (obrigatório) Identifica o portlet
para essa tag utilizando o contexto e o nome do portlet para endereçar o portlet