Radio 字段

从一组互斥选项中选择一项

属性

radio 字段可用的属性，按用途分组：

属性 说明
basic
name
string / 必填 / 唯一

Field name
Alfanumeric + underscore + dash

This attribute represents the name of the form field.
type
string / 必填

Field type

Other attributes might only be available for some field types.

值：
radio
label
string

Field label
Free text

A friendly name/label for the field. Note: if not set, the field name is used as label, but not when type is html.

Since 6.0.3: Supports placeholders for dynamic labels (e.g., Label: $(fieldname)).
placeholder
string

In-field help value
Free text

Some form fields allow an in-field hint value.

Since 6.0.3: Supports placeholders for dynamic hints (e.g., Enter password (min $(minLength) chars)).
help
string

Field help message
Free text

Some fields require additional help information. This help message will be shown below the field.

Since 6.0.3: Supports placeholders for dynamic help text (e.g., This field depends on $(fieldname)).
data
default
many

Default value

The type of the value depends on the field type.
Can be string,boolean, number, array or object. When using multiple, the default must be an array.
When using an enum field, you can use the following special values:

  • __auto__: select the first
  • __none__: select none
  • __all__: select all (if multiple is true)

For yaml fields, the default can be any valid YAML structure (object or array). For list fields, the default must be an array of objects matching the referenced subform’s fields. Use it to pre-populate the list with existing rows on form load.
evalDefault
boolean
在版本 4.0.5 中添加

Evaluates default value

A default can be treated as javascript and can thus hold expressions like '$(other_field)'.toUpperCase() or Math.PI or new Date().toISOString()

默认值：
false
interaction
dependencyFn
string
在版本 4.0.0 中添加

The dependency logical function

This attribute represents the logical function between multiple dependencies.

选项：
  • and（默认）
  • or
  • nand
  • nor
dependencies
list / elements=object

Show/hide this field based on the values or other fields
Reference to other formfields and their values

Each dependency element is either an object with the following 2 attributes:

  • name: holds the fieldname.
  • values: a list of valid values for the referenced field.

Or with the following 2 attributes:

  • name: holds the fieldname.
  • isValid: a boolean to check if the referenced is validated or not.

Use in combination with attribute dependencyFn.
output
output
boolean
在版本 6.2.0 中添加

Include field value as extravar

Form fields are by default sent as extravars.
Set to false to exclude a field from the extravar output.

默认值：
true
model
string or array

Extravar modelling
An dot-based string notation of an object, or an array of these

By default, a field is sent as a root-extravar.
If you want model the output of the extravars, you can specify a dot-notation of how this field should be modelled.
security
noLog
boolean
在版本 2.2.3 中添加

Disable backend logging

Disables logging in the backend, to hide passwords for example.

默认值：
false
validation
required
boolean

Required field

Makes the field required.

默认值：
false
validIf
object
在版本 2.2.4 中添加

An field based validation (field must be true)

Enforces a validation where a referencing (expression) field must be true. This field requires an object with 2 attributes:

  • field: The name of the referencing field
  • description: A validation message to show when the validation is not met. (Since 5.0.1: Supports placeholders for dynamic messages)
validIfNot
object
在版本 2.2.4 中添加

An field based validation (field must be false)

Enforces a validation where a referencing (expression) field must be false. This field requires an object with 2 attributes:

  • field: The name of the referencing field
  • description: A validation message to show when the validation is not met. (Since 5.0.1: Supports placeholders for dynamic messages)
ignoreIncomplete
boolean

Allow form submit on non-evaluated placeholders

When an expression-based field has placeholders,
the default form behaviour is not to allow form submit until all placeholders are resolved. When this attribute is true, the form does not wait for placeholder completion for this field.

默认值：
false
visualization
group
string

The field group name
Free text

With this attribute you can group fields together.
When all fields in a group are hidden (due to dependencies), the group is also hidden.
line
string
在版本 4.0.3 中添加

The field line name
Free text

With this attribute you can group fields in a single line together.
Use together with the width parameter to set the width, if not, the width is auto.
width
string
在版本 4.0.3 中添加

The field width
A valid Bootstrap Column width

With this attribute you can set the width of a field.
Use together wit the line parameter to put fields on 1 line. see https://getbootstrap.com/

选项：
  • col-1
  • col-2
  • col-3
  • col-4
  • col-5
  • col-6
  • col-7
  • col-8
  • col-9
  • col-10
  • col-11
  • col-12

示例

radio 字段示例（YAML）：

Radio

字段定义（YAML）：

- type: radio
  name: linuxfavourite
  label: Choose your favorite linux flavour
  values:
  - CentOS
  - Ubuntu
  - Red Hat
  - Debian
  default: CentOS
  required: true

Radio with labels

字段定义（YAML）：

- type: radio
  name: linuxfavourite
  label: Choose your favorite linux flavour
  values:
  - label: CentOS
    value: c_os
  - label: Ubuntu
    value: ubu
  - label: Red Hat
    value: rht
  - label: Debian
    value: deb
  default: c_os
  required: true