Link (SPT-Tag)

Aus SiteparkWiki
Zur Navigation springen Zur Suche springen
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, indem der Name des verknüpften Artikels, Resource oder Mediums angezeigt wird und 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 muß der vollständige Name des Feldes angegeben werden (z.B. mylist[0].mysublist[2].mylink). f ist die Javascript-Funktion, die aufgerufen werden soll. Sie wird mit zwei Parametern aufgerufen:

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 Variablen, 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 'link'
ACHTUNG: Bei type="image" finden keine Aktualisierungen statt. 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 von Anchors von Artikelpools oder von 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 Variablen.
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>