Janela Propriedades do componente Coluna da tabela do JSF 1.2

Você vê a janela Propriedades de um componente Coluna da tabela ícone do componente Coluna quando o seleciona em um componente Tabela na Um componente Coluna da tabela representa uma coluna em um componente Tabela e faz parte de um componente Grupo de linhas da tabela, de forma que você tem que expandir o nó do componente Tabela e, em seguida, um nó do Grupo de linhas da tabela para ver o componente Coluna da tabela.

Você pode usar a caixa de diálogo Layout da tabela para definir muitas dessas propriedades. Esta caixa de diálogo não só é mais fácil de usar do que as janelas Propriedades individuais dos componentes Tabela, Coluna da tabela e Grupo de linhas da tabela, mas você também pode trabalhar nessa caixa de diálogo de forma mais natural com as tabelas e todas as suas colunas. Para abri-la, clique com o botão direito do mouse na tabela no Visual Designer e escolha Layout da tabela.

Este componente JavaServer Faces 1.2 possui as propriedades a seguir.

Geral

id. Tipo: String
O nome do componente Coluna da tabela no bean de página e o arquivo JSP.

Aparência

align. Tipo: String
Especifica o alinhamento horizontal da célula. Os valores possíveis são esquerda, centralizado, direita e justificado.
alignKey. Tipo: Objeto
O id FieldKey ou FieldKey que representa um identificador de um elemento de dados específico a ser alinhado automaticamente. Caso umFieldKey seja fornecido, ele é usado da maneira como se encontra, caso contrário umFieldKey é criado usando o id fornecido. O alinhamento é baseado no tipo de objeto do elemento de dados. Por exemplo, os objetos Date e Number são alinhados à direita; Character e os objetos String são alinhados à esquerda e os objetos Boolean são alinhados no centro. Todas as colunas, incluindo as colunas selecionadas, são alinhadas à esquerda por padrão. A propriedade align substitui este valor.


	emptyCell. Tipo: booleano

 Indica que a célula da tabela não é aplicável ou está inesperadamente vazia e que em vez disso um ícone de célula de tabela vazia (ícone de traço) deve ser renderizado.
	footerText. Tipo: String

  Texto exibido para o rodapé da coluna. Para obter mais informações, consulte Elementos de layout de coluna da tabela.
	headerText. Tipo: String

Texto exibido para o cabeçalho da coluna. Para obter mais informações, consulte Elementos de layout de coluna da tabela.
	 noWrap. Tipo: booleano

Evita a quebra automática do texto na célula, o que pode resultar em rolamento horizontal, dependendo da largura da janela do navegador do usuário e do tamanho da fonte. Esta propriedade é desaprovada em HTML 4.0 e posterior em favor das folhas de estilo. 
	severity. Tipo: String

 Indica a gravidade do alarme da linha atual. Quando a gravidade é definida, as dicas de ferramenta indicam que a coluna será classificada por gravidade. Além disso, a célula da tabela fornecerá uma indicação visual do nível de gravidade. Esta propriedade é substituída pela propriedade emptyCell. 
  sortIcon. Tipo: String

  O identificador de uma imagem entre os arquivos de tema que você deseja usar para um ícone de classificação. Se você clicar nos botões de reticências, verá uma lista dos nomes de imagens na qual poderá selecionar a imagem desejada. Para obter mais informações, consulte Elementos de layout de coluna da tabela.
	sortImageURL. Tipo: String

      URL absoluto ou relativo para a imagem usada para classificação. Você pode usar esta propriedade para escolher seu próprio ícone de classificação. Para obter mais informações, consulte Elementos de layout de coluna da tabela.
style. Tipo: String

		Regras de folha de estilo em cascata (CSS nível 2) a serem aplicadas ao componente. Você pode inserir valores diretamente ou clicar no botão de reticências (...) para usar o Editor de estilo.
        
          Esta propriedade substitui quaisquer configurações do tema ou do arquivo CSS desse componente. Se um estilo especificado nesta propriedade não surtir efeito, é porque uma área do componente está obscurecida por um componente filho que possui configurações de estilo diferentes.
        

	  Para obter uma lista de estilos CSS2, consulte a página da Web em

        
        
  
	styleClass. Tipo: String

	   Uma lista separada por espaços de classes de estilo CSS2 a serem aplicadas quando o componente é renderizado. As classes de estilo devem ser definidas na folha de estilo do projeto no arquivo CSS do tema. Se você clicar no botão de reticências (...), verá uma lista de todos os estilos que podem ser adicionados a esta propriedade. Para obter informações sobre a adição de classes CSS e regras na folha de estilos em cascata do projeto, consulte Editor CSS.
      
        Consulte a observação acima abaixo da descrição da propriedade style para obter uma explicação do porquê uma classe adicionada a esta propriedade talvez pareça não ter efeito no componente. 
 Se você adicionar uma classe de estilo CSS a partir do tema atual ao arquivo CSS do projeto e redefinir a classe do estilo, a alteração afetará todos os componentes que usam essa classe de estilo. Entretanto, é possível adicionar suas próprias classes de estilo ao arquivo CSS do projeto que redefine as classes de estilo padrão e, em seguida, quando você adicionar as classes a esta propriedade, as alterações afetarão somente a instância deste componente.
       
        
      
  

