jqLite

、关于DOM导航的jqLite方法

children() 返回一组子元素。这个方法的jqLite实现不支持jQuery所提供的选择器特性

eq(index) 从一个元素集合中返回指定索引下的元素

find(tag) 按照指定的tag名称定位所有的后代元素。它可以在一个元素的子元素、孙元素等所有后代元素中查找指定类型的元素。

next() 获得下一个兄弟元素。不支持jquery所提供的选择器特性

parent() 返回父元素,不支持jquery所提供的选择器特性

angular.module("exampleApp", [])
            .directive("demoDirective", function () {
                return function (scope, element, attrs) {
                    var items = element.children();
                    for (var i = 0; i < items.length; i++) {
                        if (items.eq(i).text() == "Oranges") {
                            items.eq(i).css("font-weight", "bold");
                        } 
                    }
                }
            })

 对于这个指令及所有指令来说的出发点在于,element参数被传递给了链接函数。element参数是一个jqLite对象,支持上述所有方法。element对象表示该指令被应用到的元素。这里使用了eq方法来获得当前索引下的元素,而不是将jqLite对象当做js数组来处理,因为eq方法返回一个包含了指定索引下的元素的jqLite对象,并且支持所有的JqLite方法。

二、修改元素

用于修改元素的jqLite方法

addClass(name) 将jqLite对象中的所有元素添加到指定的class

attr(name)/attr(name,value) 获得jqLite对象中的第一个元素的指定特性的值,或者为所有元素设置指定值

css(name)/css(name,value) 获得jqLite对象中第一个元素的指定css属性的值,或者为所有元素设置指定的值

hasClass(name) 如果jqLite对象中有任一对象属于指定的class时,返回true

prop(name)/prop(name,value) 获得jqLite对象中的第一个元素的指定属性的值,或者为所有元素设置指定值

removeAttr(name) 从jqLite对象的所有元素中移除某个特性

removeClass(name) 从jqLite对象中移除具有指定class的元素

text()/text(value) 获取jqLite对象中所有元素的文本内容拼接后的结果,或者设置所有元素的文本内容

toggleClass(name) 为jqLite对象中的所有元素切换指定class的所属资格。那些不在class中的元素被添加到其中,而那些在class中的元素将会从中移除

val()/val(value) 获取jqLite对象中的第一个元素的value特性,或者设置所有元素的value特性

三、创建和移除元素

用于创建和移除元素的jqLite方法

angular.element(html) 创建一个代表特定HTML字符串的元素的jqLite对象

after(elements) 在调用方法的元素后面插入特定内容

append(elements) 在调用方法的jqLite对象的每一个元素上,将特定元素作为最后一个子元素插入

clone() 从方法调用的对象复制元素并作为一个新的jqLite对象返回

prepend(elements) 在调用方法的jqLite对象的每一个元素上,将特定元素作为第一个子元素插入

remove() 从DOM中删除jqLite对象的元素

replaceWith(elements) 用指定元素替换调用方法的jqLite对象的元素

wrap(elements) 使用特定元素包装jqLite对象中的每个元素

这里需要当心的主要问题就是jquery fluent API, 这意味着许多这类方法返回的jqLite对象中包含了原来在调用方法的jqLite对象中就存在的元素,而不是那些参数中的元素。

<script>
    angular.module("exampleApp", [])
        .directive("demoDirective", function () {
            return function (scope, element, attrs) {
                var listElem = element.append("<ol>");
                for (var i = 0; i < scope.names.length; i++) {
                    listElem.append("<li>").append("<span>").text(scope.names[i]);
                }
            }
        })
        .controller("defaultCtrl", function ($scope) {
            $scope.names = ["Apples", "Bananas", "Oranges"];
        })              
</script>
<body ng-controller="defaultCtrl">
    <h3>Fruit</h3>
    <div demo-directive></div>
</body>

在HTML中的样子<div demo-directive>Oranges</div>

