org.jboss.hal.ballroom.form

Interface Form<T>

Type Parameters:

T - The model for this form

All Superinterfaces:

Attachable, org.jboss.gwt.elemento.core.IsElement

All Known Implementing Classes:

AbstractForm

@JsType(namespace="hal.ui")
public interface Form<T>
extends org.jboss.gwt.elemento.core.IsElement, Attachable

A form bound to a model using well defined states and operations. The form contains a list of form items which are used to view and modify the attributes of the model.

Form items can be bound or unbound: Bound form items show the attributes of the model (text input, check boxes or select boxes). They're part of the automatic data mapping between the form and the model. Unbound form items have no relation to the model (static text or buttons). They are not part of the automatic data mapping.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	Form.CancelCallback<T>
static class	Form.FinishRemove<T> Callback to be used after the remove operation has been successfully executed.
static class	Form.FinishReset<T> Callback to be used after the reset operation has been successfully executed.
static class	Form.Operation
static interface	Form.PrepareRemove<T> Callback to prepare the remove operation.
static interface	Form.PrepareReset<T> Callback to prepare the reset operation.
static interface	Form.SaveCallback<T>
static class	Form.State

Method Summary

Modifier and Type	Method and Description
void	addFormValidation(FormValidation<T> formValidation) Makes it possible to validate the form as a whole or to check fields which depend on other fields.
void	cancel() Cancels any modifications to the model.
void	clear() Clears this form by removing the model reference and by clearing all form fields.
void	edit(T model) Takes the specified model and populates the editing state with the values from the model.
Iterable<FormItem>	getBoundFormItems()
<F> FormItem<F>	getFormItem(String name)
Iterable<FormItem>	getFormItems()
String	getId()
T	getModel()
StateMachine	getStateMachine()
boolean	isTransient()
boolean	isUndefined()
void	remove() Removes the model.
void	reset() Resets the model.
boolean	save() Validates the form and its fields and upon successful validation persists the changes to the model and calls the save callback.
void	setCancelCallback(Form.CancelCallback<T> cancelCallback)
void	setPrepareRemove(Form.PrepareRemove<T> removeCallback)
void	setPrepareReset(Form.PrepareReset<T> prepareReset)
void	setSaveCallback(Form.SaveCallback<T> saveCallback)
void	view(T model) Takes the specified model and updates the read-only state with the values from the model.

Methods inherited from interface org.jboss.gwt.elemento.core.IsElement

asElement

Methods inherited from interface org.jboss.hal.ballroom.Attachable

attach, detach

Method Detail

isUndefined

@JsProperty
boolean isUndefined()

isTransient

@JsProperty
boolean isTransient()

view

void view(T model)

Takes the specified model and updates the read-only state with the values from the model.

Parameters:

model - the model to view.

clear

void clear()

Clears this form by removing the model reference and by clearing all form fields.

edit

void edit(T model)

Takes the specified model and populates the editing state with the values from the model.

Parameters:

model - the model to edit.

save

boolean save()

Validates the form and its fields and upon successful validation persists the changes to the model and calls the save callback.

setSaveCallback

@JsIgnore
void setSaveCallback(Form.SaveCallback<T> saveCallback)

cancel

void cancel()

Cancels any modifications to the model.

setCancelCallback

@JsIgnore
void setCancelCallback(Form.CancelCallback<T> cancelCallback)

setPrepareReset

@JsIgnore
void setPrepareReset(Form.PrepareReset<T> prepareReset)

reset

@JsIgnore
void reset()

Resets the model.

setPrepareRemove

@JsIgnore
void setPrepareRemove(Form.PrepareRemove<T> removeCallback)

remove

@JsIgnore
void remove()

Removes the model.

getId

@JsIgnore
String getId()

Returns:

an unique identifier for this form.

getModel

@JsProperty
T getModel()

Returns:

the current model.

getStateMachine

@JsIgnore
StateMachine getStateMachine()

Returns:

the state machine which access to the current state.

getFormItem

@JsIgnore
<F> FormItem<F> getFormItem(String name)

getFormItems

@JsIgnore
Iterable<FormItem> getFormItems()

Returns:

return all form items.

getBoundFormItems

@JsIgnore
Iterable<FormItem> getBoundFormItems()

Returns:

only those form items which are bound to the model.

addFormValidation

@JsIgnore
void addFormValidation(FormValidation<T> formValidation)

Makes it possible to validate the form as a whole or to check fields which depend on other fields.