0.1.0 • Published 2 years ago

dfws-ve-form v0.1.0

Weekly downloads
3
License
ISC
Repository
-
Last release
2 years ago

东方网升 react 表单组件

发布

  1. 更改package.json版本
  2. yarn run build
  3. npm publish 注:镜像源需切换回NPM官方源

链接

示例

  • cd example
  • yarn
  • yarn start

使用之前

该组件依赖于react,rc-form,dfws-react-upload 使用前自行配置react 需要上传时自行配置ve-form-upload

何时使用

  • 项目需要构建react表单时

API

<div className="masker">
  <div className='form-box'>
    <FormList formList={this.state.formData} handleInit={this.handleInit} />
    <div>{this.state.value}</div>
    <div className='submit-btn'><button onClick={this.handleSubmit}>提交</button></div>
  </div>
</div>

form props

参数说明类型默认值
formList表单数据Array-
type表单类型 input:默认输入框;select:默认下拉选择,配合data使用;checkbox:默认点击选择 配合data使用;radio默认单项框;upload默认文件上传组件 配合component与uploadType参数使用;hidden默认隐藏内部表单;需配合formList,component使用;custom自定义组件,配合component参数使用string---
component需传入ReactNode 若type为custom,hidden,upload时生效 接收initialValue,name,rules,data,label 等参数 若type为upload时component用于自定义样式,需设置id用以上传;若type为custom额外接收handleChange 当变更数据时调用该方法传入变更后的数据reactNodenull
initialValue表单默认数据stringnumbernull
name设置表单域内字段 idstringnull
label表单前缀名stringnull
isError是否需要直接在页面上展示输入错误提示booleanfalse
rules校验数据规则 参考https://ant.design/components/form-cn/#%E6%A0%A1%E9%AA%8C%E8%A7%84%E5%88%99 https://github.com/yiminghe/async-validatorArraynull
data若type为select,checkbox,custom 时生效, custom需自己接收 参数名为dataArray[]
formList参数同表单数据,不允许继续套用hidden 只有type为hidden时起效Array---
placeholder展示placeholder,默认组件使用stringnull
inline是否需要设置为inline-blockbooleanfalse
show只有type为hidden时起效,hidden中的组件是否显示,可通过操作show变更是否展示隐藏项booleanfalse
uploadType参数同oss-upload组件,只有type为custom与upload时接收使用,若upload使用不需要success参数jsonnull
isForm只有type为custom时起效 是否要将当前组件作为可提交的表单组件booleantrue
UIComponent当需要有额外样式使用,若type为upload,额外接收value参数,用以展示上传文件reactNodenull
className当前表单模块classNamestring---
readOnly是否只读,默认组件使用booleannull
disabled是否禁用,默认组件使用booleannull
height组件高度,默认组件使用numbernull
width组件宽度,默认组件使用numbernull
handleInit表单加载完成时的调用方法,返回form方法function-

参考文档

form