一、什么是fomer?

fomer是一个基于React的前端库，可以方便地创建表单。使用它，你不需要编写HTML表单，只需要使用JavaScript以及一些CSS类名即可创建美丽的、可扩展的表单。

二、fomer的特点

1、易于使用

fomer很容易学习和使用，只需要熟悉一些简单的API和CSS类名即可。

import Form, { TextInput, CheckboxInput } from 'fomer';
function MyForm() {
  return (
    <Form onSubmit={handleSubmit}>
      <TextInput name="username" label="Username" placeholder="Enter your username" />
      <TextInput name="password" label="Password" type="password" placeholder="Enter your password" />
      <CheckboxInput name="rememberMe" label="Remember me" />
      <button type="submit">Submit</button>
    </Form>
  );
}

2、可扩展性

fomer还提供了许多扩展选项和自定义样式的机会。你可以定义自己的输入组件，或者修改fomer提供的组件的样式。

import { createInput } from 'fomer';
import './MyTextInput.css';
const MyTextInput = createInput('MyTextInput', ({ name, label, value, onChange }) => (
  <div className="myTextInput">
    <label htmlFor={name}>{label}</label>
    <input type="text" id={name} name={name} value={value} onChange={onChange} />
  </div>
));
function MyForm() {
  return (
    <Form onSubmit={handleSubmit}>
      <MyTextInput name="username" label="Username" placeholder="Enter your username" />
      <MyTextInput name="password" label="Password" type="password" placeholder="Enter your password" />
      <CheckboxInput name="rememberMe" label="Remember me" />
      <button type="submit">Submit</button>
    </Form>
  );
}

3、表单验证

fomer还可以帮助你进行表单验证。你只需要定义一个验证函数，它会在表单被提交之前进行验证。

import Form, { TextInput } from 'fomer';
function validate(values) {
  const errors = {};
  if (!values.username) {
    errors.username = 'Required';
  }
  if (!values.password) {
    errors.password = 'Required';
  }
  return errors;
}
function MyForm() {
  return (
    <Form onSubmit={handleSubmit} validate={validate}>
      <TextInput name="username" label="Username" placeholder="Enter your username" />
      <TextInput name="password" label="Password" type="password" placeholder="Enter your password" />
      <button type="submit">Submit</button>
    </Form>
  );
}

三、fomer的API

1、Form

Form是fomer的主要组件，它用于创建表单。它有几个重要的属性：

onSubmit: (values: object) => void：表单提交后的回调函数；
initialValues: object：表单输入的初始值；
validate: (values: object) => object：表单验证的函数；
className: string：自定义表单的CSS类名；
style: object：自定义表单的样式。

2、TextInput

TextInput用于创建文本输入框。

name: string：输入框的名称；
label: string：输入框的标签；
type: string：输入框的类型，如"text"或"password"（默认为"text"）；
placeholder: string：输入框的占位符。

3、CheckboxInput

CheckboxInput用于创建复选框。

name: string：复选框的名称；
label: string：复选框的标签。

4、createInput

createInput是一个帮助你创建自定义输入组件的函数。

type: string：输入组件的类型；
render: (props: object) => ReactNode：输入组件的渲染函数。

四、总结

fomer是一个非常优秀的前端库，它使得创建表单变得更加容易和优雅。它具有易于使用、可扩展性和表单验证等特点，可以让你轻松地创建出美丽、优秀的表单。如果你还没有使用fomer，一定不要错过它！

全方位解析fomer——无需编写HTML表单的前端库