Form

Instance Constructors

new Form(mapping: Mapping[T], data: Map[String, String], errors: Seq[FormError], value: Option[T])

mapping
the form mapping, which describes all form fields
data
the current form data, used to display the form
errors
the collection of errors associated with this form
value
a concrete value of type T if the form submission was successful

Value Members

final def !=(arg0: Any): Boolean

Definition Classes
AnyRef → Any
final def ##(): Int

Definition Classes
AnyRef → Any
final def ==(arg0: Any): Boolean

Definition Classes
AnyRef → Any
def apply(key: String): Field

Retrieves a field.
Retrieves a field.
For example:
```
val usernameField = userForm("username")
```
key
the field name
returns
the field, returned even if the field does not exist
final def asInstanceOf[T0]: T0

Definition Classes
Any
def bind(data: JsValue): Form[T]

Binds data to this form, i.e.
Binds data to this form, i.e. handles form submission.
data
Json data to submit
returns
a copy of this form, filled with the new data
def bind(data: Map[String, String]): Form[T]

Binds data to this form, i.e.
Binds data to this form, i.e. handles form submission.
data
the data to submit
returns
a copy of this form, filled with the new data
def bindFromRequest(data: Map[String, Seq[String]]): Form[T]
def bindFromRequest()(implicit request: Request[_]): Form[T]

Binds request data to this form, i.e.
Binds request data to this form, i.e. handles form submission.
returns
a copy of this form filled with the new data
def clone(): AnyRef

Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@throws( ... )
val constraints: Map[String, Seq[(String, Seq[Any])]]

Constraints associated with this form, indexed by field name.
val data: Map[String, String]

the current form data, used to display the form
def discardingErrors: Form[T]

Discards this form’s errors
Discards this form’s errors
returns
a copy of this form without errors
final def eq(arg0: AnyRef): Boolean

Definition Classes
AnyRef
def error(key: String): Option[FormError]

Retrieve the first error for this key.
Retrieve the first error for this key.
key
field name.
def errors(key: String): Seq[FormError]

Retrieve all errors for this key.
Retrieve all errors for this key.
key
field name.
val errors: Seq[FormError]

the collection of errors associated with this form
def errorsAsJson(implicit provider: MessagesProvider): JsValue

Returns the form errors serialized as Json.
def fill(value: T): Form[T]

Fills this form with a existing value, used for edit forms.
Fills this form with a existing value, used for edit forms.
value
an existing value of type T, used to fill this form
returns
a copy of this form filled with the new data
def fillAndValidate(value: T): Form[T]

Fills this form with a existing value, and performs a validation.
Fills this form with a existing value, and performs a validation.
value
an existing value of type T, used to fill this form
returns
a copy of this form filled with the new data
def finalize(): Unit

Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@throws( classOf[java.lang.Throwable] )
def fold[R](hasErrors: (Form[T]) ⇒ R, success: (T) ⇒ R): R

Handles form results.
Handles form results. Either the form has errors, or the submission was a success and a concrete value is available.
For example:
```
anyForm.bindFromRequest().fold(
   f => redisplayForm(f),
   t => handleValidFormSubmission(t)
)
```
R
common result type
hasErrors
a function to handle forms with errors
success
a function to handle form submission success
returns
a result R.
def forField[R](key: String)(handler: (Field) ⇒ R): R

Applies a function for a field.
Applies a function for a field.
For example:
```
userForm.forField("username") { field =>
  <input type="text" name={field.name} value={field.value.getOrElse("")} />
}
```
R
result type
key
field name
handler
field handler (transform the field to R)
val formats: Map[String, (String, Seq[Any])]

Formats associated to this form, indexed by field name.
Formats associated to this form, indexed by field name. *
def get: T

Returns the concrete value, if the submission was a success.
Returns the concrete value, if the submission was a success.
Note that this method fails with an Exception if this form has errors.
final def getClass(): Class[_]

Definition Classes
AnyRef → Any
def globalError: Option[FormError]

Retrieves the first global error, if it exists, i.e.
Retrieves the first global error, if it exists, i.e. an error without any key.
returns
an error
def globalErrors: Seq[FormError]

