Over sjablonen van Dreamweaver

Een sjabloon is een speciaal type document dat je gebruikt om een "vaste" pagina-indeling te ontwerpen; je kunt vervolgens documenten maken op basis van het sjabloon dat de pagina-indeling overneemt. Terwijl je een sjabloon ontwerpt, geef je aan welke content als "bewerkbaar" kan worden bewerkt door gebruikers in een document op basis van dat sjabloon. Sjablonen stellen sjabloonauteurs in staat te bepalen welke pagina-elementen sjabloongebruikers—zoals schrijvers, grafisch ontwerpers of andere webontwikkelaars—kunnen bewerken.Er zijn verschillende typen sjabloongebieden die de sjabloonauteur kan toevoegen aan een document.

Door sjablonen te gebruiken kunt u meerdere pagina's tegelijk bijwerken. Een document dat wordt gemaakt op basis van een sjabloon blijft verbonden met dat sjabloon (tenzij je het document later loskoppelt). Je kunt een sjabloon wijzigen en direct het ontwerp bijwerken in alle documenten die erop gebaseerd zijn.

Typen sjabloongebieden

Als u een document opslaat als een sjabloon, zijn de meeste gebieden van een document vergrendeld. Als sjabloonauteur bepaalt u welke gebieden van een op een sjabloon gebaseerd document bewerkbaar zijn door bewerkbare gebieden of bewerkbare parameters in de sjabloon in te voegen.

Terwijl u de sjabloon maakt, kunt u zowel in bewerkbare als vergrendelde gebieden wijzigingen aanbrengen. In een op de sjabloon gebaseerd document kan een sjabloongebruiker echter alleen wijzigingen aanbrengen in de bewerkbare gebieden; de vergrendelde gebieden kunnen niet worden gewijzigd.

Er zijn vier typen sjabloongebieden:

Een bewerkbaar gebied: Een niet-vergrendeld gebied in een op een sjabloon gebaseerd document—een gedeelte dat een sjabloongebruiker kan bewerken. Een sjabloonauteur kan elk gebied van een sjabloon aanmerken als bewerkbaar. Een sjabloon is pas doelmatig als het ten minste één bewerkbaar gebied bevat; Als dit niet het geval is, kunnen pagina's die op de sjabloon zijn gebaseerd, niet worden bewerkt. Zie Bewerkbare gebieden maken in sjablonen voor gedetailleerde informatie in bewerkbare gebieden.

Een herhalingsgebied: Een gedeelte van de documentlay-out dat dusdanig is ingesteld dat de sjabloongebruiker desgewenst kopieën van het herhalingsgebied kan toevoegen aan of verwijderen uit een document dat op de sjabloon is gebaseerd. Zo kunt u instellen dat een tabelrij moet worden herhaald. Herhalingsgedeelten zijn bewerkbaar zodat de sjabloongebruiker de inhoud in het herhalingselement wel kan bewerken, maar dat het ontwerp zelf onder de controle van de sjabloonauteur blijft.

Er zijn twee typen herhalingsgebieden die u in een sjabloon kunt invoegen: een herhalingsgebied en een herhalingstabel. Zie Herhalingsgebieden en tabellen maken in Dreamweaver als u wilt weten hoe u met herhalingsgebieden kunt werken.

Een optioneel gebied: Een gedeelte van een sjabloon dat inhoud—zoals tekst of een afbeelding—bevat die al dan niet in een document wordt weergegeven. Op de op een sjabloon gebaseerde pagina bepaalt meestal de sjabloongebruiker of de inhoud wordt weergegeven. Zie de sectie Optioneel gebied voor meer informatie.

Een bewerkbaar tagkenmerk: Hiermee ontgrendelt u een tagkenmerk in een sjabloon, waardoor het kenmerk kan worden bewerkt in een op een sjabloon gebaseerde pagina. Zo kunt u “vergrendelen” welke afbeelding wordt weergegeven in het document, waarbij de sjabloongebruiker nog wel de uitlijning kan instellen op links, rechts of gecentreerd. Zie Bewerkbare tagkenmerken in Dreamweaver definiëren voor meer informatie.

Koppelingen in sjablonen

Wanneer je een sjabloonbestand maakt door een bestaande pagina op te slaan als sjabloon, wordt het nieuwe sjabloon in de map Sjablonen geplaatst en worden alle koppelingen in het bestand bijgewerkt zodat hun document-relatieve paden correct zijn.Later, wanneer je een document maakt op basis van dat sjabloon en het opslaat, worden alle document-relatieve koppelingen opnieuw bijgewerkt om te blijven wijzen naar de juiste bestanden.

