如何在thinkphp中使用b-jui_随笔

B-JUI 前端框架

B-JUI（Bootstrap for DWZ）是一个富客户端框架，基于DWZ-jUI富客户端框架修改。

本文是B-JUI中文使用手册，包括使用示例代码，感兴趣的同学参考下。

概览

B-JUI仅有一个主页面(document)，框架内的所有子页面将通过Ajax获取后作为一个页面片段附加到主页面上，外部页面则通过iframe嵌入主页面，本节介绍 B-JUI的主页面结构。

HTML5 文档类型

同Bootstrap， B-JUI使用 HTML5 文档类型，参照下面的格式进行设置。

<!DOCTYPE html>

...

</html>

主页面结构(仅body部分)

主页面由上（页头）、中左（导航菜单）、中右（工作区）、下（页脚）四部分组成，其中左侧导航菜单可收缩。结构如下：

</header>

</div>

</div>

</footer>

子页面（即页面片段[后面简称：页片]）结构

页片通常由两部分组成，也可以只保留bjui-pageContent部分，其中bjui-pageContent部分可选bjui-headBar（顶部工具条）和bjui-footBar（底部工具条）。结构如下：

</div>

</div>

</div>

</div>

data-layout-h 属性表示该容器为页片自适应布局，当值为0时，B-JUI会为该容器的高度自动赋值为：本页片总高度减去本页片中的固定元素(bjui-pageHeader\bjui-headBar\bjui-footBar)高度。

data-layout-h 属性值不等于0时，该容器高度为本页片总高度减去属性值。

需要自定义固定元素(块级元素有效)，请为该元素添加属性data-layout-fixed="true"

完整的页片详见B-JUI源代码的table.html，仅bjui-pageContent部分的页片详见form.html

元素ID命名规范

因为本框架默认所有内容都位于一个Document中，所以为元素命名ID的时候需要做到唯一性，如果确实不可避免的会出现有重复ID的现象，需要 *** 作当前页片的元素时，尽量用：

$.CurrentNavtab.find('#dom-id')，在当前标签工作区中查找指定ID的元素。

或 $.CurrentDialog.find('#dom-id')，在当前d窗中查找指定ID的元素。

标签式工作区(navtab)

B-JUI框架的整个工作区部分就是一个navtab组件，本组件位于主页面的"#bjui-container"容器内，固定的html结构如下：

</ul>

</div>

</div>

</ul>

各页片内容区域

</div>

用法(如何创建一个navtab)：

DOM点击触发：

<a href="mytab.html" data-toggle="navtab" data-id="mynavtab" data-title="我的业务页面">打开navtab</a>

<button type="button" class="btn-green" data-toggle="navtab" data-id="mynavtab" data-url="mytab.html" data-title="我的业务页面">打开navtab</button>

jQuery：

$(selector).navtab({id:'标签的id', url:'载入页片的url', title:'标签的标题'})

取得当前navtab的内容容器：$.CurrentNavtab

参数：

名称类型默认值描述 id string navtab 标签的ID，如果指定重复，将覆盖现有的ID相同标签。 title string New tab 标签打开后显示的名称。 url string undefined 请求数据的url。 type string GET Http请求方式，可选‘GET/POST’。 data object {} 请求url时，需要发送的data数据。

方法：

这样调用navtab的方法：

$(selector).navtab('方法名', 参数1, ..., 参数n)

如要切换到某个标签：

$(selector).navtab('switchTab', 标签ID)

方括号的参数，表示该参数可选。

可用的方法：

switchTab(tabid)：切换到某个标签。

refresh(tabid)：刷新某个标签。

reload(options)：重新载入某个标签，options同navtab默认参数，如果未指定ID，则默认重载入当前标签。

closeTab(tabid)：关闭某个标签。

closeCurrentTab([tabid])：关闭当前标签。

closeAllTab()：关闭所有标签。

事件：

这样监听navtab的事件：

