React + Redux - Qual é a melhor maneira de lidar com CRUD em um componente de formulário?

128

Eu tenho um formulário que é usado para criar, ler, atualizar e excluir. Criei 3 componentes com a mesma forma, mas passo-os diferentes adereços. Eu tenho CreateForm.js, ViewForm.js (somente leitura com o botão excluir) e UpdateForm.js.

Eu costumava trabalhar com PHP, então sempre fazia isso de uma forma.

Eu uso o React e o Redux para gerenciar a loja.

Quando estou no componente CreateForm, passo aos meus subcomponentes esses objetos createForm={true}para não preencher as entradas com um valor e não desabilitá-las. No meu componente ViewForm, passo esses adereços readonly="readonly".

E eu tenho outro problema com uma área de texto que é preenchida com um valor e não é atualizável. Reagir a área de texto com valor é somente leitura, mas precisa ser atualizado

Qual é a melhor estrutura para ter apenas um componente que lida com esses diferentes estados do formulário?

Você tem algum conselho, tutoriais, vídeos, demonstrações para compartilhar?

Mike Boutin
fonte

Respostas:

115

Encontrei o Formulário Redux pacote . Faz um trabalho muito bom!

Então, você pode usar o Redux com o React-Redux .

Primeiro você precisa criar um componente de formulário (obviamente):

import React from 'react';
import { reduxForm } from 'redux-form';
import validateContact from '../utils/validateContact';

class ContactForm extends React.Component {
  render() {
    const { fields: {name, address, phone}, handleSubmit } = this.props;
    return (
      <form onSubmit={handleSubmit}>
        <label>Name</label>
        <input type="text" {...name}/>
        {name.error && name.touched && <div>{name.error}</div>}

        <label>Address</label>
        <input type="text" {...address} />
        {address.error && address.touched && <div>{address.error}</div>}

        <label>Phone</label>
        <input type="text" {...phone}/>
        {phone.error && phone.touched && <div>{phone.error}</div>}

        <button onClick={handleSubmit}>Submit</button>
      </form>
    );
  }
}

ContactForm = reduxForm({
  form: 'contact',                      // the name of your form and the key to
                                        // where your form's state will be mounted
  fields: ['name', 'address', 'phone'], // a list of all your fields in your form
  validate: validateContact             // a synchronous validation function
})(ContactForm);

export default ContactForm;

Depois disso, você conecta o componente que lida com o formulário:

import React from 'react';
import { connect } from 'react-redux';
import { initialize } from 'redux-form';
import ContactForm from './ContactForm.react';

class App extends React.Component {

  handleSubmit(data) {
    console.log('Submission received!', data);
    this.props.dispatch(initialize('contact', {})); // clear form
  }

  render() {
    return (
      <div id="app">
        <h1>App</h1>
        <ContactForm onSubmit={this.handleSubmit.bind(this)}/>
      </div>
    );
  }

}

export default connect()(App);

E adicione o redutor de forma redux em seus redutores combinados:

import { combineReducers } from 'redux';
import { appReducer } from './app-reducers';
import { reducer as formReducer } from 'redux-form';

let reducers = combineReducers({
  appReducer, form: formReducer // this is the form reducer
});

export default reducers;

E o módulo validador é assim:

export default function validateContact(data, props) {
  const errors = {};
  if(!data.name) {
    errors.name = 'Required';
  }
  if(data.address && data.address.length > 50) {
    errors.address = 'Must be fewer than 50 characters';
  }
  if(!data.phone) {
    errors.phone = 'Required';
  } else if(!/\d{3}-\d{3}-\d{4}/.test(data.phone)) {
    errors.phone = 'Phone must match the form "999-999-9999"'
  }
  return errors;
}

Após o preenchimento do formulário, quando você desejar preencher todos os campos com alguns valores, poderá usar a initializefunção:

componentWillMount() {
  this.props.dispatch(initialize('contact', {
    name: 'test'
  }, ['name', 'address', 'phone']));
}

Outra maneira de preencher os formulários é definir os valores iniciais.

ContactForm = reduxForm({
  form: 'contact',                      // the name of your form and the key to
  fields: ['name', 'address', 'phone'], // a list of all your fields in your form
  validate: validateContact             // a synchronous validation function
}, state => ({
  initialValues: {
    name: state.user.name,
    address: state.user.address,
    phone: state.user.phone,
  },
}))(ContactForm);

Se você tiver outra maneira de lidar com isso, deixe uma mensagem! Obrigado.

