Json (SP-Tag): Unterschied zwischen den Versionen

Aus SiteparkWiki
Zur Navigation springen Zur Suche springen
K (Schützte „Json (SP-Tag)“ [edit=autoconfirmed:move=autoconfirmed])
 
(13 dazwischenliegende Versionen von 4 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 
==Name==
 
==Name==
<sp:json> - Schreibt Objekte in JSON-Notation.
+
<sp:json> - serialisiert ein Objekt.
 +
Ab 2.13: Zuweisung des JSONObjects der übergebenen Variable
  
 
==Syntax==
 
==Syntax==
 
<source lang="xml">
 
<source lang="xml">
<sp:xxx name="variable" encoding="html"/>
+
<sp:json object="mymap"/>
 
</source>  
 
</source>  
  
 
==Beschreibung==
 
==Beschreibung==
xxx
+
Serialisiert ein Objekt nach JSON (Java Script Object Notation). In JSON serialisierte Objekte können direkt mit JavaScript weiter verarbeitet werden. Folgende Objekte werden von diesem Tag unterstützt:
 +
* [[Map]]
 +
* [[Collection]]
 +
 
 +
Alle in der Map oder der Collection enthaltenen Objekte werden als [[String]] interpretiert, es sei denn es handelt sich um weitere Maps oder Collections.
 +
 
 +
Beispiel:
 +
<source lang="xml">
 +
<sp:map name="contact" action="put" key="name" value="Peter Pan"/>
 +
   
 +
<sp:map name="address" action="new"/>
 +
<sp:map name="address" action="put" key="street" value="Sesamstraße"/>
 +
<sp:map name="address" action="put" key="zip" value="12345"/>
 +
<sp:map name="address" action="put" key="city" value="Musterstadt"/>
 +
 
 +
<sp:map name="contact" action="put" key="address" object="address"/>
 +
<pre>
 +
<sp:print name="contact.toJson(3)"/>
 +
</pre>
 +
oder
 +
<pre>
 +
<sp:json object="contact" indent="3"/>
 +
</pre>
 +
</source>
  
 
==Attribute==
 
==Attribute==
Zeile 15: Zeile 39:
 
! Name || Type || Required || Default || ab IES Version
 
! Name || Type || Required || Default || ab IES Version
 
|-
 
|-
| <code>xxx</code>
+
| <code>name</code>
 +
| [[Variable]]
 +
| Nein
 +
| None
 +
| 2.13
 +
|-
 +
| <code>object</code>
 
| [[Attribute]]
 
| [[Attribute]]
| Ja
+
| Ja, Nein ab 2.13
 
| None
 
| None
| 1
+
| 2
 
|-
 
|-
| <code>xxx</code>
+
| <code>indent</code>
| [[Text]]
+
| [[Expression]]
 
| Nein
 
| Nein
| None
+
| 0
| 1
+
| 2
 
|-
 
|-
| <code>xxx</code>
+
| <code>indent</code>
 
| [[Expression]]
 
| [[Expression]]
 +
| Nein
 +
| 0
 +
| 2
 +
|-
 +
| <code>overwrite</code>
 +
| [[Condition]]
 
| Nein
 
| Nein
 
| None
 
| None
| 1
+
| 2.13
 
|-
 
|-
| <code>xxx</code>
+
| <code>locale</code>
 
| [[Locale]]
 
| [[Locale]]
 
| Nein
 
| Nein
 
| None
 
| None
| 1
+
| 2.13
 +
|-
 +
| <code>scope</code>
 +
| [[Scope]]
 +
| Nein
 +
| request
 +
| 2.13
 
|}
 
|}
  
;<code>xxx</code>
+
;<code>name</code>
:xxx.
+
:Name der neuen Variable.
 
 
;<code>xxx</code>
 
:xxx.
 
 
 
==Beispiele==
 
 
 
====Beispiel A====
 
 
 
Template Quelltext
 
<source lang="xml">
 
xxx
 
</source>
 
  
Ausgabe
+
;<code>object</code>
<source lang="text">
+
:Objekt, das als JSONObject in die Variable gespeichert werden soll oder <tt>bodyContent</tt>
xxx
 
</source>
 
  
====Beispiel B====
+
;<code>indent</code>
 +
:Initiale Einrückung für eine formatierte Ausgabe.
  
Template Quelltext
+
;<code>overwrite</code>
<source lang="xml">
+
:Bestimmt, ob eine evtl. vorhandene Variable überschrieben werden soll. true bzw. false.
xxx
 
</source>
 
  
Ausgabe
+
;<code>locale</code>
<source lang="text">
+
:Dieses Attribut dient zur Auswahl der zu verwendenden Sprache bei mehrsprachigen Variablen.
xxx
 
</source>
 
  
 +
;<code>scope</code>
 +
:Gültigkeitsbereich, in dem die Variable definiert ist. Möglich sind page und request.
  
 
<noinclude>
 
<noinclude>
 
[[Category:SP-Tags]]
 
[[Category:SP-Tags]]
[[Category:Qualität_des_Inhalts_prüfen]]
+
[[Category:Beispiel_überarbeiten_testen]]
[[Category:Qualität_der_Sprache_prüfen]]
 
[[Category:Qualität_des_Codes_prüfen]]
 
 
</noinclude>
 
</noinclude>

Aktuelle Version vom 17. September 2015, 14:53 Uhr

Name

<sp:json> - serialisiert ein Objekt. Ab 2.13: Zuweisung des JSONObjects der übergebenen Variable

Syntax

<sp:json object="mymap"/>

Beschreibung

Serialisiert ein Objekt nach JSON (Java Script Object Notation). In JSON serialisierte Objekte können direkt mit JavaScript weiter verarbeitet werden. Folgende Objekte werden von diesem Tag unterstützt:

Alle in der Map oder der Collection enthaltenen Objekte werden als String interpretiert, es sei denn es handelt sich um weitere Maps oder Collections.

Beispiel:

<sp:map name="contact" action="put" key="name" value="Peter Pan"/>
    
<sp:map name="address" action="new"/>
<sp:map name="address" action="put" key="street" value="Sesamstraße"/>
<sp:map name="address" action="put" key="zip" value="12345"/>
<sp:map name="address" action="put" key="city" value="Musterstadt"/>

<sp:map name="contact" action="put" key="address" object="address"/>
<pre>
<sp:print name="contact.toJson(3)"/>
</pre>
oder
<pre>
<sp:json object="contact" indent="3"/>
</pre>

Attribute

Name Type Required Default ab IES Version
name Variable Nein None 2.13
object Attribute Ja, Nein ab 2.13 None 2
indent Expression Nein 0 2
indent Expression Nein 0 2
overwrite Condition Nein None 2.13
locale Locale Nein None 2.13
scope Scope Nein request 2.13
name
Name der neuen Variable.
object
Objekt, das als JSONObject in die Variable gespeichert werden soll oder bodyContent
indent
Initiale Einrückung für eine formatierte Ausgabe.
overwrite
Bestimmt, ob eine evtl. vorhandene Variable überschrieben werden soll. true bzw. false.
locale
Dieses Attribut dient zur Auswahl der zu verwendenden Sprache bei mehrsprachigen Variablen.
scope
Gültigkeitsbereich, in dem die Variable definiert ist. Möglich sind page und request.