准则
先说一下redux的使用场景,因为如果没有redux,那更不会有redux-form。
redux基于Flux架构思想,是一个状态管理框架,其目标是解决单页面应用中复杂的状态管理问题。
日常前端开发中,如果只是做一个简单的运营活动页面,甚至是一些路由稍微复杂一些的SPA项目,都可能用不到redux;只有在页面存在多种数据来源,交互非常复杂的项目中,才有必要引入redux。
redux的作者Dan Abramov指出:
“只有遇到 React 实在解决不了的问题,你才需要 redux 。”
前些日子开发的转转魔方系统,用于搭建转转日常的运营活动页面,因组件较多,交互复杂,采用了React+redux架构。先上一张“高大上”的截图(当然布局、配色可以忽略,因为没有UI资源,是我自己瞎搞的):
那么,为什么采用redux-form呢? 先让我们看一下两个普通的表单:
想象一下,如果用state来保存要提交的数据,用onChange来获取用户输入,然后改变state中相应数据荐,简直是梦魇一般。
幸亏,我们有redux和redux-form,redux用来管理状态,redux-form来负责表单数据部分。
本文不介绍redux,如果想了解关于redux的更多,可以移步http://www.redux.org.cn/ ,还可以参考阮一峰的教程:http://www.ruanyifeng.com/blog/2016/09/redux_tutorial_part_one_basic_usages.html
好了,废话说了一大堆了,现在让我们进入正题:
redux-form主要做以下4件事:
- 一个 redux reducer,监听redux-form派发出的actions,统一管理我们redux中的form state;
- 一个React组件装饰器,包含我们用高阶组件组装的整个form,提供一个带一些props的纯函数;
- 一个Filed组件将用户输入与redux store相连接;
- 用单个的Action Creator将我们的form与应用挂勾在一起。
先来了解一下redux-form的生命周期:
基本用法
必须要做的第一步,是先把redux-form的reducer用combineReducer方法给到redux。不管我们的应用中有多少form组件,我们只需要执行一次这样的操作:
请注意,传递给redux-form的默认key为form,虽然支持自定义key names,但一般情况下请勿修改这个名字。详见http://redux-form.com/6.7.0/docs/api/ReduxForm.md/#-getformstate-function-optional-。
第二步,将普通表单组件用reduxForm()方法装饰,如此一来我们的组件才会拥有form state和一些表单方法。
请注意:const { handleSubmit, pristine, reset, submitting } = props中的各项并``不是从它的父组件传过递,而是从redux-form传递过来`。
pristine、submitting分别可以标识表单的当前状态。 pristine表示表单还没有进行任何动作,如输入、获取、失去焦点等 submitting表示正在提交
我们也可以主动告诉redux-form我们希望管理哪些输入:
初始化数据
在日常前端开发过程中,尤其是后台OA中,经常会遇到新增和编辑页面,此时如果建两个页面(或者用两个不同View的路由),无疑会增加日后维护成本(学习React之初踩过这个坑),所以初始化数据尤为重要。
redux-form提供initialValues,以供表单初绍化数据。
官网中的初始化数据来自reducer(Reducer设计优雅的基础上,推荐此方法):
当然我们的数据也可能来自props(理论上数据应该完全放到一个store中,但实际项目开发过程中却未必——我们还是会用到setState,因为某个state可能只是特定组件的一个开关,没有必要放到store中)。
转转魔方系统中的页面配置初始数据就是来自props:
数据校验
数据校验是表单操作中必不可少的一部分,redux-form为我们提供了3种数据校验方法:
- 同步验证,包含Field-Level校验;
- 提交数据合法性验证(非数据格式,如用户名+密码是否匹配等);
- 异步验证(Async Validate)
同步验证
同步验证有两种方式。
- 通过一个自定义的验证函数,这个函数默认会传入携带表单字段值组成的一个object,返回对象为一个error组成的object对象。
- 在Field组件中传入一个validate的props,把需要验证的字段单独或者以数据形式传入。
以自定义验证函数为例:
redux-form的验证还支持warning,该警告不阻止表单提交,只给出提示
跟初始化数据一样,验证规则同样需要通知redux-form:
提交数据合法性验证(官方叫Submit Validation,根据Demo示例我给引申了一下)
用redux-form做服务端的推荐方式,是从onSumit方法中返回一个失败的(rejected)promise。
在表单的提交函数中,redux-form也提供了两种方式来校验:
- 通过props中的onSumit函数传递给装饰组件;
- 通过参数中的this.props.handleSubmit将form做为该函数的实参传递,可以在组件内部使用onClick={this.props.handleSubmit(mySubmit)}来代替提交按扭的默认提交事件。
在装饰组件中这样触发:
异步验证(Async Validation)
服务端异步验证最好的方式是Submit Validation,有时候在我们输入表单后,会即时的进行服务端验证,比如注册的时候验证用户名是否已存在。
asyncValidate通常也返回一个error或者resolve的reject对象。
以上便是这次的文章分享了,想对redux-form有更多的讨论,可以给我们留言哦。想认识我们团队这位小伙伴的,可以关注他的个人博 http://ushtml.com/
如果你喜欢我们的文章,关注我们的公众号和我们互动吧。