A diretiva Include é de grande valor para os desenvolvedores da web e também para nossos amigos designers, pois com o include é possível criar verdadeiras "bibliotecas" de funções, constantes e até mesmo partes de códigos HTML que se repetirão em várias páginas 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 página da web. Além de criar códigos reaproveitáveis, o uso do include agiliza a manutenção do seu site, pois basta que você altere o código de um arquivo, que todas as páginas que incorporam este arquivo serão alteradas de uma única vez.
Para aqueles que conhecem a linguagem C, é inevitável lembrar dos arquivos header que também são acrescentados ao programa via include. Para os que não conhecem C, ficará mais fácil a compreensão desta diretiva com um exemplo bem simples.
Imagine que você decidiu que todas as páginas do site no qual você está trabalhando deverão mostrar nas duas últimas linhas da página a data atual e mais uma mensagem qualquer ( "todos os direitos reservados",por exemplo ). Para isto, você teria que fazer sempre o mesmo código em todas as páginas. É uma tarefa bem simples porém repetitiva, e você pode agilizar o seu trabalho se criar um arquivo .ASP com os comandos que precisa e depois acrescentá-lo em cada página através da diretiva include.
Para implementar esta idéia, 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.
<%
Response.Write("Data: " & Date )
%>
Todos os direitos reservados
Repare que o nosso arquivo MostraRodape.asp pode, sem problema algum, mesclar código ASP com TAGS ( comandos ) HTML. Lembre-se que este arquivo nada mais é do que uma página que será incluida dentro de todas as outras.
Após termos criado o arquivo, basta incluí-lo dentro das demais páginas.
Imagine que você tem uma página inicial chamada
Inicial.asp com o seguinte código:
Bem-Vindo ao meu site.
Repare na data e na mensagem que estão na última linha....
Para que o rodapé ( que está dentro do arquivo MostraRodape.asp ) apareça no final da página, basta acrescentar a diretiva include, de modo que o código da sua página inicial ficará assim:
Bem-Vindo ao meu site.
Repare no rodapé desta página....
<!-- #include file = "MostraRodape.asp" -->
É muito simples! Desta forma, o servidor entende que no lugar da diretiva
include, deve ser colocado o código existente no arquivo indicado pela diretiva.
Como se pode perceber, a sintaxe do include é:
<!-- #include file = "nome_do_arquivo" -->
ALGUMAS OBSERVAÇÕES:
1 ) O arquivo
nome_do_arquivo deve estar no mesmo diretório que a página onde ele será incluído. Se os arquivos estiverem em diretórios diferentes, o caminho deve ser indicado.
Exemplos:
<!-- #include file="/inc/MostraRodape.asp" --> - Indica que o arquivo MostraRodapé está dentro do Diretório INC, que por sua vez está dentro do mesmo diretório que a página que contém a diretiva include.
<!-- #include file="../MostraRodape.asp" --> - Indica que o arquivo MostraRodapé está um diretório acima do diretório da página que contém a diretiva include.
2 ) Existe uma variância da diretiva include, onde troca-se o parâmetro
file por
virtual.
Enquanto o caminho no include file é procurado a partir do diretório corrente, no include virtual ele é procurado
sempre a partir da raiz.
Exemplo:
Imagine que dentro do diretório raiz do seu site você tem a pasta
INC e a pasta
PAGINAS.A pasta
PÁGINAS, por sua vez, contém 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 parâmetro
Virtual indica que o caminho deverá ser procurado a paritr da raiz, e não a partir do diretório corrente.
3 ) A diretiva include pode ser colocada em qualquer ponto dentro de uma página. Logo, no código abaixo, o "rodapé" seria mostrado na primeira e na segunda linha da página.
<!-- #include file = "MostraRodape.asp" -->
Bem-Vindo ao meu site.
Repare no rodapé desta página....
Caso você deseje utilizar a diretiva Include dentro de uma página HTM, deverá trocar a extensão da página de HTM para SHTM, e o servidor deve suportar esta tecnologia.