Packages

  • Nette
    • Application
      • Diagnostics
      • Responses
      • Routers
      • UI
    • Caching
      • Storages
    • ComponentModel
    • Config
      • Adapters
      • Extensions
    • Database
      • Diagnostics
      • Drivers
      • Reflection
      • Table
    • DI
      • Diagnostics
    • Diagnostics
    • Forms
      • Controls
      • Rendering
    • Http
    • Iterators
    • Latte
      • Macros
    • Loaders
    • Localization
    • Mail
    • Reflection
    • Security
      • Diagnostics
    • Templating
    • Utils
      • PhpGenerator
  • NetteModule
  • none

Classes

Interfaces

  • Overview
  • Package
  • Class
  • Tree
  • Deprecated
  • Other releases
  • Nette homepage

Class NFormContainer

Container for form controls.

NObject
Extended by NComponent implements IComponent
Extended by NComponentContainer implements IComponentContainer
Extended by NFormContainer implements ArrayAccess

Direct known subclasses

NForm

Indirect known subclasses

NAppForm
Package: Nette\Forms
Author: David Grudl
Located at Forms/Container.php
Methods summary
public NFormContainer
# setDefaults( array|Traversable $values, boolean $erase = FALSE )

Fill-in with default values.

Fill-in with default values.

Parameters

$values
array|Traversable
values used to fill the form
$erase
boolean
erase other default values?

Returns

NFormContainer
public NFormContainer
# setValues( array|Traversable $values, boolean $erase = FALSE )

Fill-in with values.

Fill-in with values.

Parameters

$values
array|Traversable
values used to fill the form
$erase
boolean
erase other controls?

Returns

NFormContainer
public NArrayHash|array
# getValues( boolean $asArray = FALSE )

Returns the values submitted by the form.

Returns the values submitted by the form.

Parameters

$asArray
boolean
return values as an array?

Returns

NArrayHash|array
public boolean
# isValid( )

Is form valid?

Is form valid?

Returns

boolean
public
# validate( )

Performs the server side validation.

Performs the server side validation.

public NFormContainer
# setCurrentGroup( NFormGroup $group = NULL )

Returns

NFormContainer
public NFormGroup
# getCurrentGroup( )

Returns current group.

Returns current group.

Returns

NFormGroup
public NFormContainer
# addComponent( IComponent $component, string $name, string $insertBefore = NULL )

Adds the specified component to the IContainer.

Adds the specified component to the IContainer.

Parameters

$component
IComponent
$name
string
$insertBefore
string

Returns

NFormContainer

Throws

InvalidStateException

Overrides

NComponentContainer::addComponent()
public ArrayIterator
# getControls( )

Iterates over all form controls.

Iterates over all form controls.

Returns

ArrayIterator
public NForm
# getForm( boolean $need = TRUE )

Returns form.

Returns form.

Parameters

$need
boolean
throw exception if form doesn't exist?

Returns

NForm
public NTextInput
# addText( string $name, string $label = NULL, integer $cols = NULL, integer $maxLength = NULL )

Adds single-line text input control to the form.

Adds single-line text input control to the form.

Parameters

$name
string
control name
$label
string
label
$cols
integer
width of the control
$maxLength
integer
maximum number of characters the user may enter

Returns

NTextInput
public NTextInput
# addPassword( string $name, string $label = NULL, integer $cols = NULL, integer $maxLength = NULL )

Adds single-line text input control used for sensitive input such as passwords.

Adds single-line text input control used for sensitive input such as passwords.

Parameters

$name
string
control name
$label
string
label
$cols
integer
width of the control
$maxLength
integer
maximum number of characters the user may enter

Returns

NTextInput
public NTextArea
# addTextArea( string $name, string $label = NULL, integer $cols = 40, integer $rows = 10 )

Adds multi-line text input control to the form.

Adds multi-line text input control to the form.

Parameters

$name
string
control name
$label
string
label
$cols
integer
width of the control
$rows
integer
height of the control in text lines

Returns

NTextArea
public NUploadControl
# addUpload( string $name, string $label = NULL )

Adds control that allows the user to upload files.

Adds control that allows the user to upload files.

Parameters

$name
string
control name
$label
string
label

Returns

NUploadControl
public NHiddenField
# addHidden( string $name, mixed $default = NULL )

Adds hidden form control used to store a non-displayed value.

Adds hidden form control used to store a non-displayed value.

Parameters

