cfform
Создает форму с помощью пользовательских тегов элементов управления CFML; они предоставляют больше возможностей, чем стандартные элементы ввода HTML-форм.
<cfform>
cfform();
Описание атрибутов
name string
В формате HTML, если опустить этот атрибут и указать атрибут id, ColdFusion не добавит атрибут name в HTML-код, отправляемый браузеру; это позволяет использовать тег cfform для создания форм, соответствующих XHTML. Если опустить атрибут name и атрибут id, ColdFusion автоматически создаст имя вида CFForm_n, где n — номер, последовательно присваиваемый формам на странице.
action string
Имя страницы CFML, которая будет выполнена при отправке формы на обработку.
method string
По умолчанию: post
post
Метод, который браузер использует для отправки данных формы на сервер: - post: отправить данные с помощью метода HTTP post. При этом данные передаются серверу отдельным сообщением. - get: отправить данные с помощью метода HTTP get, который помещает содержимое полей формы в строку запроса URL.
Значения:
postget
format string
По умолчанию: html
html
-
HTML: создать HTML-форму и отправить ее клиенту. - Flash: УСТАРЕЛО в CF 11+ Создать Flash-форму и отправить ее клиенту. Все элементы управления представлены в формате Flash. - XML: УСТАРЕЛО в CF 11+ Создать XML, соответствующий XForms, и сохранить результат в переменной, указанной атрибутом name. По умолчанию ColdFusion также применяет XSL-оформление и отображает результат. Значения:
htmlflashxml
skin string
УСТАРЕЛО в CF 11+
Flash: использовать цвет ореола Macromedia для оформления вывода. XML: указывает, следует ли применить XSL-оформление и отобразить полученный HTML-код клиенту. Возможны следующие значения: - Название оформления ColdFusion MX: применить указанное оформление. - Имя XSL-файла: применить оформление, расположенное по указанному пути. - "none": не применять XSL-оформление. В этом случае необходимо использовать XML XForms. - (не указано) или "default": использовать оформление ColdFusion MX по умолчанию. Значения:
haloSilverhaloBluehaloGreenhaloOrangebeigebluebluegraylightgrayredsilvernonedefaultbasicbasiccss
preservedata boolean
По умолчанию: false
false
Если атрибут action тега cfform указывает на ту же страницу, что и форма, этот параметр определяет, следует ли заменять значения элементов управления отправленными значениями. - false: используются значения, заданные в атрибутах тегов элементов управления - true: используются соответствующие отправленные значения
Значения:
truefalse
onload string
JavaScript-код, выполняемый при загрузке формы.
onsubmit string
Функция JavaScript или ActionScript, выполняемая для предварительной обработки данных перед отправкой формы. Если в дочерних тегах указана проверка полей при событии onSubmit, ColdFusion выполняет проверку до запуска этого кода JavaScript.
codebase string
По умолчанию: /CFIDE/classes/cf-j2re-win.cab
/CFIDE/classes/cf-j2re-win.cab
URL загружаемого подключаемого модуля JRE (только для Internet Explorer). По умолчанию: /CFIDE/classes/cf-j2re-win.cab
archive string
По умолчанию: /CFIDE/classes/cfapplets.jar
/CFIDE/classes/cfapplets.jar
URL загружаемых классов Java для элементов управления CFML. По умолчанию: /CFIDE/classes/cfapplets.jar
height string
По умолчанию: 100%
100%
Высота формы. Укажите число, чтобы задать размер в пикселях. В Flash можно указать процентное значение от доступной ширины. Отображаемая высота может быть меньше заданного значения.
width string
По умолчанию: 100%
100%
Ширина формы. Укажите число, чтобы задать размер в пикселях. В Flash можно указать процентное значение от доступной ширины.
onerror string
Применяется только для проверки при событиях onSubmit или onBlur; не действует при проверке onServer. Выражение или выражения ActionScript, выполняемые, если пользователь отправляет форму с одной или несколькими ошибками проверки.
wmode string
По умолчанию: window
window
Определяет, как Flash-форма отображается относительно другого содержимого, занимающего то же пространство на HTML-странице. - window: Flash-форма находится на переднем плане страницы и закрывает все элементы, занимающие то же пространство, например динамические HTML-списки с раскрывающимися пунктами. - transparent: Flash-форма учитывает z-index DHTML, поэтому поверх нее можно размещать другие элементы. Если Flash-форма находится над каким-либо элементом, сквозь прозрачные области формы видно содержимое под ней. - opaque: Flash-форма учитывает z-index DHTML, поэтому поверх нее можно размещать другие элементы. Если Flash-форма находится над каким-либо элементом, она закрывает содержимое под ней. По умолчанию используется значение window.
Значения:
windowtransparentopaque
accessible boolean
По умолчанию: false
false
Указывает, следует ли включить в Flash-форму поддержку программ чтения с экрана. Поддержка программ чтения с экрана увеличивает размер SWF-файла, отправляемого клиенту, примерно на 80 КБ. По умолчанию используется значение false.
Значения:
truefalse
preloader boolean
По умолчанию: true
true
Указывает, следует ли отображать индикатор выполнения при загрузке Flash-формы. По умолчанию используется значение true.
Значения:
truefalse
timeout numeric
Целое число секунд, в течение которых данные формы хранятся в кэше Flash на сервере. Значение 0 запрещает кэширование данных.
scriptsrc string
Указывает URL каталога относительно корня веб-сайта, содержащего файл cfform.js с клиентским кодом JavaScript, используемым этим тегом и его дочерними тегами. Для форм в формате XML этот каталог также является каталогом XSLT-оформлений по умолчанию.
style string
Стили, применяемые к форме. В форматах HTML и XML ColdFusion передает атрибут style браузеру или XML. В формате Flash необходимо указать описание стиля в формате CSS.
onreset string
JavaScript-код, выполняемый при нажатии пользователем кнопки сброса.
id string
Идентификатор HTML, передаваемый в
target string
Целевое окно или фрейм, передаваемые в
passthrough string
УСТАРЕЛО в CF 7+ УДАЛЕНО в CF 11+ Передает произвольные пары «атрибут-значение» в HTML-код, создаваемый для тега. Можно использовать один из следующих форматов: passthrough="title=""myTitle""" passthrough='title="mytitle"'
onsuccess string
Совместимость
ColdFusion:
Версия 3+ В ColdFusion 11 устарели format=flash, format=xml и format=applet
Примеры Пример кода с тегом cfform
© 2012–present Foundeo, Inc. and the CFDocs contributors.
Licensed under the MIT License.
ColdFusion is a trademark of Adobe Systems Incorporated.
https://cfdocs.org/cfform