<!DOCTYPE html>
<!-- saved from url=(0029) -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1">
<title>LayIM 前端文档</title>
<meta name="description" content="">
<link rel="stylesheet" href="./LayIM 前端文档_files/font_24081_60slu02pimt.css">
<link rel="stylesheet" href="./LayIM 前端文档_files/layui.css">
<link rel="stylesheet" href="./LayIM 前端文档_files/global.css" charset="utf-8">
<link rel="stylesheet" href="./LayIM 前端文档_files/global(1).css" charset="utf-8">
<link rel="stylesheet" href="./LayIM 前端文档_files/docs.css" charset="utf-8">
<style>
.fly-footer {
border: none;
}
</style>
<link id="layuicss-laydate" rel="stylesheet" href="./LayIM 前端文档_files/laydate.css" media="all">
<link id="layuicss-layer" rel="stylesheet" href="./LayIM 前端文档_files/layer.css" media="all">
<link id="layuicss-skincodecss" rel="stylesheet" href="./LayIM 前端文档_files/code.css" media="all">
<script src="./LayIM 前端文档_files/getjs_bdtj"></script>
<script charset="utf-8" src="./LayIM 前端文档_files/insert_bdtj"></script>
<script src="./LayIM 前端文档_files/hm.js.下载"></script>
</head>
<body class="fly-body-docs">
<div class="layui-header header header-docs" style="background-color: #24262F;">
<div class="layui-container"> <a class="logo" href="https://www.layui.com/"> <img src="./LayIM 前端文档_files/logo.png"
alt="layui"> </a>
<div class="layui-form component" lay-filter="LAY-site-header-component"></div>
</div>
</div>
<!--[if lt IE 9]> <script src="https://cdn.staticfile.org/html5shiv/r29/html5.min.js"></script> <script src="https://cdn.staticfile.org/respond.js/1.4.2/respond.min.js"></script><![endif]-->
<div class="layui-container">
<div class="fly-docs-container">
<div class="fly-docs-info"> <span>更新:3天前</span> <span>阅读:2214</span> </div>
<h1 class="fly-docs-title">LayIM 前端文档</h1>
<div class="layui-text fly-md-text" data-doc="0.0009005256081947831">
<p>当前文档适用于 LayIM PC 端版本
</p>
<blockquote>
<p>LayIM 是基于 layui 的一款用于开发网页端聊天系统的纯静态 UI 界面解决方案,采用 HTML、CSS、JavaScript
编写,其包含的只是一套前端源代码素材和相关的模拟示例,不具备后台程序以数据库存储等功能。因此实际使用时,需要自己开发后端语言或对接云服务平台(如:融云、环信等)。</p>
</blockquote>
<div class="fly-md-dir">
<ul>
<li><a href="#start">开始使用</a></li>
<li><a href="#config">初始化配置</a></li>
<li><a href="#init">init数据格式</a></li>
<li><a href="#members">获取群员</a></li>
<li><a href="#uploadImage">上传图片/文件</a></li>
<li><a href="#tool">扩展工具栏</a></li>
<li><a href="#msgbox">消息盒子</a></li>
<li><a href="#find">查找页面</a></li>
<li><a href="#log">更多聊天记录</a></li>
<li><a href="#text">富文本内容格式</a></li>
<li><a href="#WebSocket">WebSocket</a></li>
<li><a href="#on">ready事件</a></li>
<li><a href="#ononline">监听在线状态切换</a></li>
<li><a href="#onsign">监听修改签名</a></li>
<li><a href="#onsetSkin">监听更换背景皮肤</a></li>
<li><a href="#onsendMessage">监听发送的消息</a></li>
<li><a href="#ongetMessage">监听接受的消息</a></li>
<li><a href="#onmembers">监听查看群员</a></li>
<li><a href="#onchatChange">监听聊天窗口切换</a></li>
<li><a href="#chat">自定义聊天窗口</a></li>
<li><a href="#setChatStatus">更新当前会话状态</a></li>
<li><a href="#add">弹出添加面板</a></li>
<li><a href="#setFriendGroup">好友分组面板</a></li>
<li><a href="#addList">添加好友/群到主面板</a></li>
<li><a href="#removeList">移除主面板的好友/群</a></li>
<li><a href="#setFriendStatus">好友置灰和取消</a></li>
<li><a href="#cache">获取缓存</a></li>
<li><a href="#dellocal">删除本地记录</a></li>
</ul>
</div>
<p><a name="start"> </a></p>
<h2>开始使用</h2>
<p>LayIM 是基于 layui 模块体系的扩展组件。使用时,将您获得的压缩包解压,将文件放入你的项目后,不用再对其代码做任何修改(方便下次升级)。然后您只需引入下述两个文件即可。</p>
<pre><code>./layui/css/layui.css
./layui/layui.js
</code></pre>
<p>一个最直接的例子是:</p>
<pre><code><!doctype html>
<html>
<head>
<meta charset="utf-8">
<title>LayIM 测试</title>
<link rel="stylesheet" href="./layui/css/layui.css" media="all">
</head>
<body>
<script src="./layui/layui.js"></script>
<script>
//以下为 layim 最新版写法
layui.config({
layimPath: '../dist/' //配置 layim.js 所在目录
,layimAssetsPath: '../dist/layim-assets/' //layim 资源文件所在目录
}).extend({
layim: layui.cache.layimPath + 'layim' //配置 layim 组件所在的路径
}).use('layim', function(layim){ //加载组件
//先来个客服模式压压精
layim.config({
brief: true //是否简约模式(如果true则不显示主面板)
}).chat({
name: '一个新窗口'
,type: 'friend'
,avatar: 'http://tp1.sinaimg.cn/5619439268/180/40030060651/1'
,id: -2
});
});
</script>
</body>
</html>
</code></pre>
<p>通过上述方式,便可成功加载 layim。当然,你仅仅只是看到了一个"新窗口"的聊天面板,这等同于:Hello World!<br>
向“客服姐姐”问好后就忘了它吧,这份文档才刚刚开始。</p>
<p><a name="config"> </a></p>
<h2>初始化配置</h2>
<p>一个你必须认识的方法:layim.config(options)<br>
控制着许多重要的配置,基本上一个完整LayIM实例的构成由它而开始,它允许你自由设定以下参数:</p>
<pre><code>layui.config({
layimPath: '../dist/' //配置 layim.js 所在目录
,layimAssetsPath: '../dist/layim-assets/' //layim 资源文件所在目录
}).extend({
layim: layui.cache.layimPath + 'layim' //配置 layim 组件所在的路径
}).use('layim', function(layim){ //加载组件
//基础配置
layim.config({
init: {} //获取主面板列表信息,下文会做进一步介绍
//获取群员接口(返回的数据格式见下文)
,members: {
url: '' //接口地址(返回的数据格式见下文)
,type: 'get' //默认get,一般可不填
,data: {} //额外参数
}
//上传图片接口(返回的数据格式见下文),若不开启图片上传,剔除该项即可
,uploadImage: {
url: '' //接口地址
,type: 'post' //默认post
}
//上传文件接口(返回的数据格式见下文),若不开启文件上传,剔除该项即可
,uploadFile: {
url: '' //接口地址
,type: 'post' //默认post
}
//扩展工具栏,下文会做进一步介绍(如果无需扩展,剔除该项即可)
,tool: [{
alias: 'code' //工具别名
,title: '代码' //工具名称
,icon: '' //工具图标,参考图标文档
}]
,msgbox: layui.cache.dir + 'css/modules/layim/html/msgbox.html' //消息盒子页面地址,若不开启,剔除该项即可
,find: layui.cache.dir + 'css/modules/layim/html/find.html' //发现页
评论0