13 novembre 2023 à 9h33
Introduction
The checkbox widget displays an HTML <input type="checkbox"> element that is dynamically bound to either:
- the presence or absence of a specified tag on a specified tiddler
- the value of a specified field of a specified tiddler
Content and Attributes
The content of the <$checkbox> widget is displayed within an HTML <label> element immediately after the checkbox itself. This means that clicking on the content will toggle the checkbox.
| Attribute | Description |
|---|---|
tiddler | Title of the tiddler to manipulate (defaults to the Current Tiddler) |
| The name of the tag to which the checkbox is bound | |
invertTag | When set to yes, flips the tag binding logic so that the absence of the tag causes the checkbox to be checked |
| The name of the field to which the checkbox is bound | |
| Depuis : 5.2.3 The name of the field that contains the list to which the checkbox is bound | |
| Depuis : 5.1.14 The property of the DataTiddler to which the checkbox is bound | |
Depuis : 5.2.3 Like index, but treats the value as a list the same way that listField does | |
| Depuis : 5.2.3 A filter whose output determines the checked state of the checkbox | |
checked | The value of the field corresponding to the checkbox being checked |
unchecked | The value of the field corresponding to the checkbox being unchecked |
default | The default value to use if the field is not defined |
| Whether ambiguous values can produce indeterminate checkboxes (see below) | |
class | The class that will be assigned to the <label> element |
actions | Depuis : 5.1.14 A string containing ActionWidgets to be triggered when the status of the checkbox changes (whether it is checked or unchecked) |
uncheckactions | Depuis : 5.1.16 A string containing ActionWidgets to be triggered when the checkbox is unchecked |
checkactions | Depuis : 5.1.20 A string containing ActionWidgets to be triggered when the checkbox is checked |
disabled | Depuis : 5.1.23 Optionally disables the checkbox if set to yes (defaults to no) |
data-* | Depuis : 5.3.2 Optional data attributes to be assigned to the HTML <input> element |
style.* | Depuis : 5.3.2 Optional CSS properties to be assigned to the HTML <input> element |