Wanneer je een nieuwe document-relatieve koppeling toevoegt aan een sjabloonbestand, is het makkelijk om de verkeerde padnaam in te voeren als je het pad intypt in het tekstvak voor koppelingen in de Eigenschappencontrole.Het juiste pad in een sjabloonbestand is het pad van de map Sjablonen naar het gekoppelde document, niet het pad van de map van het op sjabloon gebaseerde document naar het gekoppelde document.Zorg ervoor dat de juiste paden voor koppelingen bestaan door het mappictogram of het Punt-naar-bestand-pictogram in de Property inspector te gebruiken bij het maken van koppelingen in sjablonen.

Server scripts in sjablonen en sjabloon-gebaseerde documenten

Sommige server scripts worden ingevoegd aan het begin of einde van het document (vóór de <html>-tag of na de </html>-tag). Dergelijke scripts vereisen speciale behandeling in sjablonen en sjabloon-gebaseerde documenten. Normaal gesproken, als je wijzigingen aanbrengt in scriptcode vóór de <html>-tag of na de </html>-tag in een sjabloon, worden de wijzigingen niet gekopieerd naar documenten die op dat sjabloon gebaseerd zijn. Dit kan serverfouten veroorzaken als andere serverscripts binnen de hoofdtekst van het sjabloon afhankelijk waren van de scripts die niet gekopieerd worden.Een melding waarschuwt je als je scripts wijzigt vóór de <html>-tag of na de </html>-tag in een sjabloon.

Om dit probleem te vermijden, kun je de volgende code invoegen in de head-sectie van het sjabloon:

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

Wanneer deze code in een sjabloon staat, worden wijzigingen aan scripts vóór de <html>-tag of na de </html>-tag gekopieerd naar documenten die op dat sjabloon gebaseerd zijn. Je kunt echter die scripts niet meer bewerken in documenten die op het sjabloon gebaseerd zijn. Je kunt er dus voor kiezen om deze scripts te bewerken in het sjabloon, of in documenten die op het sjabloon gebaseerd zijn, maar niet beide.

Sjabloonparameters

Sjabloonparameters geven waarden aan voor het beheren van content in documenten die op een sjabloon gebaseerd zijn.Gebruik sjabloonparameters voor optionele gebieden of bewerkbare tagattributen, of om waarden in te stellen die je wilt doorgeven aan een bijgevoegd document.Voor elke parameter selecteer je een naam, een gegevenstype en een standaardwaarde. Elke parameter moet een unieke naam hebben die hoofdlettergevoelig is. Ze moeten een van de vijf toegestane gegevenstypen zijn: tekst, boolean, kleur, URL of getal.

Sjabloonparameters worden aan het document doorgegeven als objectparameters. In de meeste gevallen kan een template-gebruiker de standaardwaarde van de parameter bewerken om aan te passen wat verschijnt in een document gebaseerd op een template. In andere gevallen kan de sjabloonauteur bepalen wat in het document verschijnt, op basis van de waarde van een sjabloonexpressie.

Sjabloonexpressies

Sjabloonexpressies zijn instructies die een waarde berekenen of evalueren.

Je kunt een expressie gebruiken om een waarde op te slaan en weer te geven in een document. Een expressie kan bijvoorbeeld zo eenvoudig zijn als de waarde van een parameter, zoals @@(Param)@@, of complex genoeg om waarden te berekenen die de achtergrondkleur in een tabelrij afwisselen, zoals @@((_index & 1) ? rood : blauw)@@.

Ook kunt u expressies definiëren voor enkelvoudige en meervoudige if-voorwaarden. Als een expressie wordt gebruikt in een voorwaardelijke instructie, beoordeelt Dreamweaver deze als true (waar) of false (onwaar). Als de voorwaarde waar is, verschijnt de optionele regio in het document gebaseerd op de template; als het false is, verschijnt het niet.

Je kunt expressies definiëren in de Code-weergave of in het dialoogvenster Optionele regio wanneer je een optionele regio invoegt.

In de Code-weergave zijn er twee manieren om sjabloonexpressies te definiëren: gebruik de <!-- TemplateExpr expr=&quot;your expression&quot;--> opmerking of @@(your expression)@@.Wanneer je de expressie in de sjablooncode invoegt, verschijnt er een expressiemarker in de Ontwerpweergave. Wanneer je het sjabloon toepast, evalueert Dreamweaver de expressie en toont de waarde in het document op basis van het sjabloon.

Taal voor sjabloonexpressies

De sjabloonexpressietaal is een kleine subset van JavaScript en gebruikt JavaScript-syntaxis en voorrangsregels. Gebruik JavaScript-operatoren om een expressie als deze te schrijven:

