Package

ViewHelpers

ViewHelper Documentation

v:format.json.encode

JSON Encoding ViewHelper

Returns a string containing the JSON representation of the argument. The argument may be any of the following types:

Recursion protection is enabled for DomainObjects with the option to add a special marker (any variable type above also supported here) which is inserted where an object which would cause recursion would be placed.

Be specially careful when you JSON encode DomainObjects which have recursive relations to itself using either 1:n or m:n - in this case the one member of the converted relation will be whichever value you specified as "recursionMarker" - or the default value, NULL. When using the output of such conversion in JavaScript please make sure you check the type before assuming that every member of a converted 1:n or m:n recursive relation is in fact a JavaScript. Not doing so may result in fatal JavaScript errors in the client browser.

Arguments

value anySimpleType

Value to encode as JSON

useTraversableKeys boolean

If TRUE, preserves keys from Traversables converted to arrays. Not recommended for ObjectStorages!

preventRecursion boolean

If FALSE, allows recursion to occur which could potentially be fatal to the output unless managed

recursionMarker anySimpleType

Any value - string, integer, boolean, object or NULL - inserted instead of recursive instances of objects

dateTimeFormat string

A date() format for DateTime values to JSON-compatible values. NULL means JS UNIXTIME (time()*1000)

ViewHelper Resources

Schema Resources