1
0
mirror of https://github.com/Jermolene/TiddlyWiki5 synced 2024-11-30 21:39:57 +00:00
TiddlyWiki5/editions/tw5.com/tiddlers/concepts/DataTiddlers.tid
Jermolene 21c137a66c Refactor theme tweaks as individual tiddlers
The trouble with the previous approach of storing several settings in a
single data tiddler was that it made it hard to introduce new settings.
Users who already have a custom copy of the settings/metrics tiddler
wouldn’t get the default settings. The new approach uses individual
tiddlers for each setting.

This commit also introduces a new theme tweak for the cutoff width for
switching between responsive views.
2014-07-06 16:55:51 +01:00

49 lines
1.4 KiB
Plaintext

created: 201308291647
modified: 201308291647
tags: concepts
title: DataTiddlers
Data tiddlers provide a way to access blocks of [[JSON]] data within the `text` field of a tiddler.
//The implementation of data tiddlers is preliminary, with some intentional limitations.//
! Data tiddler format
A native data tiddler must have:
* The ContentType field `type` set to `application/json`
* Valid JSON data in the `text` field
For example, the [[history list|$:/HistoryList]] tiddler is a data tiddler.
Other tiddler types with alternative formats can also be parsed to yield a block of data that behaves like a data tiddler.
!! Tiddler dictionary format
The tiddler dictionary format is an alternative syntax for data tiddlers:
* The ContentType field `type` is set to `application/x-tiddler-dictionary`
* The `text` field consists of one or more lines of the form `<name>:<value>`
For example, palettes such as the [[default Vanilla palette|$:/palettes/Vanilla]] are tiddler dictionaries.
! Accessing data within data tiddlers
Currently, it is only possible to access the top level properties of the data using TextReference syntax.
For example, given a `application/json` tiddler containing:
```
{"a":"one","b":"two","c":"three"}
```
Or the equivalent tiddler dictionary of type `application/x-tiddler-dictionary`:
```
a:one
b:two
c:three
```
With either of those definitions `{{TiddlerTitle##b}}` would have the value `two`.