This package has been deprecated

Author message:

update to @react-form-fields/material-ui

material-ui-form-fields
TypeScript icon, indicating that this package has built-in type declarations

1.4.1 • Public • Published

Material UI Form Fields

See Demo

See API.md for details

Requirements

  • React >= 16.0.0
  • Material-ui >= 1.0.0

Install

yarn add material-ui-form-fields

Usage

Individual field

  // import
  import FieldText from 'material-ui-form-fields/components/Text';
 
  // render()
  <FieldText
    ref={ref => this.field = ref}
    label='Email'
    type='email'
    disabled={disabled}
    value={email}
    validation='required|email'
    onChange={v => this.setState({ email: v }))}
  />
 
  // onSubmit()
  if(this.field.isValid()) { 
    console.log('submit');
  }

Complete Form

  // import
  import ValidationContext from 'material-ui-form-fields/components/ValidationContext';
  import FieldText from 'material-ui-form-fields/components/Text';
 
  // render()
  <ValidationContext ref={ref=> this.validation = ref}>
    <FieldText
      ref={ref => this.field = ref}
      label='Email'
      type='email'
      value={email}
      validation='required|email'
      onChange={v => this.setState({ email: v }))}
    />
 
    <FieldText
      label='Senha'
      type='password'
      value={password}
      validation='required'
      onChange={v => this.setState({ password: v }))}
    />
  </ValidationContext>
 
  // onSubmit()
  if(this.validation.isValid()) { 
    console.log('all fields are valid');
  }

Config

Global Setup example:

import { setConfig } from 'material-ui-form-fields/config';
import commonMasks from 'material-ui-form-fields/mask/common/pt-br';
import validationMessage from 'material-ui-form-fields/validator/custom-languages/pt-br';
 
setConfig({
  masks: commonMasks,
  defaultDateLocale: 'pt-br',
  validation: validationMessage
});

Validation Rules and Config

See validatorjs

Validation Context

<FieldDate
  label='Begin Date'
  name='begin'
  value={model.beginDate}
  validation='date'
  onChange={(v => this.setState({ model: { ...model, beginDate: v } }))}
/>
 
<FieldDate
  label='End Date'
  name='end'
  value={model.endDate}
  validation='date|after_or_equal:begin date' //after_or_equal needs a value from other prop (ex: 'begin date')
  validationContext={{ 'begin date': model.beginDate }} // build the dependency object as you needed
  onChange={(v => this.setState({ model: { ...model, endDate: v } }))}
/>

Mask

Only FieldText has mask prop;

  // register
  import { register } from 'material-ui-form-fields/mask';
   
  // -optional
  import commonMasks from 'material-ui-form-fields/mask/common/pt-br';
 
  register([
    ...commonMasks, // -optional
    name: 'my-new-mask',
    apply: value => {
      if (!value) return value;
 
      const regexp = value.length > 10 ?
        /^(\d{0,2})(\d{0,5})(\d{0,4}).*/ :
        /^(\d{0,2})(\d{0,4})(\d{0,4}).*/;
 
      const result = value.length > 2 ?
        '($1) $2-$3' : '($1$2$3';
 
      return value.replace(regexp, result).replace(/-$/, '');
    },
    clean: value => value.replace(/\D/gi, '').substr(0, 11)
  ])
 
  // usage
  <FieldText
    label='Phone'
    type='text'
    mask='my-new-mask'
    value={phone}
    onChange={v => this.setState({ phone: v }))}
  />

Common Masks

PT-BR:

  • zipcode
  • phone
  • document (CNPJ/CPF)
  • cpf
  • cnpj

Versions

Current Tags

  • Version
    Downloads (Last 7 Days)
    • Published

Version History

  • Version
    Downloads (Last 7 Days)
    • Published

Package Sidebar

Install

npm i material-ui-form-fields

Weekly Downloads

1

Version

1.4.1

License

MIT

Unpacked Size

100 kB

Total Files

79

Last publish

Collaborators

  • danieloprado