This document contains information for an outdated version and may not be maintained any more. If some of your projects still use this version, consider upgrading as soon as possible.
Read-only and Disabled Forms
Form and FormField instances can be turned into a read-only version for things like confirmation pages or
when certain fields cannot be edited due to permissions. Creating the form is done the same way and markup is similar,
readonly mode converts the
textarea tags to static HTML elements like
To make an entire Form read-only.
$form = new Form(..); $form->makeReadonly();
To make all the fields within a FieldList read-only (i.e to make fields read-only but not buttons).
$fields = new FieldList(..); $fields = $fields->makeReadonly();
To make a FormField read-only you need to know the name of the form field or call it direct on the object
$field = new TextField(..); $field = $field->performReadonlyTransformation(); $fields = new FieldList( $field ); // Or, $field = new TextField(..); $field->setReadonly(true); $fields = new FieldList( $field );
Disabling FormField instances, sets the
disabled property on the class. This will use the same HTML markup as
a normal form, but set the
disabled attribute on the
$field = new TextField(..); $field->setDisabled(true); echo $field->forTemplate(); // returns '<input type="text" class="text" .. disabled="disabled" />'