KuoqiJS 文档 v1.14
轻量级原生 JavaScript 框架 · 全功能 DOM 操作 · 现代 Web 交互
快速开始
三步上手 KuoqiJS
1
引入脚本
在页面中引入 kq.js,原生 JS 无依赖,兼容 IE9+ 和所有现代浏览器。
2
选择元素
使用 $Q() 选择器获取 DOM 元素,支持 CSS 选择器和扩展伪类。
3
链式操作
所有方法支持链式调用,DOM 操作、事件绑定、动画效果一气呵成。
基础用法
DOM 选择器
// ID 选择器
$Q('#myId');

// 类选择器
$Q('.myClass');

// 标签选择器
$Q('div');

// 后代选择器
$Q('.container .item');

// 扩展伪类
$Q('li:first');
$Q('li:eq(2)');
$Q('div:visible');
$Q('span:contains(hello)');
DOM 操作
// 获取/设置内容
$Q('#box').html('<p>内容</p>');
$Q('#box').text('纯文本');
$Q('#input').val('值');

// 样式操作
$Q('.item').css('color', 'red');
$Q('.item').addClass('active');
$Q('.item').removeClass('old');
$Q('.item').toggleClass('on');

// 插入元素
$Q('#box').append('<span>追加</span>');
$Q('#box').prepend('<span>前置</span>');
$Q('#box').after('<span>之后</span>');
$Q('#box').before('<span>之前</span>');
事件系统
// 绑定事件
$Q('.btn').on('click', function() {
    console.log('点击了');
});

// 事件委托
$Q('#list').on('click', '.item', function() {
    console.log('点击了列表项');
});

// 快捷方法
$Q('.btn').click(function() { });
$Q('form').submit(function() { });

// 触发事件
$Q('.btn').trigger('click');

// 移除事件
$Q('.btn').off('click');
AJAX 请求
// GET 请求
$Q.get('/api/data', function(res) {
    console.log(res);
});

// POST 请求
$Q.post('/api/save', {name:'test'}, function(res) {
    console.log(res);
});

// 完整配置
$Q.ajax({
    url: '/api/data',
    type: 'POST',
    data: { id: 1 },
    dataType: 'json',
    success: function(res) { },
    error: function() { }
});

// JSONP
$Q.getJSON('/api/jsonp?callback=?', function(res) { });
UI 组件
开箱即用的交互组件
弹窗 Card
标题/内容/按钮/拖拽/动画,可链式调用
消息提示
$Q.ui.msg() 支持 success/error/warning/info
确认框
$Q.confirm() 带回调函数的确认对话框
文件上传
Uploader 切片上传,支持多文件和进度回调
Canvas 绘图
图形绘制、文字渲染、动画支持
图表组件
折线图、饼图,Canvas 绘制,带动画效果
动画系统
// 基础动画
$Q('.box').animate({
    left: '200px',
    top: '100px',
    opacity: 0.5,
    width: '300px'
}, 1000, function() {
    console.log('动画完成');
});

// 显示/隐藏
$Q('.box').show(300);
$Q('.box').hide(300);
$Q('.box').toggle(300);

// 淡入淡出
$Q('.box').fadeIn(500);
$Q('.box').fadeOut(500);

// 滑入滑出
$Q('.box').slideDown(400);
$Q('.box').slideUp(400);

// 停止动画
$Q('.box').stop();
工具函数
字符串处理
// 去除首尾空格
$Q.trim(str);

// 字符串转二进制
$Q.strTobinary(str);

// HTML 转义
$Q.htmlEncode(str);
$Q.htmlDecode(str);

// 模板字符串
$Q.template(tpl, data);
日期时间
// 获取当前日期对象
var date = $Q.date();

// 格式化输出
date.output('YYYY-MM-DD HH:mm:ss');

// 时间戳转换
$Q.date(timestamp).output();

// 日期计算
date.addDay(3);
date.addMonth(1);
© 2026 幻冰小站. All rights reserved.
KuoqiPHP v1.05 | KuoqiJS v1.14 | KuoqiUI v1.06