1. class
  2. Nette
  3. \
  4. Forms
  5. \
  6. Form

Form

class Form extends Container implements HtmlStringable

Creates, validates and renders HTML forms.

Constants

Equal

validator
IsIn

validator
NotEqual

validator
IsNotIn

validator
Filled

validator
Blank

validator
Required

validator
Valid

validator
Submitted

validator
MinLength

validator
MaxLength

validator
Length

validator
Email

validator
URL

validator
Pattern

validator
PatternInsensitive

validator
Integer

validator
Numeric

validator
Float

validator
Min

validator
Max

validator
Range

validator
Count

validator
MaxFileSize

validator
MimeType

validator
Image

validator
MaxPostSize

validator
Get

method
Post

method
DataText

submitted data types
DataLine

submitted data types
DataFile

submitted data types
DataKeys

submitted data types
internal TrackerId

EQUAL

IS_IN

NOT_EQUAL

IS_NOT_IN

FILLED

BLANK

REQUIRED

VALID

SUBMITTED

MIN_LENGTH

MAX_LENGTH

LENGTH

EMAIL

PATTERN

PATTERN_ICASE

INTEGER

NUMERIC

FLOAT

MIN

MAX

RANGE

COUNT

MAX_FILE_SIZE

MIME_TYPE

IMAGE

MAX_POST_SIZE

GET

POST

DATA_TEXT

DATA_LINE

DATA_FILE

DATA_KEYS

TRACKER_ID

Properties

$onSuccess

Occurs when the form is submitted and successfully validated
$onError
$onSubmit
$onRender
internal $httpRequest
protected $crossOrigin
string[] read-only $errors
(string|Stringable)[] read-only $ownErrors
Html read-only $elementPrototype

Methods

__construct(string|null $name = null)

No description

Form|null
getForm(bool $throw = true)

Returns form.

Form
setAction(string|Stringable $url)

No description

string
getAction()

No description

Form
setMethod(string $method)

No description

string
getMethod()

No description

bool
isMethod(string $method)

Checks if the request method is the given one.

Form
setHtmlAttribute(string $name, mixed $value = true)

Sets a form-level HTML attribute.

void
allowCrossOrigin()

Disables the SameSite cookie CSRF protection, allowing cross-origin form submissions.

void
addProtection(string|null $errorMessage = null)

No description

ControlGroup
addGroup(string|Stringable|null $caption = null, bool $setAsCurrent = true)

Creates a new control group and optionally sets it as current for subsequent addXxx() calls.

void
removeGroup(ControlGroup $name)

Removes a group and all its controls from the form.

array
getGroups()

Returns all defined groups.

ControlGroup|null
getGroup(string|int $name)

Returns the specified group.

Form
setTranslator(Translator|null $translator)

No description

Translator|null
getTranslator()

No description

bool
isAnchored()

Checks whether the form is attached to a request (always true for standalone forms).

SubmitterControl|bool
isSubmitted()

Returns the submitter control if the form was submitted, or false.

bool
isSuccess()

Tells if the form was submitted and successfully validated.

Form
setSubmittedBy(SubmitterControl|null $by)

No description

FileUpload|null
getHttpData(int|null $type = null, string|null $htmlName = null)

Returns raw submitted HTTP data for a control, or all form data when called without arguments.

void
fireEvents()

Fires onSuccess, onError, onSubmit and onClick events based on submission and validation state.

Form
reset()

Clears the submission state and resets all control values to defaults.

array|null
receiveHttpData()

Internal: returns submitted HTTP data or null when form was not submitted.

void
validate(array|null $controls = null)

No description

void
validateMaxPostSize()

No description

void
addError(string|Stringable $message, bool $translate = true)

Adds a form-level (not control-level) error message.

array
getErrors()

Returns all validation errors (own form errors merged with control errors).

bool
hasErrors()

No description

void
cleanErrors()

No description

array
getOwnErrors()

Returns form-level errors only, excluding control errors.

Html
getElementPrototype()

Returns form's HTML element template.

Form
setRenderer(FormRenderer|null $renderer)

No description

FormRenderer
getRenderer()

No description

beforeRender()

No description

void
fireRenderEvents()

Triggers beforeRender() and onRender events. Must be called before manual rendering (when not using render()).

void
render(mixed ...$args)

No description

string
__toString()

No description

array
getToggles()

Returns current visibility states of all toggle targets across all controls.

static void
initialize(IRequest $reinit = false)

Initializes HTTP request and SameSite CSRF cookie for standalone (non-DI) usage.

Details

at line 213
__construct(string|null $name = null)

No description

Parameters

string|null $name