$(document).on('bjui.beforeLoadNavtab', function(e) {

var $navtab = $(e.target)

// do something...

})

名称描述 bjui.beforeLoadNavtab 载入标签内容前的事件 bjui.beforeCloseNavtab 关闭标签前的事件

d出窗口(dialog)

d出窗口分为普通d出窗口和模态d出窗口，普通d出窗口可通过taskBar组件进行最小化等 *** 作。d出窗口的DOM结构会放入Body中，结构如下：

</div>

</div>

</div>

用法(如何创建一个dialog)：

DOM点击触发：

<a href="mydialog.html" data-toggle="dialog" data-id="mydialog" data-title="我的d出窗口">打开d出窗口</a>

<button type="button" class="btn-green" data-toggle="dialog" data-id="mynavtab" data-url="mytab.html" data-title="我的d出窗口">打开d出窗口</button>

jQuery：

$(selector).dialog({id:'d窗的id', url:'载入页片的url', title:'d窗的标题'})

取得当前dialog：$.CurrentDialog

参数：

名称类型默认值描述 id string navtab d窗的ID，如果指定重复，将覆盖现有的ID相同d窗。 title string New tab d窗打开后显示的名称。 url string undefined 请求数据的url。 type string GET Http请求方式，可选‘GET/POST’。 data object {} 请求url时，需要发送的data数据。 width int 500 d窗的宽度。 height int 300 d窗的高度。 max boolean false 打开d窗时直接最大化。 mask boolean false 是否模态窗口。 resizable boolean true 可以调整d窗的大小。 drawable boolean true 可以拖动d窗。 maxable boolean true 是否显示最大化按钮。 minable boolean true 是否显示最小化按钮（模态d窗无效）。

方法：

调用方式同navtab：如要关闭某个d窗：

$(selector).dialog('close', d窗ID)

方括号的参数，表示该参数可选。

可用的方法：

switchDialog(id)：切换到某个d窗(模态d窗无效)。

refresh(id)：刷新某个d窗。

reload(options)：重新载入某个d窗，options同dialog默认参数，如果未指定ID，则默认重载入当前d窗。

close(id)：关闭某个d窗。

closeCurrent()：关闭当前d窗。

事件：

这样监听dialog的事件：

$(document).on('bjui.beforeLoadDialog', function(e) {

var $dialog = $(e.target)

// do something...

})

名称描述 bjui.beforeLoadDialog 载入d窗内容前的事件 bjui.beforeCloseDialog 关闭d窗前的事件

Ajax

本节主要介绍B-JUI框架中的Ajax *** 作，回调函数等。

Ajax *** 作：

ajax搜索 - 主要用于搜索表单，分页表单，例：B-JUI源码"table.html"中的#pagerForm：

ajax重置搜索 - 主要用于重置搜索表单，data-clear-query属性告诉form是否清空查询参数，仅保留分页及字段排序信息，例：B-JUI源码"table.html"中的清空查询按钮：

ajax载入 - 主要用于为指定容器载入url的内容，data-target属性值为选择器表达式，告诉ajax载入的内容放到该容器，适合用来做局部刷新：

ajax动作 - 主要用于执行ajax命令，如“删除”，data-confirm-msg属性用于在 *** 作前进行确认提示：

ajax导出 - 主要用于导出信息(下载文件)，data-confirm-msg属性用于在 *** 作前进行确认提示：

ajax导出选中项 - 主要用于导出选中项信息(下载文件)，data-confirm-msg属性用于在 *** 作前进行确认提示，data-idname属性指定发送到后台的字段名称，默认“ids”，data-group属性用于指定复选框的name：

<a href="book1.xlsx" data-toggle="doexportchecked" data-confirm-msg="确定要导出选中项吗？" data-idname="expids" data-group="ids">导出选中项</a>

ajax删除选中项 - 主要用于导出选中项信息(下载文件)，data-confirm-msg属性用于在 *** 作前进行确认提示，data-idname属性指定发送到后台的字段名称，默认“ids”，data-group属性用于指定复选框的name：

