 
|
|
/ Indeks dokumentacji / Wdrożenie / Szabon strony / Plik XHTML / Znaczniki w systemie
Znaczniki w systemie
Znacznik to element szablonu XHTML który interpretowany jest przez system jako element podlegający interpretacji przez system.
Znaczniki inaczej zwane tagami mają postać tradycyjnego taga HTML z przedrostkiem cms:.
Przykładowy zapis
<cms:[nazwa elementu] [atrybuty]>[opis lub dodatkowe element]</cms:[nazwa elementu] >
- nazwa elementu - Wymagany: Przyjmuje wartości w zależności od zastosowanego modułu: Plaintext, Text, Html, Flash, Library, etc.
- atrybuty - Wymagany: Dodatkowe właściwości elementu. Jedynym wymaganym atrybutem znacznika jest id="[identyfikator]", który identyfikuje element w szablonie. Maksymalna długość identyfikatora Id to 32 znaki. Po przekroczeniu tej ilości znaków, kolejne są kasowane.
Przykład pełnego znacznika:
<cms:Image id="Zdjęcie" Style="border: solid red 1px" Align="right" Alt="Moje zdjęcie" Src="moje.gif">Moje zdjęcie ze szkoły</cms:Image>
Skrócony zapis tego samego znacznika
<cms:Image id="Zdjęcie" Style="border: solid red 1px" Align="right" Alt="Moje zdjęcie" Src="moje.gif />
Znaczniki są pełnoprawnymi tagami szablonu XHTML.
Atrybuty
Każdy znacznik posiada zestaw atrybutów za pomocą których możemy parametryzować jego zachowanie. Np. znacznik cms:Image ma atrybut Border. Jeżeli zostanie mu przypisana jakaś wartość numeryczna X – element ten będzie wtedy posiadał ramkę o grubości X. Przykład:
<cms:Image id="Zdjęcie” Border=”2” />
Atrybuty dostępne dla każdego elementu są opisane w dokumentacji. Patrz opisy elementów.
Znaki specjalne
W konstrukcji znaczników trzeba przestrzegać kilku zasad. Po pierwsze nie można stosować wewnątrz znacznika znaku >, np.
<cms:Text id="text" Text="więcej >>"></cms:Text> lub<cms:Text id="text" Text="więcej"><<Więcej</cms:Text>
Taki zapis może spowodować kłopoty z interpretacją znacznika. Wszystkie znaki '>' znajdujące się wewnątrz tagu powinny być encjami,np. > powinien być zapisany > a < <
Przykład poprawnego zapisu dla pierwszego przykładu:
<cms:Text id="text" Text="więcej >>"></cms:Text>
Przykład poprawnego zapisu dla drugiego przykładu:
<cms:Text id="text" Text="więcej">>>Więcej</cms:Text> lub<cms:Text id="text" Text="więcej"><![CDATA[ <<Więcej ]]></cms:Text>
To samo dotyczy się znaków ", & ,etc. Powinny być one zapisane w formie encji.
Przykład błędnego zapisu:
<cms:Text id="text" Text="więcej "danych" " />
Powyższy tak zostanie źle zinterpretowany, gdyż znak " służy tylko i wyłącznie jako kwantyfikator tekstu. Czyli, aby powyższy zapis został dobrze zinterpretowany należy użyć encji ( w tym przypadku: "e; ) i zapisać go tak:
<cms:Text id="text" Text="więcej "e;danych"e; " />
Przykłady encji
Znak:
- '&' (ampersand) powinien być zapisany '&'
- '"' (double quote) ) powinien być zapisany '"'
- ''' (single quote) ) powinien być zapisany '''
- '<' (less than) ) powinien być zapisany '<'
- '>' (greater than) ) powinien być zapisany '>'
Metryka dokumentu |
|||
| Tytuł: | Indeks dokumantacji | ||
| Opis: | Spis stron dokumentacji | ||
| Źródło: | +CMS Content Management | ||
| Prawa autorskie: | +CMS Content Management Platform | ||
| Autor: | root | Zmodyfikowany przez: | root |
| Data utworzenia: | 2008-09-07 18:40:59 | Data modyfikacji: | 2008-09-09 21:57:47 |
| Data publikacji: | 2008-09-07 18:42:25 | ||