Sobre os modelos do Dreamweaver

Um modelo é um tipo especial de documento usado para criar um layout de página “fixo”. Os documentos criados com base no modelo herdam o seu layout de página. Ao criar um modelo, você especifica o conteúdo que os usuários podem editar em um documento criado com esse modelo. Os modelos permitem que seus autores controlem os elementos de página que os usuários do modelo (redatores, artistas gráficos ou desenvolvedores da Web) podem editar. Há diversos tipos de regiões que o autor do modelo pode incluir em um documento.

Com o uso de modelos, você pode atualizar várias páginas de uma vez. Um documento criado com um modelo permanece conectado a esse modelo até ser desanexado. É possível modificar um modelo e imediatamente atualizar o design em todos os documentos nele baseados.

Quando você salva um documento como modelo, grande parte das regiões do documento são bloqueadas. Como autor do modelo, você especifica quais regiões do documento baseado em modelo serão editáveis. Para isso, você insere regiões editáveis ou parâmetros editáveis no modelo.

Ao criar o modelo, você pode alterar as regiões editáveis e as regiões bloqueadas. Contudo, em um documento baseado no modelo, o usuário do modelo só pode efetuar alterações nas regiões editáveis; as regiões bloqueadas não podem ser modificadas.

Existem quatro tipos de regiões de modelo:

Uma região editável: uma região desbloqueada em um documento baseado em modelo (uma seção que o usuário do modelo pode editar). O autor do modelo pode especificar qualquer área do modelo como editável. Para ser eficaz, o modelo deve conter pelo menos uma região editável. Caso contrário, as páginas com base no modelo não poderão ser editadas. Para obter informações detalhadas sobre regiões editáveis, consulte Criar regiões editáveis em modelos.

Uma região repetitiva: uma seção do layout do documento definida para que o usuário do modelo possa adicionar ou excluir cópias da região repetitiva de um documento com base no modelo conforme necessário. Por exemplo, você pode definir que uma linha da tabela se repita. As seções repetitivas são editáveis; portanto, o usuário do modelo pode editar o conteúdo no elemento repetitivo, enquanto o próprio design fica sob o controle do autor do modelo.

Há dois tipos de regiões repetitivas que você pode inserir em um modelo: região repetitiva e tabela repetitiva. Para saber como trabalhar com as regiões repetitivas, consulte Criar regiões e tabelas repetitivas no Dreamweaver.

Uma região opcional: uma seção de um modelo cujo conteúdo (como texto ou imagem) pode aparecer ou não em um documento. Na página com base no modelo, o usuário do modelo geralmente controla se o conteúdo é exibido. Para obter mais informações, consulte a seção da região opcional.

Um atributo de tag editável: permite desbloquear um atributo de tag em um modelo, de modo que o atributo possa ser editado em uma página com base no modelo. Por exemplo, você pode “bloquear” a imagem que aparecerá no documento, mas permitir que o usuário do modelo defina o alinhamento à esquerda, à direita ou ao centro. Consulte Definir atributos de tag editáveis no Dreamweaver para obter mais informações.

Links em modelos

Quando você cria um arquivo de modelo salvando uma página existente como modelo, o novo modelo na pasta Modelos e os links no arquivo são atualizados para que os caminhos relativos ao documento estejam corretos. Posteriormente, quando você criar um documento baseado nesse modelo e o salvar, todos os links relativos ao documento serão atualizados novamente para continuar a apontar para os arquivos corretos.

Ao adicionar um novo link de documento ao arquivo de modelo, você pode facilmente errar o nome do caminho se o digitar na caixa de texto do link no Inspetor de propriedades. O caminho correto em um arquivo de modelo é o caminho da pasta Modelos para o documento vinculado, e não o caminho da pasta do documento baseado em modelo para o documento vinculado. Verifique se os caminhos para os links estão corretos usando o ícone de pasta ou o ícone Indicar arquivo no Inspetor de propriedades ao criar links em modelos.

Scripts de servidor em modelos e documentos baseados em modelo

Alguns scripts de servidor são inseridos no início ou no fim do documento (antes da tag <html> ou após a tag </html>). Esses scripts exigem tratamento especial em modelos e documentos baseados em modelo. Normalmente, se você altera o código do script antes da tag <html> ou após a tag </html> em um modelo, as alterações não são copiadas para os documentos que se baseiam nesse modelo. Isso pode gerar erros se outros scripts de servidor, dentro do corpo principal do modelo, dependerem dos scripts que não forem copiados. Um alerta avisa se você alterar scripts antes da tag <html> ou após a tag </html> em um modelo.

Para evitar esse problema, você pode inserir o seguinte código na seção head do modelo:

Quando esse código está em um modelo, as alterações em scripts antes da tag <html> ou após a tag </html> são copiadas para documentos baseados nesse modelo. Contudo, você não poderá mais editar esses scripts em documentos baseados no modelo. Dessa forma, você pode optar por editar esses scripts no modelo ou em documentos baseados no modelo, mas não em ambos.

Parâmetros de modelo

Os parâmetros de modelo indicam valores para controlar o conteúdo em documentos baseados em modelo. Use parâmetros de modelo para regiões opcionais ou atributos de tags editáveis ou para definir os valores que você deseja passar para um documento anexado. Para cada parâmetro, você seleciona um nome, um tipo de dados e um valor padrão. Cada parâmetro deve ter um nome exclusivo que diferencie maiúsculas e minúsculas. Eles devem ser de um dos cinco tipos de dados permitidos: texto, booliano, cor, URL ou número.

