Sencha Touch(为方便起见,本文后面一律简写为ST)页面的开发跟普通html页面相比,总体来说没有本质上的区别,只是引入了对html5和CSS3的支持,然后提供了对移动设备(iPad/iPhone/Android Mobile/Android Tablet/BlackBerry等)的特殊优化。事实上也正是因为html5和CSS3才使得ST可以实现如此美妙以至于可以媲美Native应用程序的交互效果。
ST页面的Document标记比较特殊,在html标签之前,使用如下标签来声明此文档是html5格式:
<!DOCTYPE html>
<link rel="stylesheet" href="sencha-touch.css" type="text/css"> <script type="text/javascript" src="sencha-touch.js"></script>
需要注意的是,除sencha-touch.css外,ST提供了android.css/apple.css/bb6.css等三个css文件,分别对应android风格/apple风格/黑莓6三种不同的Theme,引用不同的css文件即可实现页面Theme的切换。
引入公共文件之后,当然就要编写自己应用程序的脚本了,如我们在大多数ST应用的例子中所见,通常情况下,应用程序脚本是写在单独的js文件中进行调用的(好处可以参见.net编程中code-behind和code-beside的对比),因此,一个常见的ST文档往往大致是这个模样:
<!DOCTYPE html> <html> <head> <title>Hello World</title> <script src="sencha-touch.js" type="text/javascript"></script> <script src="app.js" type="text/javascript"></script> <link href="sencha-touch.css" rel="stylesheet" type="text/css" /> </head> <body></body> </html>
通过我们对官网SDK中的Examples和同样出自官网的quick start代码进行分析,发现ST应用首页的js脚本(可以理解为启动程序)常用编写方式有两种:
A、Examples中采用的 —— Ext.setup方式
//使用setup来启动主程序 Ext.setup({ tabletStartupScreen: 'tablet_startup.png', //tablet设备时主屏中间出现的背景图片 phoneStartupScreen: 'phone_startup.png', //phone设备时主屏中间出现的背景图片 icon: 'icon.png', glossOnIcon: false, //跟Extjs一样,主程序代码卸载onReady里面 onReady: function(options) { //TODO } });
B、quick start中采用的 —— Ext.Application方式
new Ext.Application({ launch: function() { //TODO } });
由于这里我们只关注ST应用的启动代码,所以具体界面实现代码省略。对于上述两种方式的区别,鄙人暂时无力进行解读,欢迎高手指教。
我们知道,既然ST是专为移动设备而设计,那么在我们的应用第一次被访问的时候,判断客户端设备的类型是非常重要的,在ST中,我们可以这样判断:
if (Ext.is.Phone) { //所有手机设备 } if (Ext.is.Android) { //所有Android设备 } if (Ext.is.BlackBerry) { //黑莓手机 } if (Ext.is.iPad) { //iPad平板电脑 } ……
当然关于设备类型还有很多其他判断属性,你可以参照ST的文档说明http://docs.sencha.com/touch/1-1/#!/api/Ext.is
好了,几个前提问题基本解决,现在我们尝试写一个比HelloWorld更复杂一些的启动页面,来找一找成就感。先看原型图:
非常简单的一个登陆界面,我们确定使用apple风格的theme,使之更贴近Native的感觉。注:此例只考虑界面的实现,因此使用Ext.Panel控件进行布局设计。
下面对实现代码按照步步深入的方式进行一下分解说明:
//第一步:放置一个Ext.Panel,使之充满屏幕 Ext.setup({ icon: 'icon.png', tabletStartupScreen: 'tablet_startup.png', phoneStartupScreen: 'phone_startup.png', glossOnIcon: false, onReady: function() { //判断是否是手机设备,只有手机设备才使用此布局 if (Ext.is.Phone) { new Ext.Panel({ //使用一个Panel来填满屏幕 fullscreen: true, //是否全屏,选择true则横竖屏切换时仍可以保证自动适应尺寸 id: 'content', scroll: 'vertical', //滚动方向 html: '这里放置内容', //Panel里面放置的内容 layout: {type: 'vbox', align: 'center'}, //布局方式,vbox纵向布局,且每行内容居中 items: [], //这里放置容器内部的子元素 dockedItems: [] //这里放置Panel本身所拥有的dock元素(你可以理解为自带工具栏) }); } } });
现在只有一个空容器充满屏幕,里面显示了几个汉字,看演示效果(Android 2.3,下同)
//第二步:给Panel添加一个顶部工具栏,用来显示程序标题 Ext.setup({ icon: 'icon.png', tabletStartupScreen: 'tablet_startup.png', phoneStartupScreen: 'phone_startup.png', glossOnIcon: false, onReady: function() { //判断是否是手机设备,只有手机设备才使用此布局 if (Ext.is.Phone) { new Ext.Panel({ fullscreen: true, id: 'content', scroll: 'vertical', layout: {type: 'vbox', align: 'center'}, html: '这里放置内容', items: [], //前面我们说过,Panel自带的工具栏要放置在dockedItems里面 //现在我们添加顶部的工具栏 dockedItems: [ { id: 'status', //给他一个ID xtype: 'toolbar', //xtype类型是toolbar,完整的xtype枚举见这里http://docs.sencha.com/touch/1-1/#!/api/Ext.Component ui: 'light', //light表示浅色的背景图案 dock: 'top', //工具栏放置在最顶部 title: "Sencha Touch Demo" //工具栏的标题 } ] }); } } });
效果图显示,我们已经有了一个顶部工具栏,显示应用程序的名称
//第三步:给Panel添加底部工具栏 Ext.setup({ icon: 'icon.png', tabletStartupScreen: 'tablet_startup.png', phoneStartupScreen: 'phone_startup.png', glossOnIcon: false, onReady: function() { //判断是否是手机设备,只有手机设备才使用此布局 if (Ext.is.Phone) { new Ext.Panel({ fullscreen: true, id: 'content', scroll: 'vertical', layout: {type: 'vbox', align: 'center'}, html: '这里放置内容', items: [], dockedItems: [ //这里是刚才的顶部工具栏 { id: 'status', xtype: 'toolbar', ui: 'light', dock: 'top', title: "Sencha Touch Demo" }, //这里是新增加的底部工具栏 { xtype: 'toolbar', dock: 'bottom', //在这里声明工具栏附着在底部 ui: 'dark', //深色背景图案 //又看到了items,显然ST的items是可以嵌套的,好吧,我们一口气把这个工具栏上的按钮也给加上 items: [ { xtype: 'button', //左侧一个button ui: 'drastic', //drastic是button的颜色和样式定义 text: '忘记密码' //不解释 }, {xtype: 'spacer'}, //这个需要解释一下,spacer会自动充满剩余空间 { xtype: 'button', //最右侧的button ui: 'action', //action样式是蓝色 text: '注册使用' } ] } ] }); } } });
现在看起来更像样一些了,底部工具栏也已经齐备
//第四步:顶部底部工具栏都已经ok,现在我们要给Panel添加内容 //回头看一下原型图,我们需要再Panel内部自上到下放置一个logo图片和一个表单 //表单包含了账号和密码两个文本框,其中密码是掩码框,然后是一个登录按钮和一个链接 Ext.setup({ icon: 'icon.png', tabletStartupScreen: 'tablet_startup.png', phoneStartupScreen: 'phone_startup.png', glossOnIcon: false, onReady: function() { //判断是否是手机设备,只有手机设备才使用此布局 if (Ext.is.Phone) { new Ext.Panel({ fullscreen: true, id: 'content', scroll: 'vertical', layout: {type: 'vbox', align: 'center'}, //由于使用items设计Panel的内部元素,所以把html属性注掉 //其实不注也不会出错,html的内容会被显示在最底部 //html: '这里放置内容', items: [ //从上往下第一个元素,logo图片 { xtype: 'container', //使用普通的Container容器即可 height: 98, //高度要跟图片尺寸相适应,由于我在下面html代码中给图片加了16px的margin-top,所以Container高度设置成图片高度+16,防止图片显示不完整 width: 96, //图片的宽度 html: '<img src="logo.png" style="margin-top: 16px;" />' //直接设定html代码来显示图片,注意有16像素的顶部margin }, //从上往下第二个元素,form表单 { xtype: 'form', //xtype为form id: 'loginForm', //为便于操作form,给它一个id //表单内有不止一个元素,因此又要给它添加items items: [ { xtype: 'fieldset', //加一个fieldset,可以将两个文本框放在一个圆角域组里面,更美观 margin: '-2 0 16 0', //使用margin调整与上面元素和下面元素之间的空隙 //fieldset里面包含两个文本框 items: [ { xtype: 'textfield', //第一个文本框 name: 'account', //name用来获取值 placeHolder: '您的账号', //默认显示在文本框里的文字,点击和输入时它会消失 required: true, //必填字段 useClearIcon: true //输入内容后文本框后面会出现一个清空按钮 }, { xtype: 'passwordfield', //密码文本框 name: 'password', placeHolder: '您的密码', required: true, useClearIcon: true } ] }, //提交按钮,放在fieldset外面是为了使之与fieldset等宽 { xtype: 'button', text: '登录STDEMO', ui: 'confirm' //绿色按钮 }, //再用一个Container来放置链接文字 { xtype: 'container', html: '<div style="width: 100%; text-align: center;"><a style="font-size: 14px; color: blue;">需要合作?请联系我们……</a></div>', margin: '16 0 0 0' } ] } ], dockedItems: [ { id: 'status', xtype: 'toolbar', ui: 'light', dock: 'top', title: "Sencha Touch Demo" }, { xtype: 'toolbar', dock: 'bottom', ui: 'dark', items: [ { xtype: 'button', ui: 'drastic', text: '忘记密码' }, {xtype: 'spacer'}, { xtype: 'button', ui: 'action', text: '注册使用' } ] } ] }); } } });
显然这是最复杂的一步,不过只要学得耐心点,一样不成问题
到目前为止,我们的设计意图已经实现,最下面的链接由于屏幕高度问题被盖住了,向上拖动即可显示出来。最后再来一个全屏的效果:
怎么样?还不错吧,是不是很有Native的感觉?如果你喜欢的话,我们还可以换换Theme来看看。
上面这个是Sencha Touch风格
这个是Android风格
这个是BlackBerry6风格。