$name
string
control name
$default
mixed
default value

Returns

NHiddenField
public NCheckbox
# addCheckbox( string $name, string $caption = NULL )

Adds check box control to the form.

Adds check box control to the form.

Parameters

$name
string
control name
$caption
string
caption

Returns

NCheckbox
public NRadioList
# addRadioList( string $name, string $label = NULL, array $items = NULL )

Adds set of radio button controls to the form.

Adds set of radio button controls to the form.

Parameters

$name
string
control name
$label
string
label
$items
array
options from which to choose

Returns

NRadioList
public NSelectBox
# addSelect( string $name, string $label = NULL, array $items = NULL, integer $size = NULL )

Adds select box control that allows single item selection.

Adds select box control that allows single item selection.

Parameters

$name
string
control name
$label
string
label
$items
array
items from which to choose
$size
integer
number of rows that should be visible

Returns

NSelectBox
public NMultiSelectBox
# addMultiSelect( string $name, string $label = NULL, array $items = NULL, integer $size = NULL )

Adds select box control that allows multiple item selection.

Adds select box control that allows multiple item selection.

Parameters

$name
string
control name
$label
string
label
$items
array
options from which to choose
$size
integer
number of rows that should be visible

Returns

NMultiSelectBox
public NSubmitButton
# addSubmit( string $name, string $caption = NULL )

Adds button used to submit form.

Adds button used to submit form.

Parameters

$name
string
control name
$caption
string
caption

Returns

NSubmitButton
public NButton
# addButton( string $name, string $caption )

Adds push buttons with no default behavior.

Adds push buttons with no default behavior.

Parameters

$name
string
control name
$caption
string
caption

Returns

NButton
public NImageButton
# addImage( string $name, string $src = NULL, string $alt = NULL )

Adds graphical button used to submit form.

Adds graphical button used to submit form.

Parameters

$name
string
control name
$src
string
URI of the image
$alt
string
alternate text for the image

Returns

NImageButton
public NFormContainer
# addContainer( string $name )

Adds naming container to the form.

Adds naming container to the form.

Parameters

$name
string
name

Returns

NFormContainer
public
# offsetSet( string $name, IComponent $component )

Adds the component to the container.

Adds the component to the container.

Parameters

$name
string
component name
$component
IComponent

Implementation of

ArrayAccess::offsetSet()
public IComponent
# offsetGet( string $name )

Returns component specified by name. Throws exception if component doesn't exist.

Returns component specified by name. Throws exception if component doesn't exist.

Parameters

$name
string
component name

Returns

IComponent

Throws

InvalidArgumentException

Implementation of

ArrayAccess::offsetGet()
public boolean
# offsetExists( string $name )

Does component specified by name exists?

Does component specified by name exists?

Parameters

$name
string
component name

Returns

boolean

Implementation of

ArrayAccess::offsetExists()
public
# offsetUnset( string $name )

Removes component from the container.

Removes component from the container.

Parameters

$name
string
component name

Implementation of

ArrayAccess::offsetUnset()
public
# __clone( )

Prevents cloning.

Prevents cloning.

Overrides

NComponentContainer::__clone()
public
# addFile( $name, $label = NULL )

Deprecated

Methods inherited from NComponentContainer
createComponent(), getComponent(), getComponents(), removeComponent(), validateChildComponent()
Methods inherited from NComponent
__construct(), __sleep(), __wakeup(), attached(), detached(), getName(), getParent(), lookup(), lookupPath(), monitor(), unmonitor(), validateParent()
Methods inherited from NObject
__call(), __callStatic(), __get(), __isset(), __set(), __unset(), extensionMethod(), getReflection()
Methods inherited from IComponent
setParent()
Constants inherited from IComponent
NAME_SEPARATOR
Properties summary
public array $onValidate
#

of function(Form $sender); Occurs when the form is validated

of function(Form $sender); Occurs when the form is validated

protected NFormGroup $currentGroup
#
protected boolean $valid
#
Magic properties summary
public NArrayHash $values
#
public NFormGroup $currentGroup
#
public read-only boolean $valid
#
public read-only ArrayIterator $controls
#
public read-only NForm $form
#
public write-only $defaults
#
Magic properties inherited from NComponentContainer
$components
Magic properties inherited from NComponent
$name, $parent
Magic properties inherited from NObject
$reflection
Nette Framework 2.0.18 (for PHP 5.2, prefixed) API documentation generated by ApiGen 2.8.0