Dojo1.11官方教程文档翻译(3.2)使用dojo/query

2024-03-11 04:48

本文主要是介绍Dojo1.11官方教程文档翻译(3.2)使用dojo/query,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

3.2 使用dojo/query

原文地址:https://dojotoolkit.org/documentation/tutorials/1.10/using_query/index.html
GitBook地址:https://www.gitbook.com/book/limeng1900/dojo1-11-tutorials-translation-in-chinese/details
转载请注明出处:http://blog.csdn.net/taijiedi13/ – 碎梦道


本教程中,我们将学习DOM查询和如何使用dojo/query来选择节点。

入门

在使用DOM时,快速和高效地检索节点很重要。我们已经有了dom.byId。但是,在应用中用单一的ID来查找所有的兴趣节点是不现实的。只用ID在查找和操作多节点时效率也很低。幸好,有另一种解决方案:dojo/querydojo/query模块使用类CSS查询(你在样式表里使用的)来检索一个节点列表,它也支持高级的CSS3选择器。

查询

我们用下面的HTML来展示最常用的查询,里面主要网址链接的列表:

<ul id="list"><li class="odd"><div class="bold"><a class="odd">Odd</a></div></li><li class="even"><div class="italic"><a class="even">Even</a></div></li><li class="odd"><a class="odd">Odd</a></li><li class="even"><div class="bold"><a class="even">Even</a></div></li><li class="odd"><div class="italic"><a class="odd">Odd</a></div></li><li class="even"><a class="even">Even</a></li>
</ul><ul id="list2"><li class="odd">Odd</li>
</ul>

第一件要做的事是获得整个列表的处理器。跟前面一样,可以用dom.byId,但你也可以使用query。初看这个方法不是很有用,但是我们会中这个例子开始讲:

// require the query, dom, and domReady modules
require(["dojo/query", "dojo/dom", "dojo/domReady!"], function (query, dom) {// retrieve an array of nodes with the ID "list"var list = query("#list")[0];
})

通过前置标识符“#”来告诉query用ID属性查找节点。这个规定和CSS相似。记住一件事:query总是返回一个数组。数组以后再细说,由于这里通过ID list只得到一个节点(也应该只有一个),就直接从数组取出这个元素。
通过ID获取节点很棒,但是并没有比dom.byId更强大。然而,query也可以通过类名来选择节点。我们打算检索只带“odd”类的节点:

// retrieve an array of nodes with the class name "odd"
var odds = query(".odd");

我们通过前置“.”的标识符告诉query查找className属性中含有该标识的节点,还是和CSS一样。示例中,query将返回一个包含4个<li>和3个<a>的数组。

限制查询

你可以已经发现前面的例子中odd同时包含多个list的节点。如果只想要第一个list的odd节点,可以使用两种方式:

// retrieve an array of nodes with the class name "odd"
// from the first list using a selector
var odds1 = query("#list .odd");// retrieve an array of nodes with the class name "odd"
// from the first list using a DOM node
var odds2 = query(".odd", dom.byId("list"));

两种通过不同的方法实现:第一种使用选择器语法让query引擎限制获取的结果,第二种将query引擎的作用域限制在一个特定的DOM节点。
query不带第二个参数执行的时候,它将搜索全部的DOM结构的全部节点。第二个参数指定为一个DOM节点时,查询被限制在该节点和其子节点中。
如果你的DOM相对较小,比如跟例子中一样,可以省略第二个参数。然而,对于有着更大DOM结构的页面,最好使用第二个参数来限制query的作用域。在指定部分执行查询比搜索全部文档要快的多。
后面的示例中,我们会省略第二个范围参数,但是你用query时要记住前面的话,保持你的检索快速简洁来提供更快的代码和更好的用户体验。

进阶部分

前面的查询结果混合了<li><a>节点,如果只想要<a>呢?你可以组合标签名和类名:

var oddA = query("a.odd");

