c.xlink ([target : xlink], method : string, [name : string, value : string]*) : xlink
Die Methode xlink dient der Bildung eines Methodenverweises mit Parametern. Das Ergebnis dieser Methode wird von einer Vielzahl von weiteren Methoden unterstützt. Ein XLink setzt sich aus den folgenden Elementen zusammen:
- Objektverweis innerhalb einer beliebigen Datenquelle
- Zielmethode
- eine beliebige Anzahl von Parametern
Als Parameter kann ein xlink oder ein Methodenname angegeben werden. Der Methodenname ist dann optional, wenn ein xlink ohne weitere Parameter (name, value) angegeben wurde.
Das erste Beispiel erstellt eine Referenz auf eine onion-Ressource mit der ID 100 und der Methode "teaser":
onion://data/objects/100#teaser
Das zweite Beispiel fügt zusätzlich die Parameter "language" und "mode" hinzu.
onion://data/objects/100#teaser?language=de&mode=large
Die Methode xlink ermöglicht die Bildung von eines neuen XLinks auf Basis eines vorhandenen. Auf diese Weise ist es möglich, einen vorhandenen XLink zu erweitern oder zu verändern. Das folgende Beispiel überschreibt den Parameter mode und ergänzt den XLink um den Parameter border.
Das Beispiel führt zu folgendem Ergebnis:
onion://data/objects/100#teaser?border=yes&language=de&mode=small
Die vorhandene Methode teaser wurde in diesem Beispiel beibehalten, indem eine leere Zeichenkette übergeben wurde.
Es können nur Parameter angefügt oder verändert, jedoch keine Parameter entfernt werden.
