快捷導(dǎo)航

基于react hooks,zarm組件庫(kù)配置開發(fā)h5表單頁面的實(shí)例代碼

更新時(shí)間：2021年04月06日 10:02:08 作者：記憶的森林

這篇文章主要介紹了基于react hooks,zarm組件庫(kù)配置開發(fā)h5表單頁面,本文通過實(shí)例代碼給大家介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值，需要的朋友可以參考下

最近使用React Hooks結(jié)合zarm組件庫(kù)，基于js對(duì)象配置方式開發(fā)了大量的h5表單頁面。大家都知道h5表單功能無非就是表單數(shù)據(jù)的收集，驗(yàn)證，提交，回顯編輯，通常排列方式也是自上向下一行一列的方式顯示，所以一開始就考慮封裝一個(gè)配置化的頁面生成方案，目前已經(jīng)有多個(gè)項(xiàng)目基于此方式配置開發(fā)上線，思路和實(shí)現(xiàn)分享一下。

使用場(chǎng)景

任意包含表單的h5頁面（使用zarm庫(kù)，或自行適配自己的庫(kù)）

目標(biāo)

代碼實(shí)現(xiàn)簡(jiǎn)單和簡(jiǎn)潔
基于配置
新手上手快，無學(xué)習(xí)成本
老手易擴(kuò)展和維護(hù)

寫之前參考了市面上的一些方案，大多都是通過定義json schema方式定義一套格式，比如阿里的form-render ,通過 JSON Schema定義表單，有可視化編輯器配置，導(dǎo)出json文件，動(dòng)態(tài)渲染，凡此種種，無出其外。這里就以阿里form-render為代表，談?wù)勊囊恍┤毕?(優(yōu)點(diǎn)自行參考官網(wǎng)宣傳)

form-render或思路一些缺陷

1.我的目標(biāo)是h5， form-remder目前僅僅是pc后臺(tái)表單配置方案，提供了antd和fusion主題，默認(rèn)不支持h5

2.form-render 支持?jǐn)U展組件，內(nèi)部維護(hù)了一個(gè)映射表 mapping，映射了數(shù)據(jù)類型和組件的映射關(guān)系,比如antd主題各數(shù)據(jù)類型和antd組件的映射關(guān)系如下,如果我有一套自己的/第三方公司統(tǒng)一使用的h5組件庫(kù)，需要自己去配置擴(kuò)展,比較麻煩。

// 例如在antd下映射如下：
export const mapping = {
 default: 'input',
 string: 'input',
 array: 'list',
 boolean: 'checkbox',
 integer: 'number',
 number: 'number',
 object: 'map',
 html: 'html',
 'string:upload': 'upload',
 'string:date': 'date',
 'string:dateTime': 'date',
 'string:time': 'date',
 'string:textarea': 'textarea',
 'string:color': 'color',
 'string:image': 'input',
 'string:email': 'input',
 'string:url': 'url',
 'range:date': 'dateRange',
 'range:dateTime': 'dateRange',
 '*?enum': 'select',
 'array?enum': 'checkboxes',
};

如果用過/開發(fā)過 form-render 等基于json schema的工具，有一個(gè)需求處理比較麻煩，比如表單字段聯(lián)動(dòng)處理， form-render 提供了有限的幾個(gè)聯(lián)動(dòng)屬性，ui:options,ui:disabled,ui:hidden等，這樣算下來，除了需要掌握form-render定義的數(shù)據(jù)類型，數(shù)據(jù)類型主題組件映射,及組件關(guān)聯(lián)的各種屬性，還要背下額外的聯(lián)動(dòng)屬性，不外乎多學(xué)了一門新編程的復(fù)雜程度，所以需要可視化界面輔助編輯。

import React, { useState } from 'react';
import FormRender from 'form-render/lib/antd';

