From a9c4f113a136a59534a9c396c1a4ffe4c0160426 Mon Sep 17 00:00:00 2001 From: maxthomax Date: Thu, 9 Jun 2016 23:09:16 +0200 Subject: [PATCH] More documentation about named properties (#2481) * Made the link between "names" and "properties" explicit (I only figured it out by reading the TextReference documentation) * Documented named property manipulation through ActionWidgets. --- editions/tw5.com/tiddlers/concepts/DataTiddlers.tid | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/editions/tw5.com/tiddlers/concepts/DataTiddlers.tid b/editions/tw5.com/tiddlers/concepts/DataTiddlers.tid index d03be08aa..af1cda446 100644 --- a/editions/tw5.com/tiddlers/concepts/DataTiddlers.tid +++ b/editions/tw5.com/tiddlers/concepts/DataTiddlers.tid @@ -12,7 +12,7 @@ There are two standard formats: Other formats of tiddler can also be parsed to yield blocks of data that behave like data tiddlers. -Use a TextReference to look up a value by its name. For example, if a [[DictionaryTiddler|DictionaryTiddlers]] called `MonthDays` contains: +Use a TextReference to look up the value of a named property. For example, if a [[DictionaryTiddler|DictionaryTiddlers]] called `MonthDays` contains: ``` oct:31 @@ -29,3 +29,5 @@ The same is true if `MonthDays` is a [[JSONTiddler|JSONTiddlers]] with the follo ``` Note: //It is currently only possible to retrieve data from the immediate properties of the root object of a JSONTiddler.// + +The widgets ActionSetFieldWidget and ActionListopsWidget can manipulate named properties of data tiddlers by indicating the name of the property in the $index attribute. To create or modify a named property with ActionSetFieldWidget, provide a $value attribute. To delete a named property with ActionSetFieldWidget, omit the $value attribute. ActionListopsWidget assigns the named property the list constructed through its $filter and $subfilter attributes.