easy

DocsVersion : 1.0.0

easyJS( selector, [ context ] )

构造函数Define in : easy.js

easy.js 最基本的构造函数,easy.js 的一切都是基于该构造函数,最基本的用法是传递一个选择器字符串作为参数,将返回一个实例化的 easyJS 对象,该 easyJS 对象就可以很方便的使用定义在 easyJS.prototype 上的方法。同时所有的 easy.js 的静态方法和属性都以 easyJS 为命名空间。虽是构造函数,但不需要使用 new 关键字来实例化,省略了 new 关键字在使用上会更简便。其简写形式是大写的 E ( 注意区分大小写 )。

参数
  • selector
    String|
    htmlString|
    Element|
    Element Array|
    Function
    必需

    selector 可以是选择器字符串、HTML字符串,也可以是 DOM 元素、DOM 元素数组,如果该参数为函数,将在 DomReady 后执行该函数。

  • context
    Element|
    ownerDocument
    可选

    当 selector 为选择器字符串时,context 就是查找范围,可以是一个 DOM 元素、DOM 元素数组、easyJS 对象,如果selector为HTML字符串,context 就是文档节点,HTML 字符串将在该文档节点中被创建,如果 context 不是文档节点而是普通的 DOM 元素,将查找该 DOM 元素的根文档节点。

返回值
  • easyJS Object

    在 easy.js 中,easyJS Object 是通过 easyJS 构造函数实例化的一组 DOM 元素伪数组。

例子1

查找所有的div中的p元素( 如果你不熟悉选择器的使用,可以点击查看选择器的使用规则 )。

HTML代码:
<div><p>test1</p></div><p>test2</p>
JavaScript代码:
E( 'div p' );
返回结果:
[ <p>test1</p> ]
例子2

将HTML字符串转化成easyJS对象。

JavaScript代码:
E( '<p><span>hello</span></p>' );
返回结果:
[ <p><span>hello</span></p> ]
JavaScript代码:
E( '<div/>' );
返回结果:
[ <div></div> ]