哪里出错了?答案是从一开始在DOM里就操作了错误的元素。这个例子中的第一个jqLite操作如下:var listElem=element.append("<ol>")

将一个ol元素作为传给链接函数的element参数的子元素添加进去。append操作结果所赋给的变量使用的名字暗示了问题所在:listElem。实际上append方法(就像上述方法中所有那些带有element参数的方法那样)返回的是一个表示操作被执行的元素的jqLite对象,在本例中就是div元素而不是ol元素。这意味着本例中的另一个jqLite语句会得到意外的结果:listElem.append("<li>").append("<span>").text(scope.names[i]);这条语句中有三个操作——两个对append方法的调用和一个对text方法的调用,而且所有这些操作都应用在了div元素上。首先,添加了一个li元素作为div元素的一个子元素,然后添加了一个span 元素。最后调用了text方法,结果是将所有添加到div的子元素的文本使用一个字符串替换掉,而且由于是在for循环中执行这些操作,对数组里的每一个元素都重复了这些操作,这就是为什么div元素里最后包含了oranges,因为oranges是数组中的最后一个值。

    避免这个问题的最可靠方法之一是使用angular.element方法来创建jqLite对象并在单独的语句中对他们执行各种操作。如下是正确的例子:

angular.module("exampleApp", [])
            .directive("demoDirective", function () {
                return function (scope, element, attrs) {
                    var listElem = angular.element("<ol>");
                    element.append(listElem);
                    for (var i = 0; i < scope.names.length; i++) {
                        listElem.append(angular.element("<li>")
                            .append(angular.element("<span>").text(scope.names[i])));
                    }
                }
            })

        .controller("defaultCtrl", function ($scope) {
            $scope.names = ["Apples", "Bananas", "Oranges"];
        })   

 四、处理事件

处理事件的jqLite方法

on(events,handler) 为jqLite对象所代表的元素发生的事件注册一个处理器。不支持jquery提供的选择器或事件数据特性。

off(events,handler) 为jqLite对象所代表的元素发生的事件移除一个之前已注册的处理器。不支持jquery提供的选择器特性

triggerHandler(event) 对jqLite对象所代表的所有元素上注册的指定事件触发所有处理器。

五、其他jqLite方法

data(key,value)/data(key)  将任意数据与jqLite对象代表的所有元素关联起来,或者从jqLite对象代表的第一个元素中获取指定key值。

removeData(key) 从jqLite对象代表的元素中移除与指定key相关联的数据。

html() 返回jqLite对象所代表的第一个元素的内容HTML表达形式。

ready(handler) 注册一个监听器函数,该函数将在DOM的内容被完全加载时调用一次。

六、从jqLite访问AngularJS的特性

controller()/controller(name) 返回与当前元素或其父元素相关联的控制器。

injector() 返回与当前元素或其父元素相关联的注入器。

isolatedScope() 如果当前元素有相关联的独立的作用域,则返回该作用域。

scope() 返回与当前元素或其父元素相关联的作用域。

inheritedData(key) 这个方法与jquery的data方法执行同样的功能,但是会沿着元素层次结构向上查找与指定key相匹配的值

七、使用jquery替换jqLite

jqLite所强调的是速度,简单和大小,而且一旦你习惯了使用这个可用的有限方法集,你会发现能够做到指令中需要做的一切事情,即使结果不如使用jquery完整的方法和特性所得到的那么优雅。尽管如此,如果确实无法坚持使用jqLite,你还可以使用完整的jquery库来替换它。

注意:

    jQuery脚本元素出现在加载AngularJS的脚本元素之前。AngularJS在安装jqLite之前会检查jquery是否已经被加载了,所以脚本元素必须按照这样的顺序出现。如果直到AngularJS的后面才加载jquery,那么jqLite就会被使用。

<script src="jquery-1.10.1.min.js"></script>
<script src="angualr.js"></script>
原文地址:https://www.cnblogs.com/YangqinCao/p/5998176.html