mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2024-08-17 17:00:40 +00:00
96 lines
3.0 KiB
Plaintext
96 lines
3.0 KiB
Plaintext
created: 201310241419
|
|
modified: 20150106180000000
|
|
tags: Widgets
|
|
title: ListWidget
|
|
caption: list
|
|
|
|
! Introduction
|
|
|
|
The list widget displays a sequence of tiddlers matching a [[filter|Filters]]. It is vital for a various use-cases, e.g.:
|
|
|
|
* Displaying custom lists, e.g. "all tiddlers tagged ''task'' not tagged ''done''"
|
|
* Listing the tags of a tiddler
|
|
* Displaying lists of links, like in the sidebar
|
|
* Handling the main story river
|
|
|
|
! Examples
|
|
|
|
''plain list''
|
|
|
|
```
|
|
<$list filter="[tag[ListWidget]sort[title]]"/>
|
|
```
|
|
|
|
Displays as:
|
|
|
|
<<<
|
|
<$list filter="[tag[ListWidget]sort[title]]"/>
|
|
|
|
<<<
|
|
|
|
''custom item output''
|
|
|
|
```
|
|
<$list filter="[tag[ListWidget]sort[title]]">
|
|
<<currentTiddler>>
|
|
{{||$:/core/ui/ViewTemplate/tags}}
|
|
</$list>
|
|
```
|
|
|
|
Displays as:
|
|
|
|
<<<
|
|
<$list filter="[tag[ListWidget]sort[title]]">
|
|
<<currentTiddler>>
|
|
{{||$:/core/ui/ViewTemplate/tags}}
|
|
</$list>
|
|
<<<
|
|
|
|
''custom item template''
|
|
|
|
```
|
|
<$list filter="[tag[ListWidget]sort[title]]" template="$:/core/ui/ViewTemplate/subtitle"/>
|
|
```
|
|
|
|
Displays as:
|
|
|
|
<<<
|
|
<$list filter="[tag[ListWidget]sort[title]]" template="$:/core/ui/ViewTemplate/subtitle"/>
|
|
|
|
<<<
|
|
|
|
!! Grouped Lists
|
|
|
|
See NestedLists for how to generate nested and grouped lists using the ListWidget.
|
|
|
|
! Content and Attributes
|
|
|
|
A number of options controll the list behaviour....
|
|
|
|
|!Attribute |!Description |
|
|
|filter |The [[tiddler filter|Filters]] to display |
|
|
|template |The title of a template tiddler for transcluding each tiddler in the list. When no template is specified, the body of the ListWidget serves as the item template. With no body, a simple link to the tiddler is returned. |
|
|
|editTemplate |An alternative template to use for [[DraftTiddlers|DraftMechanism]] in edit mode |
|
|
|variable |The name for a [[variable|Variables]] in which the title of each listed tiddler is stored. Defaults to ''currentTiddler'' |
|
|
|iterator|a custom iterator prefix, see IteratorVariables|
|
|
|emptyMessage |Message to be displayed when the list is empty |
|
|
|storyview |Optional name of module responsible for animating/processing the list |
|
|
|history |The title of the tiddler containing the navigation history |
|
|
|
|
!! Edit mode
|
|
|
|
The `<$list>` widget can optionally render draft tiddlers through a different template to handle editing, see DraftMechanism.
|
|
|
|
!! `storyview` attribute
|
|
|
|
The `storyview` attribute specifies the name of an optional module that can animate changes to the list (including navigation). The core ships with the following storyview modules:
|
|
|
|
* `classic`: renders the list as an ordered sequence of tiddlers
|
|
* `zoomin`: just renders the current tiddler from the list, with a zoom animation for navigating between tiddlers
|
|
* `pop`: shrinks items in and out of place
|
|
|
|
In order for the storyviews to animate correctly each entry in the list should be a single block mode DOM element.
|
|
|
|
!! History and navigation
|
|
|
|
The optional `history` attribute specifies the name of a tiddler that is used to track the current tiddler for navigation purposes. When the history tiddler changes the list view responds by telling the listview to handle navigating to the new tiddler. See HistoryMechanism for details. |