数栈技术文章分享:你居然是这样的initialValue

先说一下写着篇文章的契机,是因为回显,复杂表单的回显,让我觉得我对initialValue这个属性是有误解的。

数栈技术文章分享:你居然是这样的initialValue

一、initialValue的出处和定义

initialValue的出处:

AntDesign/Form表单件/getFieldDecorator(id,options)装饰器函数/第二个参数options/options.initialValue。

数栈技术文章分享:你居然是这样的initialValue

链接地址:https://ant.design/components/form-cn/#getFieldDecorator(id,-options)-%E5%8F%82%E6%95%B0

关于属性initialValue,官方的解释如下:

数栈技术文章分享:你居然是这样的initialValue

关键字是“子节点的初始值”,初始值也就是默认值,比如Form中有一个城市的选择器,默认选择“杭州”,那么initialValue就是杭州对应的value。

所以其实我一直以为initialValue是defaultValue一样的存在。

数栈技术文章分享:你居然是这样的initialValue


数栈技术文章分享:你居然是这样的initialValue


二、initialValue和defaultValue的区别

1. defaultValue的例子

import React, { Component,Fragment } from 'react';
import { Button,Input } from "antd";
export default class CreateFrom extends Component {
  state={value:"value"}
  updateValue = () => {
    this.setState({value:"newValue"})
  }
  render() {
    return (
      <Fragment>
        <Button onClick={this.updateValue}>更新value</Button>
        <Input defaultValue={this.state.value} />
      </Fragment>
    );
  }
}

说明:当该组件被渲染时,Input中的值为”value“,当我点击“更新value按钮”时,Input中的值不更新。

Input组件没有设置value属性的话,就是一个非受控组件,它需要设置defaultValue,如果用户不手动改变Input的输入,那么Input就一直显示defaultValue指向的值(友情提示:值为Input组件第一次被渲染时的真实值,变量或者常量指向的真实值)。这里涉及到了受控组件和非受控组件的知识,不做延伸。

2. intialValue的例子

1)models/list.js

let count = 1;
const CITY = ["杭州","北京","上海","广州","深圳"];
export default {
  namespace: 'list',

  state: {
    citys: CITY,
    detail:{city:CITY[count%5],count}
  },

  effects: {
    *fetchDetail({ payload }, { call, put }) {
      // 不发请求,而是直接更新reducer
      // const response = yield call(service, payload);
      count++; 
      yield put({
        type: 'queryDetail',
        payload: {city:CITY[count%5],count},
      });
    },
  },

  reducers: {
    queryDetail(state, action) {
      return {
        ...state,
        detail: action.payload,
      };
    }
  },
};

2)router组件文件

import React, { Component } from 'react';
import { connect } from "dva";
import { InputNumber,Select,Form,Button } from "antd";

const FormItem = Form.Item;
const { Option } = Select;
const formItemLayout = {
  labelCol: {
    xs: { span: 24 },
    sm: { span: 2 },
  },
  wrapperCol: {
    xs: { span: 24 },
    sm: { span: 22 },
  },
};
@connect(({list})=>({
  citys:list.citys,
  detail:list.detail
}))
class CreateFrom extends Component {
  getDetail = () => {
    this.props.dispatch({type:"list/fetchDetail"});
  }
  render() {
    const { form,detail={},citys=[] } = this.props;
    const { getFieldDecorator } = form;
    const { city,count } = detail;
    return (
      <Form>
        <Button onClick={this.getDetail}>重新获取数据</Button>
        <FormItem
          {...formItemLayout}
          label="城市"
        >
          {getFieldDecorator('city', {
            initialValue: city,
            rules: [{ required: true, message: '请选择城市' }],
          })(
            <Select style={{width:160}} placeholder="请选择城市">
            {
              citys.map(item=><Option key={item} value={item}>{item}</Option>)
            }
            </Select>
          )}
        </FormItem>
        <FormItem
          {...formItemLayout}
          label="总量"
        >
          {getFieldDecorator('count', {
            initialValue:count,
            rules: [{ required: true, message: '总量(1-99999999)',pattern:/^[1-9][0-9]{0,7}$/ }],
          })(
            <InputNumber style={{width:160}}/>
          )}
        </FormItem>
      </Form>
    );
  }
}

