AnnieJS API Docs for: 1.1.3
show:

annieUI.ScrollList Class

Defined in: libs/ScrollList.js:19
Module: annieUI

Available since 1.0.9

有些时候需要大量的有规则的滚动内容。这个时候就应该用到这个类了

Methods

_changeMouseCount

(
  • type
  • isAdd
)
private

Inherited from annie.EventDispatcher: libs/EventDispatcher.js:135

Available since 1.0.0

增加或删除相应mouse或touch侦听记数

Parameters:

_onDispatchBubbledEvent

(
  • type
  • updateMc
)
private

Inherited from annie.DisplayObject but overwritten in libs/Sprite.js:249

Available since 1.0.0

调用此方法对Sprite及其child触发一次指定事件

Parameters:

  • type String
  • updateMc Boolean

    是否更新movieClip时间轴信息

addChild

(
  • child
)
public

Inherited from annie.Sprite: libs/Sprite.js:84

Available since 1.0.0

添加一个显示对象到Sprite

Parameters:

addChildAt

(
  • child
  • index
)

Inherited from annie.Sprite: libs/Sprite.js:172

Available since 1.0.0

添加一个child到Sprite中并指定添加到哪个层级

Parameters:

addEventListener

(
  • type
  • listener
)
public

Inherited from annie.EventDispatcher: libs/EventDispatcher.js:107

Available since 1.0.0

给对象添加一个侦听

Parameters:

  • type String

    侦听类形

  • listener Function

    侦听后的回调方法,如果这个方法是类实例的方法,为了this引用的正确性,请在方法参数后加上.bind(this);

Example:

 this.addEventListener(annie.Event.ADD_TO_STAGE,function(e){trace(this);}.bind(this));

dispatchEvent

(
  • event
  • data
)
Boolean public

Inherited from annie.EventDispatcher: libs/EventDispatcher.js:154

Available since 1.0.0

广播侦听

Parameters:

  • event annie.Event | String

    广播所带的事件对象,如果传的是字符串则直接自动生成一个的事件对象,事件类型就是你传入进来的字符串的值

  • data Object

    广播后跟着事件一起传过去的其他任信息,默认值为null

Returns:

Boolean:

如果有收听者则返回true

Example:

 var mySprite=new annie.Sprite(),
     yourEvent=new annie.Event("yourCustomerEvent");
  yourEvent.data='Flash2x';
  mySprite.addEventListener("yourCustomerEvent",function(e){
     trace(e.data);
   })
  mySprite.dispatchEvent(yourEvent);

DisplayObject

() public

Inherited from annie.DisplayObject: libs/DisplayObject.js:27

Available since 1.0.0

getBounds

() Any public

Inherited from annie.DisplayObject but overwritten in libs/Sprite.js:418

Available since 1.0.0

重写getBounds

Returns:

Any:

getChildAt

(
  • index
)
annie.DisplayObject

Inherited from annie.Sprite: libs/Sprite.js:216

Available since 1.0.0

获取Sprite中指定层级一个child

Parameters:

getChildByName

(
  • name
  • isOnlyOne
  • isRecursive
)
Any public

Inherited from annie.Sprite: libs/Sprite.js:136

Available since 1.0.0

通过给displayObject设置的名字来获取一个child,可以使用正则匹配查找

Parameters:

  • name String
    对象的具体名字或是一个正则表达式
  • isOnlyOne Boolean
    默认为true,如果为true,只返回最先找到的对象,如果为false则会找到所有匹配的对象数组
  • isRecursive Boolean
    false,如果为true,则会递归查找下去,而不只是查找当前对象中的child,child里的child也会找,依此类推

Returns:

Any: 返回一个对象,或者一个对象数组,没有找到则返回空

getChildIndex

(
  • child
)
Number

Inherited from annie.Sprite: libs/Sprite.js:232

Available since 1.0.2

获取Sprite中一个child所在的层级索引,找到则返回索引数,未找到则返回-1

Parameters:

Returns:

getDrawRect

() annie.Rectangle public

Inherited from annie.DisplayObject: libs/DisplayObject.js:533

Available since 1.0.0

获取对象形变后外切矩形。 可以从这个方法中读取到此显示对象变形后x方向上的宽和y方向上的高

Returns:

getWH

() Width: number, height: number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:734

Available since 1.0.9

如果需要同时获取宽和高的值,建议使用此方法更有效率

Returns:

Width: number, height: number:

}

globalToLocal

(
  • point
)
annie.Point public

Inherited from annie.DisplayObject: libs/DisplayObject.js:417

Available since 1.0.0

将全局坐标转换到本地坐标值

Parameters:

Returns:

hasEventListener

(
  • type
)
Boolean public

Inherited from annie.EventDispatcher: libs/EventDispatcher.js:200

Available since 1.0.0

是否有添加过此类形的侦听

Parameters:

Returns:

Boolean:

如果有则返回true

hitTestPoint

(
  • globalPoint
  • isMouseEvent
)
Any public

Inherited from annie.DisplayObject but overwritten in libs/Sprite.js:360

Available since 1.0.0

重写碰撞测试

Parameters:

Returns:

Any:

localToGlobal

(
  • point
)
annie.Point public

Inherited from annie.DisplayObject: libs/DisplayObject.js:429

Available since 1.0.0

将本地坐标转换到全局坐标值

Parameters:

Returns:

removeAllChildren

() public

Inherited from annie.Sprite: libs/Sprite.js:294

Available since 1.0.0

移除Sprite上的所有child

removeAllEventListener

() public

Inherited from annie.EventDispatcher: libs/EventDispatcher.js:237

Available since 1.0.0

移除对象中所有的侦听

removeChild

(
  • child
)
public

Inherited from annie.Sprite: libs/Sprite.js:94

Available since 1.0.0

从Sprite中移除一个child

Parameters:

removeChildAt

(
  • index
)
public

Inherited from annie.Sprite: libs/Sprite.js:269

Available since 1.0.0

移除指定层级上的孩子

Parameters:

removeEventListener

(
  • type
  • listener
)
public

Inherited from annie.EventDispatcher: libs/EventDispatcher.js:214

Available since 1.0.0

移除对应类型的侦听

Parameters:

  • type String

    要移除的侦听类型

  • listener Function

    及侦听时绑定的回调方法

render

(
  • renderObj
)
public

Inherited from annie.DisplayObject but overwritten in libs/Sprite.js:466

Available since 1.0.0

重写渲染

Parameters:

  • renderObj annie.IRender

ScrollList

(
  • itemClassName
  • itemWidth
  • itemHeight
  • vW
  • vH
  • isVertical
  • cols
)

Defined in libs/ScrollList.js:28

Available since 1.0.9

构造函数

Parameters:

  • itemClassName Class

    可以做为Item的类

  • itemWidth Number

    item宽

  • itemHeight Number

    item高

  • vW Number

    列表的宽

  • vH Number

    列表的高

  • isVertical Boolean

    是横向滚动还是纵向滚动 默认是纵向

  • cols Number

    分几列,默认是1列

ScrollPage

(
  • vW
  • vH
  • maxDistance
  • isVertical
)
构造函数

Parameters:

  • vW Number
    可视区域宽
  • vH Number
    可视区域高
  • maxDistance Number
    最大滚动的长度
  • isVertical Boolean
    是纵向还是横向,也就是说是滚x还是滚y,默认值为沿y方向滚动

Example:

 s.sPage=new annieUI.ScrollPage(640,s.stage.viewRect.height,4943);
     s.addChild(s.sPage);
     s.sPage.view.addChild(new home.Content());
     s.sPage.y=s.stage.viewRect.y;
     s.sPage.mouseEnable=false;

测试链接

scrollTo

(
  • dis
  • time
)
public

Inherited from annieUI.ScrollPage: libs/ScrollPage.js:350

Available since 1.1.1

滚到指定的坐标位置

Parameters:

  • dis Number
    需要去到的位置
  • time Number
    滚动需要的时间 默认为0 即没有动画效果直接跳到指定页

setLoading

(
  • downLoading
)

Defined in libs/ScrollList.js:178

Available since 1.0.9

设置加载数据时显示的loading对象

Parameters:

setViewRect

(
  • w
  • h
  • isVertical
)
public

Inherited from annieUI.ScrollPage but overwritten in libs/ScrollList.js:130

Available since 1.1.1

设置可见区域,可见区域的坐标始终在本地坐标中0,0点位置

Parameters:

  • w Number

    设置可见区域的宽

  • h Number

    设置可见区域的高

  • isVertical Boolean

    方向

startDrag

(
  • isCenter
  • bounds
)
public

Inherited from annie.DisplayObject: libs/DisplayObject.js:448

Available since 1.1.2

启动鼠标或者触摸拖动

Parameters:

  • isCenter Boolean

    指定将可拖动的对象锁定到指针位置中心 (true),还是锁定到用户第一次单击该对象的位置 (false) 默认false

  • bounds annie.Rectangle

    相对于显圣对象父级的坐标的值,用于指定 Sprite 约束矩形

stopDrag

() public

Inherited from annie.DisplayObject: libs/DisplayObject.js:481

Available since 1.1.2

停止鼠标或者触摸拖动

