ctr.md

ngui/ctr

empty

• 这是一个常量空view xml，描述一个无子视图的View

isEmpty(vx)

• vx是否等于empty空视图数据

New(vx[,parent[,...args]])

New(vx[,...args])

• 通过vx描述数据创建视图或视图控制器

• @arg vx {Object} view xml描述数据
• @arg [parent] {View} 传入父视图时将新创建的视图加入到它的结尾
• @arg [...args] 视图的构造参数
• @ret {View|ViewController}

Example:

import { GUIApplication, ViewController, Root, Div } from 'ngui'
import 'ngui/http'
class MyCtr extends ViewController {
    loadView() {
        http.get('http://192.168.1.100:1026/README.md?param=' + this.message.param, bf=>{
            super.loadView(
                <Div width=100 height=100 backgroundColor="#f00">
                    ${bf.toString('utf8')}
                </Div>
            )
        })
    }
}
new GUIApplication().start(
    <Root>
        <ViewController vdata={ divWidth: 200, divCon: 'Hello' }>
            <Div width=%{vd.divWidth} height=100 backgroundColor="#000">
                %{vd.divCon}
            </Div>
        </ViewController>
        <MyCtr message={param:10} />
    </Root>
);

Class: ViewController

• extends Notification

视图控制器，与视图绑定后视图变成关键视图，当前控制器有可称为成员视图控制器，

关键视图下面所有后代视图以及子视图控制器都属于这个作用域中的成员，

成员视图的top属性都指向当前绑定的关键视图,成员视图的topCtr以及子视图控制器的parent都指向当前视图控制器，

如果这些成员有具名的id,可以通过当前视图控制器find(id)找到这些成员

ViewController.onLoadView

• 载入视图完成时触发

ViewController.onViewDataChange

• 视图数据变化时触发，如果有视图关注这个数据，那么它也会发生改变

ViewController.onRemoveView

• 绑定的视图从父视图删除时触发

ViewController.constructor([msg])

• 构造函数

• @arg [msg] {Object} 传入可选的消息对像

ViewController.find(id)

• 通过id查找成员视图或成员控制器

• @arg id {String}
• @ret {View|ViewController)

ViewController.message

• 控制器消息对像

• {Object}

ViewController.vdata

• 控制器视图数据

• {Object}

Get: ViewController.parent

• 获取父控制器

• {ViewController}

ViewController.view

• 获取或设置当前控制器绑定的视图

• {View}

ViewController.id

• 获取或设置一个id，这个id在同一个作用域中不能重复

• 可通过id在父视图控制器中查询子控制器

• {uint}

ViewController.loadView(vx)

• 通过vx数据载入视图，这是个相当重要的方法，所有gui视图载入创建以及视图数据的绑定都在这个方法中完成，

重写ViewController类与该方法来实现自定义组件。

• 这个方法调用完成会触发onloadView事件

• @arg vx {Object}

View proxy events

• 这些事件都为代理视图的快捷方式，需要绑定的视图支持这些事件

ViewController.onBack

ViewController.onClick

ViewController.onTouchstart

ViewController.onTouchmove

ViewController.onTouchend

ViewController.onTouchcancel

ViewController.onKeydown

ViewController.onKeypress

ViewController.onKeyup

ViewController.onKeyenter

ViewController.onFocus

ViewController.onBlur

ViewController.onHighlighted

ViewController.onFocusMove

ViewController.onScroll

ViewController.onActionKeyframe

ViewController.onActionLoop

ViewController.onWaitBuffer

ViewController.onReady

ViewController.onStartPlay

ViewController.onError

ViewController.onSourceEof

ViewController.onPause

ViewController.onResume

ViewController.onStop

ViewController.onSeek

View proxy methods and properties

• 代理视图的快捷方法与属性

ViewController.action

• --> View.action

ViewController.style

• --> View.style

ViewController.visible

• --> View.visible

ViewController.receive

• --> View.receive

ViewController.class

• --> View.class

ViewController.transition(style[,delay[,cb]])

ViewController.transition(style[,cb])

• --> View.transition()

ViewController.show()

• --> View.show()

ViewController.hide()

• --> View.hide()

ViewController.addClass(name)

• --> View.addClass()

ViewController.removeClass(name)

• --> View.removeClass()

ViewController.toggleClass(name)

• --> View.toggleClass()

ViewController.remove()

• --> View.remove()