<a href="del.html" data-toggle="dodelchecked" data-confirm-msg="确定要删除选中项吗？" data-idname="delids" data-group="ids">导出选中项</a>

Ajax回调：

ajaxsearch、doajax、dodelchecked三种ajax *** 作支持自定义ajax回调函数，自定义的回调函数放到data-callback属性，写法如下：。

function mycallback(json) {

//do something...

}

服务端返回的JSON参数如下：

名称类型描述 statusCode int 必选。状态码(ok = 200, error = 300, timeout = 301)，可以在BJUI.init时配置三个参数的默认值。 message string 可选。信息内容。 tabid string 可选。待刷新navtab id，多个id以英文逗号分隔开，当前的navtab id不需要填写，填写后可能会导致当前navtab重复刷新。 closeCurrent boolean 可选。是否关闭当前窗口(navtab或dialog)。 forward string 可选。跳转到某个url。 forwardConfirm string 可选。跳转url前的确认提示信息。

默认的回调函数会根据当前触发元素的位置确定是刷新navtab还是dialog，或是局部div容器。

可调用的返回信息提示：

$(selector).bjuiajax('ajaxDone', json)

表格

表格的Class同Bootstrap，仅调整了padding值，使表格显示得更紧凑。

.table 少量的padding和水平分隔线。

.table-striped 条纹状表格 [IE8 不支持]。

.table-bordered 带边框表格。

.table-hover 附加鼠标悬停效果。

表格表头字段排序按钮实现：

data-order-field=""属性令本字段可排序，属性值为与后台交互的字段名称。

data-order-direction属性表示本字段的当前排序状态，可选值(asc/desc)

普通表格

普通的表格，可显示列表状条目，或布局表单，表头字段可附加排序按钮。

完整的实例详见B-JUI源代码的table.html。

固定表头表格

表格的头可固定住，可调整各列的宽度，表头字段可附加排序按钮。

表格添加属性data-toggle="tablefixed"后就会固定表头，B-JUI默认为固定的表头的表格添加Class：table table-striped table-bordered table-hover，如果该table设置有Class，则以设置的为准

data-width属性可定义固定表格的宽度，默认为"100%"，可设置大于100%或固定值，如：150%和1200都是合法的，超过navtab工作区的宽度时会出现横向滚动条。

完整的实例详见B-JUI源代码的table-fixed.html。

可编辑表格

用于需要动态添加简单行内容的地方。

<thead>

<tr>

</th>

</tr>

</thead>

</table>

实现步骤：

表格添加属性data-toggle="tablefixed"；

thead中添加上对应的表单信息，字段名放到title属性上；

若想在某列上显示添加按钮，需在对应列上添加属性data-addtool="true"；

若每行显示删除按钮，需为删除按钮添加Classrow-del，如果要确认才能删除，需为删除按钮添加属性data-confirm-msg="删除提示信息"。

表格的data-initnum属性，表示载入本页片时，初始化的添加行数，值为0时不需写。

外部触发添加行事件：

按钮式：

<button type="button" class="btn-green" data-toggle="tableditadd" data-target="#tabledit1" data-num="1">添加编辑行</button>

data-target属性设置编辑表格的jQuery选择器，data-num属性设置点击时添加的行数。

jQuery：$(selector).tabledit('add', 编辑表格的jQuery对象, 待添加的行数)

$(selector).tabledit('add', $('#tabledit1'), 2)

完整的实例详见B-JUI源代码的table-edit.html。

是和百度一样的吗？打一个字，就可以出来一些可能的结果

如果是的话使用AJAX，JQuery的.post函数，然后用php *** 作数据库把结果通过json发给前台，前台的.post得到以后展开数据，通过JQuery *** 作DOM生成搜索词

欢迎分享，转载请注明来源：内存溢出

原文地址: http://outofmemory.cn/zaji/7082961.html

如何在thinkphp中使用b-jui

发表评论

评论列表（0条）