update

(
  • isDrawUpdate
)
public

Inherited from annie.DisplayObject but overwritten in libs/Sprite.js:307

Available since 1.0.0

重写刷新

Parameters:

  • isDrawUpdate Object

    不是因为渲染目的而调用的更新,比如有些时候的强制刷新 默认为true

updateData

(
  • data
  • isReset
)

Defined in libs/ScrollList.js:74

Available since 1.0.9

更新列表数据

Parameters:

Properties

_enterFrameEvent

annie.Event private

Inherited from annie.DisplayObject: libs/DisplayObject.js:79

Available since 1.0.0

因为每次enterFrame事件时都生成一个Event非常浪费资源,所以做成一个全局的

Default: null

_MECO

Unknown private

Inherited from annie.EventDispatcher: libs/EventDispatcher.js:254

Available since 1.0.0

全局的鼠标事件的监听数对象表

_offsetX

Number protected

Inherited from annie.DisplayObject: libs/DisplayObject.js:165

Available since 1.0.0

Default: 0

_offsetY

Number protected

Inherited from annie.DisplayObject: libs/DisplayObject.js:173

Available since 1.0.0

Default: 0

_texture

Any protected

Inherited from annie.DisplayObject: libs/DisplayObject.js:156

Available since 1.0.0

缓存起来的纹理对象。最后真正送到渲染器去渲染的对象

Default: null

_UI

Unknown

更新信息

Sub-properties:

  • UM Object

    是否更新矩阵 UA 是否更新Alpha UF 是否更新滤镜

addSpeed

Number private

Inherited from annieUI.ScrollPage: libs/ScrollPage.js:130

Available since 1.0.0

加速度

alpha

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:278

Available since 1.0.0

显示对象透明度

Default: 1

anchorX

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:332

Available since 1.0.0

显示对象上x方向的缩放或旋转点

Default: 0

anchorY

Number

Inherited from annie.DisplayObject: libs/DisplayObject.js:350

Available since 1.0.0

显示对象上y方向的缩放或旋转点

Default: 0

autoScroll

Boolean private

Inherited from annieUI.ScrollPage: libs/ScrollPage.js:168

Available since 1.0.2

是否是通过scrollTo方法在滑动中

Default: false

blendMode

String public

Inherited from annie.DisplayObject: libs/DisplayObject.js:126

Available since 1.0.0

显示对象的混合模式 支持的混合模式大概有

Default: 0

cacheAsBitmap

Boolean public

Inherited from annie.Sprite: libs/Sprite.js:54

Available since 1.1.2

是否缓存为位图,注意一但缓存为位图,它的所有子级对象上的事件侦听都将无效

Default: false

cAlpha

Number private

Inherited from annie.DisplayObject: libs/DisplayObject.js:60

Available since 1.0.0

显示对象在显示列表上的最终表现出来的透明度,此透明度会继承父级的透明度依次相乘得到最终的值

Default: 1

cFilters

Array private

Inherited from annie.DisplayObject: libs/DisplayObject.js:97

Available since 1.0.0

显示对象上对显示列表上的最终的所有滤镜组

Default: []

children

Array public

Inherited from annie.Sprite: libs/Sprite.js:40

Available since 1.0.0

显示对象的child列表

Default: []

cMatrix

annie.Matrix private

Inherited from annie.DisplayObject: libs/DisplayObject.js:70

Available since 1.0.0

显示对象上对显示列表上的最终合成的矩阵,此矩阵会继承父级的显示属性依次相乘得到最终的值

Default: null

filters

Array public

Inherited from annie.DisplayObject: libs/DisplayObject.js:400

Available since 1.0.0

显示对象的滤镜数组

Default: null

fSpeed

Number public

Inherited from annieUI.ScrollPage: libs/ScrollPage.js:156

Available since 1.0.0

摩擦力,值越大,减速越快

Default: 20

height

Unknown public

Inherited from annie.DisplayObject: libs/DisplayObject.js:712

Available since 1.0.3

获取或者设置显示对象在父级里的y方向的高,不到必要不要用此属性获取高 如果你要同时获取款高,建议使用getWH()方法获取宽和高

instanceId

Unknown public

Inherited from annie.AObject: libs/EventDispatcher.js:28

Available since 1.0.0

每一个annie引擎对象都会有一个唯一的id码。

Example:

 //获取 annie引擎类对象唯一码
 trace(this.instanceId);

instanceType

Unknown public

Inherited from annie.AObject: libs/EventDispatcher.js:46

Available since 1.0.3

每一个annie类都有一个实例类型字符串,通过这个字符串,你能知道这个实例是从哪个类实例而来

isStop

Boolean public