Mike Boutin
fonte
3
Apenas imaginando - você ainda está usando redux-forms? Eu estou querendo saber como que as escalas clichê comparado a reagir formas
Ashley COOLMAN
2
Sim, eu ainda estou usando isso! Muito bom, criei formulários muito grandes e funcionou como o número 1. Você só precisa ter muito cuidado com o que passa como suporte para seus componentes e suas atualizações. Desculpe pelo atraso da resposta.
Mike Boutin 06/10
1
@ MikeBoutin, você poderia elaborar essa cautela em relação aos adereços? Obrigado
Adam K Dean
Vale ressaltar que, mesmo a partir da v6.4.3, se você estiver usando todo o seu potencial, o desempenho de redux-formé péssimo em todas as versões do IE, incluindo o Edge. Se você precisar apoiá-lo, procure outro lugar.
Stephen Collins
2
É apenas a ser muito rigoroso com shouldComponentUpdate, para não criar defasagens em suas formas
Mike Boutin
11

UPDATE: é 2018 e só vou usar o Formik (ou bibliotecas semelhantes ao Formik)

Há também a forma react-redux ( passo a passo ), que parece trocar parte da forma redux javascript (& boilerplate) com a declaração de marcação. Parece bom, mas ainda não o usei.

Um recortar e colar do leia-me:

import React from 'react';
import { createStore, combineReducers } from 'redux';
import { Provider } from 'react-redux';
import { modelReducer, formReducer } from 'react-redux-form';

import MyForm from './components/my-form-component';

const store = createStore(combineReducers({
  user: modelReducer('user', { name: '' }),
  userForm: formReducer('user')
}));

class App extends React.Component {
  render() {
    return (
      <Provider store={ store }>
        <MyForm />
      </Provider>
    );
  }
}

./components/my-form-component.js

import React from 'react';
import { connect } from 'react-redux';
import { Field, Form } from 'react-redux-form';

class MyForm extends React.Component {
  handleSubmit(val) {
    // Do anything you want with the form value
    console.log(val);
  }

  render() {
    let { user } = this.props;

    return (
      <Form model="user" onSubmit={(val) => this.handleSubmit(val)}>
        <h1>Hello, { user.name }!</h1>
        <Field model="user.name">
          <input type="text" />
        </Field>
        <button>Submit!</button>
      </Form>
    );
  }
}

export default connect(state => ({ user: state.user }))(MyForm);

Editar: Comparação

Os documentos react-redux-form fornecem uma comparação vs redux-form:

https://davidkpiano.github.io/react-redux-form/docs/guides/compare-redux-form.html

Ashley Coolman
fonte
4

Para aqueles que não se importam com uma enorme biblioteca para lidar com questões relacionadas a formulários, eu recomendaria redux-form-utils .

Ele pode gerar valor e alterar manipuladores para seus controles de formulário, gerar redutores do formulário, criadores de ações úteis para limpar certos (ou todos) campos, etc.

Tudo que você precisa fazer é montá-los em seu código.

Ao usar redux-form-utils, você acaba com a manipulação de formulários da seguinte maneira:

import { createForm } from 'redux-form-utils';

@createForm({
  form: 'my-form',
  fields: ['name', 'address', 'gender']
})
class Form extends React.Component {
  render() {
    const { name, address, gender } = this.props.fields;
    return (
      <form className="form">
        <input name="name" {...name} />
        <input name="address" {...address} />
        <select {...gender}>
          <option value="male" />
          <option value="female" />
        </select>
      </form>
    );
  }
}

No entanto, essa biblioteca apenas resolve problemas Ce U, para Re D, talvez um Tablecomponente mais integrado seja o antipate.

jasonslyvia
fonte
1

Apenas mais uma coisa para quem deseja criar um componente de formulário totalmente controlado sem usar uma biblioteca de grandes dimensões.

ReduxFormHelper - uma pequena classe ES6, com menos de 100 linhas:

class ReduxFormHelper {
  constructor(props = {}) {
    let {formModel, onUpdateForm} = props
    this.props = typeof formModel === 'object' &&
      typeof onUpdateForm === 'function' && {formModel, onUpdateForm}
  }

  resetForm (defaults = {}) {
    if (!this.props) return false
    let {formModel, onUpdateForm} = this.props
    let data = {}, errors = {_flag: false}
    for (let name in formModel) {
      data[name] = name in defaults? defaults[name] :
        ('default' in formModel[name]? formModel[name].default : '')
      errors[name] = false
    }
    onUpdateForm(data, errors)
  }

  processField (event) {
    if (!this.props || !event.target) return false
    let {formModel, onUpdateForm} = this.props
    let {name, value, error, within} = this._processField(event.target, formModel)
    let data = {}, errors = {_flag: false}
    if (name) {
      value !== false && within && (data[name] = value)
      errors[name] = error
    }
    onUpdateForm(data, errors)
    return !error && data
  }

  processForm (event) {
    if (!this.props || !event.target) return false
    let form = event.target
    if (!form || !form.elements) return false
    let fields = form.elements
    let {formModel, onUpdateForm} = this.props
    let data = {}, errors = {}, ret = {}, flag = false
    for (let n = fields.length, i = 0; i < n; i++) {
      let {name, value, error, within} = this._processField(fields[i], formModel)
      if (name) {
        value !== false && within && (data[name] = value)
        value !== false && !error && (ret[name] = value)
        errors[name] = error
        error && (flag = true)
      }
    }
    errors._flag = flag
    onUpdateForm(data, errors)
    return !flag && ret
  }

