Alterator/form: различия между версиями

Версия от 12:17, 16 февраля 2009

Каждое поле адресуется по значению атрибута name. Метка поля должна иметь имя, совпадающее с именем соответствующего ей поля.

Пример:

(label text "Field name" name "field")(edit name "field" value "Field value")

Исключение — в качестве поля выступает виджет label. В этом случае метки с тем значением атрибута name быть не должно.

Пример:

(label name "field" value "Field label") ;; Ошибка!!!
(label name "field" value "Static field")

(form-value name) — получить значение поля с именем name
(form-value-list . namelist) — получить полный список имён полей и их значений в формате plist. namelist - необязательный параметр, список строк - имён полей. В этом случае ответ будет содержать имена и значения только тех имён что перечислены в этом списке.

(form-update-value name value) — изменить значение поля с именем name на значение value.
(form-update-value-list namelist data) — заполнить поля с именами перечисленными в списке namelist согласно значениям data возвращённым командой woo-read-first
(form-update-enum name data) — заполнить поле с именем name типа enum списком значений data, возвращённым командой woo-list

Эти функции меняют свойства одновременно и полей и меток к ним.

(form-update-visibility namelist status) - изменить видимость поля в соотвестствии со значением переменной status - булевого типа. namelist - или список имён полей или одно поле.
(form-update-activity namelist status) - изменить активность поля в соответствии со значением переменной status - булевого типа.

namelist - или список имён полей или одно поле.

(form-bind name event proc) — привязать вызов процедуры proc в случае возникновения события event в виджете с именем name. Допустимые события: «click», «change».
(form-replace url . url-args) — перенаправить на страницу по адресу url и передать аргументы url-args
(form-popup url . url-args) — вызвать страницу по адресу url как popup и передать аргументы url-args

@@ Строка 26: / Строка 26: @@
 * '''(form-update-value-list namelist data)''' — заполнить поля с именами перечисленными в списке <tt>namelist</tt> согласно значениям <tt>data</tt> возвращённым командой <tt>woo-read-first</tt>
 * '''(form-update-enum name data)''' — заполнить поле с именем <tt>name</tt> типа enum списком значений <tt>data</tt>, возвращённым командой <tt>woo-list</tt>
+=== Функции модификации состояний полей ===
+Эти функции меняют свойства одновременно и полей и меток к ним.
+* '''(form-update-visibility namelist status)''' - изменить видимость поля в соотвестствии со значением переменной status - булевого типа. namelist - или список имён полей или одно поле.
+* '''(form-update-activity namelist status) - изменить активность поля в соответствии со значением переменной status - булевого типа.
+namelist - или список имён полей или одно поле.
 === Другие функции ===