### 返回值:jQueryjQuery(html,*[ownerDocument]*)
### 概述
根据提供的原始 HTML 标记字符串,动态创建由 jQuery 对象包装的 DOM 元素。同时设置一系列的属性、事件等。
你可以传递一个手写的 HTML 字符串,或者由某些模板引擎或插件创建的字符串,也可以是通过 AJAX 加载过来的字符串。但是在你创建 input 元素的时会有限制,可以参考第二个示例。当然这个字符串可以包含斜杠 (比如一个图像地址),还有反斜杠。当你创建单个元素时,请使用闭合标签或 XHTML 格式。例如,创建一个 span ,可以用$("<span/>") 或 $("<span></span>") ,但不推荐 $("<span>")。在jQuery 中,这个语法等同于$(document.createElement("span")) 。
在jQuery 1.8中,通过$(html,props), 您可以使用任何jQuery对象的方法或插件。在此之前,你只能使用一个方法名的短名单,并有没有成文的方式添加到列表中。现在并不需要是一个列表,在所有!然而,请注意,这可能会导致你的代码的行为改变,如果插件添加后,有相同的名称作为HTML属性。
### 参数
#### **html,[ownerDocument]**String,Document*V1.0*
**html**:用于动态创建DOM元素的HTML标记字符串
**ownerDocument**:创建DOM元素所在的文档
#### **html,props**String,Map*V1.4*
**html**:用于动态创建DOM元素的HTML标记字符串
**props**:用于附加到新创建元素上的属性、事件和方法
### 示例
#### 描述:
动态创建一个 div 元素(以及其中的所有内容),并将它追加到 body 元素中。在这个函数的内部,是通过临时创建一个元素,并将这个元素的 innerHTML 属性设置为给定的标记字符串,来实现标记到 DOM 元素转换的。所以,这个函数既有灵活性,也有局限性。
##### jQuery 代码:
~~~
$("<div><p>Hello</p></div>").appendTo("body");
~~~
#### 描述:
创建一个 <input> 元素必须同时设定 type 属性。因为微软规定 <input> 元素的 type 只能写一次。
##### jQuery 代码:
~~~
// 在 IE 中无效:
$("<input>").attr("type", "checkbox");
// 在 IE 中有效:
$("<input type='checkbox'>");
~~~
#### 描述:
动态创建一个 div 元素(以及其中的所有内容),并将它追加到 body 元素中。在这个函数的内部,是通过临时创建一个元素,并将这个元素的 innerHTML 属性设置为给定的标记字符串,来实现标记到 DOM 元素转换的。所以,这个函数既有灵活性,也有局限性。
##### jQuery 代码:
~~~
$("<div>", {
"class": "test",
text: "Click me!",
click: function(){
$(this).toggleClass("test");
}
}).appendTo("body");
~~~
#### 描述:
创建一个 <input> 元素,同时设定 type 属性、属性值,以及一些事件。
##### jQuery 代码:
~~~
$("<input>", {
type: "text",
val: "Test",
focusin: function() {
$(this).addClass("active");
},
focusout: function() {
$(this).removeClass("active");
}
}).appendTo("form");
~~~
- 速查表
- 核心
- jQuery(selector,[context])
- jQuery(html,[ownerDocument])
- jQuery(callback)
- jQuery.holdReady(hold)
- each(callback)
- size()
- length
- selector
- context
- get([index])
- index([selector|element])
- data([key],[value])
- removeData([name|list])
- jQuery.data(element,[key],[value])
- queue(element,[queueName])
- dequeue([queueName])
- clearQueue([queueName])
- jQuery.noConflict([extreme])
- 选择器
- #id
- element
- .class
- *
- selector1,selector2,selectorN
- ancestor descendant
- parent > child
- prev + next
- prev ~ siblings
- :first
- :last
- :not(selector)
- :even
- :odd
- :eq(index)
- :gt(index)
- :lt(index)
- :header
- :animated
- :focus
- :contains(text)
- :empty
- :has(selector)
- :parent
- :hidden
- :visible
- [attribute]
- [attribute=value]
- [attribute!=value]
- [attribute^=value]
- [attribute$=value]
- [attribute*=value]
- [selector1][selector2][selectorN]
- :nth-child
- :first-child
- :last-child
- :only-child
- :input
- :text
- :password
- :radio
- :checkbox
- :submit
- :image
- :reset
- :button
- :file
- :enabled
- :disabled
- :checked
- :selected
- 属性
- attr(name|pro|key,val|fn)
- removeAttr(name)
- prop(name|pro|key,val|fn)
- removeProp(name)
- addClass(class|fn)
- removeClass([class|fn])
- toggleClass(class|fn[,sw])
- html([val|fn])
- text([val|fn])
- val([val|fn|arr])
- 筛选
- eq(index|-index)
- first()
- last()
- hasClass(class)
- filter(expr|obj|ele|fn)
- is(expr|obj|ele|fn)
- map(callback)
- has(expr|ele)
- not(expr|ele|fn)
- slice(start, [end])
- children([expr])
- closest(expr,[con]|obj|ele)
- find(expr|obj|ele)
- next([expr])
- nextAll([expr])
- nextUntil([exp|ele][,fil])
- parent([expr])
- parents([expr])
- parentsUntil([exp|ele][,fil])
- prev([expr])
- prevAll([expr])
- prevUntil([exp|ele][,fil])
- siblings([expr])
- add(expr|ele|html|obj[,con])
- andSelf()
- contents()
- end()
- 文档处理
- append(content|fn)
- appendTo(content)
- prepend(content|fn)
- prependTo(content)
- after(content|fn)
- before(content|fn)
- insertAfter(content)
- insertBefore(content)
- wrap(html|ele|fn)
- unwrap()
- wrapAll(html|ele)
- wrapInner(html|ele|fn)
- replaceWith(content|fn)
- replaceAll(selector)
- empty()
- remove([expr])
- detach([expr])
- clone([Even[,deepEven]])
- CSS
- css(name|pro|[,val|fn])
- offset([coordinates])
- position()
- scrollTop([val])
- scrollLeft([val])
- height([val|fn])
- width([val|fn])
- innerHeight()
- innerWidth()
- outerHeight([options])
- outerWidth([options])
- 事件
- ready(fn)
- on(events,[selector],[data],fn)
- off(events,[selector],[fn])
- bind(type,[data],fn)
- one(type,[data],fn)
- trigger(type,[data])
- triggerHandler(type,[data])
- unbind(type,[data|fn])
- live(type,[data],fn)
- die(type,[fn])
- delegate(sel,[type],[data],fn)
- undelegate([sel,[type],fn])
- hover([over,]out)
- toggle(fn, fn2, [fn3, fn4, ...])
- blur([[data],fn])
- change([[data],fn])
- click([[data],fn])
- dblclick([[data],fn])
- error([[data],fn])
- focus([[data],fn])
- focusout([data],fn)
- keydown([[data],fn])
- keypress([[data],fn])
- keyup([[data],fn])
- mousedown([[data],fn])
- mouseenter([[data],fn])
- mouseleave([[data],fn])
- mousemove([[data],fn])
- mouseout([[data],fn])
- mouseover([[data],fn])
- mouseup([[data],fn])
- resize([[data],fn])
- scroll([[data],fn])
- select([[data],fn])
- submit([[data],fn])
- unload([[data],fn])
- 效果
- show([speed,[easing],[fn]])
- hide([speed,[easing],[fn]])
- slideDown([speed],[easing],[fn])
- slideUp([speed,[easing],[fn]])
- slideToggle([speed],[easing],[fn])
- fadeIn([speed],[easing],[fn])
- fadeOut([speed],[easing],[fn])
- fadeTo([[speed],opacity,[easing],[fn]])
- fadeToggle([speed,[easing],[fn]])
- animate(param,[spe],[e],[fn])
- stop([cle],[jum])
- delay(duration,[queueName])
- jQuery.fx.off
- jQuery.fx.interval
- Ajax
- jQuery.ajax(url,[settings])
- load(url,[data],[callback])
- jQuery.get(url,[data],[callback],[type])
- jQuery.getJSON(url,[data],[callback])
- jQuery.getScript(url,[callback])
- jQuery.post(url,[data],[callback],[type])
- ajaxComplete(callback)
- ajaxError(callback)
- ajaxSend(callback)
- ajaxStart(callback)
- ajaxStop(callback)
- ajaxSuccess(callback)
- jQuery.ajaxPrefilter([type],fn)
- jQuery.ajaxSetup([options])
- serialize()
- serializeArray()
- 工具
- jQuery.support
- jQuery.browser
- jQuery.browser.version
- jQuery.boxModel
- jQuery.each(object,[callback])
- jQuery.extend([deep],target,object1,[objectN])
- jQuery.grep(array,callback,[invert])
- jQuery.makeArray(obj)
- jQuery.map(array, callback)
- jQuery.inArray(val,arr,[from])
- jQuery.toArray()
- jQuery.sub()
- jQuery.when(deferreds)
- jQuery.merge(first,second)
- jQuery.unique(array)
- jQuery.parseJSON(json)
- jQuery.parseXML(data)
- jQuery.noop
- jQuery.proxy(function,context)
- jQuery.contains(container, contained)
- jQuery.isArray(obj)
- jQuery.isFunction(obj)
- jQuery.isEmptyObject(obj)
- jQuery.isPlainObject(obj)
- jQuery.isWindow(obj)
- jQuery.isNumeric(value)
- jQuery.type(obj)
- jQuery.trim(str)
- jQuery.param(obj,[traditional])
- jQuery.error(message)
- Event对象
- event.currentTarget
- event.data
- event.delegateTarget
- event.isDefaultPrevented()
- event.isImmediatePropagationStopped()
- event.isPropagationStopped()
- event.namespace
- event.pageX
- event.pageY
- event.preventDefault()
- event.relatedTarget
- event.result
- event.stopImmediatePropagation()
- event.stopPropagation()
- event.target
- event.timeStamp
- event.type
- event.which
- Deferred
- def.done(donCal,[donCal])
- def.fail(failCal)
- def.isRejected()
- def.isResolved()
- def.reject(args)
- def.rejectWith(context,[args])
- def.resolve(args)
- def.resolveWith(context,args)
- def.then(doneCal,failCal)
- def.progress([type],[target])
- def.pipe([donFil],[faiFil],[proFil])
- def.always(alwCal,[alwCal])
- def.notify(args)
- def.notifyWith(context,[args])
- def.state()
- Callbacks
- callbacks.add(callbacks)
- callbacks.disable()
- callbacks.empty()
- callbacks.fire(arguments)
- callbacks.fired()
- callbacks.fireWith([context][,args])
- callbacks.has(callback)
- callbacks.lock()
- callbacks.locked()
- callbacks.remove(callbacks)
- jQuery.callbacks(flags)
- 关于
- 关于jQuery API 文档
- 提交bug及获取更新
- 其它
- CSS压缩/格式化
- JS压缩/格式化
- 正则表达式在线测试
- 正则表达式速查表
- HTML5速查表