Retrieves all global errors, i.e.
Retrieves all global errors, i.e. errors without a key.
returns
all global errors
def hasErrors: Boolean

Returns true if there is an error related to this form.
def hasGlobalErrors: Boolean

Returns true if there is a global error related to this form.
final def isInstanceOf[T0]: Boolean

Definition Classes
Any
val mapping: Mapping[T]

the form mapping, which describes all form fields
final def ne(arg0: AnyRef): Boolean

Definition Classes
AnyRef
final def notify(): Unit

Definition Classes
AnyRef
final def notifyAll(): Unit

Definition Classes
AnyRef
final def synchronized[T0](arg0: ⇒ T0): T0

Definition Classes
AnyRef
val value: Option[T]

a concrete value of type T if the form submission was successful
final def wait(): Unit

Definition Classes
AnyRef
Annotations
@throws( ... )
final def wait(arg0: Long, arg1: Int): Unit

Definition Classes
AnyRef
Annotations
@throws( ... )
final def wait(arg0: Long): Unit

Definition Classes
AnyRef
Annotations
@throws( ... )
def withError(key: String, message: String, args: Any*): Form[T]

Convenient overloaded method adding an error to this form
Convenient overloaded method adding an error to this form
key
Key of the field having the error
message
Error message
args
Error message arguments
returns
a copy of this form with the added error
def withError(error: FormError): Form[T]

Adds an error to this form
Adds an error to this form
error
Error to add
returns
a copy of this form with the added error
def withGlobalError(message: String, args: Any*): Form[T]

Adds a global error to this form
Adds a global error to this form
message
Error message
args
Error message arguments
returns
a copy of this form with the added global error

Related Docs: object Form | package data

case class Form[T](mapping: Mapping[T], data: Map[String, String], errors: Seq[FormError], value: Option[T]) extends Product with Serializable

Instance Constructors

new Form(mapping: Mapping[T], data: Map[String, String], errors: Seq[FormError], value: Option[T])

Value Members

final def !=(arg0: Any): Boolean

final def ##(): Int

final def ==(arg0: Any): Boolean

def apply(key: String): Field

final def asInstanceOf[T0]: T0

def bind(data: JsValue): Form[T]

def bind(data: Map[String, String]): Form[T]

def bindFromRequest(data: Map[String, Seq[String]]): Form[T]

def bindFromRequest()(implicit request: Request[_]): Form[T]

def clone(): AnyRef

val constraints: Map[String, Seq[(String, Seq[Any])]]

val data: Map[String, String]

def discardingErrors: Form[T]

final def eq(arg0: AnyRef): Boolean

def error(key: String): Option[FormError]

def errors(key: String): Seq[FormError]

val errors: Seq[FormError]

def errorsAsJson(implicit provider: MessagesProvider): JsValue

def fill(value: T): Form[T]

def fillAndValidate(value: T): Form[T]

def finalize(): Unit

def fold[R](hasErrors: (Form[T]) ⇒ R, success: (T) ⇒ R): R

def forField[R](key: String)(handler: (Field) ⇒ R): R

val formats: Map[String, (String, Seq[Any])]

def get: T

final def getClass(): Class[_]

def globalError: Option[FormError]

def globalErrors: Seq[FormError]

def hasErrors: Boolean

def hasGlobalErrors: Boolean

final def isInstanceOf[T0]: Boolean

val mapping: Mapping[T]

final def ne(arg0: AnyRef): Boolean

final def notify(): Unit

final def notifyAll(): Unit

final def synchronized[T0](arg0: ⇒ T0): T0

val value: Option[T]

final def wait(): Unit

final def wait(arg0: Long, arg1: Int): Unit

final def wait(arg0: Long): Unit

def withError(key: String, message: String, args: Any*): Form[T]

def withError(error: FormError): Form[T]

def withGlobalError(message: String, args: Any*): Form[T]

Inherited from Serializable

Inherited from Serializable

Inherited from Product

Inherited from Equals

Inherited from AnyRef

Inherited from Any

Ungrouped