at line 229
Form|null getForm(bool $throw = true)

Returns form.

Parameters

bool $throw

Return Value

Form|null

at line 235
Form setAction(string|Stringable $url)

No description

Parameters

string|Stringable $url

Return Value

Form

at line 242
string getAction()

No description

Return Value

string

at line 248
Form setMethod(string $method)

No description

Parameters

string $method

Return Value

Form

at line 259
string getMethod()

No description

Return Value

string

at line 268
bool isMethod(string $method)

Checks if the request method is the given one.

Parameters

string $method

Return Value

bool

at line 277
Form setHtmlAttribute(string $name, mixed $value = true)

Sets a form-level HTML attribute.

Parameters

string $name
mixed $value

Return Value

Form

at line 287
void allowCrossOrigin()

Disables the SameSite cookie CSRF protection, allowing cross-origin form submissions.

Return Value

void

at line 293
void addProtection(string|null $errorMessage = null)

No description

Parameters

string|null $errorMessage

Return Value

void

at line 303
ControlGroup addGroup(string|Stringable|null $caption = null, bool $setAsCurrent = true)

Creates a new control group and optionally sets it as current for subsequent addXxx() calls.

Parameters

string|Stringable|null $caption
bool $setAsCurrent

Return Value

ControlGroup

at line 322
void removeGroup(ControlGroup $name)

Removes a group and all its controls from the form.

Parameters

ControlGroup $name

Return Value

void

at line 347
array getGroups()

Returns all defined groups.

Return Value

array

at line 356
ControlGroup|null getGroup(string|int $name)

Returns the specified group.

Parameters

string|int $name

Return Value

ControlGroup|null

at line 365
Form setTranslator(Translator|null $translator)

No description

Parameters

Translator|null $translator

Return Value

Form

at line 372
Translator|null getTranslator()

No description

Return Value

Translator|null

at line 384
bool isAnchored()

Checks whether the form is attached to a request (always true for standalone forms).

Return Value

bool

at line 393
SubmitterControl|bool isSubmitted()

Returns the submitter control if the form was submitted, or false.

Return Value

SubmitterControl|bool

at line 406
bool isSuccess()

Tells if the form was submitted and successfully validated.

Return Value

bool

at line 415
Form setSubmittedBy(SubmitterControl|null $by)

internal  
 

No description

Parameters

SubmitterControl|null $by

Return Value

Form

at line 426
FileUpload|null getHttpData(int|null $type = null, string|null $htmlName = null)

Returns raw submitted HTTP data for a control, or all form data when called without arguments.

Parameters

int|null $type
string|null $htmlName

Return Value

FileUpload|null

at line 453
void fireEvents()

Fires onSuccess, onError, onSubmit and onClick events based on submission and validation state.

Return Value

void

at line 520
Form reset()

Clears the submission state and resets all control values to defaults.

Return Value

Form

at line 532
protected array|null receiveHttpData()

Internal: returns submitted HTTP data or null when form was not submitted.

Return Value

array|null

at line 566
void validate(array|null $controls = null)

No description

Parameters

array|null $controls

Return Value

void

at line 579
void validateMaxPostSize()

internal  
 

No description

Return Value

void

at line 595
void addError(string|Stringable $message, bool $translate = true)

Adds a form-level (not control-level) error message.

Parameters

string|Stringable $message
bool $translate

Return Value

void

at line 609
array getErrors()

Returns all validation errors (own form errors merged with control errors).

Return Value

array

at line 615
bool hasErrors()

No description

Return Value

bool

at line 621
void cleanErrors()

No description

Return Value

void

at line 631
array getOwnErrors()

Returns form-level errors only, excluding control errors.

Return Value

array

at line 643
Html getElementPrototype()

Returns form's HTML element template.

Return Value

Html

at line 655
Form setRenderer(FormRenderer|null $renderer)

No description

Parameters

FormRenderer|null $renderer

Return Value

Form

at line 662
FormRenderer getRenderer()

No description

Return Value

FormRenderer

at line 672
protected beforeRender()

No description

at line 680
void fireRenderEvents()

Triggers beforeRender() and onRender events. Must be called before manual rendering (when not using render()).

Return Value

void

at line 690
void render(mixed ...$args)

No description

Parameters

mixed ...$args

Return Value

void

at line 697
string __toString()

No description

Return Value

string

at line 708
array getToggles()

Returns current visibility states of all toggle targets across all controls.

Return Value

array

at line 727
static void initialize(IRequest $reinit = false)

Initializes HTTP request and SameSite CSRF cookie for standalone (non-DI) usage.

Parameters

IRequest $reinit

Return Value

void