Overview

Helper for building CSS-based forms.

This is a fluent class; all method calls except fetch() return $this, which means you can chain method calls for easier readability.

Package

This class is part of the Solar_View_Helper_Form package.

Inheritance:

Configuration Keys

  • attribs: Default attributes to use in the <form> tag.

  • request: A Solar_Request dependency injection.

  • descr_part: Where to place descriptions (in the 'label' or the 'value').

  • decorator_tags: Use these decorator tags around form parts.

  • decorator_attribs: Use these attributes for decorator tags.

  • css_classes: Use these CSS classes for form elements.

  • label_suffix: Attach this suffix to all labels.

Constants

None.

Public Properties

The Solar_View_Helper_Form class has no public properties; try the list of all properties.

Public Methods

These are all the public methods in the Solar_View_Helper_Form class.

You can also view the list of all public, protected, and private methods.

__call()

Magic __call() for addElement() using element helpers.

__construct()

Constructor.

__destruct()

Default destructor; does nothing other than provide a safe fallback for calls to parent::__destruct().

__toString()

Magic __toString() to print out the form automatically.

_postConstruct()

Post-construction tasks to complete object construction.

addDecoratorAttribs()

Adds attributes to a single decorator part, merging with existing attributes.

addElement()

Adds a single element to the form.

addElements()

Adds multiple elements to the form.

addFeedback()

Adds to the form-level feedback message array.

addHtml()

Adds arbitrary raw HTML to the form stack outside the normal element structure.

addProcess()

Adds a submit button named 'process' to the form, using a translated locale key stub as the submit value.

addProcessGroup()

Adds a group of process buttons with an optional label.

auto()

Automatically adds multiple pieces to the form.

beginFieldset()

Begins a <fieldset> block with a legend/caption.

beginGroup()

Begins a group of form elements under a single label.

decorateAsDivs()

When fetching output, render the list and elements inside divs.

decorateAsDlList()

When fetching output, render elements as part of an HTML definition list.

decorateAsPlain()

When fetching output, render elements without any surrounding decoration.

decorateAsTable()

When fetching output, render elements as part of an HTML table.

dump()

Convenience method for getting a dump the whole object, or one of its properties, or an external variable.

endFieldset()

Ends a <fieldset> block.

endGroup()

Ends a group of form elements.

fetch()

Builds and returns the form output, adding a hidden CSRF element as needed.

form()

Main method interface to Solar_View.

getStatus()

Gets the form validation status.

locale()

Looks up class-specific locale strings based on a key.

meta()

Automatically adds attributes and feedback, and sets status, for the form as a whole from a Solar_Form object.

reset()

Resets the form entirely.

setAttrib()

Sets a form-tag attribute.

setAttribs()

Sets multiple form-tag attributes.

setCssClass()

Set the CSS class to use for particular element type.

setCssClasses()

Set the CSS classes to use for various element types.

setDecorator()

Set decoration tag to use for a particular form part.

setDecoratorAttribs()

Resets the attributes on a single decorator part, overwriting the existing attributes.

setDecorators()

Sets the decoration tags to use for various form parts.

setDescrPart()

Sets where the element description goes, 'label' or 'value'.

setLabelSuffix()

Use this suffix string on all labels; for example, ": ".

setStatus()

Sets the form validation status.



Local