Документация / Взаимодействие с виджетами /

Получение объекта виджета

Прежде чем каким-то образом взаимодействовать с виджетами формы, необходимо получить сами объекты, которые их представляют. В ZForms доступ к виджету осуществляется с помощью метода поиска у объекта формы, к которой он принадлежит. См. «Получение объекта формы».

var oWidget = oFormWidget.getWidgetById(
	String sElementId
	);

Где:

sElementId — значение атрибута id соответствующего HTML-элемента.

Для того чтобы иметь возможность получить объект виджета, необходимо чтобы у соответствующего ему HTML-элемента был задан атрибут id.

Пример. Получение объекта виджета.

<form class="zf" id="form-1" action=".">
	<dl>
		<dt><label for="input-last-name-1">Имя</label></dt>
		<dd><input class="zf" type="text" id="input-last-name-1" /></dd>
	</dl>
</form>
<script type="text/javascript">
//<![CDATA[
ZForms.attachObserver(
	ZForms.EVENT_TYPE_ON_INIT,
	function() {

		var
			oForm = ZForms.getFormById('form-1'),
			oNameWidget = oForm.getWidgetById('input-last-name-1'),
			;

		// Действия с виджетом oNameWidget

	}
	);
//]]>
</script>