Spec-Zone.ru › ColdFusion

cfform

Создает форму с помощью пользовательских тегов элементов управления CFML; они предоставляют больше возможностей, чем стандартные элементы ввода HTML-форм.

<cfform>

cfform();

  • CF3+
  • Lucee
  • См. также: cfformgroup cfformitem

    Описание атрибутов

    name string

    В формате HTML, если опустить этот атрибут и указать атрибут id, ColdFusion не добавит атрибут name в HTML-код, отправляемый браузеру; это позволяет использовать тег cfform для создания форм, соответствующих XHTML. Если опустить атрибут name и атрибут id, ColdFusion автоматически создаст имя вида CFForm_n, где n — номер, последовательно присваиваемый формам на странице.

    action string

    Имя страницы CFML, которая будет выполнена при отправке формы на обработку.

    method string
    По умолчанию: post

    Метод, который браузер использует для отправки данных формы на сервер: - post: отправить данные с помощью метода HTTP post. При этом данные передаются серверу отдельным сообщением. - get: отправить данные с помощью метода HTTP get, который помещает содержимое полей формы в строку запроса URL.
    Значения:
    • post
    • get

    format string
    По умолчанию: html

    - HTML: создать HTML-форму и отправить ее клиенту. - Flash: УСТАРЕЛО в CF 11+ Создать Flash-форму и отправить ее клиенту. Все элементы управления представлены в формате Flash. - XML: УСТАРЕЛО в CF 11+ Создать XML, соответствующий XForms, и сохранить результат в переменной, указанной атрибутом name. По умолчанию ColdFusion также применяет XSL-оформление и отображает результат.
    Значения:
    • html
    • flash
    • xml

    skin string

    УСТАРЕЛО в CF 11+ Flash: использовать цвет ореола Macromedia для оформления вывода. XML: указывает, следует ли применить XSL-оформление и отобразить полученный HTML-код клиенту. Возможны следующие значения: - Название оформления ColdFusion MX: применить указанное оформление. - Имя XSL-файла: применить оформление, расположенное по указанному пути. - "none": не применять XSL-оформление. В этом случае необходимо использовать XML XForms. - (не указано) или "default": использовать оформление ColdFusion MX по умолчанию.
    Значения:
    • haloSilver
    • haloBlue
    • haloGreen
    • haloOrange
    • beige
    • blue
    • bluegray
    • lightgray
    • red
    • silver
    • none
    • default
    • basic
    • basiccss

    preservedata boolean
    По умолчанию: false

    Если атрибут action тега cfform указывает на ту же страницу, что и форма, этот параметр определяет, следует ли заменять значения элементов управления отправленными значениями. - false: используются значения, заданные в атрибутах тегов элементов управления - true: используются соответствующие отправленные значения
    Значения:
    • true
    • false

    onload string

    JavaScript-код, выполняемый при загрузке формы.

    onsubmit string

    Функция JavaScript или ActionScript, выполняемая для предварительной обработки данных перед отправкой формы. Если в дочерних тегах указана проверка полей при событии onSubmit, ColdFusion выполняет проверку до запуска этого кода JavaScript.

    codebase string
    По умолчанию: /CFIDE/classes/cf-j2re-win.cab

    URL загружаемого подключаемого модуля JRE (только для Internet Explorer). По умолчанию: /CFIDE/classes/cf-j2re-win.cab

    archive string
    По умолчанию: /CFIDE/classes/cfapplets.jar

    URL загружаемых классов Java для элементов управления CFML. По умолчанию: /CFIDE/classes/cfapplets.jar

    height string
    По умолчанию: 100%

    Высота формы. Укажите число, чтобы задать размер в пикселях. В Flash можно указать процентное значение от доступной ширины. Отображаемая высота может быть меньше заданного значения.

    width string
    По умолчанию: 100%

    Ширина формы. Укажите число, чтобы задать размер в пикселях. В Flash можно указать процентное значение от доступной ширины.

    onerror string

    Применяется только для проверки при событиях onSubmit или onBlur; не действует при проверке onServer. Выражение или выражения ActionScript, выполняемые, если пользователь отправляет форму с одной или несколькими ошибками проверки.

    wmode string
    По умолчанию: window

    Определяет, как Flash-форма отображается относительно другого содержимого, занимающего то же пространство на HTML-странице. - window: Flash-форма находится на переднем плане страницы и закрывает все элементы, занимающие то же пространство, например динамические HTML-списки с раскрывающимися пунктами. - transparent: Flash-форма учитывает z-index DHTML, поэтому поверх нее можно размещать другие элементы. Если Flash-форма находится над каким-либо элементом, сквозь прозрачные области формы видно содержимое под ней. - opaque: Flash-форма учитывает z-index DHTML, поэтому поверх нее можно размещать другие элементы. Если Flash-форма находится над каким-либо элементом, она закрывает содержимое под ней. По умолчанию используется значение window.
    Значения:
    • window
    • transparent
    • opaque

    accessible boolean
    По умолчанию: false

    Указывает, следует ли включить в Flash-форму поддержку программ чтения с экрана. Поддержка программ чтения с экрана увеличивает размер SWF-файла, отправляемого клиенту, примерно на 80 КБ. По умолчанию используется значение false.
    Значения:
    • true
    • false

    preloader boolean
    По умолчанию: true

    Указывает, следует ли отображать индикатор выполнения при загрузке Flash-формы. По умолчанию используется значение true.
    Значения:
    • true
    • false

    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

    Применяется только к формам внутри элементов управления cfdiv, cflayout, cfpod или cfwindow. Имя функции JavaScript, которая будет выполнена при успешной асинхронной отправке формы.

    Совместимость

    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

    Spec-Zone.ru

    Настройки Оффлайн Что нового Помощь О нас
    Spec-Zone .ru
    спецификации, руководства, описания, API