const schema = {
 type: 'object',
 properties: {
 select: {
  title: '單選',
  type: 'string',
  enum: ['a', 'b'],
  enumNames: () => ['顯示輸入框', '隱藏輸入框'],
  'ui:disabled': (formData, rootValue) => rootValue.input1.length > 5,
  'ui:widget': 'radio',
 },
 input1: {
  title: '輸入框',
  description: '嘗試輸入超過5個(gè)字符',
  type: 'string',
  'ui:hidden': (formData, rootValue) => formData.select === 'b',
 },
 },
};

const Demo1 = () => {
 const [formData, setFormData] = useState({});
 return (
 <FormRender schema={schema} formData={formData} onChange={setFormData} />
 );
};

export default Demo1;

4.這種配置的json適合非開發(fā)人員快速懟出表單功能，但是不適合開發(fā)人員開發(fā)擴(kuò)展，比如我要在兩個(gè)輸入框中間放個(gè)圖文混排的東西. （另行開發(fā)一個(gè)自定義組件掛載？）

javascript object 方案

所以以阿里form-render 等以json配置實(shí)現(xiàn)動(dòng)態(tài)渲染的方案不能滿足簡(jiǎn)單，快速，突破，共贏的碼農(nóng)生存準(zhǔn)則，如果把json換成javascript object , 那配置和擴(kuò)展的能力就不一樣了, 這里我們還是借用form-render的總體思路，但是將type從string,number,boolean,array,object,html等數(shù)據(jù)類型換成Function，一個(gè)Function就是一個(gè)React組件，比如antd-mobile ,zarm 的Input組件,因?yàn)楸疚幕趜arm, 后面都基于zarm展開（對(duì)antd-mobile ，vue等第三方移動(dòng)端/pc端同樣適用），例如下面的配置

import React, { useState, useEffect } from 'react';
import FormRenderer from 'zarm-form-render';
import { Input, Cell, Radio, Select, DateSelect, Button, Toast, Panel } from 'zarm';

export default function App() {
 const [data, setData] = useState({});

 const layoutData = [
 {
  type: Input,
  label: '被保人姓名',
  placeholder: '請(qǐng)?zhí)顚?,
  name: 'name',
 },
 {
  type: Radio.Group,
  label: '性別',
  name: 'gender',
  elProps: {
  type: 'button',
  ghost: true,
  },
  items: [
  { label: '男', value: 'male' },
  { label: '女', value: 'female' },
  ],
 },
 {
  render() {
  if (!data.gender) return null;
  return <Cell title="你是" description={data.gender === 'male' ? '男生' : '女生'}></Cell>;
  },
 },
 {
  type: Select,
  label: '愛吃的水果',
  name: 'favfood',
  elProps: {
  dataSource: [
   { label: 'apple', value: 'apple' },
   { label: 'banana', value: 'banana' },
  ],
  },
 },

 {
  type: DateSelect,
  label: '出生日期',
  title: '被保人出生日期',
  placeholder: '請(qǐng)選擇',
  name: 'birthday',
  min: '1900-01-01',
 },
 {
  type: Input,
  label: '手機(jī)號(hào)',
  placeholder: '請(qǐng)?zhí)顚?,
  name: 'mobile',
 },
 {
  render() {
  return <div style={{ margin: '30px 6px',}}></div>;
  },
 },
 {
  render() {
  return (
   <Panel title="你錄入的內(nèi)容">
   <div style={{ margin: '10px 6px' }}>{JSON.stringify(data)}</div>
   </Panel>
  );
  },
 },
 ];

 return (
 <div>
  <FormRenderer layoutData={layoutData} data={data} setData={setData} />
  <Button block theme="primary" onClick={() => Toast.show(JSON.stringify(data))}>
  確定
  </Button>
 </div>
 );
}

