mirrors/TiddlyWiki5
1
0
Fork 0
mirror of https://github.com/Jermolene/TiddlyWiki5 synced 2024-10-01 16:30:46 +00:00
Code Issues Releases Wiki Activity

Docs update

Browse Source
This commit is contained in:
Jeremy Ruston 2012-07-17 18:06:09 +01:00
parent 247ef94682
commit 9c4ed18129
1 changed files with 12 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
tw5.com/tiddlers/concepts/TiddlerFilters.tid
View File

@ -1,7 +1,7 @@
title: TiddlerFilters title: TiddlerFilters
tags: docs concepts tags: docs concepts
TiddlyWiki has a special syntax for expressing filters. They can be used to select tiddlers for an operation, or to filter a set of tiddlers to add or remove members. Filters are used in TiddlyWiki to choose tiddlers by specifying simple match criteria.
! Examples ! Examples
@ -26,17 +26,15 @@ The mechanism is easiest to understand by first presenting some example filter s
! Operators ! Operators
A filter string consists of one or more filter operations, each comprising one or more filter operators with associated operands. A filter string consists of one or more runs of filter operators that each look like `[operator[operand]]`, where `operator` is one of:
The operations look like `[operator[operand]]`, where `operator` is one of:
* ''title'': selects the tiddler with the title given in the operand * ''title'': selects the tiddler with the title given in the operand
* ''is'': tests whether a tiddler is a member of the system defined set named in the operand (see below) * ''is'': tests whether a tiddler is a member of the system defined set named in the operand (see below)
* ''has'': tests whether a tiddler has a specified field * ''has'': tests whether a tiddler has the field specified in the operand
* ''sort'': sorts the tiddlers by a given field * ''sort'': sorts the tiddlers by the field specified in the operand
* ''sort-case-sensitive'': a case sensitive sort of the current tiddlers * ''sort-case-sensitive'': a case sensitive sort of the current tiddlers by the field specified in the operand
* ''prefix'': tests whether a tiddlers title starts with a particular prefix * ''prefix'': tests whether a tiddlers title starts with the prefix specified in the operand
* ''limit'': limits the number of subresults * ''limit'': limits the number of subresults to the integer specified in the operand
* ''tag'': tests whether a given tag is (`[tag[mytag]]`) or is not (`[!tag[mytag]]`) present on the tiddler * ''tag'': tests whether a given tag is (`[tag[mytag]]`) or is not (`[!tag[mytag]]`) present on the tiddler
* ''{field}'': tests whether a tiddler field has a specified value (`[modifier[Jeremy]]`) or not (`[!modifier[Jeremy]]`) * ''{field}'': tests whether a tiddler field has a specified value (`[modifier[Jeremy]]`) or not (`[!modifier[Jeremy]]`)
* ''tags'': selects the tags on the currently selected tiddlers * ''tags'': selects the tags on the currently selected tiddlers
@ -59,15 +57,15 @@ Operators are combined into runs that function as logically ANDed expressions by
[tag[one]] [tag[two]] ---> [tag[one]tag[two]] [tag[one]] [tag[two]] ---> [tag[one]tag[two]]
}}} }}}
Operation runs can be preceded with `-` to negate their action, removing the selected tiddlers from the results. For example, `[tag[Tommy]] -HelloThere -[[Another One]]` selects all tiddlers tagged with `Tommy` except those titled `HelloThere` or `Another One`. Runs can be preceded with `-` to negate their action, removing the selected tiddlers from the results. For example, `[tag[Tommy]] -HelloThere -[[Another One]]` selects all tiddlers tagged with `Tommy` except those titled `HelloThere` or `Another One`.
Operation runs can be preceded with `+` in order to make them apply to all of the accumulated results, rather than the original source. For example, `[tag[Jeremy]] [tag[Tommy]] +[sort[title]]` selects the tiddlers tagged `Tommy` or `Jeremy`, and sorts them by the `title` field. Runs can be preceded with `+` in order to make them apply to all of the accumulated results, rather than the original source. For example, `[tag[Jeremy]] [tag[Tommy]] +[sort[title]]` selects the tiddlers tagged `Tommy` or `Jeremy`, and sorts them by the `title` field.
! Processing model ! Processing model
Filters are processed with the following elements: Filters are processed with the following elements:
* a string of filter operations, each made up of one or more filter operators * a sequence of runs of filter operations
* the incoming source tiddlers * the incoming source tiddlers, typically all the tiddlers available in the wiki
* the overall result stack * the overall result stack
* the subresult stack of the tiddlers selected by the current operation * the subresult stack of the tiddlers selected by the current run