Класс CFormOutput

Описание и методы

CFormOutput - класс для работы с шаблонами форм

Использование класса

Класс используется для для управления визульным отображением формы. При выводе шаблона формы, ему передается переменная $FORM - инициализированный экземпляр класса. Шаблон формируется в виде HTML-кода со вставками вызовов методов класса (пример см. ниже). Возможно визуальное редактирование шаблона, а также, создание формы на основе шаблона.

Основные методы класса

Основные методы класса.

Методы для проверки условий. Все условные методы недоступны в режиме визуального редактора. Их можно использовать только в режиме редактирования PHP-кода.

Примеры

Пример шаблона формы

$FORM - экземпляр класса CFormOutput - создаётся и инициализируется автоматически вне шаблона. Вызов методов CFormOutput::ShowFormHeader() и CFormOutput::ShowFormFooter() также добавляется к шаблону автоматически.

 <!-- Выведем описание формы -->
<table width="100%" cellpadding="2" cellspacing="0" border="0">
	<tr>
		<td align="center"><?=$FORM->ShowFormDescription()?></td>
	</tr>
</table>

<!-- Если есть ошибки валидатора - выведем их -->
<?if($FORM->isFormErrors()):?>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
	<tr>
		<td><?=$FORM->ShowFormErrors()?></td>
	</tr>
</table>
<?endif?>

<!-- Выведем поля формы -->
<table width="100%" cellpadding="2" cellspacing="0" border="0">
	<tr>
		<td width="40%" valign="top" align="right"><?=$FORM->ShowInputCaption('test_q')?>: </td>
		<td width="60%" valign="top"><?=$FORM->ShowInput('test_q')?></td>
	</tr>
	<tr>
		<td valign="top" align="right"><?=$FORM->ShowInputCaption('test_q_text')?>: </td>
		<td valign="top"><?=$FORM->ShowInput('test_q_text')?></td>
	</tr>
	<tr>
		<td valign="top" align="right"><?=$FORM->ShowInputCaption('test_q_textarea')?>: </td>
		<td valign="top"><?=$FORM->ShowInput('test_q_textarea')?></td>
	</tr>
</table>

<!-- Если используется CAPTCHA - выведем картинку и поле для ввода -->
<?if($FORM->isUseCaptcha()):?>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
	<tr>
		<td colspan="2" height="8"></td>
	</tr>
	<tr>
		<td width="40%" valign="top" align="right" class="text">Защита от автоматической регистрации: </td>
		<td width="60%" valign="top"><?=$FORM->ShowCaptchaImage()?></td>
	</tr>
	<tr>
		<td valign="top" align="right" class="text">Введите слово с картинки<?=$FORM->ShowRequired()?>: </td>
		<td valign="top"><?=$FORM->ShowCaptchaField()?></td>
	</tr>
</table>
<?endif?>

<!-- Выведем кнопки формы -->
<table width="100%" cellpadding="2" cellspacing="0" border="0">
	<tr>
		<td width="40%">&nbsp;</td>
		<td width="60%">
			<?=$FORM->ShowSubmitButton()?>&nbsp;
			<?=$FORM->ShowApplyButton()?>&nbsp;
			<?=$FORM->ShowResetButton()?>
		</td>
	</tr>
</table>

Если не предполагается использование страниц редактирования результата формы или просмотра списка результатов, то имеет смысл вставить в шаблон ответ веб-формы в обход основного шаблона:

 <!-- Если есть ответ формы - выведем его в обход шаблона -->
<?if($FORM->isFormNote()):?>
<?=$FORM->ShowFormNote()?>
<?else:?>
<!-- здесь остальной шаблон веб-формы -->
<?endif?>