QueryList API文档

QL\Dom\Elements


  • ](#anchor)

该对象拥有所有phpQuery的方法,也就是说拥有几乎所有与jQuery操作DOM完全相同的API。

下面列几个常用的API,具体解释可以查看jQuery手册:

  • [HTML属性] 快捷获取html属性
  • map() 元素遍历
  • attr() 获取html属性
  • html() 获取元素的html内容
  • text() 获取元素的text内容
  • attrs() 获取多个元素的html属性
  • htmls() 获取多个元素的html内容
  • texts() 获取多个元素的text内容
  • children() 获取孩子节点

要采集的html:

$html = <<<STR
<div id="one">
    <div class="two">
        <a href="http://querylist.cc">QueryList官网</a>
        <img src="http://querylist.com/1.jpg" alt="这是图片" abc="这是一个自定义属性">
        <img src="http://querylist.com/2.jpg" alt="这是图片2">
    </div>
    <span>其它的<b>一些</b>文本</span>
</div>        
STR;

$ql = QueryList::html($html);

[HTML属性] 获取html属性

快速获取选中元素的任意属性,同attr()方法.

//获取第一张图片的链接地址
$ql->find('img')->src;
//等价下面这句话
$ql->find('img:eq(0)')->src;
//也等价下面这句话
$ql->find('img')->eq(0)->src;

//获取第一张图片的abc属性
$ql->find('img')->abc;

//获取第二张图片的alt属性
$ql->find('img')->eq(1)->alt;
//等价下面这句话
$ql->find('img:eq(1)')->alt;

map() 元素遍历

返回值为Collection集合对象

$data = $ql->find('img')->map(function($item){
    return $item->alt;
});

print_r($data->all());

输出:

Array
(
    [0] => 这是图片
    [1] => 这是图片2
)

attr() 获取html属性

获取选中元素的任意属性.

//获取第一张图片的链接地址
$ql->find('img')->attr('src');

//获取第一张图片的abc属性
$ql->find('img')->attr('abc');

//获取class为two的元素下的第一个a标签的href属性
$ql->find('.two>a')->attr('href');

attrs() 获取多个元素的html属性

返回值为Collection集合对象

//获取所有的图片链接
$data = $ql->find('img')->attrs('src');
print_r($data->all());

输出:

Array
(
    [0] => http://querylist.com/1.jpg
    [1] => http://querylist.com/2.jpg
)

htmls() 获取多个元素的html内容

返回值为Collection集合对象

$data = $ql->find('#one')->append('<div>追加内容</div>')->find('div')->htmls();
print_r($data->all());

输出:

Array
(
    [0] => <a href="http://querylist.cc">QueryList官网</a>
        <img src="http://querylist.com/1.jpg" alt="这是图片" abc="这是一个自定义属性"><img src="http://querylist.com/2.jpg" alt="这是图片2">
    [1] => 追加内容
)

children() 获取孩子节点

//获取class为two元素下的所有img孩子节点
$data = $ql->find('.two')->children('img')->attrs('alt');
print_r($data->all());

//获取class为two元素下的所有孩子节点
$data = $ql->find('.two')->children()->map(function ($item){
    //用is判断节点类型
    if($item->is('a')){
        return $item->text();
    }elseif($item->is('img'))
    {
        return $item->alt;
    }
});
print_r($data->all());

输出:

Array
(
    [0] => 这是图片
    [1] => 这是图片2
)

Array
(
    [0] => QueryList官网
    [1] => 这是图片
    [2] => 这是图片2
)