Class Ext.DomQuery
|
Package:
|
Ext.grid
|
|
Defined In:
|
.js
|
|
Class:
|
|
|
Extends:
|
Object
|
根据编译请求提供高效的将选择符 / xpath 处理为可复用的函数的方法。可以添加新的伪类和匹配器。该类可以运行于 HTML 和 XML 文档之上(如果给出了一个内容节点)。
DomQuery 提供大多数的CSS3 选择符,同时也支持某些自定义选择符和基本的 XPath。
下列所有的选择符、属性过滤器和伪类可以在任何命令中无限地组合使用。例如:“div.foo:nth-child(odd)[@foo=bar].bar:first”将是一个完全有效的选择符。命令中出现的节点过滤器将可以使你根据自己的文档结构对查询做出优化。
元素选择符:
- 任意元素
- E 一个标签为 E 的元素
- E F 所有 E 元素的分支元素中含有标签为 F 的元素
- E > F 或 E/F 所有 E 元素的直系子元素中含有标签为 F 的元素
- E + F 所有标签为 F 并紧随着标签为 E 的元素之后的元素
- E ~ F 所有标签为 F 并与标签为 E 的元素是兄弟的元素
属性选择符:
@ 与引号的使用是可选的。例如:div[@foo='bar'] 也是一个有效的属性选择符。
- E[foo] 拥有一个名为 “foo” 的属性
- E[foo=bar] 拥有一个名为 “foo” 且值为 “bar” 的属性
- E[foo^=bar] 拥有一个名为 “foo” 且值以 “bar” 开头的属性
- E[foo$=bar] 拥有一个名为 “foo” 且值以 “bar” 结尾的属性
- E[foo=bar] 拥有一个名为 “foo” 且值包含字串 “bar” 的属性
- E[foo%=2] 拥有一个名为 “foo” 且值能够被2整除的属性
- E[foo!=bar] 拥有一个名为 “foo” 且值不为 “bar” 的属性
Pseudo Classes:
伪类:
- E:first-child E 元素为其父元素的第一个子元素
- E:last-child E 元素为其父元素的最后一个子元素
- E:nth-child(n) E 元素为其父元素的第 n 个子元素(由1开始的个数)
- E:nth-child(odd) E 元素为其父元素的奇数个数的子元素
- E:nth-child(even) E 元素为其父元素的偶数个数的子元素
- E:only-child E 元素为其父元素的唯一子元素
- E:checked E 元素为拥有一个名为“checked”且值为“true”的元素(例如:单选框或复选框)
- E:first 结果集中第一个 E 元素
- E:last 结果集中最后一个 E 元素
- E:nth(n) 结果集中第 n 个 E 元素(由1开始的个数)
- E:odd :nth-child(odd) 的简写
- E:even :nth-child(even) 的简写
- E:contains(foo) E 元素的 innerHTML 属性中包含“foo”字串
- E:nodeValue(foo) E 元素包含一个 textNode 节点且 nodeValue 等于“foo”
- E:not(S) 一个与简单选择符 S 不匹配的 E 元素
- E:has(S) 一个包含与简单选择符 S 相匹配的分支元素的 E 元素
- E:next(S) 下一个兄弟元素为与简单选择符 S 相匹配的 E 元素
- E:prev(S) 上一个兄弟元素为与简单选择符 S 相匹配的 E 元素
CSS 值选择符:
- E{display=none} css 的“display”属性等于“none”
- E{display^=none} css 的“display”属性以“none”开始
- E{display$=none} css 的“display”属性以“none”结尾
- E{display=none} css 的“display”属性包含字串“none”
- E{display%=2} css 的“display”属性能够被2整除
- E{display!=none} css 的“display”属性不等于“none”
@
配置项
这个类没有配置项。
公告属性
这个类没有公告属性。
公共方法
| |
compile
(
String selector,
[String type]
)
: Function
将一个 选择符 / xpath 查询编译为一个可利用的函数。返回的函数...
将一个 选择符 / xpath 查询编译为一个可利用的函数。返回的函数获得一个“root”参数(可选)作为查询的起点。
|
DomQuery
|
| |
select
(
String selector,
[Node root]
)
: Array
|
DomQuery
|
| |
selectNode
(
String selector,
[Node root]
)
: Element
选择单个元素。
选择单个元素。
参数项:
selector : String
选择符 / xpath 查询
root : Node
(可选)查询的起点(默认为:document)。
返回:
|
DomQuery
|
| |
selectValue
(
String selector,
[Node root],
String defaultValue
)
选择一个节点的值,可选择使用 defaultValue 替换掉 null。
选择一个节点的值,可选择使用 defaultValue 替换掉 null。
参数项:
selector : String
选择符 / xpath 查询
root : Node
(可选)查询的起点(默认为:document)。
defaultValue : String
返回:
|
DomQuery
|
| |
selectNumber
(
String selector,
[Node root],
Number defaultValue
)
: Number
取得一个经过处理的整形或浮点型的节点值。
取得一个经过处理的整形或浮点型的节点值。
参数项:
selector : String
查询时使用的 XPath 或选择符
root : Node
(可选)查询的起点(默认为 document)。
defaultValue : Number
返回:
|
DomQuery
|
| |
is
(
*/ ,
String selector
)
: Boolean
如果所给的元素与简易选择符相匹配,则返回 true(例如:div.so...
如果所给的元素与简易选择符相匹配,则返回 true(例如:div.some-class 或者 span:first-child)
|
DomQuery
|
| |
filter
(
Array el,
String selector,
Boolean nonMatches
)
: Array
将元素数组过滤成只包含匹配简易选择符的元素(例如:div.some-c...
将元素数组过滤成只包含匹配简易选择符的元素(例如:div.some-class 或者 span:first-child)
|
DomQuery
|
| |
matchers
(
)
|
DomQuery
|
| |
operators
(
)
= 和 %=。
可以添加形如 c= 的运算符。其中 <...
= 和 %=。
可以添加形如 c= 的运算符。其中 c 可以是除空格、>和<之外的任意字符。
|
DomQuery
|
| |
pseudos
(
)
"pseudo class" 处理器集合。每一个处理器将传递当前节点集...
"pseudo class" 处理器集合。每一个处理器将传递当前节点集(数组形式)和参数(如果有)以供选择符使用。
|
DomQuery
|
| |
Ext.query
(
String path,
[Node root]
)
: Array
选定一个通过 CSS/XPath 选择符获取的 DOM 节点组成的数组...
选定一个通过 CSS/XPath 选择符获取的 DOM 节点组成的数组。{@link Ext.DomQuery#select} 的简写方式
@member Ext
@method query
|
DomQuery
|
公告事件
这个类没公共的事件。