ludo.form.Manager

var view = new ludo.View({
    form:{
            hiddenFields: ['id'], // Hidden fields which could be populated using ludo.get('myWindow).getForm().set('id', 100);
            submit:{
                url: '../controller.php',
                data: {
                    submit:1
                },
                listeners:{
                    'success': function(json, form){
                        new ludo.dialog.Alert({
                            title:'Thank you!',
                            resizable:true,
                            html:'Thank you. Your data has been saved..'
                        });

                        form.commit();
                    },
                    'fail': function(text, error, form){
                        // do something on failure
                    }
                }
            },

            read: {
                autoload:true,  // autoload data on create
                url: 'form-data.json', // read url
                keys:['id'], // array of form values to add to the view request
                listeners:{
                    'success': function(json, form){
                        form.clear();
                        form.populate(json);
                    },
                    'fail': function(text, error, form){
                        // do something on failure
                    }
                }
            }
    }
	children:[
		{ type:'form.Text', label:'First name', name:'firstname' },
		{ type:'form.Text', label:'Last name', name:'lastname' }
	]
});

view.getForm().val("firstname", "John"); // update all form views with name "firstname" with the value "John"
view.getForm().val("lastname", "Doe"); // update all form veiws with name "lastname" with the value "Doe"

// Return form values as JSON { "firstname": "John", "lastname": "Doe" }
var json = view.getForm().values();

Members

---

view

Source:

• form/manager.js, line 95

Methods

---

clear()

Clear value of all child form views back to blank or default view value

Source:

• form/manager.js, line 573

---

commit()

Commit all form Views. This will reset the dirty flag. The dirty flag is true when on form view has been updated.
A later call to reset will reset all form Views back to the value it had when commit was called.
with a new value.

Source:

• form/manager.js, line 530

---

get(name) → {String|Number|Object}

Return value of form element.

Parameters:

Name	Type	Description
name	String	Name of form element

Source:

• form/manager.js, line 291

Returns:

Type

String | Number | Object

---

getFormElements()

Get all form elements, store them in an array and add valid and invalid events to them

Source:

• form/manager.js, line 151

---

isDirty()

Returns true if a form View has been updated with a new value. This is useful for handling disabling/enabling of buttons
based on changes made to the form. The dirty flag can be reset by calling the ludo.form.Manager#commit method. This will
call commit on all form views.

Source:

• form/manager.js, line 588

---

isValid()

Returns true when all child form views are valid

Source:

• form/manager.js, line 377

---

populate(json)

Populate form fields with data from JSON object

Parameters:

Name	Type	Description
json	Object	JSON object

Source:

• form/manager.js, line 213

Example

var view = new ludo.View({
	renderTo:document.body,
	layout:{ type:'linear', orientation:'vertical', width:'matchParent', height:'matchParent' },
	children:[
		{ type:'form.Text', name:'firstname' },
		{ type:'form.Text', name:'lastname' }
	]
});
// Update form views firstname and lastname with values from JSON
view.getForm.populate({
	"firstname" : "Jane", "lastname": "Anderson"
});

---

read()

Read form values from the server. This method triggers the events read.init and read.success|read.fail.
This method will be called during view creation if read.autoload is set to true.

Source:

• form/manager.js, line 462

Example

var v = new ludo.View({
         form:{
            hiddenFields: ['id'],
            read: {
                url: 'form-data.json', // read url
                keys:['id'], // array of form values to add to the view request
                listeners:{
                    'success': function(json, form){
                        form.clear();
                        form.populate(json);
                    },
                    'fail': function(text, error, form){
                        // do something on failure
                    }
                }
            }
        }
     });
     // load data from server and trigger the listeners above.
     v.getForm().read();

---

reset()

Reset value of all form Views back to it's commited value.

Source:

• form/manager.js, line 552

---

rollback()

Alias to reset

Source:

• form/manager.js, line 544

---

set(name, value)

Set value of a form element

Parameters:

Name	Type	Description
name	String	name of form element
value	String | Number | Object

Source:

• form/manager.js, line 238

---

submit()

Submit form to server

Source:

• form/manager.js, line 386

---

val(key, value)

Set OR get value of form component.
Called with two arguments(key and value), a value will be set. Called with one argument(key), value will be returned.

Parameters:

Name	Type	Description
key
value

Source:

• form/manager.js, line 255

Example

view.getForm().val('firstname', 'Hannah');
var firstname = view.getForm().val('firstname');

---

validate()

Validate form and fire "invalid" or "valid" event

Source:

• form/manager.js, line 364

Returns:

void

---

values() → {Object}

Returns values of all form elements in JSON format.
This method can be called on all views. It will return a JSON containing key-value pairs for all the views form elements(nested, i.e. children, grand children etc)

Source:

• form/manager.js, line 274

Returns:

Type

Object