Um componente Guia é parte de um componente Conjunto de guias. Você pode adicionar uma nova guia a um conjunto de guias de duas formas: clicando com o botão direito do mouse no componente Conjunto de guias ou em um componente Guia e escolhendo Adicionar Guia, ou arrastando um novo componente Guia da categoria Layout Woodstock da Paleta e soltando-o no Conjunto de guias ou em outro componente Guia. Você também pode arrastar da Paleta e soltar a aba nos nós do conjunto de abas na
Este é um componente JavaServer Faces 1.2. Você pode ver componentes que utilizam essa versão do JavaServer Faces quando seu projeto utiliza Java EE 5. Para mais informações sobre o JavaServer Faces 1.2, consulte:
Se o componente Guia à esquerda ou à direita de uma guia existente, ele será adicionado na mesma linha de guias.
Se soltar o componente Guia em uma guia existente, a guia solta se torna uma guia filha da guia na qual você a soltou a menos que a guia existente seja de terceiro nível. Você pode ter pelo menos três níveis de guias em um conjunto de guias.
Não é possível adicionar uma guia filha a uma guia que tenha componentes no Painel do layout. Ao soltar uma guia em um componente Guia existente que tenha um Painel de layout vazio, o Painel de layout vazio é excluído para dar espaço para a guia solta.
Por padrão, um componente Guia possui um Painel de layout abaixo dele, onde você pode soltar componentes que serão exibidos quando o usuário selecionar a guia. Por padrão, o Painel de layout possui sua propriedade panelLayout definida como Layout de grade, o que significa que os componentes soltos no painel são alinhados no local em que foram soltos. Você pode alterar o comportamento do layout definindo a propriedade panelLayout como Layout de fluxo, o que alinha os componentes soltos da esquerda para a direita nas linhas. Para obter mais informações sobre as propriedades do Painel de layout, consulte Janela propriedades do componente Painel de layout.
Para selecionar uma aba em um conjunto de abas, clique no componente Aba na página ou selecione o nó do componente Aba na Para selecionar o conjunto de abas inteiro, clique na borda no componente Conjunto de abas na página ou selecione o nó do conjunto de abas na janela Navegador. Como alternativa, você pode selecionar um componente Guia e pressionar Esc ou clicar com o botão direito do mouse e escolher Selecionar pai para selecionar seu componente pai.
Se você selecionar uma guia em uma página no Visual Designer, o efeito colateral é que ela se torna a guia selecionada. Se este não é o efeito desejado, selecione a guia na janela Navegador para que você possa definir suas propriedades.
Você pode arrastar as guias na janela Navegador para alterar seu local e nível no conjunto de guias.
Alguns usos típicos das guias:
Você pode soltar os componentes no componente Painel de layout abaixo de uma guia para permitir que um conjunto de guias seja exibido abaixo de cada guia. Quando o usuário seleciona uma guia, ele vê apenas os componentes que estão associados à guia, sem ter que alterar as páginas.
Você pode usar um conjunto de guias para navegar em um conjunto de páginas. Cada componente Aba vincula-se a uma página JSF Visual Web em sua aplicação Web. Você poderia usar o editor Fluxo de página para definir cada aba para exibir uma página na aplicação, com o conjunto de abas da página atual como a aba selecionada. Se quiser usar o conjunto de guias para navegação de página, certifique-se de excluir o Painel de layout de cada componente Guia.
Você também pode clicar com o botão direito do mouse no componente Guia e escolher inúmeras opções, incluindo as seguintes:
Editar texto. Digite o texto que aparecerá na guia e pressione Enter. O novo texto será definido na propriedade text.
Editar manipuladr de eventos da ação. Codifique o manipulador de eventos de ação, o método que é chamado quando o usuário clica na guia. Este método determina qual página ou recurso deve ser aberto com base em condições específicas. O método de ação geralmente processa os cliques do mouse e retorna uma string indicando o nome de um caso de navegação de página (a página da aplicação que será exibida a seguir). O nome padrão do método é id-da-aba_action, onde id-da-aba é o nome da aba, o valor da propriedade id da aba.
Vincular aos dados. Define dinamicamente o texto que aparece na guia. Você pode vincular a propriedade text do componente a um objeto ou a um provedor de dados, conforme descrito no tópico Caixa de diálogo Vincular aos dados.
Vinculações de propriedade. Abre a caixa de diálogo que permite vincular as propriedades dos componentes, além da propriedade text, a outros objetos ou beans de propriedades que atualizam automaticamente estas propriedades do componente.
Adicionar atributo de vinculação. Essa opção adiciona um atributo de vinculação ao componente
Observação: se você planeja fazer o script do componente em código Java, deve adicionar um atributo de vinculação manualmente, que é vinculado usando uma expressão vinculadora de valor a uma propriedade do bean da página de backup.
Remover atributo de vinculação Essa opção remove o atributo de vinculação do componente.