Class FormControl (namespace Nette\Forms)


Base class that implements the basic functionality common to form controls.

Object
   |
   --Component
      |
      --FormControl

Implements interfaces:

Author: David Grudl
Copyright: Copyright (c) 2004, 2009 David Grudl
Abstract:
Located: in /Forms/Controls/FormControl.php (line 51)
Public Method Summary
FormControl
__construct ([string $caption = NULL])
Rules
addCondition (mixed $operation, [mixed $value = NULL])
Adds a validation condition a returns new branch.
Rules
addConditionOn (IFormControl $control, mixed $operation, [mixed $value = NULL])
Adds a validation condition based on another control a returns new branch.
void
addError (string $message)
Adds error message to the list.
FormControl
addRule (mixed $operation, [string $message = NULL], [mixed $arg = NULL])
Adds a validation rule.
void
Html
Generates control's HTML element.
Html
Returns control's HTML element template.
array
Returns errors corresponding to control.
Form
getForm ([bool $need = TRUE])
Returns form.
string
Returns control's HTML id.
string
Returns name of control within a Form & INamingContainer scope.
Html
getLabel ([string $caption = NULL])
Generates label's HTML element.
Html
Returns label's HTML element template.
mixed
getOption (string $key, [mixed $default = NULL])
Returns user-specific option.
array
Returns user-specific options.
Rules
ITranslator|NULL
Returns translate adapter.
mixed
Returns control's value.
bool
bool
Is control disabled?
bool
Does method getControl() have been called?
bool
Is control mandatory?
void
Loads HTTP data.
void
notifyRule (Rule $rule)
New rule or condition notification callback.
FormControl
setDefaultValue (mixed $value)
Sets control's default value.
FormControl
setDisabled ([bool $value = TRUE])
Disables or enables control.
FormControl
setHtmlId (string $id)
Changes control's HTML id.
FormControl
setOption (string $key, mixed $value)
Sets user-specific option.
FormControl
setParent ([$parent = NULL], [string $name = NULL])
Overloaded parent setter. This method checks for invalid control name.
FormControl
setRendered ([bool $value = TRUE])
Sets 'rendered' indicator.
FormControl
setRequired ([string $message = NULL])
Makes control mandatory.
FormControl
setTranslator ([$translator = NULL])
Sets translate adapter.
FormControl
setValue (mixed $value)
Sets control's value.
string
translate (string $s)
Returns translated string.
static bool
validateEqual (IFormControl $control, mixed $arg)
Equal validator: are control's value and second parameter equal?
static bool
Filled validator: is control filled?
static bool
Valid validator: is control valid?
Protected Method Summary
protected void
attached (IComponent $form)
This method will be called when the component becomes attached to Form.
Methods Inherited From Component
__construct(), attached(), detached(), getName(), getParent(), lookup(), lookupPath(), monitor(), setParent(), unmonitor(), validateParent(), __clone(), __wakeup()
Methods Inherited From Object
extensionMethod(), getClass(), getReflection(), __call(), __callStatic(), __get(), __isset(), __set(), __unset()
Variable Summary
string $caption

line 57

textual caption or label
protected Html $control

line 63

control element template
static string $idMask 'frm%s-%s'

line 54

protected Html $label

line 66

label element template
protected mixed $value

line 60

unfiltered control value

Method Details

line 94

__construct

public FormControl __construct ([string $caption = NULL])

Input
string $caption caption
Output
FormControl  

line 491

addCondition

public Rules addCondition (mixed $operation, [mixed $value = NULL])

Adds a validation condition a returns new branch.

Input
mixed $operation condition type
mixed $value optional condition arguments
Output
Rules new branch

line 505

addConditionOn

public Rules addConditionOn (IFormControl $control, mixed $operation, [mixed $value = NULL])

Adds a validation condition based on another control a returns new branch.

Input
IFormControl $control form control
mixed $operation condition type
mixed $value optional condition arguments
Output
Rules new branch

line 617

addError

public void addError (string $message)

Adds error message to the list.

Input
string $message error message
Output
void  

line 477

addRule

public FormControl addRule (mixed $operation, [string $message = NULL], [mixed $arg = NULL])

Adds a validation rule.

Input
mixed $operation rule type
string $message message to display for invalid data
mixed $arg optional rule arguments
Output
FormControl provides a fluent interface

line 111

attached

protected void attached (IComponent $form)

This method will be called when the component becomes attached to Form.

Overridden in child classes as:

Input
IComponent $form
Output
void  

line 651

cleanErrors

public void cleanErrors ()

Output
void  

line 383

getControl

public Html getControl ()

