dhtmlXForm API

Methods
addItem adds an item to the form
adjustParentSize adjusts the parent's size to the form content
attachEvent adds any user-defined handler to available events
checkItem checks a checkbox or a radio button
clear clears the list of files
clearBackup deletes the specified backup
clearNote removes the note block from an input or a radio button
clearValidation removes all validation rules from an input
detachEvent detaches a handler from an event
disableItem disables an item
enableItem enables an item
enableLiveValidation sets the mode when validation is invoked just after an input goes out of focus
forEachItem iterator, calls a user-defined handler for each item
getCalendar returns dhtmlxCalendar instance
getCheckedValue returns the value of the checked radio button
getColorPicker returns dhtmlxColorPicker instance
getColumnNode returns the DOM node of the specified column
getCombo returns dhtmlxCombo instance
getContainer returns the HTMLElement object of the container control
getEditor returns dhtmlxEditor instance
getFirstActive returns the first element of the form
getForm returns dhtmlxForm instance
getFormData returns a hash of data values
getInput returns item object (input, textarea, password, calendar, colorpicker, hidden only)
getItemLabel returns the label of an item
getItemText returns the text of an item
getItemType returns the type of an item
getItemValue returns the value of an item
getItemWidth returns the width of an item set either by init or by the [setItemWidth()](setItemWidth) method
getItemsList returns an array with the names of the form's items
getOptions returns the options of an item (select, multiselect only)
getSelect returns an item's object (select, multiselect only)
getUploader returns the uploader instance
getUploaderStatus returns the status of uploading
getUserData returns any user data set into the given input by the setUserData() method
hideItem hides an item
isItem returns "true" if an item exists
isItemChecked returns "true" if an item is checked (a checkbox and a radio button only)
isItemEnabled returns "true" if an item is enabled
isItemHidden returns "true" if an item is hidden
isLocked returns "true" if the form is locked
isReadonly returns "true" if an item is readonly
load loads data to the component via XML or JSON, usually data-values pairs
loadStruct loads data to the component via XML or JSON, usually component config
loadStructHTML loads dhtmlxForm from HTML form structure
loadStructString loads XML string into dhtmlxForm instance
lock locks the form (disables all the items)
reloadOptions reloads options of the item (combo, select, multiselect only)
removeColumn removes the specified item
removeItem removes an item
reset resets the items of the form saved by means of the load or save methods to their initial states
resetDataProcessor sets the mode of saving, if Form is used together with DataProcessor
resetValidateCss resets CSS treatment of the form's validation
restoreBackup restores the specified backup
save saves the form's data in DB
saveBackup creates a backup of the form
send saves data to the server side script
setCalendarDateFormat sets the format of date presentation in the calendar input
setFocusOnFirstActive moves the focus on the first form's element
setFontSize sets the font size for the whole form
setFormData sets values for all items (form's controls) in the component
setItemFocus sets the keyboard focus on the specified item
setItemHeight sets the height of a textarea
setItemLabel sets the label of an item
setItemText sets the text of an item
setItemValue sets the value of an item or clears the list in uploader (if the 2nd param is omitted)
setItemWidth sets the width of an item
setNote adds the note block under the specified input
setNumberFormat allows setting the format of numeric data (for inputs only)
setReadonly makes an item readonly
setRequired makes/unmakes a certain field required
setSkin sets skin for a form
setTooltip sets a tooltip for an item
setUserData allows attaching user data to a form without modifying the DOM
setValidateCss sets CSS treatment of the form validation
setValidation adds a validation rule to the input with the specified name
showItem shows an item
uncheckItem unchecks an item (a checkbox or a radio button only)
unload destructor, removes the form instance and cleans the used memory
unlock unlocks the form (enables all the items)
updateValues updates the inputs' values
validate starts the form's validation
validateItem invokes the validation of the specified item
Events
onAfterReset fires after resetting the form
onAfterSave fires after data has been saved in DB
onAfterValidate fires after the validation
onBeforeChange fires before the data in some input changed ( by user actions )
onBeforeClear fires before the user clears the list of files to upload (clicks the button )
onBeforeDataLoad fires after the data for the form received, but before it's assigned to actual fields
onBeforeFileAdd fires when the user adds a file to the upload queue
onBeforeFileRemove fires before the user removes a single file from the list of files to upload (clicks the button )
onBeforeFileUpload fires before file uploading has started
onBeforeReset fires before resetting the form
onBeforeSave fires before saving the form
onBeforeValidate fires when validation has started but is not applied yet
onBlur fires when the user moves the mouse pointer out of the input
onButtonClick fires when the user clicks a button
onChange fires when data in some input was changed
onClear when the user clears the list of files to upload (clicks on button )
onDisable fires when the container is disabled after being enabled
onEditorAccess fires when the user accesses the editor body
onEditorToolbarClick fires when the user clicks the editor toolbar
onEnable fires when the container control is enabled after being disabled
onEnter fires on pressing the Enter button when the mouse pointer is set in an input control
onFileAdd fires when the user adds a file to the upload queue
onFileRemove fires when the user removes single file from the list of files to upload (clicks the button )
onFocus fires when an input gets focus
onImageUploadFail fires when an image was uploaded incorrectly
onImageUploadSuccess fires when an image was uploaded correctly
onInfo fires when the user clicks the Info icon
onInputChange fires when data in an input was changed and the cursor is still in this input
onKeydown fires when the native "onkeydown" event is triggered
onKeyup fires when the native "onkeyup" event is triggered
onOptionsLoaded fires after the item options were completely loaded from the server to the client
onUploadCancel fires when the user cancels uploading of a file (clicks the button ).
onUploadComplete fires when all files from the list have been uploaded to the server
onUploadFail fires when the file upload has failed
onUploadFile fires when a single file from the list has been uploaded to the server
onValidateError fires for each error during validation
onValidateSuccess fires for each success during validation
onXLE fires when the data loading is finished and a component or data is rendered
onXLS fires when XML loading started
Back to top