Appearance
zeropdf / TextFieldOptions
Interface: TextFieldOptions
Defined in: src/types.ts:2512
Options for creating a text 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:2559 |
appearance? | string | Custom appearance stream content. When provided, this raw PDF content stream is used instead of the auto-generated appearance for the /N (normal) appearance state. Example: "1 0 0 rg 0 0 16 16 re f" | src/types.ts:2554 |
borderWidth? | number | Annotation or field border width in PDF points. | src/types.ts:2530 |
color? | ColorInput | Color used for drawing, text, or highlighting. | src/types.ts:2528 |
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:2547 |
font? | FontName | Font used to render text. | src/types.ts:2524 |
fontSize? | number | Font size in PDF points. | src/types.ts:2526 |
height | number | Height in PDF points. | src/types.ts:2520 |
multiline? | boolean | Whether the text field accepts multiple lines. | src/types.ts:2536 |
readOnly? | boolean | Whether the form field is read-only. | src/types.ts:2532 |
required? | boolean | Whether the form field is required. | src/types.ts:2534 |
richValue? | string | Rich text value (XML string in XFA rich text format). When set, emitted as /RV in the field dictionary. | src/types.ts:2541 |
structure? | PdfStructureOptions | Additional structure metadata for tagged PDF output. | src/types.ts:2563 |
tag? | "Annot" | "Artifact" | Structure tag used for tagged PDF output. | src/types.ts:2561 |
value? | string | Current or default value for the option. | src/types.ts:2522 |
width | number | Width in PDF points. | src/types.ts:2518 |
x | number | Horizontal position in PDF points. | src/types.ts:2514 |
y | number | Vertical position in PDF points. | src/types.ts:2516 |