| Defined In: | Form.js |
| Class: | Ext.form.Form |
| Extends: | Ext.form.BasicForm |
| 配置项 | 定义者 | |
|---|---|---|
|
labelWidth
: Number
标签的宽度。该属性级联于子容器。
标签的宽度。该属性级联于子容器。
|
Form | |
|
:
|
BasicForm | |
|
buttonAlign
: String
有效值为"left," "center" 和 "right" (默认为...
有效值为"left," "center" 和 "right" (默认为"center")
|
Form | |
|
minButtonWidth
: Number
每个button的最小宽度(默认75)
每个button的最小宽度(默认75)
|
Form | |
|
labelAlign
: String
有效值为"left," "top" 和 "right" (默认为"le...
有效值为"left," "top" 和 "right" (默认为"left")。
该属性级联于没有设定此属性的子容器。
|
Form | |
|
monitorValid
: Boolean
true表示为通过不断触发一个事件,来监视有效值的状态(在客户端进行)...
true表示为通过不断触发一个事件,来监视有效值的状态(在客户端进行)
该项须绑定到有配置项formBind:true的按钮的valid state
|
Form | |
|
monitorPoll
: Number
检验valid state的间隔毫秒数,如monitorValid非真...
检验valid state的间隔毫秒数,如monitorValid非真则忽略改项。(默认为200)
|
Form | |
|
method
: String
所有动作的默认表单请求方法(GET 或 POST)
所有动作的默认表单请求方法(GET 或 POST)
|
BasicForm | |
|
reader
: DataReader
An Ext.data.DataReader (e.g. Ext.da...
An Ext.data.DataReader (e.g. Ext.data.XmlReader) to be used to read data when executing "load" actions. This is optional as there is built-in support for processing JSON. 一个Ext.data.DataReader对象(e.g. Ext.data.XmlReader),当执行"load"动作时被用来读取数据 它是一个可选项,因为这里已经有了一个内建对象来读取JSON数据
|
BasicForm | |
|
errorReader
: DataReader
一个Ext.data.DataReader对象(e.g. {@link...
一个Ext.data.DataReader对象(e.g. {@link Ext.data.XmlReader}),当执行"submit"动作出错时被用来读取数据
|
BasicForm | |
|
url
: String
当动作选项未指定url时使用
当动作选项未指定url时使用
|
BasicForm | |
|
baseParams
: Object
表单请求时传递的参数。例,baseParams: {id: '123'...
表单请求时传递的参数。例,baseParams: {id: '123', foo: 'bar'}
|
BasicForm | |
|
timeout
: Number
表单动作的超时秒数(默认30秒)
表单动作的超时秒数(默认30秒)
|
BasicForm | |
|
trackResetOnLoad
: Boolean
如果为true,表单对象的form.reset()方法重置到最后一次加...
如果为true,表单对象的form.reset()方法重置到最后一次加载或setValues()数据,
|
BasicForm | |
|
standardSubmit
: Boolean
If set to true, standard HTML form ...
If set to true, standard HTML form submits are used instead of XHR (Ajax) style
form submissions. (defaults to false)
|
BasicForm | |
|
listeners
: Object
一个配置项对象,可方便在该对象初始化时便加入多个事件处理函数。 这应该...
一个配置项对象,可方便在该对象初始化时便加入多个事件处理函数。 这应该是一个如#addListener有效的配置项对象,即可一次过加入多个事件处理函数。
|
Observable | |
| 属性 | 定义者 | |
|---|---|---|
|
items: this.
所有表单内元素的集合。
所有表单内元素的集合。
|
BasicForm | |
|
waitMsgTarget: waitMsgTarget
By default wait messages are displ...
By default wait messages are displayed with Ext.MessageBox.wait. You can target a specific element by passing it or its id or mask the form itself by passing in true. 默认的等待提示窗口为Ext.MessageBox.wait。也可以指定一个对象或它的ID做为遮罩目标,如果指定为真则直接遮罩在表单对象上
|
BasicForm | |
| 方法 | 定义者 | |
|---|---|---|
Form
(
Object config
)
: Ext.form.Form
构造器
构造器
参数项:
|
Form | |
layout
(
Object config,
[Field field1],
[Field field2],
[Field etc]
)
:
在布局堆栈中打开一个新的Ext.form.Column类容器。如果所...
在布局堆栈中打开一个新的Ext.form.Column类容器。如果所有域在配置之后被通过,域将被添加同时该column被关闭, 如果没有域被通过该column仍然打开,直至end()方法被调用。
参数项:
|
Form | |
|
getForm
(
)
: Ext.form.BasicForm} The {@link Ext.form.BasicForm Form} which this Panel contains. 该面板对象包含的 {@link Ext.form.BasicForm Form
Provides access to the {@link Ext....
Provides access to the {@link Ext.form.BasicForm Form} which this Panel contains. 返回面板对象包含的 {@link Ext.form.BasicForm Form}以供访问。
参数项:
|
Form | |
|
startMonitoring
(
)
Starts monitoring of the valid sta...
Starts monitoring of the valid state of this form. Usually this is done by passing the config option "monitorValid" 开始监视该表单的验证过程。通常这是由配置项"monitorValid"完成的。
参数项:
|
Form | |
|
stopMonitoring
(
)
停止监视该form的验证状态。
停止监视该form的验证状态。
参数项:
|
Form | |
load
(
Object options
)
: BasicForm
做加载动作的简便方法。
做加载动作的简便方法。
参数项:
|
BasicForm | |
BasicForm
(
String/HTMLElement/Ext.Element el,
Object config
)
: Ext.form.BasicForm
构造器
构造器
参数项:
|
BasicForm | |
|
isValid
(
)
:
如果客户端的验证通过则返回真
如果客户端的验证通过则返回真
参数项:
|
BasicForm | |
|
isDirty
(
)
:
如果自从被加载后任何一个表单元素被修了,则返回真
如果自从被加载后任何一个表单元素被修了,则返回真
参数项:
|
BasicForm | |
doAction2_1
(
String/Object actionName,
@link Ext.form.BasicForm#isValid isValid prior
)
: BasicForm
Performs a predefined action (Ext....
Performs a predefined action (Ext.form.Action.Submit or Ext.form.Action.Load) or a custom extension of Ext.form.Action to perform application-specific processing.
or instance of Ext.form.Action to perform.
All of the config options listed below are supported by both the submit and load actions unless otherwise noted (custom actions could also accept other config options):
参数项:
|
BasicForm | |
doAction
(
String actionName,
Object options
)
: BasicForm
Performs a predefined action (subm...
Performs a predefined action (submit or load) or custom actions you define on this form. 执行一个预定义的(提交或加载)或一个在表单上自定义的动作,
below are supported by both the submit and load actions unless otherwise noted (custom actions could also accept other config options): 传递给行动作象的选项配制。除非另有声明(自定义的动作仍然可以有附加的选项配制),下面是所有提供给提交与加载动作的选项配制列表。
Property Type Description ---------------- --------------- ---------------------------------------------------------------------------------- url String The url for the action (defaults to the form's url) method String The form method to use (defaults to the form's method, or POST if not defined) params String/Object The params to pass (defaults to the form's baseParams, or none if not defined) clientValidation Boolean Applies to submit only. Pass true to call form.isValid() prior to posting to validate the form on the client (defaults to false)属性 类型 描述 ---------------- --------------- ---------------------------------------------------------------------------------- url String 动作请求的url (默认为表单的url) method String 表单使用的提交方式 (默认为表单的方法,如果没有指定则"POST") params String/Object 要传递的参数 (默认为表单的基本参数,如果没有指定则为空) clientValidation Boolean 只应用到提交方法。为真则在提交前调用表单对像的isValid方法,实现在客户端的验证。(默认为假)
参数项:
|
BasicForm | |
submit
(
Object options
)
: BasicForm
做提交动作的简便方法。
做提交动作的简便方法。
参数项:
|
BasicForm | |
updateRecord
(
Record record
)
: BasicForm
Persists the values in this form i...
Persists the values in this form into the passed Ext.data.Record object in a beginEdit/endEdit block. 表单内的元素数据考贝到所传递的Ext.data.Record对象中(beginEdit/endEdit块中进行赋值操作)。
参数项:
|
BasicForm | |
loadRecord
(
Record record
)
: BasicForm
Loads an Ext.data.Record into this...
Loads an Ext.data.Record into this form. 加载Ext.data.Record对象的数据到表单元素中。
参数项:
|
BasicForm | |
findField
(
String id
)
:
按传递的ID、索引或名称查询表单中的元素。
按传递的ID、索引或名称查询表单中的元素。
参数项:
|
BasicForm | |
markInvalid
(
Array/Object errors
)
: BasicForm
可以批量的标记表单元素为失效的。
可以批量的标记表单元素为失效的。
参数项:
|
BasicForm | |
setValues
(
Array/Object values
)
: BasicForm
表单元素批量赋值。
表单元素批量赋值。
参数项:
|
BasicForm | |
getValues
(
Boolean asString
)
: Object
返回以键/值形式包函表单所有元素的信息对象。 如果表单元素中有相同名...
返回以键/值形式包函表单所有元素的信息对象。 如果表单元素中有相同名称的对象,则返回一个同名数组。
参数项:
|
BasicForm | |
|
clearInvalid
(
)
: BasicForm
清除表单中所有校验错误的显示信息。
清除表单中所有校验错误的显示信息。
参数项:
|
BasicForm | |
|
reset
(
)
: BasicForm
重置表单。
重置表单。
参数项:
|
BasicForm | |
add
(
Field field1,
Field field2,
Field etc
)
: BasicForm
向表单中清加组件。
向表单中清加组件。
参数项:
|
BasicForm | |
remove
(
Field field
)
: BasicForm
从表单对象集中清除一个元素(不清除它的页面标签)。
从表单对象集中清除一个元素(不清除它的页面标签)。
参数项:
|
BasicForm | |
|
render
(
)
: BasicForm
遍历表单所有元素,以ID属性检查它们是否在页面上存在, 以它的ID为...
遍历表单所有元素,以ID属性检查它们是否在页面上存在, 以它的ID为值调用每个元素的applyTo方法到现有的页面对象。
参数项:
|
BasicForm | |
applyToFields
(
Object values
)
: BasicForm
遍历表单元素并以传递的对象为参调用 Ext#apply 方法。
遍历表单元素并以传递的对象为参调用 Ext#apply 方法。
参数项:
|
BasicForm | |
applyIfToFields
(
Object values
)
: BasicForm
遍历表单元素并以传递的对象为参调用 {@link Ext#appl...
遍历表单元素并以传递的对象为参调用 {@link Ext#applyIf} 方法。
参数项:
|
BasicForm | |
fireEvent
(
String eventName,
Object... args
)
: Boolean
触发指定的事件,并将欲执行的处理函数的参数传入。(应该至少要有事件的...
触发指定的事件,并将欲执行的处理函数的参数传入。(应该至少要有事件的名称)
参数项:
|
Observable | |
addListener
(
String eventName,
Function handler,
[Object scope],
[Object options]
)
为该组件加入事件处理函数(event handler)
sc...
为该组件加入事件处理函数(event handler)
处理函数执行时所在的作用域。处理函数“this”的上下文。 触发事件后开始执行处理函数的延时时间(invocation:the act of making a particular function start),单位:毫秒 true代表为下次事件触发加入一个要处理的处理函数,然后再移除本身。 不同配搭方式的选项 一次调用加入上多个处理函数(handlers) 或者是以简写的方式书写,前提是只允许同一个的作用域对象传入到所有的处理函数中:
参数项:
|
Observable | |
removeListener
(
String eventName,
Function handler,
[Object scope]
)
移除侦听器
移除侦听器
参数项:
|
Observable | |
|
purgeListeners
(
)
从这个对象身上移除所有的侦听器
从这个对象身上移除所有的侦听器
参数项:
|
Observable | |
addEvents
(
Object object
)
定义观察者的事件。
定义观察者的事件。
参数项:
|
Observable | |
hasListener
(
String eventName
)
: Boolean
查询该对象是否有指定事件的侦听器
查询该对象是否有指定事件的侦听器
参数项:
|
Observable | |
|
suspendEvents
(
)
暂停触发所有的事件(参阅#resumeEvents)
暂停触发所有的事件(参阅#resumeEvents)
参数项:
|
Observable | |
|
resumeEvents
(
)
重新触发事件(参阅{@link #suspendEvents})
重新触发事件(参阅{@link #suspendEvents})
参数项:
|
Observable | |
on
(
String eventName,
[Object scope],
Function handler,
[Object options]
)
为该元素添加事件处理函数(event handler),addLis...
为该元素添加事件处理函数(event handler),addListener的简写方式 @param {String} eventName 侦听事件的类型 @param {Object} scope (可选的) 执行处理函数的作用域 @param {Function} handler 事件涉及的方法 @param {Object} options (可选的)
参数项:
|
Observable | |
un
(
String eventName,
Function handler,
[Object scope]
)
移除侦听器 @param {String} eventName ...
移除侦听器 @param {String} eventName 侦听事件的类型 @param {Function} handler 事件涉及的方法 @param {Object} scope (可选的)处理函数的作用域
参数项:
|
Observable | |
capture
(
Observable o,
Function fn,
[Object scope]
)
开始捕捉特定的观察者。 在事件触发之前,所有的事件会以“事件名称+标...
开始捕捉特定的观察者。 在事件触发之前,所有的事件会以“事件名称+标准签名”的形式传入到函数(传入的参数是function类型)。 如果传入的函数执行后返回false,则接下的事件将不会触发。 @param {Observable} o 要捕捉的观察者 @param {Function} fn 要调用的函数 @param {Object} scope (可选的)函数作用域
参数项:
|
Observable | |
releaseCapture
(
Observable o
)
从Observable身上移除所有已加入的捕捉captures。 @...
从Observable身上移除所有已加入的捕捉captures。 @param {Observable} o 要释放的观察者
参数项:
|
Observable | |
| 事件 | 定义者 | |
|---|---|---|
clientvalidation
(
Ext.form.FormPanel this
)
If the monitorValid config option...
If the monitorValid config option is true, this event fires repetitively to notify of valid state 如果配置项monitorValid为true,那么为通知验证的状态(valid state)该事件将不断地触发。
参数项:
|
Form | |
beforeaction
(
Form this,
Action action
)
在任何动作被执行前被触发。如果返回假则取消这个动作
在任何动作被执行前被触发。如果返回假则取消这个动作
参数项:
|
BasicForm | |
actionfailed
(
Form this,
Action action
)
当动作失败时被触发。
当动作失败时被触发。
参数项:
|
BasicForm | |
actioncomplete
(
Form this,
Action action
)
当动作完成时被触发。
当动作完成时被触发。
参数项:
|
BasicForm | |