一份简短的 QuoJs 官方 API 帮助文档 - 文章教程

一份简短的 QuoJs 官方 API 帮助文档

发布于 2019-12-15 字数 6509 浏览 1277 评论 0

如果您认为 QuoJS 只是一个触摸事件管理器,那你就错了,它是一个功能丰富的类库,无需第三方 JavaScript 库(例如 jQuery、Prototype、 Kendo)来创建基于浏览器应用程序的复杂项目。

项目地址:http://quojs.tapquo.com/

如何使用

QuoJS 使用的命名空间是 $$,所以如果你需要的话,你还可以使用其它的 JavaScript 类库例如 jQuery、Zepto 使用通用符号$。

// Find all  elements in 
 elements
$$('span', 'p');

//Subscribe to a tap event with a callback
$$('p').tap(function() {
    // affects "span" children/grandchildren
    $$('span', this).style('color', 'red');
});

// Chaining methods
$$('p > span').html('tapquo').style('color', 'blue');

查询方法

QuoJs 有 DOM 元素查询引擎与其它著名的类库非常相似,你已经使用的 jQuery 的很多方法在这里都可以使用。jQuery 的支持的查询方法。

.get(index)
.find('selector')
.parent()
.siblings('selector')
.children('selector')
.first()
.last()
.closest('selector')
.each(callback)

元素方法

QuoJs 有DOM 元素查询引擎与其它著名的类库非常相似,你已经使用的 jQuery 的很多方法在这里都可以使用.

// Get/Set element attribute
.attr('attribute')
.attr('attribute', 'value')
.removeAttr('attribute')
// Get/Set the value of the "data-name" attribute
.data('name')
.data('name', 'value')
// Get/Set the value of the form element
.val()
.val('value')
// Show/Hide a element
.show()
.hide()
// get object dimensions in px
.offset('selector')
.height()
.width()
// remove element
.remove()

样式方法

QuoJS 可以轻松管理你任何 DOM 元素的CSS样式,这些方法很箱子,你很容易记住所有的 CSS 方法。

// set a CSS property
.style('css property', 'value')
 // add/remove a CSS class name
.addClass('classname')
.removeClass('classname')
.toggleClass('classname')
// returns true of first element has a classname set
.hasClass('classname')
// Set a style with common vendor prefixes
.vendor('transform', 'translate3d(50%, 0, 0)');

$$('article').style('height', '128px');
$$('article input').addClass('hide');

var houses = $$('.house');
if (houses.hasClass('ghost')) {
    houses.addClass('buuhh');
}

DOM操作方法

这些方法允许我们插入/更新现有的元素,里面的内容。

// get first element's .innerHTML
.html()
// set the contents of the element(s)
.html('new html')
// get first element's .textContent
.text()
// set the text contents of the element(s)
.text('new text')
// add html (or a DOM Element) to element contents
.append(), prepend()
// If you like set a new Dom Element in a existing element
.replaceWith()
// Empty element
.empty()

$$('article').html('tapquo');
var content = $$('article').html(); //content is 'tapquo'

事件处理

每一个前端项目需要一个高效的事件管理,你可以创建自己的活动,以及现有的订阅。

// add event listener to elements
.on(type, [selector,] function);
// remove event listener from elements
.off(type, [selector,] function);
// triggers an event
.trigger(type);
//If loaded correctly all resources
.ready(function);

// Subscribe for a determinate event
$$(".tapquo").on("tap", function);
// Trigger custom event
$$(".quojs").trigger("loaded");
// Loaded page
$$.ready(function() {
    alert("QuoJS rulz!");
});

手势事件

既然 QuoJs 支持浏览器的触摸事件,那么你有无数的事件和手势来帮助你做任何一个项目

//Tap event, common event
.tap(function);
//Long tap event (650 miliseconds)
.hold(function);
//A tap-delay event to combine with others events
.singleTap(function);
//If you send two singleTap
.doubleTap(function);

滑动方法

不仅有基本的滑动方法,常见的应用程序中有很多的滑动你都可以使用

.swipe(function);
//Detect if is swipping
.swiping(function);
//Swipe directions
.swipeLeft(function);
.swipeRight(function);
.swipeDown(function);
.swipeUp(function);

捏方法(类似iphone图片缩小的手势 )

As with the previous gesture, QuoJS have easy control over this gesture and its variations.

.pinch(function);
//Detect if is pinching
.pinching(function);
//Pinch zoom
.pinchIn(function);
.pinchOut(function);

旋转方法(Rotate methods)

.rotate(function);
//Detect if is rotating
.rotating(function);
//Rotate directions
.rotateLeft(function);
.rotateRight(function);

Ajax方法

$$.get(url, [parameters], [callback], [mime-type]);
$$.post(url, [parameters], [callback], [mime-type]);
$$.put(url, [parameters], [callback], [mime-type]);
$$.delete(url, [parameters], [callback], [mime-type]);
$$.json(url, [parameters], [callback]);

$$.json(url, {id: 1980, user: 'dan'}, function(data){ ... });

$$.ajax({
    type: 'POST', // defaults to 'GET'
    url: 'http://rest',
    data: {user: 'soyjavi', pass: 'twitter'},
    dataType: 'json', //'json', 'xml', 'html', or 'text'
    async: true,
    success: function(response) { ... },
    error: function(xhr, type) { ... }
});
//Default Settings
$$.ajaxSettings = {
    async: true,
    success: {},
    error: {},
    timeout: 0
};

//Set de default timeout to 1 second (1000 miliseconds)
$$.ajaxSettings.timeout = 1000;

//Set de default callback when ajax request failed
$$.ajaxSettings.error = function(){ ... };

$$.ajaxSettings.async = false;
var response = $$.json('http://', {id: 1980, user: 'dan'});

环境事件

The environment object contains useful information to learn more about your device.

var env = $$.environment();

env.browser     //[STRING] Browser of your mobile device
env.isMobile    //[BOOLEAN]
env.os.name     //[STRING] iOS, Android, Blackberry...
env.os.version  //[STRING] Versión of OS
env.screen      //[OBJECT] With properties: width & height

相关链接

如果你对这篇文章有疑问,欢迎到本站 社区 发帖提问或使用手Q扫描下方二维码加群参与讨论,获取更多帮助。

扫码加入群聊

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

目前还没有任何评论,快来抢沙发吧!

关于作者

JSmiles

生命进入颠沛而奔忙的本质状态,并将以不断告别和相遇的陈旧方式继续下去。

2891 文章
评论
84935 人气
更多

推荐作者

勿忘心安

文章 0 评论

ekko

文章 0 评论

江挽川

文章 0 评论

献世佛

文章 0 评论

Meets

文章 0 评论