Form field properties

Set what a form field is called, how it looks and what it does on iPhone and iPad: name, tooltip, required, read-only, visibility, colours and font, the options of each kind of field, its actions and scripts.

Every field has properties: its name and tooltip, how it looks, and what it accepts or does. You set them in the field's properties, a sheet with a page for each group of properties.

Changing field properties needs Pro, as all of Prepare Form does.

Open a field's properties

  1. Tap the More menu (…), then Prepare Form > Edit Fields.
  2. Tap the field to select it, then tap Properties on its bar.

You can also choose More > Prepare Form > All Fields and tap the field in the list: this is the quickest way to a field that is hard to tap, such as a hidden one.

The properties of a text field: a page for each group
The properties of a text field: a page for each group

The sheet is titled with the field's name. It lists the pages this kind of field has: tap one to open it, and the back arrow at the top left to come back to the list. Make your changes on any of the pages, then tap Done: they are saved as one step, that Undo takes back. Cancel leaves the field as it was.

Kind of field Its pages
Text field, date field General, Appearance, Options, Actions, Format, Validate, Calculate
Dropdown Items, then as a text field
List Items, General, Appearance, Options, Actions, Selection Change
Check box General, Appearance, Options, Actions
Option buttons Buttons, General, Appearance, Options, Actions
Button, image field General, Appearance, Options, Actions
Signature field General, Appearance, Signed

General

The General page of a text field
The General page of a text field
  • Name: what scripts, calculations and exported form data call the field. Each field needs a name of its own.
  • Tooltip: what the field is for, for example Email address. A screen reader says it for the field, and the app uses it to title a list's choices. The accessibility check asks for a tooltip on every field.
  • Form field: Visible, Hidden, Visible but doesn't print (a button that is only for the screen) or Hidden but printable.
  • Orientation: turns the field's text by 0, 90, 180 or 270 degrees, for a field on a page printed sideways.
  • Read-only: the field shows its value, but people filling the form cannot change it. A calculation or a script can still set it: the amounts and the total of an order are read-only fields.
  • Required: the form must have a value here. A required field has a red outline, Check Required Fields names it while it is empty, and the form is not sent while it is empty. Buttons have no Required.
  • Locked: while you prepare the form, the field cannot be moved, resized or deleted.

Appearance

  • Font: the font of the text typed in the field, chosen from the Standard Fonts. Signature fields have no font.
  • Font size: the size of the text. 0 (auto) sizes the text to fit the field.
  • Text colour: the colour of the text, or of a check box's mark.
  • Border colour and Fill colour: the colours of the field's frame and background. Tap the colour to choose another; the button beside it leaves the frame out, or the background clear.
  • Line thickness (Thin, Medium or Thick) and Line style: Solid, Dashed, Beveled, Inset or Underline (a line under the field, as on a paper form).

Options

What the Options page holds depends on the kind of field.

Text fields

The Options page of a text field
The Options page of a text field
  • Alignment: Left, Center or Right. Amounts are easier to read aligned right.
  • Default value: the value of an empty form, and what Reset form brings back.
  • Multi-line: the text wraps, and the return key starts a new line. For addresses and comments.
  • Scroll long text: people can type more than the field shows. Turn it off to stop the typing when the field is full.
  • Allow rich text formatting: marks the field as taking styled text, as Acrobat does. This app fills it as plain text.
  • Check spelling: marks what is typed in the field for spell checking. Turn it off for codes, names and numbers.
  • Password: what is typed shows as dots. The value is still kept in the document: don't use it for real passwords.
  • Field is used for file selection: marks the field as one that holds the path of a file, as Acrobat's file-selection fields do.
  • Limit of ... characters: the most characters the field takes. Turn it on, then type the number in the row below it.
  • Comb of characters: the field is split into equal boxes, one character in each, as for a code or a date written box by box. The number of boxes is the limit of characters. A comb has one line.

Check boxes and option buttons

  • Check box style: the mark: Check, Circle, Cross, Diamond, Square or Star.
  • Export value (a check box): the value the form keeps when the box is ticked (Yes by default). Calculations and exported data see this value. An empty box's value is Off.
  • Checked by default (a check box): the box is ticked in an empty form.
  • Buttons with the same name and choice are selected in unison (option buttons): buttons of the group that stand for the same value turn on and off together.

The value of each option button is set on the group's Buttons page: tap a button to type its Value of This Button, swipe it to delete it, or tap Add Button for one more. A new button appears beside the last one on the page: drag it into place.

  • Allow typing (a dropdown): people can type a value that is not in the list. Check spelling marks what they type for spell checking.
  • Multiple selection (a list): people can choose several items.
  • Sort items: the items are kept in alphabetical order.
  • Commit selected value immediately: the value is kept as soon as an item is chosen, rather than when the field is left, for readers that wait until then.

The items themselves are on the Items page: see Create a form.

Buttons and image fields

  • Layout: Label only, Icon only, or both: Icon top, label bottom, Label top, icon bottom, Icon left, label right, Label left, icon right or Label over icon.
  • Behavior: what the button does while it is pressed: None, Invert (its colours turn), Outline or Push.
  • Label and Choose icon…, for each State: Up is the button as it is; with the Push behavior, the button can also have a label and an icon of its own while it is pressed (Down) and while the pointer is on it (Rollover). The icon is a picture from your photos; Clear removes it.
  • Icon placement: When to scale the icon to the button (Always, Icon is too big, Icon is too small, Never), how (Scale: Proportionally or Non-proportionally), Fit to bounds, and where it sits: Space on the left (%) and Space at the bottom (%).

An image field is a button made for a picture: Icon only, and a tap lets the person filling the form choose the picture.

Actions

The Actions page sets what happens when something is done to the field. It has a part for each moment:

  • Mouse Up: the tap is released over the field (the usual one for a button).
  • Mouse Down: the field is touched.
  • Mouse Enter and Mouse Exit: the pointer comes onto the field or leaves it.
  • On Focus and On Blur: the field becomes the one being filled, or stops being it.

Tap Add Action under a moment and choose what it does: go to a page, open a web link, Reset a form, Submit a form, show or hide a field, run a JavaScript and the others. Tap an action to change it (Edit…), move it (Up, Down) or Delete it. They work as a link's actions: see Links and actions.

For example, a button with Mouse Up and Reset a form clears the form; one with Submit a form sends it to a web address or by email.

Format, Validate and Calculate

Text fields and dropdowns have three more pages: how the value is shown (a number, an amount, a date...), which values are accepted, and how the value is worked out from other fields. See Calculate, format and check values.

Selection Change

A list has a Selection Change page: a script that runs when the selection changes, under This script executes when the selection changes:. Leave it empty and nothing happens when the selection changes.

Signature fields

A signature field's Signed page sets what signing the field does:

  • Nothing happens when signed.
  • Mark as read-only: the fields that can no longer be changed once the field is signed: All fields, All fields except these or Just these fields, turned on in the list below. Use it so that what was signed stays as it was.
  • This script executes when the field is signed: a script that runs right after the signature.

See Digital signatures to sign the field.