React Native基础&入门教程:以一个To Do List小例子,看props和state

本文由葡萄城技术团队于博客园原创并首发

转载请注明出处:葡萄城官网,葡萄城为开发者提供专业的开发工具、解决方案和服务,赋能开发者。

在上篇中,我们介绍了什么是Flexbox布局,以及如何使用Flexbox布局。还没有看过的小伙伴欢迎回到文章列表点击查看之前的文章了解。

那么,当我们有了基本的布局概念之后,就可以做一些有意思的尝试了。不过,它们会有一个美中不足:只是静静地呆在那里,不接受反馈。换句话说,它们从应用开始到结束,只有一种状态。

注意,上面这句话其实包含了RN中(当然同时也是React中)两个非常重要的概念:

  • 第一,“从应用开始到结束”,意味着它在时间上有一段生命周期(Life Cycle)
  • 第二,应用其实可以拥有很多种状态(State),比如,正常时是一种状态,出错时是另一种状态。而且这些状态能够在某些条件下进行转换。

基本概念:

在RN中,界面的变化对应着程序状态的变化。或者说,界面的变化,正是因为应用的状态发生了转换而导致的。应用的状态主要由两个变量决定,props和state,它们可以存在于继承自React.Component的每一个组件中。state由组件自身定义,用来管理组件及其子组件的状态。而props来自于父组件,在本组件中相当于常量,它的改变方式只能来自于父组件。

在RN中,界面的变化对应着程序状态的变化。或者说,界面的变化,正是因为应用的状态发生了转换而导致的。应用的状态主要由两个变量决定,props和state,它们可以存在于继承自React.Component的每一个组件中。state由组件自身定义,用来管理组件及其子组件的状态。而props来自于父组件,在本组件中相当于常量,它的改变方式只能来自于父组件。

state和props都不允许手动地直接设值。像this.state.a = 1或者this.props.b = 2这种代码是会报错的。要改变state,只能是在本组件中调用this.setState方法。而要改变props,只能依赖于它的值在传下来之前,已经在其父组件中被改变。

既然在组件中,state属性无论从字面含义还是程序语义上,都是用来表示状态的,那么为什么还需要一个props属性呢?

我的理解主要有两个原因。

第一,因为有些组件其实是“无状态”的。它们只是接受父组件传给它们的东西,然后老老实实把它们渲染出来。它们自己内部不保存任何状态,它们只是对父组件状态的反应。或者说:“它们不生产状态,它们只是父组件状态的显示器。”父组件的状态通过props传递给子组件。我们经常会构造这种无状态的组件,因为它职责单一,封装性好,可作为更复杂组件的基石。

第二,由于父组件与子组件之间往往需要联动,props就是最直接的提供联动的手段。父组件中构造子组件时,就像函数调用的传参一样,把需要的东西传给子组件的props。

state和props的重要特点是,默认情况下。当它们改变时,RN会自动东西渲染与之相关的界面以保持和state与props同步。为什么说“默认情况下”,是因为我们可以利用生命周期函数手动“截断”这个渲染逻辑,本文暂不涉及。

另外,在RN中,其实也可以使用不属于props和state的变量,来手动控制组件的状态。但是不推荐这么做。因为这会使状态的控制方法变得不统一,不利于后期维护。

开始尝试:

我们已经可以基于state与props的概念做一个小练习了。它是一个ToDo List,也就是待办列表。大概长下面这个样子:

To Do List草图

我们把它分为两个页面。最左边是添加待办事项的界面,记为ToDoListAdd。中间和最右边其实是同一个界面,记为ToDoListMain,它拥有两种不同状态。

我们先来看ToDoListAdd界面。它有上中下三个部分。最上面是一个可点击返回的头部,中间是用于输入文字的TextInput,底部是一个确认添加的Button。

有没有发现它和上一次我们的flexbox小练习界面很像呢?没错,基于上一篇的布局知识,我们可以方便地把页面修改成这样。

再来看ToDoListMain界面,它与ToDoListAdd很像。头部的"添加"用以跳转至ToDoListAdd。“多选”用以让每一个待办项的Checkbox显示出来,并且显示最下面包含全选Checkbox的footer。

要完整地完成这个应用,本文的篇幅是不够的,后续文章会深入到更加细节的地方。但是首先,本文会介绍如何实现以下基本功能:1.利用state控制编辑状态;2.利用state实现界面的跳转;3.父子组件之间的通信。让我们着手编写程序,穿插着介绍着三点内容。

步骤1,使用flex布局完成ToDoListAdd界面。在根目录新建一个文件ToDoListAdd.js,定义ToDoListAdd类。为更加简洁,这里省去必要组件的引入代码,以及样式代码。