@@(firstName+lastName)@@

De volgende functies en operatoren worden ondersteund:

• numerieke literals, tekenreeks literals (alleen dubbele aanhalingstekens syntaxis), Boolean literals (true of false)

• Variabeleverwijzing (zie de lijst met gedefinieerde variabelen verderop in deze sectie)

• veldverwijzing (de “punt”-operator)

• monadische operatoren: +, -, ~, !

• binaire operatoren: +, -, *, /, %, &, |, ^, &&, ||, <, <=, >, >=, ==, !=, <<, >>

• voorwaardelijke operator: ?:

• haakjes: ()

  De volgende gegevenstypes worden gebruikt: Boolean, IEEE 64‑bpc Zweven punt, tekenreeks en object. Dreamweaver sjablonen ondersteunen het gebruik van JavaScript "null" of "undefined" types niet. Ze staan ook niet toe dat scalaire types impliciet worden geconverteerd naar een object; dus de expressie "abc".length zou een fout veroorzaken, in plaats van de Waarde 3 op te leveren.

  De enige beschikbare objecten zijn die welke zijn gedefinieerd door het expressieobjectmodel. De volgende variabelen zijn gedefinieerd:

  _document

  Bevat de document-Niveau template-gegevens met een veld voor elke parameter in het template.

  _repeat

  Alleen gedefinieerd voor uitdrukkingen die binnen een herhalende regio verschijnen. Biedt ingebouwde informatie over het gebied

  _index

  De numerieke index (vanaf 0) van de huidige vermelding

  _numRows

  Het totaal aantal vermeldingen in dit herhalingsgebied

  _isFirst

  True als de huidige invoer de eerste invoer is in zijn herhalende regio

  _isLast

  True als de huidige invoer de laatste invoer is in zijn herhalende regio

  _prevRecord

  Het object _repeat voor de vorige vermelding. Het is een fout om toegang te krijgen tot deze eigenschap voor de eerste invoer in de regio.

  _nextRecord

  Het object _repeat voor de volgende vermelding. Het is een fout om deze eigenschap te benaderen voor de laatste invoer in de regio.

  _parent

  In een geneste herhaalde regio geeft dit het _repeat object voor de omsluitende (buitenste) herhaalde regio. Het is een fout om toegang te krijgen tot deze eigenschap buiten een geneste herhaalde regio.

  Tijdens de evaluatie van expressies zijn alle velden van het _document object en _repeat object impliciet beschikbaar.Je kunt bijvoorbeeld title invoeren in plaats van _document.title om toegang te krijgen tot de titelparameter van het document.

  In gevallen waar er een veldconflict is, hebben velden van het _repeat object voorrang over velden van het _document object.Daarom hoef je _document of _repeat niet expliciet te refereren, behalve dat _document mogelijk nodig is binnen een herhalende regio om document parameters te refereren die verborgen zijn door herhaalde regio parameters.

  Wanneer geneste herhaalde regio's worden gebruikt, zijn alleen velden van de binnenste herhaalde regio's impliciet beschikbaar.Naar buitenste gebieden moet expliciet worden verwezen door middel van _parent.

Meerdere if-voorwaarden in sjablooncode

Je kunt sjabloonexpressies definiëren voor if- en multiple-if-condities.Dit voorbeeld toont het definiëren van een parameter genaamd "Dept", het instellen van een initiële waarde en het definiëren van een multiple-if-voorwaarde die bepaalt welk logo wordt weergegeven.

Het volgende is een voorbeeld van de code die je zou kunnen invoeren in de head-sectie van het sjabloon:

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

De volgende voorwaarde instructie controleert de Waarde toegewezen aan de Dept parameter. Wanneer de voorwaarde waar of overeenkomt, wordt de juiste Afbeelding weergegeven.

<!-- TemplateBeginMultipleIf -->

<!-- controleert waarde van Dept en toont juiste afbeelding-->

<!-- 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 -->

Wanneer je een document maakt op basis van een template, worden de template-parameters automatisch doorgegeven.De template-gebruiker bepaalt welke afbeelding wordt weergegeven.

Verwante informatie

• Een Dreamweaver-sjabloon maken
• Inhoud in een op een sjabloon gebaseerd document bewerken
• Bewerkbare gebieden maken in sjablonen
• Herhalingsgebieden maken in sjablonen
• Optionele gebieden gebruiken in sjablonen
• Bewerkbare tag-attributen definiëren in templates
• Documentafhankelijke relatieve paden
• Sjablooneigenschappen wijzigen