フォームフィールド

フォームの入力コントロール


フォーム作成者向け: フォームに配置できるフィールドの種類と、それぞれがサポートするプロパティを説明します。

フォームフィールドは、フォームの入力コントロールを定義します。フィールドの種類ごとに、特定の種類のデータを収集するための独自のプロパティと動作があります。

単純なテキストから構造化されたリストまで、収集したいデータに合ったフィールドの種類を選んでください。


共通プロパティ

すべてのフォームフィールドには、次の 2 つの基本プロパティがあります。

  • name (string、必須): フィールドの一意な識別子
  • type (string、必須): フィールドの種類。使用できるプロパティを説明するページは、この値で決まります

各フィールドの種類には、その機能に固有のプロパティが追加されます。ナビゲーションのサイドバーまたは下の表でフィールドの種類を選ぶと、プロパティの完全なリファレンスが開きます。

フィールドの種類 説明
text

A text input field

textarea

A textarea input field

datetime

A datetime input field

html

An HTML field. The html is sanitized before it is rendered: <script>, event handlers (onclick, onerror, …) and javascript: links are always removed. A link may carry target="_blank" to open in a new tab ; rel="noopener noreferrer" is added automatically.

file

A file upload field, the file is uploaded prior to the job start and the extravars will contain the uploaded file info.

number

A number input field

password

A password masked input field

checkbox

A checkbox field

radio

A radio field (multi options)

enum

A multi-column filterable dropdown box

expression

A powerfull javascript driven expression field

list

A list of structured rows edited through a reusable subform (replaces the table field, removed in 7.0.0)

yaml

A YAML editor field with syntax highlighting and validation