Os parâmetros de modelo são passados para o documento como parâmetros de ocorrência. Na maioria dos casos, o usuário de um modelo pode editar o valor padrão do parâmetro para personalizar o que é exibido no documento baseado em modelo. Em outros casos, o autor do modelo pode determinar o que aparece no documento, de acordo com o valor de uma expressão do modelo.

Expressões de modelo

As expressões de modelo são instruções que computam ou avaliam um valor.

Você pode usar uma expressão para armazenar um valor e exibi-lo em um documento. Por exemplo, uma expressão pode ser simples como o valor de um parâmetro, como @@(Param)@@, ou complexa o suficiente para computar valores que alternam a cor de fundo em uma linha de tabela, como @@((_index & 1) ? red : blue)@@.

Você também pode definir expressões para condições if e if múltiplo. Quando uma expressão é usada em uma instrução condicional, o Dreamweaver a avalia como verdadeira ou falsa. Se a condição é verdadeira, a região opcional aparece no documento baseado em modelo; se é falsa, ela não aparece.

Você pode definir expressões na visualização de código ou na caixa de diálogo Região opcional ao inserir uma região opcional.

Na visualização de código, há duas formas de definir expressões de modelo: use o comentário <!-- TemplateExpr expr="sua expressão"--> comentário ou @@(sua expressão)@@. Quando você insere a expressão no código de modelo, um marcador de expressão é exibido na Visualização de design. Quando você aplica o modelo, o Dreamweaver avalia a expressão e exibe o valor no documento baseado em modelo.

Linguagem da expressão de modelo

A linguagem da expressão de modelo é um pequeno subconjunto de JavaScript e usa regras precedentes e sintaxe JavaScript. Use os operadores JavaScript para desenvolver uma expressão como esta:

Estes recursos e operadores podem ser usados:

• literais numéricos, sequências de caracteres literais (somente sintaxe entre aspas duplas), boolianos literais (verdadeiro ou falso)

• referência de variável (veja a lista de variáveis definidas nesta seção)

• referência de campo (operador "dot")

• operadores unários: +, -, ~, !

• operadores binários: +, -, *, /, %, &, |, ^, &&, ||, <, <=, >, >=, ==, !=, <<, >>

• operador condicional: ?:

• parênteses: ()

  Estes são os tipos de dados usados: booliano, ponto flutuante IEEE 64 bpc, sequência de caracteres e objeto. Os modelos do Dreamweaver não utilizam os tipos JavaScript “nulo” ou “não definido”. Eles também não permitem que tipos escalares sejam convertidos implicitamente em um objeto; portanto, a expressão "abc".length acionaria um erro, em vez de gerar o valor 3.

  Os únicos objetos disponíveis são os definidos pelo modelo de objeto de expressão. As seguintes variáveis são definidas:

  _document

  Contém os dados do modelo em nível de documento com um campo para cada parâmetro no modelo.

  _repeat

  Definido apenas para expressões que aparecem em uma região repetitiva. Fornece informações internas sobre a região.

  _index

  O índice numérico (a partir de 0) da entrada atual.

  _numRows

  O número total de entradas nesta região repetitiva.

  _isFirst

  Verdadeiro se a entrada atual for a primeira entrada na região repetitiva.

  _isLast

  Verdadeiro se a entrada atual for a última entrada na região repetitiva.

  _prevRecord

  O objeto _repeat da entrada anterior. É um erro acessar esta propriedade para a primeira entrada na região.

  _nextRecord

  O objeto _repeat da próxima entrada. É um erro acessar esta propriedade para a última entrada na região.

  _parent

  Em uma região repetitiva aninhada, ele informa o objeto _repeat para a região repetitiva externa. É um erro acessar esta propriedade fora de uma região repetitiva aninhada.

  Durante a avaliação da expressão, todos os campos dos objetos _document e _repeat estão implicitamente disponíveis. Por exemplo, você pode inserir title em vez de _document.title para acessar o parâmetro de título do documento.

  Em casos nos quais há conflito de campo, os campos do objeto _repeat têm prioridade em relação aos campos do objeto _document. Portanto, não há necessidade de mencionar explicitamente _document ou _repeat, a não ser que _document seja necessário em uma região repetitiva para fazer referência aos parâmetros de documento que são ocultos por parâmetros de região repetitiva.

  Quando regiões repetitivas aninhadas são usadas, somente os campos das regiões repetitivas mais internas estão implicitamente disponíveis. As regiões externas devem ser referenciadas explicitamente com _parent.

Condição If múltiplo em código de modelo

Você pode definir expressões de modelo para condições if e if múltiplo. Este exemplo demonstra como definir um parâmetro denominado “Dept”, como configurar um valor inicial e como definir uma condição if múltiplo que determina a exibição de determinado logotipo.

Este é um exemplo do código a ser inserido na seção head do modelo:

A instrução de condição a seguir verifica o valor atribuído ao parâmetro Dept. Quando a condição é verdadeira ou correspondente, a imagem apropriada é exibida.

Quando você cria um documento baseado em modelo, os parâmetros de modelo são passados para o documento automaticamente. O usuário do modelo determina qual imagem será exibida.