Este componente permite que você inclua um fragmento de página em uma página. Um fragmento de página é uma parte separada, reutilizável de uma página que pode ser incluída em qualquer número de páginas. Por exemplo, talvez você queira colocar um elemento visual comum como um gráfico de cabeçalho em uma fragmento de página e incluí-lo em todas as páginas em uma aplicação.
Quando você arrasta o componente Caixa de fragmento de página
da categoria Layout da Paleta e o solta em uma página, a caixa de diálogo Selecionar fragmento de página solicita o nome do fragmento de página a ser incluído. Você pode indicar o nome de um fragmento de página existente
ou criar um novo fragmento de página. Se você criar um novo fragmento de página, o IDE fornece ao novo fragmento um sufixo de arquivo .jspf e cria um nó para ele na janela Projetos, assim como adiciona o fragmento de página à janela Navegador.
Depois de soltar um componente Caixa de fragmento de página na página, se clicar dentro do componente, você vê as propriedades do fragmento incluído. Se clicar na borda do componente, você vê s propriedades do bloco <div>
de fechamento. Você também pode usar a janela Navegador para selecionar o bloco de fechamento, o fragmento de página, ou os componentes no fragmento de página. Na janela Navegador, o componente Caixa de fragmento de página é representado por um nó chamado directive.include:arquivo-do-fragmento.jspf, onde arquivo-do-fragmento é o nome do arquivo do fragmento de página.
Se clicar duas vezes no fragmento de página, ele se abre como uma página no Visual Editor, permitindo que você edite-o como uma página regular. O fragmento de página possui um objeto JavaBeans associado, um bean de fragmento de página, que você pode editar, clicando no botão Java na parte superior do fragmento, quando ele é aberto no Editor Visual. Como em uma página regular, se você soltar um componente como um botão em um fragmento, clicar duas vezes adiciona um manipulador de eventos no bean do fragmento de página, permitindo que você reutilize o código em qualquer página a qual você adiciona o fragmento de página. Um cenário comum para reutilizar o código do componente seria um fragmento Caixa de pesquisa que possui um Rótulo de pesquisa, um Campo de texto onde o usuário indica a string de pesquisa, alguma Ajuda in-line e o código lógico da pesquisa no bean do fragmento de página.
Verbatim do Faces.