Generates control's HTML element.

Output
Html  

line 422

getControlPrototype

public Html getControlPrototype ()

Returns control's HTML element template.

Output
Html  

line 631

getErrors

public array getErrors ()

Returns errors corresponding to control.

Implementation of:

Output
array  

line 142

getForm

public Form getForm ([bool $need = TRUE])

Returns form.

Input
bool $need throw exception if form doesn't exist?
Output
Form  

line 188

getHtmlId

public string getHtmlId ()

Returns control's HTML id.

Output
string  

line 153

getHtmlName

public string getHtmlName ()

Returns name of control within a Form & INamingContainer scope.

Overridden in child classes as:

Output
string  

line 400

getLabel

public Html getLabel ([string $caption = NULL])

Generates label's HTML element.

Input
string $caption
Output
Html  

line 433

getLabelPrototype

public Html getLabelPrototype ()

Returns label's HTML element template.

Output
Html  

line 233

getOption

public mixed getOption (string $key, [mixed $default = NULL])

Returns user-specific option.

Input
string $key key
mixed $default default value
Output
mixed  

line 244

getOptions

public array getOptions ()

Returns user-specific options.

Output
array  

line 515

getRules

public Rules getRules ()

Implementation of:

Output
Rules  

line 272

getTranslator

public ITranslator|NULL getTranslator ()

Returns translate adapter.

Output
ITranslator|NULL  

line 316

getValue

public mixed getValue ()

Returns control's value.

Implementation of:

Output
mixed  

line 641

hasErrors

public bool hasErrors ()

Output
bool  

line 368

isDisabled

public bool isDisabled ()

Is control disabled?

Implementation of:

Output
bool  

line 459

isRendered

public bool isRendered ()

Does method getControl() have been called?

Output
bool  
Tags
Deprecated

line 541

isRequired

public bool isRequired ()

Is control mandatory?

Output
bool  
Tags
Deprecated

line 343

loadHttpData

public void loadHttpData ()

Loads HTTP data.

Overridden in child classes as:

Implementation of:

Output
void  

line 553

notifyRule

public void notifyRule (Rule $rule)

New rule or condition notification callback.

Overridden in child classes as:

Input
Rule $rule
Output
void  

line 328

setDefaultValue

public FormControl setDefaultValue (mixed $value)

Sets control's default value.

Input
mixed $value
Output
FormControl provides a fluent interface

line 356

setDisabled

public FormControl setDisabled ([bool $value = TRUE])

Disables or enables control.

Input
bool $value
Output
FormControl provides a fluent interface

line 176

setHtmlId

public FormControl setHtmlId (string $id)

Changes control's HTML id.

Input
string $id new ID, or FALSE or NULL
Output
FormControl provides a fluent interface

line 214

setOption

public FormControl setOption (string $key, mixed $value)

Sets user-specific option.

Common options:

  • 'rendered' - indicate if method getControl() have been called
  • 'required' - indicate if ':required' rule has been applied
  • 'description' - textual or Html object description (recognized by ConventionalRenderer)

Input
string $key key
mixed $value value
Output
FormControl provides a fluent interface

line 127

setParent

public FormControl setParent ([$parent = NULL], [string $name = NULL])

Overloaded parent setter. This method checks for invalid control name.

Input
$parent
string $name
Output
FormControl provides a fluent interface

line 446

setRendered

public FormControl setRendered ([bool $value = TRUE])

Sets 'rendered' indicator.

Input
bool $value
Output
FormControl provides a fluent interface
Tags
Deprecated

line 528

setRequired

public FormControl setRequired ([string $message = NULL])

Makes control mandatory.

Input
string $message error message
Output
FormControl provides a fluent interface
Tags
Deprecated

line 260

setTranslator

public FormControl setTranslator ([$translator = NULL])

Sets translate adapter.

Input
$translator
Output
FormControl provides a fluent interface

line 304

setValue

public FormControl setValue (mixed $value)

Sets control's value.

Implementation of:

Input
mixed $value
Output
FormControl provides a fluent interface

line 287

translate

public string translate (string $s)

Returns translated string.

Implementation of:

Input
string $s
Output
string  

line 572

validateEqual

public static bool validateEqual (IFormControl $control, mixed $arg)

Equal validator: are control's value and second parameter equal?

Input
IFormControl $control
mixed $arg
Output
bool  

line 593

validateFilled

public static bool validateFilled (IFormControl $control)

Filled validator: is control filled?

Input
IFormControl $control
Output
bool  

line 605

validateValid

public static bool validateValid (IFormControl $control)

Valid validator: is control valid?

Input
IFormControl $control
Output
bool