Datamanager 2 simple textarea widget

As with all subclasses, the actual initialization is done in the initialize() function, not in the constructor, to allow for error handling.

This widget supports all types which have a simple, plain text representation accessible though their value member.

Available configuration options:

  • int maxlength: The maximum length of the string allowed for this field. This includes any newlines, which account as at most two characters, depending on the OS. If you specify a 0, no maximum length is set. If you specify a -1, maximum length is inherited from the type, if applicable or unlimited otherwise. If a maximum length is set, an appropriate validation rule is created implicitly. A -1 setting is processed during startup and has no effect at a later time.
  • int width: The number of columns of the textarea, this defaults to 50. Note that this value might be overridden by CSS.
  • int height: The number of rows of the textearea, this defaults to 6. Note that this value might be overridden by CSS.
  • string wrap: Controls the textbox wrapping, defaults to 'virtual' text is wrapped by the browser, but the automatic wraps are not sent to the server. You can set this to 'off' or 'physical'. If you set this to an empty string, the attribute is omitted.
package midcom.helper.datamanager2


_on_initialize ()

The initialization event handler post-processes the maxlength setting.


booleanIndicating Success

add_elements_to_form ($attributes)

Adds a simple single-line text form element at this time.



get_default ()

sync_type_with_widget ($results)





int $height

Height of the textbox.

int $maxlength

Maximum length of the string encapsulated by this type.

0 means no limit. -1 tries to bind to the types maxlength member, if available.


int $width

Width of the textbox.

string $wrap

Wrapping mode of the textbox.