tableFooterText. Tipo: String

  O texto exibido para o rodapé da coluna da tabela. Para obter mais informações, consulte Elementos de layout de coluna da tabela.
		     valign. Tipo: String

  Especifica a posição vertical na célula do conteúdo da célula. Os valores possíveis são:
    
        top - Posiciona o conteúdo na parte superior da célula.
        middle - O valor padrão, que centraliza o conteúdo verticalmente.
         bottom - Posiciona o conteúdo na parte inferior da célula.



Layout

  colSpan. Tipo: int 

    O número de colunas ocupadas por cada célula nesta coluna. O valor padrão é 1. O valor 0 é ignorado por alguns navegadores da Web, portanto, é melhor inserir um número de colunas real a serem ocupadas e não presumir que um navegador da Web irá interpretar que 0 significará todas as colunas desta até o fim da tabela.
  height. Tipo: String 

    Desaprovada em HTML 4.0 e posterior em favor das folhas de estilo, a propriedade de altura recomenda que a altura da célula seja em pixels. 
  rowSpan. Tipo: int 

    O número de linhas ocupadas por cada célula nesta coluna. O valor padrão é 1. O valor 0 é ignorado por alguns navegadores da Web, portanto, é melhor inserir um número de linhas real a serem ocupadas e não presumir que um navegador da Web irá interpretar que 0 significará todas as linhas desta até o fim da tabela.
  spacerColumn. Tipo: booleano 

    Indica que a coluna é usada como um espaçador de duas e três tabelas de colunas. A definição desta propriedade altera o estilo usado na coluna para parecer que as colunas são justificadas. Se um cabeçalho e um rodapé de coluna forem necessários, forneça uma string vazia para as propriedades headerText e footerText. Defina a propriedade width para justificar as colunas de forma adequada. 
  width. Tipo: String 

    Esta propriedade é desaprovada em HTML 4.0 e posterior em favor das folhas de estilo. O valor é a largura da célula em pixels. 

Dados

	descending. Tipo: boolean

 Indica que as ações de classificação são aplicadas pelo usuário em ordem decrescente. Se esta propriedade não for selecionada, a ordem será crescente. Esta propriedade não afeta a ordem de classificação inicial da coluna, mas a ordem de classificação aplicada quando o usuário clica pela primeira vez em um botão de classificação ou texto de cabeçalho da coluna. Para obter mais informações, consulte Elementos de layout de coluna da tabela.
  selectId. Tipo: String

 O ID do componente de uma caixa de seleção ou botão de opção usado para selecionar ou cancelar a seleção de linhas da tabela. Quando o componente é renderizado, um ID totalmente qualificado é criado dinamicamente com base no ID do componente Coluna da tabela e na linha atual. A definição desta propriedade identifica a coluna como uma coluna selecionada. 
     sort. Tipo: Objeto 

 O ID FieldKey ou SortCriteria usado para definir os critérios para classificar o conteúdo de um TableDataProvider. Este valor será necessário se uma coluna for mostrada como classificável. Se você soltar uma tabela de banco de dados no componente, esta propriedade será definida para você.
 
 Se SortCriteria for fornecida, o objeto será usado simplesmente para classificação. Se um ID for fornecido, um FieldIdSortCriteria será criado para classificação. Como alternativa, uma vinculação de valor pode ser usada para classificar um objeto externo para TableDataProvider, tal como o estado marcado de uma caixa de seleção ou botão de opção. Neste caso, um objeto ValueBindingSortCriteria é criado para classificação. Toda a classificação é baseada no tipo de objeto associado ao elemento de dados, tal como Boolean, Character, Comparator, Date, Number ou String. Se o tipo de objeto não puder ser determinado, o objeto será comparado como um tipo String.
    


Comportamento

  toolTip. Tipo: String

O valor do atributo de título da coluna. Se a célula não possuir um componente filho, o texto especificado será exibido como uma dica de ferramenta quando o cursor do mouse passar sobre uma célula na coluna.
  
    A dica de ferramenta não aparecerá se a célula possuir um componente filho, como geralmente possui. Se houver uma propriedade de dica de ferramenta para o componente filho da célula, defina essa propriedade. 
  
  
  visible. Tipo: booleano

  Indica se o componente pode ser visto ou não pelo usuário na página HTML renderizada. Esta propriedade é selecionada por padrão. Se você desmarcar esta propriedade, o código HTML do componente será renderizado na página, mas o componente não ficará visível no navegador porque ele estará oculto por uma configuração de estilo. Como o código HTML é renderizado, o componente ainda pode ser processado em envios de formulário, e os usuários que vêem o código-fonte no navegador podem ver o código HTML. Além disso, sua aplicação Web pode usar JavaScript do lado cliente para mostrar ou ocultar o componente. 
    
      Se você precisar ocultar completamente o componente, por exemplo, porque ele contém informações confidenciais que determinados usuários não podem ver, desmarque a propriedade rendered.
    


