mip-form
| 标题 | 内容 |
|---|---|
| 类型 | 动态内容 |
| 支持布局 | responsive, fixed-height, fill, container, fixed |
| 所需脚本 | https://c.mipcdn.com/static/v2/mip-form/mip-form.js |
示例
基本使用
mip-form 通过必选项 method 设置提交方法,url 设置表单提交地址。同时可选项 validatetarget 和 validatetype 支持对表单中 input 进行校验。
1234567<mip-form method="get" url="https://www.mipengine.org?we=123">
<input type="text" name="username" validatetarget="username" validatetype="must" placeholder="姓名">
<div target="username">姓名不能为空</div>
<input type="number" name="age" validatetarget="age" validatetype="must" placeholder="年龄">
<div target="age">年龄不能为空</div>
<input type="submit" value="提交">
</mip-form>加清空按钮
<mip-form> 添加 clear 属性可以对表单中 <input> 添加清空按钮。
1234567<mip-form method="get" url="https://www.mipengine.org" clear>
<input type="text" name="username2" validatetarget="username2" validatetype="must" placeholder="姓名">
<div target="username2">姓名不能为空</div>
<input type="number" name="age2" validatetarget="age2" validatetype="must" placeholder="年龄">
<div target="age2">年龄不能为空</div>
<input type="submit" value="提交">
</mip-form>自定义验证规则
12345<mip-form method="get" url="https://www.mipengine.org">
<input type="text" name="customnumber" validatetarget="custom" validatetype="custom" validatereg="^[0-9]*$" placeholder="我是自定义验证规则数字">
<div class="mip-form-target" target="custom">请输入正确的数字</div>
<input type="submit" value="提交">
</mip-form>页面数据刷新
1234567891011121314<mip-form fetch-url="http://yourdomain.com/path">
<input type="text" name="name" placeholder="姓名">
<div submit-success>
<template type="mip-mustache">
Success! Thanks for {{name}} trying the mip demo.
</template>
</div>
<div submit-error>
<template type="mip-mustache">
Error!.
</template>
</div>
<input type="submit" value="提交">
</mip-form>属性
method
说明:表单提交方法
必选项:是
url
说明:表单提交地址,必须是 http(s) 或 // 开头的地址
必选项: 是
validatetarget
说明: 验证提示对应 tag,用于对应错误时的提示显示元素的查找
必选项:否
validatetype
说明:验证类型, 用于支持简单的验证。目前提供 must, email, phone, idcar, custom。当类型为 must 时表示提交项不能为空,类型为 custom 时则需要填写 validatereg 实现自定义校验。
必选项:否
validatereg
说明: 自定义验证,补充站长个性化的验证规则。如果 validatetype 为 custom 时需填写相应验证规则
必选项:否
clear
说明: 表单中 <input> 清空按钮开关
fetch-url
说明: 有此属性则可以开启异步请求数据逻辑,组件会并根据数据返回状态来按submit-success,submit-error块中的模板刷新局部信息。 需要注意的几个点:
- 方法支持。
- 请求结果请返回 JSON 对象。
- 数据状态只有在成功(2xx)的时候触发
submit-success的逻辑,其他的均触发submit-error逻辑。
必选项:否
注意事项
- 表单提交方法如果为
post,应使用 HTTPS 地址。避免 MIP-Cache HTTPS 环境提交到 HTTP,导致浏览器报错。 - 使用 fetch 功能时,请求使用 cors 时不能配置为 *。