一個(gè)表單由一個(gè)數(shù)組定義，對(duì)象type為要渲染的組件, name為收集數(shù)據(jù)的key,其他屬性定義組件其他的props，基于哪個(gè)庫(kù)，則參考相關(guān)庫(kù)的組件API文檔配置即可，對(duì)于一些特殊的/不存在的組件我們定義render函數(shù)動(dòng)態(tài)渲染，然后就沒有其他的了，全部是你熟悉的React，最終我們可以定義一個(gè)自己的FormRender 接受一個(gè)一維數(shù)組用于從上往下排列表單項(xiàng)(用render不限于表單項(xiàng)，你可以render任意內(nèi)容)，一個(gè)data用于數(shù)據(jù)收集，一個(gè)setData用于數(shù)據(jù)更新 (源自React Hooks useState)，就這么簡(jiǎn)單，源碼如下

import React from 'react';
import { Cell, Radio, DateSelect, Select } from 'zarm';

// 對(duì)于無法配置(比如自定義組件，需要根據(jù)條件顯示的組件等)的情況， 請(qǐng)使用render方法，
// getJSON() 動(dòng)態(tài)返回json
// render() 自定義render

export default function FormRenderer({ layoutData, data, setData }) {
 const onFiledChange = (name, value) => {
 let v = value;

 // for Select ctrl
 if (Array.isArray(value)) {
  v = value.map((item) => item.value)[0];
 }

 setData({ ...data, [name]: v });
 };

 const onChangeFactory = (name) => (value) => onFiledChange(name, value);

 return (
 <div className="renderer">
  {layoutData.map((item, idx) => {
  if (typeof item.getJSON === 'function') {
   item = item.getJSON();
  }
  if (typeof item !== 'object' || !item) return null;
  const {
   name,
   type,
   description,
   items,
   elProps = {},
   cellProps = {},
   render,
   ...props
  } = item;

  if (typeof render === 'function') {
   return render();
  }

  let children = [];
  if (Array.isArray(items) && type === Radio.Group) {
   children = items.map((it, idx1) => (
   <Radio value={it.value} key={idx1}>
    {it.label}
   </Radio>
   ));
  }

  props.value = data[name];
  props.onChange = onChangeFactory(name);

  if (type === Select) {
   props.dataSource = items;
  }
  if (type === DateSelect || type === Select) {
   props.onOk = props.onChange;
   delete props.onChange;
   props.onChange = elProps.onChange;
  }

  return (
   <Cell key={idx} title={item.label} description={description} {...cellProps} name={name}>
   {React.createElement(type, { ...props, ...elProps }, ...children)}
   </Cell>
  );
  })}
 </div>
 );
}

配置說明

import * as React from 'react';
export interface Item {
 type: React.Component; // 組件類型， 比如Input 等
 name: string; // key
 items?: Array<any>; // dataSource
 description: string; // Cell description
 label?: string; // Cell title
 render?: () => React.ReactNode; //自定義 render
 getJSON?: () => object | null; // 動(dòng)態(tài)返回Item配置
 elProps?: object; // 組件的props配置 , 比如type為Input, elProps則會(huì)配置到Input
 cellProps?: object; // cell props配置
}
export interface Props {
 layoutData: Array<Item>; // 表單布局配置
 data: object; // 數(shù)據(jù)存儲(chǔ),name作為key,內(nèi)容為value
 setData: () => void; // 數(shù)據(jù)更新
}
interface FormRenderer extends React.FC<Props> {}
declare const FormRenderer: FormRenderer;
export default FormRenderer;

上述代碼效果如下

這種方式唯一缺點(diǎn)是無法像json一樣持久化存儲(chǔ)在數(shù)據(jù)庫(kù) ，優(yōu)點(diǎn)是可以統(tǒng)一移動(dòng)和pc端表單配置式開發(fā)，少了大量的樣板代碼和嵌套，可以統(tǒng)一處理數(shù)據(jù)的存取和驗(yàn)證,表單項(xiàng)的排列方式。

到此這篇關(guān)于基于react hooks,zarm組件庫(kù)配置開發(fā)h5表單頁面的文章就介紹到這了,更多相關(guān)react hooks,zarm組件庫(kù)內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: