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 时不能配置为 *。