  _processField (field, formModel) {
    if (!field || !field.name || !('value' in field))
      return {name: false, value: false, error: false, within: false}
    let name = field.name
    let value = field.value
    if (!formModel || !formModel[name])
      return {name, value, error: false, within: false}
    let model = formModel[name]
    if (model.required && value === '')
      return {name, value, error: 'missing', within: true}
    if (model.validate && value !== '') {
      let fn = model.validate
      if (typeof fn === 'function' && !fn(value))
        return {name, value, error: 'invalid', within: true}
    }
    if (model.numeric && isNaN(value = Number(value)))
      return {name, value: 0, error: 'invalid', within: true}
    return {name, value, error: false, within: true}
  }
}

Não faz todo o trabalho para você. No entanto, facilita a criação, validação e manipulação de um componente de formulário controlado. Você pode apenas copiar e colar o código acima em seu projeto ou incluir a respectiva biblioteca -redux-form-helper (plug!).

Como usar

O primeiro passo é adicionar dados específicos ao estado Redux, o que representará o estado do nosso formulário. Esses dados incluirão os valores atuais do campo, bem como o conjunto de sinalizadores de erro para cada campo no formulário.

O estado do formulário pode ser adicionado a um redutor existente ou definido em um redutor separado.

Além disso, é necessário definir uma ação específica iniciando a atualização do estado do formulário, bem como o respectivo criador da ação.

Exemplo de ação :

export const FORM_UPDATE = 'FORM_UPDATE' 

export const doFormUpdate = (data, errors) => {
  return { type: FORM_UPDATE, data, errors }
}
...

Exemplo de redutor :

...
const initialState = {
  formData: {
    field1: '',
    ...
  },
  formErrors: {
  },
  ...
}

export default function reducer (state = initialState, action) {
  switch (action.type) {
    case FORM_UPDATE:
      return {
        ...ret,
        formData: Object.assign({}, formData, action.data || {}),
        formErrors: Object.assign({}, formErrors, action.errors || {})
      }
    ...
  }
}

A segunda e última etapa é criar um componente de contêiner para nosso formulário e conectá-lo à respectiva parte do estado e ações do Redux.

Também precisamos definir um modelo de formulário especificando a validação dos campos do formulário. Agora, instanciamos o ReduxFormHelperobjeto como membro do componente e passamos para lá nosso modelo de formulário e uma atualização de despacho de retorno de chamada do estado do formulário.

Em seguida, no render()método do componente , precisamos vincular onChangeos onSubmiteventos de cada campo e do formulário aos métodos processField()e processForm()respectivamente, além de exibir blocos de erro para cada campo, dependendo dos sinalizadores de erro do formulário no estado.

O exemplo abaixo usa CSS da estrutura do Twitter Bootstrap.

Exemplo de componente de contêiner :

import React, {Component} from 'react';
import {connect} from 'react-redux'
import ReduxFormHelper from 'redux-form-helper'

class MyForm extends Component {
  constructor(props) {
    super(props);
    this.helper = new ReduxFormHelper(props)
    this.helper.resetForm();
  }

  onChange(e) {
    this.helper.processField(e)
  }

  onSubmit(e) {
    e.preventDefault()
    let {onSubmitForm} = this.props
    let ret = this.helper.processForm(e)
    ret && onSubmitForm(ret)
  }

  render() {
    let {formData, formErrors} = this.props
    return (
  <div>
    {!!formErrors._flag &&
      <div className="alert" role="alert">
        Form has one or more errors.
      </div>
    }
    <form onSubmit={this.onSubmit.bind(this)} >
      <div className={'form-group' + (formErrors['field1']? ' has-error': '')}>
        <label>Field 1 *</label>
        <input type="text" name="field1" value={formData.field1} onChange={this.onChange.bind(this)} className="form-control" />
        {!!formErrors['field1'] &&
        <span className="help-block">
          {formErrors['field1'] === 'invalid'? 'Must be a string of 2-50 characters' : 'Required field'}
        </span>
        }
      </div>
      ...
      <button type="submit" className="btn btn-default">Submit</button>
    </form>
  </div>
    )
  }
}

const formModel = {
  field1: {
    required: true,
    validate: (value) => value.length >= 2 && value.length <= 50
  },
  ...
}

function mapStateToProps (state) {
  return {
    formData: state.formData, formErrors: state.formErrors,
    formModel
  }
}

function mapDispatchToProps (dispatch) {
  return {
    onUpdateForm: (data, errors) => {
      dispatch(doFormUpdate(data, errors))
    },
    onSubmitForm: (data) => {
      // dispatch some action which somehow updates state with form data
    }
  }
}

export default connect(mapStateToProps, mapDispatchToProps)(MyForm)

Demo

mais atrasado
fonte