首页 > 代码库 > [iOS] 用 Swift 开发一个 TODO 应用

[iOS] 用 Swift 开发一个 TODO 应用




背景

相信不少 iOS 程序员对于 Swift 依旧持以观望的态度,一来是这小家伙刚出来没几天,本身还处于完善的阶段;二来是学习的成本较高,看完官方文档怎么也要个几天的时间;三来是反正最近几年很难在工程项目里推广使用,工作又用不到,那我学个锤子呐。

是的,我一开始也是这么想的。直到有一天,我遇到了它:Swift Tutorial - To Do List App。这是 YouTube 上的一个很好地视屏教程,手把手教你如何完成一个 TODO 的应用,功能很简单,就是添加任务和浏览任务。将视屏内容整理了一下。虽然没有什么高深的内容,但是作为一个入门的小程序还是挺适合的。

适用人群:有一定 Objective-C 的开发基础但是还没怎么接触 Swift 不过装有 Xcode6 想感受一下的 iOS 开发者。

客官,都看到这里了,何不打开 Xcode6 耍两把?玩一玩噻!来吧。来嘛!

需求

我们想做一个很简单的小东西,和官网的 Demo 一样,是一个 TODO 列表 (TODO:待办事项) ,具有以下功能:

  • 有一个列表显示 TODO
  • 有一个页面添加 TODO
  • 点击添加按钮,在列表显示新的 TODO 列表

揍是这么简单,让我们开始吧!

新建项目

新建一个项目,选择 Tabbed Application 模板,项目名称为:MyTodoList。记得选中 Swift 作为开发语言。Xcode 会创建一个 Swift 的项目:

添加管理类

我们需要的第一个类是一个 TodoList 的管理器,用来存储 TODO 列表的数据,进行一些增删改查的基本操作。我们将其命名为 TodoManager 。

在左侧文件夹上右击,选择 New File,选择 Cocoa Class ,类名为 TodoManager ,继承自 NSObject , Xcode 会自动为我们添加一个 TodoManager.swift 文件。

我们在 Swift 里定义的变量和函数都是全局属性的,这样我们可以在类的外面定义一个 TodoManager 的对象todoManager,简单的实现了单例模式:

import UIKit

var todoManager : TodoManager = TodoManager ()

class TodoManager: NSObject {

}

接下来定义一个结构体 (struct) 来表示一个 TODO 项,它有两个属性,一个是任务名称,一个是任务描述:

struct todo {
    var name = "Un-Named"
    var desc = "Un-Described"
}

在 TodoManager 里面添加一个 todos 数组,用来存储所有的任务:

class TodoManager: NSObject {

    var todos = [todo]()

}

最后定义一个方法 addTask ,用来添加任务:

class TodoManager: NSObject {

    var todos = [todo]()

    func addTask(name: String, desc: String) {
        todos.append(todo(name: name, desc: desc))
    }

}

OK,这样 TodoManager 就算基本完成了。

开发界面

回到 StoryBoard ,我们把页面上系统自动生成的内容 (几个Label) 删除:

然后加个 UITableView 到 FirstViewController 上:

选中 Tab Bar ,可以编辑 Tab Bar 的显示名称和图片:

接下来看下 Second View 。把第二个 Tab Bar 的 Title 改成 Add :

这样基本的页面就算是搞定了。

数据显示

First View Controller

在第一个 Tab 下,将鼠标移到 UITableView 上,按住鼠标右键拖动到 View Controller 上,选择 DataSource 和 Delegate :

回到代码里,打开 FirstViewController.swift 文件,添加 UITableViewDelegate 和 UITableViewDataSource 这两个协议。按住 Command 键点击协议名称可以查看协议的声明,从而知道需要实现那些方法。方法名称和 OC 中的完全相同,只需要转换成 Swift的语法即可。完成之后的 FirstViewController 是这个样子:

class FirstViewController: UIViewController, UITableViewDelegate, UITableViewDataSource
{

    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view, typically from a nib.
    }

    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
        // Dispose of any resources that can be recreated.
    }


    // UITableView DataSource
    func tableView(tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        return todoManager.todos.count;
    }


    func tableView(tableView: UITableView, cellForRowAtIndexPath indexPath: NSIndexPath) -> UITableViewCell {
        let cell: UITableViewCell = UITableViewCell(style: UITableViewCellStyle.Subtitle, reuseIdentifier: "Default")

        cell.textLabel?.text = todoManager.todos[indexPath.row].name
        cell.detailTextLabel?.text = todoManager.todos[indexPath.row].desc

        return cell
    }


}

Second View Controller

拖拽一些控件搭建下基本的框架,一个 Label 作为标题,两个 TextField 分别填写 TODO 的名称和描述,然后再加上添加按钮,基本的框架时候是这个样子的:

然后我们把这两个 TextField 的 Delegate 都指向 View Controller ,因为我们希望在我们输入完成点击 Return 之后,键盘会自动弹回去。在 SecondViewController.swift 里面添加 UITextFieldDelegate 并实现 textFieldShouldReturn 委托方法,在方法里,通过 resignFirstResponder 把键盘弹回去:

// UITextField Delegate
func textFieldShouldReturn(textField: UITextField) -> Bool {
    textField.resignFirstResponder()
    return true
}

我们希望用户在点击背景图片的时候就可以把键盘收回来,我们可以重写 touchsBegan 方法,在里面加上 endEditing方法:

override func touchesBegan(touches: NSSet, withEvent event: UIEvent) {
    self.view.endEditing(true)
}

定义两个属性来获取文本框中的值,切换到 Assistant 视图,通过鼠标右键拖拽新建两个变量:

然后我们再新建一个 IBAction ,用来处理 Add 按钮的点击事件:

在点击事件里,我们希望完成以下任务:

  • 在 todoManager 里面添加一个 TODO 项
  • 把键盘收起
  • 清空 TextField 中的内容
  • TabBar 切换到 TODO 那个标签下,即时查看结果

OK完成之后的 addBtnClick 方法如下:

@IBAction func addBtnClick(sender: AnyObject) {
    todoManager.addTask(todoText.text, desc: descText.text)
    self.view.endEditing(true)
    todoText.text = ""
    descText.text = ""
    self.tabBarController?.selectedIndex = 0
}

这样,添加 TODO 的任务就完成了。

删除数据

删除数据和 Objective-C 版本的接口是完全一样的,通过 commitEditingStyle 方法实现。打开 FirstViewController.swift 文件,先在代码中添加一个 TableView 的属性,方便我们刷新数据:

删除其实也就是删除掉 todoManager 的 todos 数组里面的对应数据而已,我们可以用 removeAtIndex 实现,记得reloadData 刷新 TableView:

func tableView(tableView: UITableView, commitEditingStyle editingStyle: UITableViewCellEditingStyle, forRowAtIndexPath indexPath: NSIndexPath) {
    if(editingStyle == UITableViewCellEditingStyle.Delete) {
        todoManager.todos.removeAtIndex(indexPath.row)
    }

    todoTableView.reloadData()
}

测试

基本的开发工作到此就结束啦,我们可以运行应用跑跑看。

首先添加一个 TODO:

点击 Add 之后可以看到 TableView 里已经有了添加的 TODO 项:

滑动可以看到删除按钮:

点击删除,删除成功:

小结

不知道各位看到这里感觉如何,反正我感觉:水爆了!也没什么深奥的技术点,也没什么创新的东西,就是一个中规中矩的小应用而已。

是的,确实这样。不过希望通过这样一个简单的例子可以和大家一起熟悉一下 Swift ,熟悉一下这个新来的小伙伴^_^

完整的项目源码可以点击这里下载。玩的开心。


[iOS] 用 Swift 开发一个 TODO 应用