Você está na página 1de 3

Utilizando a diretiva include ( e poupando trabalho )

A diretiva Include de grande valor para os desenvolvedores da web e tambm para


nossos amigos designers, pois com o include possvel criar verdadeiras "bibliotecas"
de funes, constantes e at mesmo partes de cdigos HTML que se repetiro em
vrias pginas de um mesmo site.
A diretiva include acrescenta um arquivo ( geralmente .HTM, .ASP ou algum script em
JavaScript armazenado dentro de um .TXT ) em uma pgina da web. Alm de criar
cdigos reaproveitveis, o uso do include agiliza a manuteno do seu site, pois basta
que voc altere o cdigo de um arquivo, que todas as pginas que incorporam este
arquivo sero alteradas de uma nica vez.
Para aqueles que conhecem a linguagem C, inevitvel lembrar dos arquivos header
que tambm so acrescentados ao programa via include. Para os que no conhecem C,
ficar mais fcil a compreenso desta diretiva com um exemplo bem simples.
Imagine que voc decidiu que todas as pginas do site no qual voc est trabalhando
devero mostrar nas duas ltimas linhas da pgina a data atual e mais uma mensagem
qualquer ( "todos os direitos reservados",por exemplo ). Para isto, voc teria que fazer
sempre o mesmo cdigo em todas as pginas. uma tarefa bem simples porm
repetitiva, e voc pode agilizar o seu trabalho se criar um arquivo .ASP com os
comandos que precisa e depois acrescent-lo em cada pgina atravs da diretiva
include.
Para implementar esta idia, o primeiro passo criar um arquivo .ASP qualquer com os
comandos que mostram a data atual e a mensagem desejada ("todos os direitos
reservados"). Vamos cham-lo de MostraRodape.asp.
<CENTER>
<%
Response.Write("Data: " & Date )
%>
<p>Todos os direitos reservados</p>
</CENTER>
Repare que o nosso arquivo MostraRodape.asp pode, sem problema algum, mesclar
cdigo ASP com TAGS ( comandos ) HTML. Lembre-se que este arquivo nada mais do
que uma pgina que ser incluida dentro de todas as outras.
Aps termos criado o arquivo, basta inclu-lo dentro das demais pginas.
Imagine que voc tem uma pgina inicial chamada Inicial.asp com o seguinte cdigo:
<HTML>
<BODY>
<p>Bem-Vindo ao meu site.
<p>Repare na data e na mensagem que esto na ltima linha....
</BODY>
<HTML>
Para que o rodap ( que est dentro do arquivo MostraRodape.asp ) aparea no final
da pgina, basta acrescentar a diretiva include, de modo que o cdigo da sua pgina
inicial ficar assim:
<HTML>
<BODY>
<p>Bem-Vindo ao meu site.

<p>Repare no rodap desta pgina....


<!-- #include file = "MostraRodape.asp" -->
</BODY>
<HTML>
muito simples! Desta forma, o servidor entende que no lugar da diretiva include,
deve ser colocado o cdigo existente no arquivo indicado pela diretiva.
Como se pode perceber, a sintaxe do include :
<!-- #include file = "nome_do_arquivo" -->
ALGUMAS OBSERVAES:
1 ) O arquivo nome_do_arquivo deve estar no mesmo diretrio que a pgina onde ele
ser includo. Se os arquivos estiverem em diretrios diferentes, o caminho deve ser
indicado.
Exemplos:
<!-- #include file="/inc/MostraRodape.asp" --> - Indica que o arquivo MostraRodap
est dentro do Diretrio INC, que por sua vez est dentro do mesmo diretrio que a
pgina que contm a diretiva include.
<!-- #include file="../MostraRodape.asp" --> - Indica que o arquivo MostraRodap
est um diretrio acima do diretrio da pgina que contm a diretiva include.
2 ) Existe uma varincia da diretiva include, onde troca-se o parmetro file por
virtual.
Enquanto o caminho no include file procurado a partir do diretrio corrente, no
include virtual ele procurado sempre a partir da raiz.
Exemplo:
Imagine que dentro do diretrio raiz do seu site voc tem a pasta INC e a pasta
PAGINAS.A pasta PGINAS, por sua vez, contm as pastas COMUNS e
ADMINISTRACAO.
Imaginando que o arquivo MostraRodape.asp esteja dentro da pasta INC e o arquivo
Inicial.asp esteja dentro da pasta COMUNS, temos os seguintes caminhos:
MostraRodape.asp : /INC/MOSTRARODAPE.ASP
Inicial.asp : /PAGINAS/COMUNS/MOSTRARODAPE.ASP
Uma forma correta de acrescentar a diretiva include dentro do arquivo Inicial.asp seria
<!-- #include virtual= "/inc/MostraRodape.asp" -->
Pois o parmetro Virtual indica que o caminho dever ser procurado a paritr da raiz, e
no a partir do diretrio corrente.
3 ) A diretiva include pode ser colocada em qualquer ponto dentro de uma pgina.
Logo, no cdigo abaixo, o "rodap" seria mostrado na primeira e na segunda linha da
pgina.

<HTML>
<BODY>
<!-- #include file = "MostraRodape.asp" -->
<p>Bem-Vindo ao meu site.
<p>Repare no rodap desta pgina....
</BODY>
<HTML>
Caso voc deseje utilizar a diretiva Include dentro de uma pgina HTM, dever trocar
a extenso da pgina de HTM para SHTM, e o servidor deve suportar esta tecnologia.