Appearance
a11ydocs / ChoiceFieldOptions
Interface: ChoiceFieldOptions
Defined in: src/types.ts:2684
Options for creating a list box or combo box form field.
Properties
| Property | Type | Description | Defined in |
|---|---|---|---|
actions? | FieldActions | JavaScript actions attached to this field's /AA dictionary. Each action value is raw PDF JavaScript source code. | src/types.ts:2738 |
appearance? | string | Custom appearance stream content for the choice field. Example: "1 0 0 rg 0 0 100 20 re f" | src/types.ts:2733 |
borderWidth? | number | Annotation or field border width in PDF points. | src/types.ts:2710 |
color? | ColorInput | Color used for drawing, text, or highlighting. | src/types.ts:2708 |
description? | string | Field description, emitted as /TU (the field's user-facing name). Assistive technology reads it as the field's accessible name, and it satisfies the "form fields have a description" accessibility check. | src/types.ts:2690 |
editable? | boolean | When true, the combo box allows user to type custom values. When false (default), combo box is select-only. Has no effect on list boxes. | src/types.ts:2722 |
encrypt? | boolean | Whether the field value follows document encryption. When false, the field value is not encrypted (useful for searchable fields). Defaults to true (follow document encryption). | src/types.ts:2728 |
font? | FontName | Font used to render text. | src/types.ts:2704 |
fontSize? | number | Font size in PDF points. | src/types.ts:2706 |
height | number | Height in PDF points. | src/types.ts:2698 |
mode? | ChoiceFieldMode | Choice field display mode. | src/types.ts:2716 |
options | string[] | Options that control this item. | src/types.ts:2700 |
readOnly? | boolean | Whether the form field is read-only. | src/types.ts:2712 |
required? | boolean | Whether the form field is required. | src/types.ts:2714 |
structure? | PdfStructureOptions | Additional structure metadata for tagged PDF output. | src/types.ts:2742 |
tag? | "Annot" | "Artifact" | Structure tag used for tagged PDF output. | src/types.ts:2740 |
value? | string | Current or default value for the option. | src/types.ts:2702 |
width | number | Width in PDF points. | src/types.ts:2696 |
x | number | Horizontal position in PDF points. | src/types.ts:2692 |
y | number | Vertical position in PDF points. | src/types.ts:2694 |