DropDownField.md

sapi-pro

---

sapi-pro / DropDownField

Class: DropDownField

下拉菜单

Extends

• ValueField<number>

Constructors

Constructor

new DropDownField(label, items, defaultValueIndex?, tooltip?): DropDownField

Parameters

label

TextType

items

TextType[]

defaultValueIndex?

number = 0

tooltip?

TextType

Returns

DropDownField

Overrides

ValueField.constructor

Properties

__optional

protected __optional: boolean = false

Inherited from

ValueField.__optional

---

_key?

protected optional _key?: string

Inherited from

ValueField._key

---

isValueField

readonly isValueField: true = true

Inherited from

ValueField.isValueField

---

validators

protected validators: FieldValidator<number>[] = []

Inherited from

ValueField.validators

Accessors

isOptional

Get Signature

get isOptional(): boolean

Returns

boolean

Inherited from

ValueField.isOptional

Methods

build()

build(form, t): void

Parameters

form

ModalFormData

t

UniversalTranslator

Returns

void

Overrides

ValueField.build

---

getKey()

getKey(): string | undefined

Returns

string | undefined

Inherited from

ValueField.getKey

---

key()

key(key): this

Parameters

key

string

Returns

this

Inherited from

ValueField.key

---

optional()

optional(): DropDownField & object

Returns

DropDownField & object

Inherited from

ValueField.optional

---

parse()

parse(raw): number | undefined

将 UI 原始值解析为目标类型。

• 如果是基础类型错误（如期待数字却得到布尔），抛出对应类型的 ParseError。
• 如果是数值格式错误（如 TextField 输入了非数字），抛出格式 ParseError。

Parameters

raw

ValueType

Returns

number | undefined

Overrides

ValueField.parse

---

validate()

validate(value): string | LangText | undefined

执行校验链。

• isEmpty 判定：undefined 或空字符串。
• 如果必填且为空，返回 Field_Empty 错误。

Parameters

value

number | undefined

Returns

string | LangText | undefined

Inherited from

ValueField.validate

---

validator()

validator(...v): DropDownField

Parameters

v

...FieldValidator<number>[]

Returns

DropDownField

Inherited from

ValueField.validator