Kline

本项目基于某网站的K线插件做了一些封装和二次开发,使插件更加易用,方便后来的开发者. 修改主要涉及以下几个点:

• 删除了一些不必要的逻辑
• 把源码中可配置的部分抽出来
• 添加了对 websocket(websocket over stomp)连接方式的支持
• 用 js 创建 K 线页面元素

Features

✅ 支持两种主题配色切换 
✅ 支持简体中文,英文,繁体中文三种语言 
✅ 可配置的时间聚合方式
✅ 支持多种画线工具
✅ 支持多种画图算法
✅ 支持普通轮询和Websocket Over Stomp两种连接方式

ScreenShot!

依赖

• jquery
• jquery.mousewheel
• sockjs (socket方式)
• stomp (socket方式)

安装

• 使用标签引入, 在HTML页面头部加入

    <link href="/js/kline.css" rel="stylesheet"/>
    <script src="/lib/sockjs.js"></script>
    <script src="/lib/stomp.js"></script>
    <script src="/lib/jquery.js"></script>
    <script src="/lib/jquery.mousewheel.js"></script>

• 或者使用RequireJs引入

    require.config({
        paths: {
            "jquery": "../lib/jquery",
            "jquery.mousewheel": "../lib/jquery.mousewheel",
            "sockjs": "../lib/sockjs",
            "stomp": "../lib/stomp",
            "kline": "../js/kline"
        },
        shim: {
            "jquery.mousewheel": {
                deps: ["jquery"]
            },
            "kline": {
                deps: ["jquery.mousewheel", "sockjs", "stomp"]
            }
        }
    });

    require(['kline'], function () {
       // ...
    });

• 在页面中加入

  <div id="kline_container"></div>

开发

• 轮询

    var kline = new Kline({
        width: 1200,
        height: 462,
        theme: 'dark', // light/dark
        language: 'zh-cn', // zh-cn/en-us/zh-tw
        ranges: ["1w", "1d", "1h", "30m", "15m", "5m", "1m", "line"],
        symbol: "coin5/coin4",
        symbolName: "COIN5_COIN4",
        type: "polling", // polling/socket
        url: "http://127.0.0.1:8080/mock.json",
        limit: 1000,
        intervalTime: 3000,
        debug: true,
    });
    kline.draw();

• Websocket Over Stomp

   var kline = new Kline({
        width: 1200,
        height: 462,
        theme: 'dark', // light/dark
        language: 'zh-cn', // zh-cn/en-us/zh-tw
        ranges: ["1w", "1d", "1h", "30m", "15m", "5m", "1m", "line"],
        symbol: "coin5/coin4",
        symbolName: "COIN5_COIN4",
        type: "socket", // polling/socket
        url: 'http://127.0.0.1:8088/socket',
        limit: 1000,
        intervalTime: 3000,
        subscribePath: "/kline/push",
        sendPath: "/app/kline",        
        debug: true
    });
    kline.draw();

参数说明

• width: 宽度 (px) Default: 1200
• height: 宽度 (px) Default: 462
• theme: 主题 dark(暗色)/light(亮色) Default: dark
• language: 语言 zh-cn(简体中文)/en-us(英文)/zh-tw(繁体中文) Default: zh-cn
• ranges: 聚合选项 1w(1周)/1d(1天)/12h(12小时)/6h(6小时)/4h(4小时)/2h(2小时)/1h(1小时)/30m(30分钟)/15m(15分钟)/5m(5分钟)/3m(3分钟)/1m(1分钟)/line(分时) Default: ["1w", "1d", "1h", "30m", "15m", "5m", "1m", "line"]
• symbol: 交易代号
• symbolName: 交易名称
• type: 连接类型 socket(websocket)/polling(轮询) Default: polling
• url: 请求地址
• limit: 分页大小 Default: 1000
• intervalTime: 请求间隔时间(毫秒) Default: 3000
• subscribePath(仅socket方式需要): 订阅地址
• sendPath(仅socket方式需要): 发送地址
• debug: 调试模式 true/false Default: true