JavaScript

  onClick. Tipo: String

  JavaScript a ser executado quando o usuário clica no componente.
  onDblClick.  Tipo: String

    JavaScript a ser executado quando o usuário clica duas vezes no componente.
  onKeyDown. Tipo: String

    JavaScript a ser executado quando o componente recebe o foco e a tecla é pressionada. 
  onKeyPress. Tipo: String

    JavaScript a ser executado quando o componente recebe o foco e a tecla é pressionada e liberada.
  onKeyUp. Tipo: String

    JavaScript a ser executado quando o componente recebe o foco e a tecla é liberada.
  onMouseDown. Tipo: String

    JavaScript a ser executado quando o cursor do mouse está sobre o componente e o usuário pressiona o botão do mouse.
  onMouseMove. Tipo: String

    JavaScript a ser executado quando o usuário move o cursor do mouse no componente.
  onMouseOut. Tipo: String

    JavaScript a ser executado quando o usuário move o cursor do mouse para longe do componente, depois de estar sobre o componente.
  onMouseOver. Tipo: String

    JavaScript a ser executado quando o usuário move o cursor do mouse para o componente.
  onMouseUp. Tipo: String

    JavaScript a ser executado quando o cursor do mouse está sobre o componente e o usuário libera o botão do mouse.

Avançado

	embeddedActions. Tipo: booleano 

	    Indica que as ações de tabela incorporadas aparecem nesta coluna. Faz com que uma barra separadora apareça entre cada componente filho. Esta propriedade é substituída pela propriedade emptyCell. 
	extraFooterHtml. Tipo: String

  Código HTML extra a ser anexado ao elemento HTML <td> renderizado no rodapé da coluna. Use somente código que seja válido em um elemento HTML <td>. O código especificado é inserido no elemento HTML e não tem sua validade verificada. Por exemplo, você pode definir este atributo como nowrap='nowrap'. Para obter mais informações sobre o rodapé da coluna, consulte Elementos de layout de coluna da tabela.
	extraHeaderHtml. Tipo: String

Código HTML extra a ser anexado ao elemento HTML <th> renderizado no cabeçalho da coluna. Use somente código que seja válido em um elemento HTML <th>. O código especificado é inserido no elemento HTML e não tem sua validade verificada. Por exemplo, você pode definir este atributo como nowrap='nowrap'. Para obter mais informações sobre o cabeçalho da coluna, consulte Elementos de layout de coluna da tabela.
	extraTableFooterHtml. Tipo: String

Código HTML extra a ser anexado ao elemento HTML <td> renderizado no rodapé da coluna da tabela. Use somente código que seja válido em um elemento HTML <td>. O código especificado é inserido no elemento HTML e não tem sua validade verificada. Por exemplo, você pode definir este atributo como nowrap='nowrap'. Para obter mais informações sobre o rodapé da coluna da tabela, consulte Elementos de layout de coluna da tabela.
  rendered. Tipo: booleano

	  Se for selecionada, o componente será renderizado e processado em qualquer envio de página subseqüente. Se não for selecionada, a Coluna da tabela e seu conteúdo (componentes filho da Coluna da tabela) não aparecerão na página, nem mesmo como componentes ocultos. Se esta propriedade não estiver selecionada (falso), ela substituirá as propriedades renderizadas de quaisquer componentes filho.
	    Você pode vincular esta propriedade a uma propriedade JavaBeans que determina quando o componente é renderizado. Por exemplo, um formulário de reserva de viagens pode mostrar um componente Coluna da tabela para passageiros freqüentes e não mostrá-lo para o público em geral. Para vincular esta propriedade, clique no botão de reticências (...) à direita da propriedade e escolha Usar vinculação na caixa de diálogo.
  
     rowHeader. Tipo: booleano

 Indica que as células da coluna contêm cabeçalhos para cada linha. O HTML equivalente de cada célula na coluna é <th scope="row">. Por exemplo, uma tabela possui uma coluna contendo nomes de usuário. À esquerda desta coluna está uma coluna de caixas de seleção e à direita estão as colunas que contêm os atributos desses usuários. O conteúdo das células na coluna Nome do usuário está agindo como cabeçalho de linha, portanto, esta é a propriedade da coluna Nome. Para obter mais informações, consulte Elementos de layout de coluna.
    scope. Tipo: String

Especifica as células para a qual a coluna fornece informações do cabeçalho. Os valores possíveis são os seguintes:
  
     row - A célula fornece informações do cabeçalho para o resto da linha.
    col - A célula fornece informações do cabeçalho para o resto da coluna.
     rowgroup - A célula fornece informações de cabeçalho para o resto do grupo de linhas (ou seja, as células restantes de <thead>, <tfoot< ou <tbody>).
    colgroup - A célula fornece informações do cabeçalho para o resto do grupo de colunas, as células restantes de colgroup. 
  
    



	Consulte também
	Componente Coluna da tabela
	Componente Tabela
	Componente Grupo de linhas da tabela
	Trabalhando com componentes
	Tarefas de componente: referência rápida




 

  Notificações legais