export default Form.create()(CreateFrom);

说明:当该Form组件被渲染时,接收props.detail,因为在models/list.js文件的state中已经初始化,所以,第一次render被渲染的值是“杭州”和“1”,点击“重新获取数据按钮”,这个时候props.detail改变为{city:"北京",count:2},与此同时Form被渲染的值也随之改变。

数栈技术文章分享:你居然是这样的initialValue

uhmmm,怎么和defaultValue的表现方式不一样?不是说好是默认值的嘛?不是说好不会跟着数据的改变而改变的嘛?逗我玩还是~

敲黑板,划重点,initialValue值可以被更新,除了下面两种情况:

  • 1. 用户手动更新表单数据,比如在<Input />组件中手动输入,在<Select />组件中手动选择等等,在用户手动更新数据之后,initialValue的值改变不会更新表单值。
  • 2. 当执行了setFieldsValue方法之后,initialValue的值改变不会更新表单值。

下面的例子中在生命周期函数componentDidMount中执行了setFieldsValue方法,其他不变,你会发现不管怎么点击“重新获取数据按钮”,城市对应的值都不会被更新,而总量对应的值却一直在更新。如果你手动改变总量的输入,再点击“重新获取数据按钮”,此时城市和总量的值都不会被更新。

import React, { Component } from 'react';
import { connect } from "dva";
import { InputNumber,Select,Form,Button } from "antd";

const FormItem = Form.Item;
const { Option } = Select;
const formItemLayout = {
  labelCol: {
    xs: { span: 24 },
    sm: { span: 2 },
  },
  wrapperCol: {
    xs: { span: 24 },
    sm: { span: 22 },
  },
};
@connect(({list})=>({
  citys:list.citys,
  detail:list.detail
}))
class CreateFrom extends Component {
  componentDidMount(){
    this.props.form.setFieldsValue({city:"上海"});
  }
  getDetail = () => {
    this.props.dispatch({type:"list/fetchDetail"});
  }
  render() {
    const { form,detail={},citys=[] } = this.props;
    const { getFieldDecorator } = form;
    const { city,count } = detail;
    return (
      <Form>
        <Button onClick={this.getDetail}>重新获取数据</Button>
        <FormItem
          {...formItemLayout}
          label="城市"
        >
          {getFieldDecorator('city', {
            initialValue: city,
            rules: [{ required: true, message: '请选择城市' }],
          })(
            <Select style={{width:160}} placeholder="请选择城市">
            {
              citys.map(item=><Option key={item} value={item}>{item}</Option>)
            }
            </Select>
          )}
        </FormItem>
        <FormItem
          {...formItemLayout}
          label="总量"
        >
          {getFieldDecorator('count', {
            initialValue:count,
            rules: [{ required: true, message: '总量(1-99999999)',pattern:/^[1-9][0-9]{0,7}$/ }],
          })(
            <InputNumber style={{width:160}}/>
          )}
        </FormItem>
      </Form>
    );
  }
}

export default Form.create()(CreateFrom);

数栈技术文章分享:你居然是这样的initialValue

貌似,表单的回显出现一些转机。。。

三、碎碎念

不要一提表单回显,就使劲往代码里面怼“setFieldsValue”,这样会把代码写得很!很!很!很!很不优雅!!!

超级喜欢《锋利的jQuery》封面上的这句话“每多学一点知识,就少写一行代码”,简直是我写代码的信条。


数栈是云原生—站式数据中台PaaS,我们在github和gitee上有一个有趣的开源项目:FlinkXFlinkX是一个基于Flink的批流统一的数据同步工具,既可以采集静态的数据,也可以采集实时变化的数据,是全域、异构、批流一体的数据同步引擎。大家喜欢的话请给我们点个star!star!star!

github开源项目:https://github.com/DTStack/flinkx

gitee开源项目:https://gitee.com/dtstack_dev_0/flinkx



上一篇:光谱反射率重建方法简述


下一篇:数栈技术文章分享:你居然是这样的initialValue