轻量级的DOM操作库 -- zBase 库 使用介绍

摘要：是我个人写的一个轻量级的操作库，里面封装了一些对元素节点的简单操作，如节点的查询获取，的添加移除，样式的添加移除，节点的添加和移除，事件的封装，动画的封装等等如果你只是想简单的操作，但又不想写繁琐的原生代码，也不希望加载像这么功能齐全的库，

zBase是我个人写的一个轻量级的 DOM 操作库，里面封装了一些对元素节点的简单操作， 如节点的查询获取，className的添加移除，样式的添加移除， 节点的添加和移除，事件的封装，动画的封装等等...

如果你只是想简单的操作 dom ，但又不想 写繁琐的 js 原生代码，也不希望加载像 jquery 这么功能齐全的库，那么 zBase适合你 ！！！

当然只是做了简单的封装，减少 原生 js 操作dom 的麻烦，整个类库也是利用 $ 操作符，如果在使用的过程中和一些 大型的类库 如 jquery 冲突可以下载 zBase 源码，将 $ 改成任意字符即可。

库的简单使用：

1、一般查找：

2、组合查找

在此前提下，你还可以任意组合，得到你所需要的节点，如：

3、find查找

利用 find() 方法来查找：

由于 $() 及几乎所有库的方法都返回当前对象，所以支持链式操作

1、.addClass()

//给 所有 p 标签 添加 一个"name_1"  的className
$("p").addClass("name_1")  

//添加多个  className
$("p").addClass("name_1 name_2")  

2、.removeClass()

//给 所有 p 标签 移除 一个"name_1"  的className
$("p").removeClass("name_1")  

//移除多个  removeClass
$("p").removeClass("name_1 name_2")  

3、获取第几个节点 .getE()
注意，.getE() 返回的是 dom元素，所以后面不能再执行链式操作

//得到 ul 里面的 第 3 个 li节点
$("ul li").getE(2)  

4、获取第几个节点 .getElement()
与第 3 条不同的是 .getElement() 返回的是 当前对象，所以后面可以再执行链式操作

//得到 ul 里面的 第 3 个 li节点
$("ul li").getElement(2) .css("color","red"); 

5、操作样式 .css()

// 给所有 p 标签 添加 color ：red ；样式
 $("p").css("color","red");

// 给所有 p 标签 添加多组样式，参数是一个 obj
 $("p").css({
        "color":"red",
        "background":"blue"
    });

说明

// 当 参数为 string 时 ，是 获取  p 标签下的 color 样式,返回一个 rgb(x, x, x)值
 $("p").css("color");

6、获取 或 设置 某一节点的属性 .arrt()

// 给所有 p 标签 添加 age 属性
$("p").arrt("age","233");

// 当参数只有一个时 ， 获得 p 标签下的属性
$("p").arrt("age");

7、获取或设置 .html()

// 给所有 p 标签 设置 html
$("p").html("我的天，我的地，先赚一个亿！！！！");

// 得到 html 值
$("p").html("age");

1、隐藏标签 .show 和 .hide

 
$("p").show();

$("p").hide();

2、鼠标的移入移出事件 .hover()；

// hover传递两个函数，分别 用于处理 鼠标移入事件 和 鼠标移出 事件

 $("span").hover(function () {
        $("span").css("color","red");
    },function () {
        $("span") .css("color","blue");
    });

3、添加事件 addEvent(ele,type,fun);
这里做了兼容 IE6、7、8
参数：ele：添加事件的元素节点 ， type：事件类型(click,movie等)，fun:执行事件函数
注意：第一个参数为元素节点，可用上面提到的 getE() 来获得

 
 addEvent($("#div_id").getE(0),"click",function () {
        alert(" 啊 ，我被点击啦~~~ ");
    });

4、移除事件 removeEvent(ele,type,fun)

//添加事件
 addEvent($("#div_id").getE(0),"click",f_click);
