jQuery.chatbox说明文档特性1.轻量级动画特效以及友好的界面2.支持多窗口3.完善的回调函数以实现自定义功能4.多种调用方式4.良好的封装以及扩展性5.每个聊天窗对象实例以data属性的形式附加在聊天窗DOM对象上（如果你想获得某个特定插件的实例，可以直接从页面元素中获取：$('{boxId}').data('chatbox')）配置项
配置项分为全局配置项和实例配置项
全局配置项:参数 类型 默认值 说明-----------------------------------------------------------------------------------------------id umber ull 当前用户的id，也就是发送者的id，必须是唯一值user strig ull 发送者的显示名称，可以是昵称用户名等，不要求唯一debug boolea false 是否打开调试功能idPrefix strig 'chatbox_' 生成页面DOM元素的id值实例配置项:参数 类型 默认值 说明-----------------------------------------------------------------------------------------------id umber ull 接收者的id，同时也会作为实例id，必须是唯一值user strig ull 接收者的显示名称，可以是昵称用户名等，不要求唯一title strig 'Chat with '+{user} 聊天窗的标题回调函数回调函数也分为两种，一种是全局回调函数另一种是实例回调函数。但是有点Javascript基础的开发者应该了解不管是哪种类型的回调函数我们都应该以传递函数引用的方式来调用，而不是对每个实例创建一个函数副本。这样会造成内存浪费。全局回调函数不会在实例化每个聊天窗对象时重复创建副本分配给每个对象实例，而实例回调函数会。因此在不需要为每个独立的聊天窗分配不同的回调功能时使用实例回调函数也应该以传递函数引用的方式来分配回调函数以节省内存空间。回调函数参考:函数名 参数 说明-----------------------------------------------------------------------------------------------oChatboxCreate 创建聊天窗时触发oChatboxEable 聊天窗被启用时触发oChatboxDisable 聊天窗被禁用时触发oMessageSed msg 发送消息时触发,唯一参数:消息内容msgoMessageReceive msg 收到消息时触发,唯一参数:消息内容msgoMessageSystem msg 收到系统消息时触发,唯一参数:消息内容msgoChatboxDestroy 销毁聊天窗时触发 优先级：实例回调函数优先级高于全局回调函数，也就是说实例配置项中的回调函数会覆盖全局配置项中同名的回调函数。 this指针：this指针经由apply或者call方法已经指向调用该方法的实例。API(属性和方法)全局API:属性/方法名 类型 参数 说明-----------------------------------------------------------------------------------------------globalOptios 属性 无 保存所有聊天窗的全局配置项getQueue() 方法 无 返回当前聊天窗的实例队列实例API:属性/方法名 类型 参数 说明-----------------------------------------------------------------------------------------------$elem 属性 无 保存着当前聊天窗实例的jQuery对象opts 属性 无 保存着当前聊天窗实例的初始化选项show() 方法 无 显示聊天窗hide() 方法 无 隐藏聊天窗eable() 方法 无 启用聊天窗disable() 方法 无 禁用聊天窗message() 方法 msg,type 设置接收到的消息到聊天窗,两个参数:消息内容msg、消息类型typeblik() 方法 无 高亮标题栏闪烁提示destroy() 方法 无 无调用方式设定全局配置项: 直接定义配置对象globalOptios，未给定的配置项依旧会使用默认值并不会被该配置对象覆盖$.chatbox.globalOptios = { id:10000, user:'Jaso', debug:true, oChatboxCreate:fuctio(){ //要执行的代码 }}或者以附加属性的方式$.chatbox.globalOptios.id = 10000;$.chatbox.globalOptios.user = 'Jaso';$.chatbox.globalOptios.oChatboxCreate = fuctio(){ //要执行的代码}; 初始化聊天窗: $.chatbox({ id:11254, user:'Toy', title:'Chat with Toy', oChatboxCreate:fuctio(){ //要执行的代码 }}); 调用API方法: 第一种调用方式$.chatbox({istaceId}).message({message cotet});第二种调用方式$({boxId}).data('chatbox').message({message cotet});
评论