代替分离的标识符,你可以组合标识符来指向更明确的节点;上面的组合类名在跨浏览器的样式表中有不同的效果,不过query能正常工作。、
query还有另一个跨浏览器的选择器“>”,但不是全部样式表都支持。它将只在第一个选择器下一级查找第二个:

// Retrieve an array of any a element that has an
// li as its ancestor.
var allA = query("li a");
// Retrieve an array of any a element that has an
// li as its direct parent.
var someA = query("li > a");

View Demo
allA将包含全部的6个<a>someA只有2个<a>。任何选择器都可以放在“>”的两边,包括类选择器。这里我们只涉及几个常见的选择器,query是完全遵循CSS3的,并且可以接受更多选择器,你可以自己试试。

NodeList

如前面提到的,query返回一个匹配选择器的节点数组;这个数组实际上是一个dojo/NodeList,它还有操作节点的方法。前面的例子已经用了几个方法,不过我们在看一个你更可能在应用里用到的。这一系列的示例使用下面的标记:

<div id="list"><div class="odd">One</div><div class="even">Two</div><div class="odd">Three</div><div class="even">Four</div><div class="odd">Five</div><div class="even">Six</div>
</div>

NodeList具备相当于Dojo数组辅助方法的方法。一个是forEach,会对数组里每一个节点执行函数:

// Wait for the DOM to be ready before working with it
require(["dojo/query", "dojo/dom-class", "dojo/domReady!"],function(query, domClass) {query(".odd").forEach(function(node, index, nodelist){// for each node in the array returned by query,// execute the following codedomClass.add(node, "red");});});

传递给forEach的函数是一个回调,调用给数组的每一项,参数如下:当前它所在的节点,节点的索引和迭代的NodeList。对于大部分的开发者,第三个参数可以忽略;但是在数组没有存储在变量中的实例中,第三个参数可以用来获取数组的其他项。forEach方法也接收第二个参数来指定回调调用的范围。
NodeList定义的其他数组帮助函数是mapfiltereverysome。这些函数都返回一个NodeList,除了everysome返回布尔值。
NodeList还有几个拓展模块来添加额外的方法。dojo/NodeList-dom模块里是类和样式帮助方法。dojo/NodeList-dom提供对应各种DOM方法的遍历方法, 这样前面的例子就可以简化成:

require(["dojo/query", "dojo/NodeList-dom", "dojo/domReady!"], function(query) {// Add "red" to the className of each node matching// the selector ".odd"query(".odd").addClass("red");// Add "blue" to the className of each node matching// the selector ".even"query(".even").addClass("blue");
});

NodeList里对每个节点执行DOM方法,并且返回一个NodeList支持链接写法:

// Remove "red" from and add "blue" to the className
// of each node matching the selector ".odd"
query(".odd").removeClass("red").addClass("blue");

dojo/NodeList-dom定义的其它DOM方法有styletoggleClassreplaceClassplaceempty。这些方法也都返回一个NodeList

// Change the font color to "white" and add "italic" to
// the className of each node matching the selector ".even"
query(".even").style("color", "white").addClass("italic");

View Demo

事件

NodeList提供的另一个便利的方法是on来连接DOM事件。虽然DOM事件将在下一个教程里涉及,我们会先涉及NodeListon方法的语法。也要记住,虽然这是个方便的语法,这个方式不应该用在包含大量节点的NodeList,应该用一种叫做事件委托的技术来替代,见事件教程。

<button class="hookUp demoBtn">Click Me!</button>
<button class="hookUp demoBtn">Click Me!</button>
<button class="hookUp demoBtn">Click Me!</button>
<button class="hookUp demoBtn">Click Me!</button>
<script>// Wait for the DOM to be ready before working with itrequire(["dojo/query", "dojo/domReady!"], function(query) {query(".hookUp").on("click", function(){alert("This button is hooked up!");});});
</script>

View Demo

on方法附在查询返回的每一个节点上。

小结

如你所见,大多时候使用DOM节点是很简单的。使用query可以快速、轻易地得到想要节点的集合。适应样式和改变类大多时候很便利,这正是Dojo向页面添加交互的开始。我们已经展示了一个处理点击事件的简单例子,在下一个教程中,我们将深度解析Dojo事件处理。

这篇关于Dojo1.11官方教程文档翻译(3.2)使用dojo/query的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/796688

相关文章

Java中的ConcurrentBitSet使用小结

《Java中的ConcurrentBitSet使用小结》本文主要介绍了Java中的ConcurrentBitSet使用小结,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,... 目录一、核心澄清:Java标准库无内置ConcurrentBitSet二、推荐方案:Eclipse

Go语言结构体标签(Tag)的使用小结

《Go语言结构体标签(Tag)的使用小结》结构体标签Tag是Go语言中附加在结构体字段后的元数据字符串,用于提供额外的属性信息,这些信息可以通过反射在运行时读取和解析,下面就来详细的介绍一下Tag的使... 目录什么是结构体标签?基本语法常见的标签用途1.jsON 序列化/反序列化(最常用)2.数据库操作(

Java中ScopeValue的使用小结

《Java中ScopeValue的使用小结》Java21引入的ScopedValue是一种作用域内共享不可变数据的预览API,本文就来详细介绍一下Java中ScopeValue的使用小结,感兴趣的可以... 目录一、Java ScopedValue(作用域值)详解1. 定义与背景2. 核心特性3. 使用方法

spring中Interceptor的使用小结

《spring中Interceptor的使用小结》SpringInterceptor是SpringMVC提供的一种机制,用于在请求处理的不同阶段插入自定义逻辑,通过实现HandlerIntercept... 目录一、Interceptor 的核心概念二、Interceptor 的创建与配置三、拦截器的执行顺

Python中Tkinter GUI编程详细教程

《Python中TkinterGUI编程详细教程》Tkinter作为Python编程语言中构建GUI的一个重要组件,其教程对于任何希望将Python应用到实际编程中的开发者来说都是宝贵的资源,这篇文... 目录前言1. Tkinter 简介2. 第一个 Tkinter 程序3. 窗口和基础组件3.1 创建窗

C#中checked关键字的使用小结

《C#中checked关键字的使用小结》本文主要介绍了C#中checked关键字的使用,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学... 目录✅ 为什么需要checked? 问题:整数溢出是“静默China编程”的(默认)checked的三种用

C#中预处理器指令的使用小结

《C#中预处理器指令的使用小结》本文主要介绍了C#中预处理器指令的使用,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧... 目录 第 1 名:#if/#else/#elif/#endif✅用途:条件编译(绝对最常用!) 典型场景: 示例

C#如何在Excel文档中获取分页信息

《C#如何在Excel文档中获取分页信息》在日常工作中,我们经常需要处理大量的Excel数据,本文将深入探讨如何利用Spire.XLSfor.NET,高效准确地获取Excel文档中的分页信息,包括水平... 目录理解Excel中的分页机制借助 Spire.XLS for .NET 获取分页信息为什么选择 S

Java利用Spire.XLS for Java自动化设置Excel的文档属性

《Java利用Spire.XLSforJava自动化设置Excel的文档属性》一个专业的Excel文件,其文档属性往往能大大提升文件的可管理性和可检索性,下面我们就来看看Java如何使用Spire... 目录Spire.XLS for Java 库介绍与安装Java 设置内置的 Excel 文档属性Java

Mysql中RelayLog中继日志的使用

《Mysql中RelayLog中继日志的使用》MySQLRelayLog中继日志是主从复制架构中的核心组件,负责将从主库获取的Binlog事件暂存并应用到从库,本文就来详细的介绍一下RelayLog中... 目录一、什么是 Relay Log(中继日志)二、Relay Log 的工作流程三、Relay Lo