// 移除事件
 removeEvent($("#div_id").getE(0),"click",f_click);
 
 function f_click() {
    alert(" 啊 ，我被点击啦~~~ ");
 }

5、绑定事件 bind();

其实这个方法是有上面的添加事件封装的，只不过这个方法可以多个元素同时绑定。

// 给所有的 span 标签 绑定点击事件

 $("span").bind("click",function () {
        console.log("........"+this);  //  ....[object HTMLSpanElement]
    });

动画做的不多，就一个 animate() ，其实现在的css3的动画效果已经很强大和简便了，这里 做了一个动画的简单封装，有兴趣可以查看源码，看一下思路。

animate(obj);
参数为一个 对象

/
 * @param attr 样式 ，一般是 left 或 top
 * @param start 开始的位置
 * @param step 移动的距离
 * @param target 移动的终点
 * @param t 每次移动的毫秒
/
    $("#div_id").animate({
        "attr":"x",
        "start":100,
        "t":500,
        "step":10,
        "alter":550
    });

1、设置元素处在 视口中间位置 .centerInWindow()

传递的两个参数分别是 元素自身的 的 宽 和 高；

// 传递的两个参数分别是 元素自身的 的 宽 和 高；
 $("#div_id").centerInWindow(100,100);

2、获取当前视口的大小 getInner();
返回 obj ，兼容 IE

  console.log("...width....."+ getInner().width);
  console.log("...height....."+ getInner().height);

3、获取 浏览器滚动条的距离 getScroll()

 console.log("...top....."+  getScroll().top);
console.log("...top....."+  getScroll().left);

4、图片预加载 preprocessorImage(obj)
一般呢，我们往 而图片 预加载 则是 先在后台请求数据加载完图片，然后再让图片一下显示出来，效果是不同的！
参数 obj ：一个对象，里面是 图片的 链接数组 和 回调函数，如下例子：
加载完图片，再将

 preprocessorImage({
                img_array:["http://img.pconline.com.cn/images/upload/upc/tx/wallpaper/1209/10/c1/13764273_1347270360314_800x600.jpg",
                    "https://cloud.githubusercontent.com/assets/15622519/18378764/61d0b4be-76a1-11e6-9571-36d785a35e56.png"],
               
                callback:function (img_src) {
                   
                    $("#img-div").html( "");
                }
            });

在 zBase库中还支持扩展插件：
比如有个 js 插件

// 加载在 zBase.js 的后面

那么这个js插件需要 用 $().extend("name",fun) 来扩展
参数：第一个参数为 插件的名称，第二个参数是 插件的实现函数

$().extend("drag",function () {

        // 开始编程...
}

那怎么调用写好的插件呢？ 比如我上面写了是一个 盒子拖拽的插件，那么我直接调用

 $("#div_id").drag();

此时，id = div_id 的元素就有了拖拽的功能了(前提这个 div 必须 position: absolute;)
关于 zBase_drag.js 插件源码可以查看的到。

有了插件扩展是不是很方便呢，可以为 zBase 库 扩展跟多自己实用的功能。

导入 js

ajax(obj);
参数 obj 里面的属性说明：

 
  method ： 请求方式 -- get 或 post
  url ： 请求路径
  async ：true 为异步请求 ， false 为同步请求
  data ： 请求数据 ，为 一个 对象
  success ：请求成功回调函数
  error ：请求失败回调函数
 

 addEvent(document,"click",function () {
        ajax({
            method:"get",
            url:"https://api.github.com/users/ZengTianShengZ",
            async:true,
            data:{
                "name":"zeng",
                "age": 24
            },
            success:function (text) {
                alert(text);
            },
            error : function(error_status,error_statusText){
                alert(error_status + "........." + error_statusText);
            }

        });

没错，就是怎么使用，是不是很方便，具体可查看源码

项目有不足的地方欢迎大家 issues ，本类库适合做一些小项目时使用，主要避免了原生js操作dom的麻烦，但是远不及jquery，zepto那么强大 的功能。
项目地址 github .................... 欢迎 star