$colacola.AbstractButtoncola.AbstractCheckboxcola.AbstractContainercola.AbstractDropdowncola.AbstractEditorcola.AbstractInputcola.AbstractItemGroupcola.AbstractListcola.AbstractMenuItemcola.AbstractSlotListcola.AjaxValidatorcola.AsyncValidatorcola.Avatarcola.Breadcrumbcola.Buttoncola.ButtonGroupcola.Calendarcola.CardBookcola.Carouselcola.CascadeBindcola.Checkboxcola.ControlMenuItemcola.Cornercola.CustomDropdowncola.CustomValidatorcola.DataTypecola.DatePickercola.DateTimePickercola.Dialogcola.Dividercola.Dropdowncola.DropdownMenuItemcola.Elementcola.EmailValidatorcola.Entitycola.EntityDataTypecola.EntityListcola.FieldSetcola.GroupBoxcola.HeaderMenuItemcola.IFramecola.Imagecola.Inputcola.ItemsViewcola.Labelcola.Layercola.LengthValidatorcola.Linkcola.ListViewcola.Menucola.MenuButtoncola.MenuItemcola.Modelcola.MultiSlotPickercola.NestedListcola.NestedListBindcola.NestedListNodecola.Nodecola.NumberValidatorcola.Panelcola.PointingLabelcola.Progresscola.Propertycola.Providercola.RadioButtoncola.RadioGroupcola.RangeSlotListcola.Ratingcola.RegExpValidatorcola.RenderableElementcola.RequiredValidatorcola.Revealcola.Ribboncola.Segmentcola.Selectcola.Sidebarcola.Slidercola.SlotListcola.SplitPanecola.Stackcola.Stepscola.Tabcola.TabButtoncola.Tablecola.TableColumncola.TableContentColumncola.TableDataColumncola.TableGroupColumncola.TableSelectColumncola.Tagcola.TimeLinecola.TitleBarcola.Togglecola.Treecola.TreeNodecola.TreeNodeBindcola.UrlValidatorcola.Validatorcola.Widgetcola.breadcrumb.Sectioncola.buttonGroup.Separatorcola.steps.Stepcola.tab.AbstractTabButtoncola.utilcola.util.KeyedArray

cola.Entity

数据实体

state
string
数据实体的状态
该状态目前有四种可能的取值:
  • none - 无状态
  • new - 新增状态
  • modified - 被修改状态
  • deleted - 被删除状态
参考: setState(state)
dataType
cola.EntityDataType
数据类型
hasValue判断某属性中是否有值cola.Entity
Parameters:
  • propstring

    属性名

Returns:boolean
get获取一个属性的值cola.Entity
Parameters:
  • propstring

    属性名或路径

  • loadModestring | function | Object

    该装载模式目前有四种可能的取值:

    • async - 异步装载模式
    • sync - 同步装载模式
    • never - 不装载
    • 传入一个回调方法或一个回调对象,相当于按照异步模式装载,同时定义了该异步操作的回调方法或回调对象。 回调对象的定义请参考: 回调对象

Returns:any
当一个属性的值是懒装载的,那么在我们通过get()方法尝试从此属性中读取内容时,Cola会利用loadMode参数的值来确定要如何来装载尚未装载的数据。
set设置一个属性的值cola.Entity
Parameters:
  • namestring

    属性名或路径

  • valueany

    数据

Returns:cola.Entity
set设置一批属性的值cola.Entity
Parameters:
  • datajson

    以JSON方式定义的一批属性值

Returns:cola.Entity
remove删除当前数据实体。cola.Entity
Returns:cola.Entity
如果这个数据实体此时是另一个父Entity的某属性值,或者它正隶属于某个EntityList。
那么,此操作也会将此数据实体从父Entity或EntityList中移除。
createChild在某个属性中创建一个新的子Entity并返回。cola.Entity
Parameters:
  • propstring

    属性名

  • datajson

    以JSON方式定义的一批属性值,用于初始化新Entity中的数据。此参数可省略。

Returns:cola.Entity
如果之前已经通过DataType声明了相应子属性的DataType,那么新创建的子Entity将是与该DataTypre匹配的。
createBrother创建一个兄弟Entity并返回。cola.Entity
Parameters:
  • datajson

    以JSON方式定义的一批属性值,用于初始化新Entity中的数据。此参数可省略。

Returns:cola.Entity
此方法首先会创建一个与当前Entity类型相同的新Entity,如果当前Entity隶属于某个EntityList,那么新创建的Entity还会被自动添加到EntityList中。
setState设置数据实体的状态cola.Entity
Parameters:
  • statestring

Returns:cola.Entity
该状态有四种取值:
  • none - 无状态
  • new - 新增状态
  • modified - 被修改状态
  • deleted - 被删除状态
参考: state
getOldValue返回某属性的旧值cola.Entity
Parameters:
  • propstring

    属性名

Returns:any
即返回某属性修改之前的值。如果当前Entity并不处于modified状态,那么此方法将返回undefined。
reset重置某个属性或整个Entitycola.Entity
Parameters:
  • propstring

    属性名

Returns:cola.Entity
如果定义了prop参数,那么此方法会清除该属性的值和相关的校验信息,但此种清除并不会导致Entity的状态发生改变。
如果没有定义prop参数,那么此方法会清除整个Entity中的所有数据和校验信息并重置整个Entity的状态。
resetState清除所有校验信息并重置整个Entity的状态cola.Entity
Returns:cola.Entity
getDataType根据路径查找并返回DataType。cola.Entity
Parameters:
  • pathstring

    属性名或路径

Returns:cola.DataType
如果没有定义path参数,那么此方法会直接返回当前Entity的DataType。
如果定义了path参数,那么此方法会根据这个路径返回相应子属性或子对象的DataType。
getPath返回当前Entity的数据路径cola.Entity
Returns:string
flush刷新某个属性的数据cola.Entity
Parameters:
  • propstring

    属性名

  • loadModestring | function | Object

    该装载模式目前有四种可能的取值:

    • async - 异步装载模式
    • sync - 同步装载模式
    • never - 不装载
    • 传入一个回调方法或一个回调对象,相当于按照异步模式装载,同时定义了该异步操作的回调方法或回调对象。 回调对象的定义请参考: 回调对象

Returns:cola.Entity
此方法只有在该属性的数据是通过cola.Provider获取的情况下是有效的,即通知Cola清空该属性的数据并重新利用Provider获取。
disableObservers将禁止Entity向观察者发送消息cola.Entity
Returns:cola.Entity
参考 cola.Model.disableObservers()
enableObservers将禁止Entity向观察者发送消息cola.Entity
Returns:cola.Entity
参考 cola.Model.disableObservers()
notifyObservers将禁止Entity向观察者发送消息cola.Entity
Returns:cola.Entity
参考 cola.Model.disableObservers()
validate校验当前Entity中的数据并返回是否校验通过cola.Entity
Parameters:
  • propstring

    属性名

Returns:boolean
如果定义了属性名,那么此方法只校验指定的属性,否则将校验每一个属性。
toJSON将Entity转换成一个JSON对象cola.Entity
Parameters:
  • optionsjson

    选项

Returns:json