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

Материал из ALT Linux Wiki
Строка 1: Строка 1:
== Модуль (alterator lookout form) ==
== Модуль (alterator lookout form) ==


=== Адресация полей ===
=== Адресация полей ===
Строка 10: Строка 10:
</source>
</source>


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


Пример:
Пример:
Строка 19: Строка 19:


=== Функции доступа к значениям полей ===
=== Функции доступа к значениям полей ===
* '''(form-value name)''' - получить значение поля с именем <tt>name</tt>
* '''(form-value name)''' — получить значение поля с именем <tt>name</tt>
* '''(form-value-list)''' - получить полный список имён полей и их значений в формате plist.
* '''(form-value-list)''' — получить полный список имён полей и их значений в формате plist.


=== Функции модификации значений полей ===
=== Функции модификации значений полей ===
* '''(form-update-value name value)''' - изменить значение поля с именем <tt>name</tt> на значение <tt>value</tt>.
* '''(form-update-value name value)''' — изменить значение поля с именем <tt>name</tt> на значение <tt>value</tt>.
* '''(form-update-value-list namelist data)''' - заполнить поля с именами перечисленными в списке <tt>namelist</tt> согласно значениям <tt>data</tt> возвращённым командой <tt>woo-read-first</tt>
* '''(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-enum name data)''' — заполнить поле с именем <tt>name</tt> типа enum списком значений <tt>data</tt>, возвращённым командой <tt>woo-list</tt>


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

Версия от 09:25, 3 февраля 2009

Модуль (alterator lookout form)

Адресация полей

Каждое поле адресуется по значению атрибута 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) — получить полный список имён полей и их значений в формате plist.

Функции модификации значений полей

  • (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-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