Inherited from annieUI.ScrollPage: libs/ScrollPage.js:138

Available since 1.0.0

是否是停止滚动状态

Default: true

isVertical

Boolean private

Inherited from annieUI.ScrollPage: libs/ScrollPage.js:48

Available since 1.0.0

横向还是纵向 默认为纵向

Default: true

lastValue

Number private

Inherited from annieUI.ScrollPage: libs/ScrollPage.js:114

Available since 1.0.0

最后鼠标经过的坐标值

loadingView

Unknown

Defined in libs/ScrollList.js:62

Available since 1.0.9

获取下拉滚动的loadingView对象

mask

annie.DisplayObject public

Inherited from annie.DisplayObject: libs/DisplayObject.js:137

Available since 1.0.0

显示对象的遮罩, 是一个Shape显示对象或是一个只包含shape显示对象的MovieClip

Default: null

maskObj

annie.Shape private

Inherited from annieUI.ScrollPage: libs/ScrollPage.js:98

Available since 1.0.0

遮罩对象

matrix

annie.Matrix public

Inherited from annie.DisplayObject: libs/DisplayObject.js:384

Available since 1.0.0

显示对象的变形矩阵

Default: null

maxDistance

Number public

Inherited from annieUI.ScrollPage: libs/ScrollPage.js:76

Available since 1.0.0

整个滚动的最大距离值

Default: 1040

maxSpeed

Number public

Inherited from annieUI.ScrollPage: libs/ScrollPage.js:147

Available since 1.0.0

滚动的最大速度,直接影响一次滑动之后最长可以滚多远

Default: 100

mouseChildren

Boolean public

Inherited from annie.Sprite: libs/Sprite.js:30

Available since 1.0.0

是否可以让children接收鼠标事件,如果为false 鼠标事件将不会往下冒泡

Default: true

mouseEnable

Boolean public

Inherited from annie.DisplayObject: libs/DisplayObject.js:88

Available since 1.0.0

是否可以接受点击事件,如果设置为false,此显示对象将无法接收到点击事件

Default: false

name

String public

Inherited from annie.DisplayObject: libs/DisplayObject.js:106

Available since 1.0.0

每一个显示对象都可以给他启一个名字,这样我们在查找子级的时候就可以直接用this.getChildrndByName("name")获取到这个对象的引用

Default: ""

parent

annie.Sprite public

Inherited from annie.DisplayObject: libs/DisplayObject.js:50

Available since 1.0.0

显示对象的父级

Default: null

rotation

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:260

Available since 1.0.0

显示对象旋转角度

Default: 0

scaleX

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:224

Available since 1.0.0

显示对象x方向的缩放值

Default: 1

scaleY

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:242

Available since 1.0.0

显示对象y方向的缩放值

Default: 1

skewX

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:296

Available since 1.0.0

显示对象x方向的斜切值

Default: 0

skewY

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:314

Available since 1.0.0

显示对象y方向的斜切值

Default: 0

speed

Number protected

Inherited from annieUI.ScrollPage: libs/ScrollPage.js:122

Available since 1.0.0

速度

stage

Stage public

Inherited from annie.DisplayObject: libs/DisplayObject.js:40

Available since 1.0.0

此显示对象所在的舞台对象,如果此对象没有被添加到显示对象列表中,此对象为空。

Default: null;

view

annie.Sprite public

Inherited from annieUI.ScrollPage: libs/ScrollPage.js:106

Available since 1.0.0

真正的容器对象,所有滚动的内容都应该是添加到这个容器中

viewHeight

Number private

Inherited from annieUI.ScrollPage: libs/ScrollPage.js:66

Available since 1.0.0

可见区域的高

Default: 0

viewWidth

Number private

Inherited from annieUI.ScrollPage: libs/ScrollPage.js:57

Available since 1.0.0

可见区域的宽

Default: 0

visible

Boolean public

Inherited from annie.DisplayObject: libs/DisplayObject.js:368

Available since 1.0.0

显未对象是否可见

Default: 0

width

Unknown public

Inherited from annie.DisplayObject: libs/DisplayObject.js:689

Available since 1.0.3

获取或者设置显示对象在父级里的x方向的宽,不到必要不要用此属性获取高 如果你要同时获取款高,建议使用getWH()方法获取宽和高

x

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:187

Available since 1.0.0

显示对象位置x

Default: 0

y

Number public

Inherited from annie.DisplayObject: libs/DisplayObject.js:205

Available since 1.0.0

显示对象位置y

Default: 0

滚动距离

Number protected

Inherited from annieUI.ScrollPage: libs/ScrollPage.js:85

Available since 1.0.0

Default: 0