aboutsummaryrefslogtreecommitdiff
path: root/doc/ref/javascript/input_list.texi
diff options
context:
space:
mode:
authorHugo Hörnquist <hugo@lysator.liu.se>2021-01-13 22:47:46 +0100
committerHugo Hörnquist <hugo@lysator.liu.se>2021-01-13 22:47:46 +0100
commit341e5a65a7b36e1f70ed9e6c2ae4f5b18c083b5b (patch)
tree6f01775b070e61b50cb88c757672aef6bbbfe4f4 /doc/ref/javascript/input_list.texi
parentSplit javascript doc into multiple files. (diff)
downloadcalp-341e5a65a7b36e1f70ed9e6c2ae4f5b18c083b5b.tar.gz
calp-341e5a65a7b36e1f70ed9e6c2ae4f5b18c083b5b.tar.xz
Doc work.
Diffstat (limited to '')
-rw-r--r--doc/ref/javascript/input_list.texi49
1 files changed, 48 insertions, 1 deletions
diff --git a/doc/ref/javascript/input_list.texi b/doc/ref/javascript/input_list.texi
index bda2de83..e22d4c2b 100644
--- a/doc/ref/javascript/input_list.texi
+++ b/doc/ref/javascript/input_list.texi
@@ -1,4 +1,51 @@
-
@node input_list
@section input_list.js
+@cindex dummy component
+
+All elements with the class @code{input-list} are treated as a
+collection of input fields. Uses including setting tags on calendar
+entries.
+
+All direct children of the ``input-list'' @emph{must} have the class
+@code{unit}, and one direct child @code{unit} have the class @code{final}.
+
+@c All elements having 'input-list' ∈ =class=
+
+@c Direct children must all have 'unit' ∈ =class=
+@c One direct child must have 'final' ∈ =class=
+
+@defmethod input_list get_value
+
+@example
+querySelectorAll('input')
+ .map(x => x.value)
+ .join(@var{joinby})
+@end example
+@end defmethod
+
+@defivar input_list [data-]joinby
+ Alternative character to join by
+@end defivar
+
+@defivar input_list [data-]bindby
+ replacement for get_value
+@end defivar
+
+binds =get_value= on instances, by default returning the value
+of all =<input/>= tags joined by =,=. This can be overwritten with
+
+TODO: instead, override value?
+
+=addEventList('input',= is overwritten, registering the listener for all input
+elements.
+
+
+ ∀ children('.input-list') => 'unit' ∈ classList(child)
+
+ <div class="input-list">
+ <div class="unit"><input/></div>
+ <div class="unit final"><input/></div>
+ </div>
+@defun init_input_list
+@end defun