45 lines
2.7 KiB
Plaintext
45 lines
2.7 KiB
Plaintext
caption: range
|
|
created: 20171102134825376
|
|
modified: 20231113093304323
|
|
tags: Widgets TriggeringWidgets
|
|
title: RangeWidget
|
|
type: text/vnd.tiddlywiki
|
|
|
|
! Introduction
|
|
|
|
The range widget displays an HTML `<input type="range">` that reflects a given tiddler field numeric value. Adjusting the range slider sets the tiddler field to the value.
|
|
|
|
! Content and Attributes
|
|
|
|
The content of the `<$range>` widget is ignored.
|
|
|
|
|!Attribute |!Description |
|
|
|tiddler |Title of the tiddler to manipulate (defaults to the [[current tiddler|Current Tiddler]]) |
|
|
|field |The field of the //tiddler// bound to the range slider|
|
|
|index|<<.from-version "5.1.22">> The index of the //tiddler//, a [[DataTiddler|DataTiddlers]], to which the radio button is bound |
|
|
|min |The minimum value to be able to be set by the `<$range>` widget |
|
|
|max |The maximum value to be able to be set by the `<$range>` widget |
|
|
|increment |The minimum amount by which a value may be changed. Defaults to 1 |
|
|
|default |If the field is missing or empty this is the default position for the widget handle relative to the min and max values|
|
|
|class |CSS classes to be assigned to the label around the range slider |
|
|
|actions|<<.from-version "5.1.23">> Optional, A string containing ActionWidgets to be triggered when the value changes. <br>The variable: ''actionValue'' is available for ''all'' actions.<br>The variable: ''actionValueHasChanged'' is always `yes` here.|
|
|
|actionsStart|<<.from-version "5.1.23">> Optional, A string containing ~ActionWidgets to be triggered when the "handle" is ''clicked''. <br>The variable: ''actionValueHasChanged'' is always `no` here|
|
|
|actionsStop|<<.from-version "5.1.23">> Optional, A string containing ~ActionWidgets to be triggered when the "handle" is ''released''. <br>The variable: ''actionValueHasChanged'' is `yes`, ''if'' the new-value is different to the start-value |
|
|
|disabled|<<.from-version "5.1.23">> Optional, disables the range input if set to "yes". Defaults to "no"|
|
|
|data-* |<<.from-version "5.3.2">> Optional [[data attributes|https://developer.mozilla.org/en-US/docs/Learn/HTML/Howto/Use_data_attributes]] to be assigned to the `<input>` HTML element |
|
|
|style.* |<<.from-version "5.3.2">> Optional [[CSS properties|https://developer.mozilla.org/en-US/docs/Web/CSS/Reference]] to be assigned to the `<input>` HTML element |
|
|
|
|
! Examples
|
|
|
|
!! Range -1 to 10
|
|
|
|
<$macrocall $name='wikitext-example-without-html'
|
|
src="""<$range tiddler="$:/_RangeDemo/1" min="-1" max="10" default="1" increment="1"/> {{$:/_RangeDemo/1}}"""/>
|
|
|
|
!! Range 0 to 1
|
|
|
|
<$macrocall $name='wikitext-example-without-html'
|
|
src="""<$range tiddler="$:/_RangeDemo/2" min="0" max="1" default=".01" increment=".01"/> {{$:/_RangeDemo/2}}"""/>
|
|
|
|
|
|
{{RangeWidget Example}} |