1export default class ToDoListAdd extends Component<Props> { 2 constructor(props) { 3 super(props); 4 } 5 onPress() { } // 暂且为空 6 7 render() { 8 return ( 9 <View style={styles.container}> 10 <View style={styles.header}> 11 <Text style={styles.add} onPress={this.props.onBack}>返回</Text> 12 </View> 13 <View style={styles.body}> 14 <TextInput /> 15 </View> 16 <View style={styles.footer}> 17 <Button title="确定" onPress={this.onPress} style={styles.btn} /> 18 </View> 19 </View> 20 ); 21 } 22}

步骤2,初步创建ToDoListMain组件。当开始构思这个组件的时候,至少有两件事情是需要考虑的:

待办事项的数据源,应该来自那里?显示和隐藏底部的状态存应该在哪里?

第一个问题,为了叙述方便,我们把待办事项的数据源用变量todoList来表示。 todoList可以理解为一些状态,它是需要在ToDoListMain组件中被显示和操作的。有两个todoList的可选位置,要么放在ToDoListMain组件自身,要么放在ToDoListMain更上一层的组件中。于此同时,当ToDoListAdd组件试图添加一个新的待办事项时,ToDoListAdd组件是需要修改todoList这个数据源的。如果todoList在ToDoListMain组件中,ToDoListAdd组件就需要和ToDoListMain组件进行通信。但这其实就绕了一个圈子,因为从草图的逻辑上看,ToDoListAdd是与ToDoListMain同级的一个界面,它们之间要通信,一般的做法是借助于共同的父组件。所以,就这个例子来说,把数据源就直接放在ToDoListAdd和ToDoListMain共同的父组件中是更方便的选择。接下来会看到,这个共同的父组件就是App.js,它将引入ToDoListAdd和ToDoListMain,我们还会App.js中手动设置渲染选择的逻辑。

第二个问题,显示和隐藏底部是只在ToDoListMain组件中使用的状态,它不与外界有联系,所以放在它内部即可。

经过上面的分析,我们创建初步创建ToDoListMain如下:

1export default class ToDoListmain extends Component<Props> { 2 constructor(props) { 3 super(props); 4 this.state = { 5 isEditing: false 6 }; 7 8 this.onEdit = this.onEdit.bind(this); 9 this.renderItem = this.renderItem.bind(this); 10 } 11 12 renderFooter(toggleCheckAll, isAllChecked) { 13 if (!this.state.isEditing) { 14 return null; 15 } 16 const count = this.props.todoList.filter(item => item.isChecked).length; 17 return ( 18 <View style={styles.footer}> 19 <CheckBox onValueChange={toggleCheckAll} value={isAllChecked} /> 20 <Text style={styles.menu}>{`已选择:${count}`}</Text> 21 </View> 22 ); 23 } 24 25 onEdit() { 26 this.setState((prevState) => { 27 return { 28 isEditing: !prevState.isEditing 29 } 30 }); 31 } 32 33 renderItem(item) { 34 return (<ToDoListItem {...item} 35 toggleItemCheck={this.props.toggleItemCheck} 36 isEditing={this.state.isEditing} />); 37 } 38 39 render() { 40 const { toggleCheckAll, isAllChecked, onAddItem, todoList } = this.props; 41 42 return ( 43 <View style={styles.container}> 44 <View style={styles.header}> 45 <Text style={styles.add} onPress={onAddItem}>添加</Text> 46 <Text style={styles.title}>待办列表</Text> 47 <Text style={styles.multi} 48 onPress={this.onEdit}>{this.state.isEditing ? '取消' : '多选'} 49 </Text> 50 </View> 51 52 <FlatList style={styles.body} isEditing={this.state.isEditing} 53 data={todoList} renderItem={this.renderItem} /> 54 55 {this.renderFooter(toggleCheckAll, isAllChecked)} 56 </View> 57 ); 58 } 59}

我们看到该组件只有一个状态,isEditing。它控制了左上角的文字是"取消"还是"多选",也控制了底部是否显示。

我们在控制底部是否显示时,调用了一个自定义的函数,用它的返回值最为内容插入在调用函数的位置。在RN中,如果在渲染的时候返回null,就表示什么也不渲染。所以调用renderFooter时,在isEditing状态为false时,什么都不渲染。

toggleCheckAll用来控制是否全选待办事项。isAllChecked是判断是否全选。onAddItem用作点击"添加"文字的回调。而todoList就是最重要的待办事项的数据源了。它们都来自ToDoListMain的父组件,通过props传下来。

而ToDoListMain组件内部,有一个onEdit函数,用作右上角"取消"和"多选"文字onPress时的回调。在里面我们看到RN中设置state的正确方式是调用this.setState方法。

另外,为了演示方便,这里使用官方提供的Checkbox组件来表示待办事项是否check了。但这个Checkbox组件的其实只有Android平台才有,iOS下没有。而对iOS的处理,打算在后面的文章中专门分享。

还有一点值得注意的地方,是引入了FlatList组件来对todoList数据源进行渲染。FlatList是官方提供的用意显示列表的组件,老版本的ListView已经被标记为弃用了(deprecated)。FlatList组件对列表的渲染做了许多性能优化和功能增强。我们暂时只是使用它来简单显示待办列表。

每一个待办事项使用了自定义的另一个组件ToDoListItem,我们马上来看看它。

步骤3,实现ToDoListItem组件。它没有自己的状态,也只是对父组件内容的展示。

1export default class ToDoListItem extends Component<Props> { 2 constructor(props) { 3 super(props); 4 } 5 6 render() { 7 const { toggleItemCheck, item } = this.props; 8 const { isChecked, detail, level } = item; 9 const basicLevelStyle = styles.level; 10 let specificLevelStyle; 11 if (level === 'info') { 12 specificLevelStyle = styles.info; 13 } else if (level === 'warning') { 14 specificLevelStyle = styles.warning; 15 } else { 16 specificLevelStyle = styles.error; 17 } 18 19 return ( 20 <View style={styles.container}> 21 {this.props.isEditing && <CheckBox onValueChange={(value) => toggleItemCheck(item, value)} style={styles.checkbox} value={isChecked} />} 22 <Text style={styles.detail}>{detail}</Text> 23 <View style={[basicLevelStyle, specificLevelStyle]}></View> 24 </View> 25 ); 26 } 27}

特别是,每一项是否被check,这个状态其实来自于todoList数据源,而每一项的Checkbox的value完全受控于父组件传来的值,所以这种用户输入型的组件,其值完全受控于父组件的props的传值的,也常被称为受控组件(Controlled Component)。

另外,todoList的每一项,我们用level来表示待办项的某种等级,用detail表示它的内容,用isChecked来表示它是否完成。

但是做了这么多,我们还啥都没看到呢。所以,接下来的关键一步,就是把ToDoListMain和ToDoListAdd的渲染逻辑一口气写到App.js中去。

步骤4,写最外层的渲染逻辑。在App.js中,引入

1import ToDoListMain from './ToDoListMain'; 2import ToDoListAdd from './ToDoListAdd';

然后定义App组件

1export default class App extends Component<Props> { 2 constructor(props) { 3 super(props); 4 this.state = { 5 current: 'main', 6 todoList: [ 7 { 8 level: 'info', 9 detail: '一般的任务', 10 isChecked: false, 11 key: '0' 12 }, 13 { 14 level: 'warning', 15 detail: '较重要的任务', 16 isChecked: false, 17 }, 18 { 19 level: 'error', 20 detail: '非常重要且紧急的任务', 21 isChecked: false, 22 key: '2' 23 } 24 ] 25 } 26 this.onAddItem = this.onAddItem.bind(this); 27 this.onBack = this.onBack.bind(this); 28 this.toggleCheckAll = this.toggleCheckAll.bind(this); 29 this.toggleItemCheck = this.toggleItemCheck.bind(this); 30 } 31 32 onAddItem() { 33 this.setState((prevState) => { 34 return { 35 current: 'add' 36 } 37 }); 38 } 39 40 onBack() { 41 this.setState({ 42 current: 'main' 43 }); 44 } 45 46 toggleCheckAll() { 47 const flag = this.isAllChecked(); 48 const newTodos = this.state.todoList.map(item => { 49 return { 50 ...item, 51 isChecked: !flag 52 }; 53 }); 54 this.setState({ 55 todoList: newTodos 56 }); 57 } 58 59 toggleItemCheck(item, key) { 60 const newTodos = this.state.todoList.map(todo => { 61 if (todo !== item) { 62 return todo; 63 } 64 return { 65 ...todo, 66 isChecked: !item.isChecked 67 } 68 }); 69 this.setState({ 70 todoList: newTodos 71 }); 72 } 73 74 isAllChecked() { 75 if (!this.state.todoList) return false; 76 if (this.state.todoList.length === 0) return false; 77 return this.state.todoList.every(item => item.isChecked); 78 } 79 80 render() { 81 if (this.state.current === 'main') { 82 return (<ToDoListMain 83 isAllChecked={this.isAllChecked()} 84 toggleCheckAll={this.toggleCheckAll} 85 toggleItemCheck={this.toggleItemCheck} 86 onAddItem={this.onAddItem} 87 todoList={this.state.todoList} />); 88 } else { 89 return (<ToDoListAdd onBack={this.onBack} />); 90 } 91 } 92}

我们看到App组件有两个状态,一个是current,用以指定当前渲染的是哪个界面(其实我们这里就两个界面)。另一个是todoList数据源。

界面是如何切换的呢?

观察render函数,里面就是界面渲染逻辑,如果this.state.current的值是main,那么就会渲染App就会渲染ToDoListMain,否则,渲染ToDoListAdd。你可以理解成,我们手动实现了一个特别简单的前端路由。这一切都是基于当state变化时,相应的界面自动重新渲染了。

更具体地来说,我们把onAddItem作为props的一个属性传给ToDoListMain,把onBack也作为一个属性传给ToDoListAdd。所以当它们的头部相应文字被点击时,实际上调用的,是定义在App组件中的回调函数。回调函数修改了current状态,而current状态的修改引起了App的render函数重新被调用,它根据当前的current状态而重新渲染了相应的界面。

todoList中每项的key值是给FlatList作为唯一标识用的。

另外,在setState句子中,我们会构造一个新的变量,然后一把setState,而不是去修改原有的state。这也是RN中的常用做法。对于初学者来说,可能语法有点怪异。不过,这样做是有它的理由的。简单的说,因为RN在底层大量使用了比较对象是否变化的逻辑,如果挨个便利对象的每个属性,而且对象很复杂的话,这个比较的逻辑是很慢的。但是,比较两个对象的引用是否相等却很容易,直接一个表达式就可以了。所以,我们在setState时往往会构造一个新的对象。更深的机理就留给读者去探索啦。

好了,让我们运行起程序,看看效果怎么样吧。

本文通过一个ToDo List的例子,介绍了RN中最基本的两个概念state和props。并简单实现了状态提升、组件间的通信等功能。

不过这个例子还没完。这个ToDo List目前只是一个展示的功能,如何对它们进行编辑、添加、删除,后续会进一步分享。

文章中使用到的源码下载: todo-list.zip

点赞
收藏

评论区

加载中...

相关推荐

Vue 3.0 升级指南

本文由葡萄城技术团队原创并首发转载请注明出处:葡萄城官网(https://www.oschina.net/action/GoToLink?urlhttps%3A%2F%2Fwww.grapecity.com.cn%2F),葡萄城为开发者提供专业的开发工具、解决方案和服务,赋能开发者。2020年9月18日Vue3.0正式发布,距离2

Vue 3自定义指令开发

本文由葡萄城技术团队原创并首发转载请注明出处:葡萄城官网(https://www.oschina.net/action/GoToLink?urlhttps%3A%2F%2Fwww.grapecity.com.cn%2F),葡萄城为开发者提供专业的开发工具、解决方案和服务,赋能开发者。什么是指令(directive)在An

Deno会在短期内取代Node吗?

转载请注明出处:葡萄城官网(https://www.oschina.net/action/GoToLink?urlhttps%3A%2F%2Fwww.grapecity.com.cn%2F),葡萄城为开发者提供专业的开发工具、解决方案和服务,赋能开发者。原文出处:https://blog.bitsrc.io/whatisdenoa

Flash Player的终章——赠予它的挽歌

本文由葡萄城技术团队原创并首发转载请注明出处:葡萄城官网(https://www.oschina.net/action/GoToLink?urlhttps%3A%2F%2Fwww.grapecity.com.cn%2F),葡萄城为开发者提供专业的开发工具、解决方案和服务,赋能开发者。12月28日消息,微软已经确认Windows10

Ember.js和Vue.js对比,哪个框架更优秀?

本文由葡萄城技术团队于OSChina翻译并首发转载请注明出处:葡萄城官网(https://www.oschina.net/action/GoToLink?urlhttps%3A%2F%2Fwww.grapecity.com.cn%2F),葡萄城为开发者提供专业的开发工具、解决方案和服务,赋能开发者。JavaScript最初是为Web

2020年值得你去试试的10个React开发工具

本文由葡萄城技术团队翻译并首发转载请注明出处:葡萄城官网(https://www.oschina.net/action/GoToLink?urlhttps%3A%2F%2Fwww.grapecity.com.cn%2F),葡萄城为开发者提供专业的开发工具、解决方案和服务,赋能开发者。JavaScript每天都在出现大量的框架和工具,

React Native基础&入门教程:以一个To Do List小例子,看props和state - HelloWorld