Sobre os modelos do Dreamweaver

Um modelo é um tipo especial de documento usado para criar um layout de página "fixo"; você pode criar documentos com base no modelo que herdam o layout da página. Ao criar um modelo, você especifica como "editável" o conteúdo que os usuários podem editar em um documento baseado nesse modelo. Os modelos permitem que os autores de modelo controlem quais elementos de página os usuários de modelo—como redatores, artistas gráficos ou outros desenvolvedores web—podem editar. Há vários tipos de regiões de modelo que o autor de modelo pode incluir em um documento.

Com o uso de modelos, você pode atualizar várias páginas de uma vez. Um documento criado a partir de um modelo permanece conectado a esse modelo (a menos que você desanexe o documento posteriormente). Você pode modificar um modelo e atualizar imediatamente o design em todos os documentos baseados nele.

Tipos de regiões de modelo

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 quaisquer links no arquivo são atualizados para que seus caminhos relativos ao documento estejam corretos. Posteriormente, quando você cria um documento baseado nesse modelo e o salva, todos os links relativos ao documento são atualizados novamente para continuar apontando para os arquivos corretos.

Quando você adiciona um novo link relativo ao documento a um arquivo de modelo, é fácil inserir o nome de caminho incorreto se você digitar o caminho 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, não o caminho da pasta do documento baseado em modelo para o documento vinculado. Certifique-se de que os caminhos corretos para links existam usando o ícone de pasta ou o ícone Apontar para 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 final do documento (antes da tag <html> ou após a tag </html>). Esses scripts requerem tratamento especial em modelos e documentos baseados em modelo. Normalmente, se você fizer alterações no código de script antes da tag <html> ou após a tag </html> em um modelo, as alterações não são copiadas para documentos baseados nesse modelo. Isso pode causar erros de servidor se outros scripts de servidor, dentro do corpo principal do modelo, dependessem dos scripts que não são 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:

<!-- TemplateInfo codeOutsideHTMLIsLocked="true" -->

Quando esse código está em um modelo, as alterações nos scripts antes da tag <html> ou após a tag </html> são copiadas para documentos baseados nesse modelo. No entanto, você não conseguirá mais editar esses scripts em documentos baseados no modelo. Assim, você pode escolher editar esses scripts no modelo ou em documentos baseados no modelo, mas não ambos.

Parâmetros de modelo

Parâmetros de modelo indicam valores para controlar conteúdo em documentos baseados em um modelo. Use parâmetros de modelo para regiões opcionais\nou atributos de tag editáveis, ou para definir valores que deseja passar para\num documento anexo.Para cada parâmetro, você seleciona um nome, um tipo de dados e um valor padrão.Cada parâmetro deve ter um nome único\nque diferencia maiúsculas de minúsculas.Eles devem ser um dos cinco tipos de dados permitidos: texto, booleano, 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, um usuário de modelo pode editar o valor padrão do parâmetro para personalizar o que aparece em um documento baseado em modelo.Em outros casos, o autor do modelo pode determinar o que aparece no documento, com base no valor de uma expressão de modelo.

Expressões de modelo

Expressões de modelo são declarações que calculam 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 tão simples quanto o valor de um parâmetro, como @@(Param)@@, ou complexa o suficiente para calcular valores que alternam a cor do 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 for verdadeira, a região opcional aparece no documento baseado em modelo; se for falsa, não aparece.

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

Na visualização Código, há duas maneiras de definir expressões de modelo:\nuse o <!-- TemplateExpr expr=\"your expresson\"--> Comentário\nou @@(your expression)@@.Quando você inserir a expressão no código do modelo, um marcador de expressão aparece na exibição Design.Quando aplicar 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 de expressão de modelo é um pequeno subconjunto do JavaScript e usa sintaxe do JavaScript e regras de precedência.Use\noperadores JavaScript para escrever uma expressão como esta:

@@(firstName+lastName)@@

Estes recursos e operadores podem ser usados:

• literais numéricos, literais de string (apenas sintaxe de\naspas duplas), literais booleanos (verdadeiro ou falso)

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

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

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

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

• operador condicional: ?:

• parênteses: ()

  Os seguintes tipos de dados são usados:\nBooleano, ponto flutuante IEEE 64‑bpc, string e objeto.Os modelos do Dreamweaver não oferecem suporte ao\nuso de tipos JavaScript "null" ou "undefined".Nem permitem que tipos escalares sejam convertidos implicitamente em um objeto; assim, a expressão "abc".length acionaria um erro, em vez de gerar o valor 3.

  Os únicos objetos disponíveis\nsão aqueles definidos pelo modelo de objeto de expressão.As seguintes\nvariáveis são definidas:

  _document

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

  _repeat

  Definido apenas para expressões que aparecem dentro de uma região repetida. 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 é a primeira entrada de sua região repetida

  _isLast

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

  _prevRecord

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

  _nextRecord

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

  _parent

  Em uma região repetida aninhada, isso fornece o objeto _repeat para a região repetida que a envolve (externa). É um erro acessar essa propriedade fora de uma região repetida aninhada.

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

  Em casos onde há conflito de campos, os campos do objeto _repeat têm precedência sobre os campos do objeto _document.Portanto, você não deve precisar referenciar explicitamente _document ou _repeat, exceto que _document pode ser necessário dentro de uma região repetida para referenciar parâmetros do documento que estão ocultos por parâmetros da região repetida.

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

Condição If múltipla no código do modelo

Você pode definir expressões de modelo para condições if e multiple-if . Este exemplo demonstra como definir um parâmetro chamado "Dept", definir um valor inicial e definir uma condição multiple-if que determina qual logotipo exibir.

A seguir está um exemplo do código que você pode inserir na seção head do modelo:

<!-- TemplateParam name="Dept" type="number" value="1" -->

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

<!-- TemplateBeginMultipleIf -->

<!-- verifica valor de Dept e mostra imagem apropriada-->

<!-- TemplateBeginIfClause cond="Dept == 1" --> <img src=".../sales.gif"> <!-- TemplateEndIfClause -->

<!-- TemplateBeginIfClause cond="Dept == 2" --> <img src=".../support.gif"> <!-- TemplateEndIfClause-->

<!-- TemplateBeginIfClause cond="Dept == 3" --> <img src=".../hr.gif"> <!-- TemplateEndIfClause -->

<!-- TemplateBeginIfClause cond="Dept != 3" --> <img src=".../spacer.gif"> <!-- TemplateEndIfClause -->

<!-- TemplateEndMultipleIf -->

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

Veja também

• Criar um modelo do Dreamweaver
• Editar o conteúdo em um documento com base no modelo
• Criar regiões editáveis nos modelos
• Criar regiões repetitivas em modelos
• Utilizando regiões opcionais em modelos
• Definição de atributos de tag editáveis em modelos
• Caminhos relativos a documentos
• Modificar propriedades de modelo