来源【1-5部分】:http://miamicoder.com/2012/how-to-create-a-sencha-touch-2-app-part-1/
在此系列中,我们将创建一个Sencha Touch 2版本的记事本应用,用来记录用户的笔记并存储在该运行设备上。在这个过程中,我们将深入一下几个区域:
- 建立一个Sencha Touch 应用的区块
- 如何实现一个应用多视图的导航栏
- 如何使用Sencha Touch表单元素编辑数据
- 如何利用列表视图呈现数据
- 如何使用HTML5本地存储保存数据
此系列的第一部分中,我们将定义该应用的特性,包括外观样式,我们将开始建立应用主窗口。
记事本应用的特性
我们希望该应用能够让用户可做以下事情:
- 创建笔记
- 编辑已存在的笔记
- 删除笔记
- 以列表方式显示当前设备上的笔记
- 通过浏览器sessions将此设备上的笔记持久化
应用的用户界面
该记事本应用的主界面将以列表形式显示已有记录。我们将次视图命名为NotesListContainer。此处是它的模型,描述了怎样利用Sencha Touch组件来构建。
正如你看到的,NoteListContainer 视图是一个Ext.Container组件,它集成了一个工具栏组件和一个列表组件。我们将把Ext.List组件作为一个独立的视图:NotesList视图。
第二屏NoteEditor视图,用户可以在此创建、编辑和删除记事。该视图就像如下模型:
该NoteEditor视图是一个Ext.form.Panel组件,它包含了一组工具栏和表单元素以编辑记录的属性。
同时,我们也需要一种在不同屏幕中导航的机制。由于每个Sencha Touch应用已启动变获取了一个Viewport,我们可以利用它来呈现NotesListContainer 和NoteEditor 视图,同时也可以利用它管理两视图间的导航:
该Viewport很适用于当前任务,它继承自Container类,默认全屏卡片布局,这正是我们所需要的。
一个Sencha Touch 应用在目录与文件上如何组织
我们已经定义好了应用的特性以及用户界面,接下来,我们将开始编写源代码,我们将如下组织源代码文件目录:
将文件放在NotesApp目录下,一并包含着该应用的启动代码(app.js中)。
我们同样需要一个app目录,其下放置controller,model,profile,store,view目录。程序中用的控制器、模型等将分别放置在对应的目录下。
index.html文件将启动该应用,此文件中,将包含Sench Touch框架。
01.
<!--<!DOCTYPE html>
02.
<html>
03.
<head>--> <!--Remove comments!-->
04.
<title>My Notes</title>
05.
<link href=
"../Lib/ST2/resources/css/sencha-touch.css"
rel=
"stylesheet"
type=
"text/css"
/>
06.
<script src=
"../Lib/ST2/sencha-touch-debug.js"
type=
"text/javascript"
></script>
07.
<script src=
"app.js"
type=
"text/javascript"
></script>
08.
<!--</head>
09.
<body>
10.
</body>
11.
</html>--> <!--Remove comments!-->
注意,我们将该框架文件防止在Lib/ST2文件夹下
创建一个Sencha Touch应用实例
第一步我们将在app.js中创建一个Sench Touch应用类的实例,如下定义一个应用实例:
1.
Ext.application({
2.
name:
"NotesApp"
,
3.
launch:
function
() {
4.
5.
console.log(
"App launch"
);
6.
}
7.
});
application()方法将在页面准备就绪后加载一个应用实例,它将使用给定的配置设置该应用。对我们而言,只是简单的给定了一个程序名、并定义了launch()函数。
application()函数有一个重要的作用就是出发Models,Views,Controllers,Stores和Profiles的加载。当我们定义好了相关部分的依赖,这些出发都将自动产生。在此教程中,我们将看到这一特性。
launch()函数当程序加载依赖以及实例化Controllers时被调用。
若我们在模拟器中进入此页面,将看到下面这些:
在Sencha Touch中继承类
我们已经了解,主屏幕将以列表形式展现已经缓存在设备中的记录列表。构建此屏,我们需要使用一个Container类的实例,该实例将集成一个工具栏和一个列表
首先,我们需要在view目录下创建NotesListContainer.js文件:
在此js文件中,我们将如下定义NotesListContainer 视图:
01.
Ext.define(
"NotesApp.view.NotesListContainer"
, {
02.
extend:
"Ext.Container"
,
03.
config: {
04.
items: [{
05.
xtype:
"toolbar"
,
06.
docked:
"top"
,
07.
title:
"My Notes"
,
08.
items: [{
09.
xtype:
"spacer"
10.
}, {
11.
xtype:
"button"
,
12.
text:
"New"
,
13.
ui:
"action"
,
14.
id:
"new-note-btn"
15.
}]
16.
}]
17.
}
18.
});
这里我们将使用Ext.define()来定义一个Ext.Container类的扩展,将在此视图中添加一个Toolbar实例,让其停靠在顶部,该Toolbar将依次包含一个New按钮,该按钮将激活NoteEditor视图来创建新的记事。
请注意我们如何将一个Spacer组件添加在该按钮之前。这能使New按钮放置于Toolbar的右端。同时,ui=“action”设置如何让该button拥有特别的外观样式,该设置定义了在该视图上的的button的默认样式。
在Sench Touch指定应用的依赖
在定义好NotesListContainer类后,是让程序注意到它的时候了。我们回到app.js文件,在application()函数中添加视图设置:
01.
Ext.application({
02.
name:
"NotesApp"
,
03.
views: [
"NotesListContainer"
],
04.
05.
launch:
function
() {
06.
07.
var
notesListContainer = Ext.create(
"NotesApp.view.NotesListContainer"
);
08.
Ext.Viewport.add(notesListContainer);
09.
}
10.
});
我们使用以下视图配置来通知程序在NoteListContainer视图上有一个依赖:
1.
views: [
"NotesListContainer"
]
该应用类默认models, views, controllers, stores 和 profiles放置在app/model, app/view, app/controller, app/store, 和 app/profile目录下。在此约定下,我们可以使用它们名称的后部分来定义models, views, controllers, stores 和profiles。如果我们使用了不同的目录结构,便需要指明它们的完整命名。
是时候看看这个视图的模样了。在模拟器中,你将看到类似下面的外观:
不错对吧,让我们继续构建Controller,我们需要一个Controller类来管理用户输入,模型修改,以及试图间的切换。
创建Sencha Touch 控制器
让我们先创建一个简单的Notes控制器类,将此类放置在Notes.js文件中,并将此文件放在controller目录下:
如下为Controller定义:
01.
Ext.define(
"NotesApp.controller.Notes"
, {
02.
extend:
"Ext.app.Controller"
,
03.
launch:
function
() {
04.
this
.callParent();
05.
console.log(
"launch"
);
06.
},
07.
init:
function
() {
08.
this
.callParent();
09.
console.log(
"init"
);
10.
}
11.
});
控制器包含一些方法,如init()与launch(),这些方法将在应用处理的不同时刻运行。init()将在应用运行launch()函数钱调用,而控制器的launch()函数将在应用运行launch()后调用。
在控制器设置中添加相关依赖使得程序能识别到Notes控制器类:
01.
Ext.application({
02.
name:
"NotesApp"
,
03.
controllers: [
"Notes"
],
04.
views: [
"NotesListContainer"
],
05.
06.
launch:
function
() {
07.
08.
var
notesListContainer = Ext.create(
"NotesApp.view.NotesListContainer"
);
09.
Ext.Viewport.add(notesListContainer);
10.
}
11.
});
众所周知,在控制器设置中添加Notes Controller Class将使得应用自动实例化该控制器并保持对它的引用。
如何处理Sencha Touch控制器中的视图事件
我们已经创建好了控制器,准备好向其添加特性。首先Notes控制器需要的是处理New按钮的点击。我们可以通过如下代码修改控制器定义来完成此功能:
01.
Ext.define(
"NotesApp.controller.Notes"
, {
02.
extend:
"Ext.app.Controller"
,
03.
config: {
04.
refs: {
05.
newNoteBtn:
"#new-note-btn"
06.
},
07.
control: {
08.
newNoteBtn: {
09.
tap:
"onNewNote"
10.
}
11.
}
12.
},
13.
onNewNote:
function
() {
14.
console.log(
"onNewNote"
);
15.
}
16.
17.
// init and launch functions omitted.
18.
});
看到变化了吗?是的,就在refs与control设置上。他们是控制器引用其他组件的机制基础,并为他们定义事件处理。
refs 是的控制器能够找到应用中的组件,使用ComponetQuery类的类似于样式选择器的语法来检索组件。
在Notes Controller中,我们使用newNoteBtn ref来创建一个id为#new-note-btn组件的应用,这便是New按钮。
1.
refs: {
2.
newNoteBtn:
"#new-note-btn"
3.
}
基于次ref,框架将生成一个getter函数让我们能够随时获取该New按钮。Ref- 衍生的getter方法将以如下简单格式命名,它由get与大些名字组成,该函数名即为getNewNoteBtn()。
Refs同时能在某组件应用不存在的情况下实例化次组件。即使在本代码中我们并未采用此方法,当时建议研究一下次特性。
control设置项定义了应用组件的事件处理,可使用refs或ComponentQuery选择器定义control中的时间处理。在Notes Controller中,我们使用newNoteBtn来定义New按钮的单击处理:
1.
control: {
2.
newNoteBtn: {
3.
tap:
"onNewNote"
4.
}
5.
}
很明显,我们需要定义处理函数,我们将在Controller的代码中做进一步的工作:
1.
onNewNote:
function
() {
2.
console.log(
"onNewNote"
);
3.
}
onNewNote()函数只是简单的信息输出到控制台而已,不久我们就会添加打开NoteEditor视图的代码。
在模拟器中检查程序,如果单击New按钮,将会输出一条消息。
如果你的控制器需要处理某个组件的特定事件,你可以参考一下步骤:
为组件创建引用(ref)
在控制器的control 设置中为ref创建实体
使用该control设置中的实体指定你感兴趣的时间处理方法
下一步
到这里我们将结束教程的第一部分,让我们再次回顾一下我们已经做的。
在定义好特性与用户界面后,我们开始熟悉sench Touch是如何工作原理,我们学习了如何我app创建目录和应用程序类实例。
我们穿件了主界面的第一个版本,命名为NotesListContainer,并且开始为Notes Conroller与程序的其它部分交互做了一些工作。
在下一章中,我们将继续对应用的主界面与它的子元素进行开发,我们需要创建一个List来显示存储在设备中的记事。
下载
源代码下载地址:NotesApp-1.zip
译者: bluishoul
翻译自:http://miamicoder.com/2012/how-to-create-a-sencha-touch-2-app-part-1/
转自: http://www.oschina.net/question/89964_38791