Link (SPT-Tag)

Dieser Artikel bedarf einer Überarbeitung. Näheres ist auf der Diskussionsseite angegeben. Hilf bitte mit ihn zu verbessern und entferne anschließend diese Markierung.

Name

<spt:link> - Erzeugt Links auf Informationen und bindet Bildmedien ein.

Syntax

<spt:link name      = "variable"
          type      = "navlink"
          pools     = "!{gui.informations}"
          hidden    = "false"
          locale    = "de"
          size      = "50"
          value     = ""
          width     = ""
          height    = ""
          showTree  = "true"
/>

Beschreibung

Der Tag spt:link löst den veralteten Tag spt:systemlink ab.

Mit dem spt:link-Tag kann ein Link auf andere Informationen des Systems gesetzt werden. Mit diesem Tag lassen sich weiterhin Bildmedien in einen Artikel einbinden.

Dieser Link erzeugt ein readonly-Textfeld, in dem der Name des verknüpften Artikels, Resource oder Mediums angezeigt wird sowie einen Button. Bei Klick auf den Button öffnet sich ein Auswahldialog über den der zu verknüpfende Artikel ausgewählt werden kann. Es ist möglich bei Änderungen des Links, per JavaScript darauf zu reagieren. Dazu ist mit der JavaScript-Funktion setLinkChangeHandler(fieldname, f) ein Handler zu definieren, der aufgerufen werden soll, wenn sich der Link ändert. Mit fieldname muss der vollständige Name des Feldes angegeben werden (z.B. mylist[0].mysublist[2].mylink). f ist die Javascript-Funktion, die aufgerufen werden soll. Dies erfolgt mit zwei Parametern:

fieldname

Variablename des Feldes dessen Link geändert wurde.

fieldvalue

ID des Links der gesetzt wurde oder "", wenn der Link gelöst wurde.

<script language="javascript">
  function linkChanged(fieldname, fieldvalue) {
     alert("link changed: fieldname=" + fieldname + ",fieldvalue=" + fieldvalue);
  }
</script>
...
<spt:iterator name="mylist" item="it">
  <spt:iterator name="mysublist" item="jt">
    ...
    <spt:link name="mylink" type="link"/>
    <script language="javascript">
      setLinkChangeHandler("<sp:print name="jt.field"/>.mylink", linkChanged);
    </script>
  </spt:iterator>
</spt:iterator>

Attribute

Name	Type	Required	Default	ab IES Version
name	Variable	Ja	nein	1
type	Linktyp	Nein	link	1
pools	Anchor-List oder ID-List	Nein	aktueller Informationspool	1
hidden	Condition	Nein	false	1
locale	Text	Nein	default	1
size	Number	Nein	50	1
value	Text	Nein	kein	1
width	Number	Nein	Wert des Mediums	1
height	Number	Nein	Wert des Mediums	1
showTree	Text	Nein	true	1

name

Name der Variable, unter der der Systemlink in die Datenbank geschrieben wird.

type

Typ der Verlinkung

systemlink

bei Änderung des verlinkten Artikels wird der verlinkende Artikel neu publiziert.

navlink

bei Änderung des verlinkenden Artikels wird der verlinkte neu publiziert.

resultlink

wird auf eine Suchabfrage verlinkt wird bei Änderung der Suchabfrage der verlinkende Artikel neu publiziert.

link

es erfolgt keine Aktualisierung in irgendeine Richtung.

image

'image' erzeugt einen Linktype 'systemlink'

es wird bei Verwendung im Ausgabebereich eines Templates ein <a href=...>-Tag generiert. Die Auswahl, die dem Redakteur zur Verfügung gestellt wird, ist von dieser Einstellung abhängig. Ist 'type=image' gesetzt, kann der Redakteur ein Bildmedium auswählen, mit dem ein <img ...>-Tag generiert wird.

pools

Kommaseparierte Liste mit Anchors von Artikelpools oder mit IDs von Artikelpools; die Elemente der Pools werden dem Redakteur zur Auswahl angeboten.

hidden

Macht das Feld unsichtbar.

locale

Diese Attribut bestimmt die Mehrsprachigkeit der Variable.

size

HTML-size Wert des von spt:link erzeugten Eingabefeldes.

value

Vorgabefeld für das erzeugte Eingabefeld.

width

Bei type="image" kann durch dieses Attribut der 'width'-Wert des generierten <img ...>-Tags gesetzt werden.

height

Bei type="image" kann durch dieses Attribut der 'height'-Wert des generierten <img ...>-Tags gesetzt werden.

showTree

wenn false, werden nur die im Attribut pools übergebenen Einsprungpunkte in der Baumansicht angezeigt (ohne Aufklappmöglichkeit und ohne Kinder)

Beispiele

Verschiedene Links

Template Quelltext

<sp:io type="in">
  <spt:link type="navlink" name="sp_parent" pools="!{information.pool}" size="60"/><br>
  <spt:link name="imglink" type="image" size="20" pools="!{media},!{infra}" linklabel="Thumbnail wählen"/>
</sp:io>

<sp:io type="out">
  <a href="<sp:print name='sp_parent.navlink.url'/>">
    <img src="<sp:print name='imglink.link.url'/>" height="50" width="80"/>
  </a>
</sp:io>