前端组件
# 前端组件
JbootAdmin 内置了大量的组件,我们几乎不需要编写任何的 JavaScript 代码就可以轻松的使用这些前段组件。
# Layer
Layer 是一个功能强大的弹出层,弹出层里既可以通过一个 Div 来渲染,也可以通过一个 IFrame 来渲染弹出。
示例:
<a href="user.html" open-type="layer"> 示例 </a>
当我们点击该 a
标签链接时,此链接将以弹窗的方式访问 user.html
。若是 input
或者 textarea
等添加了 open-type="layer"
属性,那么当 input
或者 textarea
获得焦点的时候,会自动打开弹窗 Layer。
在组件中,可以配置的属性如下:
- data-layer-type : 打开 layer 的类型
- data-layer-title : 打开 layer 的标题
- data-layer-anim : 打开 layer 的动画
- data-layer-shade-close
- data-layer-shade
- data-layer-area
- data-layer-content
- data-layer-binds : layer 关闭后,对数据进行绑定
- data-layer-end : 当 layer 关闭后,执行的方法
# Switchery 开关
<input class="switchery" type="checkbox">
其支持的属性内容如下:
- for: 自动同步 switchery 的值到其他的 input
- data-ctrl: 用于控制某个 div 显示或隐藏
- data-open-sync :当此 switchery 开启的时候,自动同步到其他的 switchery 一起开启。
- data-close-sync : 当此 switchery 关闭的时候,自动同步其他的 switchery 一起关闭。
- data-change-function : 当此 switchery 点击开启或者关闭时执行的方法
# 确认操作弹出组件
在很多场景下,在用户要进行某个操作之前,我们需要弹出一个对话框让用户进行确定。比如我们要删除某个数据,我们需要弹出一个确认框让用户确认之后,在进行下一步的删除行动。
<a href="href/to/your/path" open-type="confirm">
或者 如下代码用于 删除数据 的弹出确认。
<a href="href/to/your/path" open-type="del-confirm">
其支持的属性内容如下:
- data-title : 弹出确认框标题
- data-text: 弹出确认框内容
- data-btn-text: 弹出确认框按钮内容
- data-success-title : 成功弹出标题
- data-success-text: 成功弹出内容
- data-success-function : ajax 提交数据成功执行的方法
- data-success-goto: ajax 执行数据成功后,跳转到的页面url地址
- data-success-message: ajax 支持成功后,弹出提示内容
- data-fail-function: ajax 提交失败后,执行的 js 方法
- data-fail-message: ajax 提交失败后,弹出的提示内容。
# 链接自动 Ajax 提交
<a href="/href/to/your/path" open-type="ajax">
当 a
标签有 open-type="ajax"
时,我们点击 a
标签的时候,自动会自动以 ajax 方式提交到 /href/to/your/path
,但是往往我们需要执行完成 ajax 提交后,会执行某些动作,此时需要添加
data-success-function
属性。
<a href="/href/to/your/path" open-type="ajax" data-success-function="myfunc">
<script>
function myfunc(data){
//data 为后台返回的 json 数据
alert('ajax finished!');
}
</scripts>
其支持的属性内容如下:
- data-success-function : ajax 提交数据成功执行的方法
- data-success-goto: ajax 执行数据成功后,跳转到的页面url地址
- data-success-message: ajax 支持成功后,弹出提示内容
- data-fail-function: ajax 提交失败后,执行的 js 方法
- data-fail-message: ajax 提交失败后,弹出的提示内容。
# 图片上传组件
JbootAdmin 图片上传组件支持了图片剪切的功能,如下图所示:
上传图片的本质是使用了 layer 组件,当 上传图片 的 layer 弹出被关闭的时候,会自动把 src 只返回来。我们可以使用属性 data-layer-binds 来为其绑定数据。例如:
<a href="/cms/upload/image" open-type="layer"
data-layer-area="['800px', '600px']"
data-layer-title="上传图片..."
data-layer-binds="#input:src">选择图片</a >
调用上传图片组件,调用完成后,自动把图片的地址绑定到 id='input'
的组件里去。
<a href="/cms/upload/image" open-type="layer"
data-layer-area="['800px', '600px']"
data-layer-title="上传图片..."
data-layer-end="endFunction">选择图片</a >
调用上传图片组件,调用完成后,自动把自动执行 endFunction(data)
这个 js 方法,通过 data.src
可以获得图片的 url 地址。