* $myDocumentId;
* phpQuery::newDocument('')
* ->getDocumentIDRef($myDocumentId)
* ->find('div')->...
*
*
* @param $documentID
* @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
* @see phpQuery::newDocument
* @see phpQuery::newDocumentFile
*/
public function getDocumentIDRef(&$documentID)
{
$documentID = $this->getDocumentID();
return $this;
}
/**
* Returns object with stack set to document root.
*
* @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
*/
public function getDocument()
{
return phpQuery::getDocument($this->getDocumentID());
}
/**
*
* @return DOMDocument
*/
public function getDOMDocument()
{
return $this->document;
}
/**
* @return int|phpQueryObject|QueryTemplatesParse|QueryTemplatesSource|QueryTemplatesSourceQuery|string|null
*/
public function getDocumentID()
{
return $this->documentID;
}
/**
* Unloads whole document from memory.
* CAUTION! None further operations will be possible on this document.
* All objects referring to it will be useless.
*
* @return void
*/
public function unloadDocument()
{
phpQuery::unloadDocuments($this->getDocumentID());
}
/**
* @return bool
*/
public function isHTML()
{
return $this->documentWrapper->isHTML;
}
/**
* @return bool
*/
public function isXHTML()
{
return $this->documentWrapper->isXHTML;
}
/**
* @return bool
*/
public function isXML()
{
return $this->documentWrapper->isXML;
}
/**
* Enter description here...
*
* @link http://docs.jquery.com/Ajax/serialize
* @return string
* @throws Exception
*/
public function serialize()
{
return phpQuery::param($this->serializeArray());
}
/**
* Enter description here...
*
* @link http://docs.jquery.com/Ajax/serializeArray
* @param null $submit
* @return array
* @throws Exception
*/
public function serializeArray($submit = null)
{
$source = $this->filter('form, input, select, textarea')
->find('input, select, textarea')
->andSelf()
->not('form');
$return = array();
foreach ($source as $input) {
$input = phpQuery::pq($input);
if ($input->is('[disabled]'))
continue;
if (!$input->is('[name]'))
continue;
if ($input->is('[type=checkbox]') && !$input->is('[checked]'))
continue;
if ($submit && $input->is('[type=submit]')) {
if ($submit instanceof DOMELEMENT && !$input->elements[0]->isSameNode($submit))
continue;
else if (is_string($submit) && $input->attr('name') != $submit)
continue;
}
$return[] = array(
'name' => $input->attr('name'),
'value' => $input->val(),
);
}
return $return;
}
/**
* @access private
* @param $in
*/
protected function debug($in)
{
if (!phpQuery::$debug)
return;
print('');
print_r($in);
print("\n");
}
/**
* @access private
* @param $pattern
* @return bool
*/
protected function isRegexp($pattern)
{
return in_array(
$pattern[mb_strlen($pattern) - 1],
array('^', '*', '$')
);
}
/**
* Determines if $char is really a char.
*
* @param string $char
* @return bool
* @todo rewrite me to char code range ! ;)
* @access private
*/
protected function isChar($char)
{
return extension_loaded('mbstring') && phpQuery::$mbstringSupport
? mb_eregi('\w', $char)
: preg_match('@\w@', $char);
}
/**
* @access private
* @param $query
* @return array
*/
protected function parseSelector($query)
{
// TODO include this inside parsing ?
$query = trim(
preg_replace('@\s+@', ' ',
preg_replace('@\s*(>|\\+|~)\s*@', '\\1', $query)
)
);
$queries = array(array());
if (!$query)
return $queries;
$return =& $queries[0];
$specialChars = array('>', ' ');
$specialCharsMapping = array();
$strlen = mb_strlen($query);
$classChars = array('.', '-');
$pseudoChars = array('-');
$tagChars = array('*', '|', '-');
$_query = array();
for ($i = 0; $i < $strlen; $i++)
$_query[] = mb_substr($query, $i, 1);
$query = $_query;
$i = 0;
while ($i < $strlen) {
$c = $query[$i];
$tmp = '';
// TAG
if ($this->isChar($c) || in_array($c, $tagChars)) {
while (isset($query[$i])
&& ($this->isChar($query[$i]) || in_array($query[$i], $tagChars))) {
$tmp .= $query[$i];
$i++;
}
$return[] = $tmp;
// IDs
} else if ($c == '#') {
$i++;
while (isset($query[$i]) && ($this->isChar($query[$i]) || $query[$i] == '-')) {
$tmp .= $query[$i];
$i++;
}
$return[] = '#' . $tmp;
} else if (in_array($c, $specialChars)) {
$return[] = $c;
$i++;
} else if (isset($specialCharsMapping[$c])) {
$return[] = $specialCharsMapping[$c];
$i++;
// COMMA
} else if ($c == ',') {
$queries[] = array();
$return =& $queries[count($queries) - 1];
$i++;
while (isset($query[$i]) && $query[$i] == ' ')
$i++;
} else if ($c == '.') {
while (isset($query[$i]) && ($this->isChar($query[$i]) || in_array($query[$i], $classChars))) {
$tmp .= $query[$i];
$i++;
}
$return[] = $tmp;
// ~ General Sibling Selector
} else if ($c == '~') {
$spaceAllowed = true;
$tmp .= $query[$i++];
while (isset($query[$i])
&& ($this->isChar($query[$i])
|| in_array($query[$i], $classChars)
|| $query[$i] == '*'
|| ($query[$i] == ' ' && $spaceAllowed)
)) {
if ($query[$i] != ' ')
$spaceAllowed = false;
$tmp .= $query[$i];
$i++;
}
$return[] = $tmp;
// + Adjacent sibling selectors
} else if ($c == '+') {
$spaceAllowed = true;
$tmp .= $query[$i++];
while (isset($query[$i])
&& ($this->isChar($query[$i])
|| in_array($query[$i], $classChars)
|| $query[$i] == '*'
|| ($spaceAllowed && $query[$i] == ' ')
)) {
if ($query[$i] != ' ')
$spaceAllowed = false;
$tmp .= $query[$i];
$i++;
}
$return[] = $tmp;
// ATTRS
} else if ($c == '[') {
$stack = 1;
$tmp .= $c;
while (isset($query[++$i])) {
$tmp .= $query[$i];
if ($query[$i] == '[') {
$stack++;
} else if ($query[$i] == ']') {
$stack--;
if (!$stack)
break;
}
}
$return[] = $tmp;
$i++;
// PSEUDO CLASSES
} else if ($c == ':') {
$tmp .= $query[$i++];
while (isset($query[$i]) && ($this->isChar($query[$i]) || in_array($query[$i], $pseudoChars))) {
$tmp .= $query[$i];
$i++;
}
// with arguments ?
if (isset($query[$i]) && $query[$i] == '(') {
$tmp .= $query[$i];
$stack = 1;
while (isset($query[++$i])) {
$tmp .= $query[$i];
if ($query[$i] == '(') {
$stack++;
} else if ($query[$i] == ')') {
$stack--;
if (!$stack)
break;
}
}
$return[] = $tmp;
$i++;
} else {
$return[] = $tmp;
}
} else {
$i++;
}
}
foreach ($queries as $k => $q) {
if (isset($q[0])) {
if (isset($q[0][0]) && $q[0][0] == ':')
array_unshift($queries[$k], '*');
if ($q[0] != '>')
array_unshift($queries[$k], ' ');
}
}
return $queries;
}
/**
* Return matched DOM nodes.
*
* @param int $index
* @param null $callback1
* @param null $callback2
* @param null $callback3
* @return array|DOMElement Single DOMElement or array of DOMElement.
*/
public function get($index = null, $callback1 = null,
$callback2 = null, $callback3 = null)
{
$return = isset($index)
? (isset($this->elements[$index]) ? $this->elements[$index] : null)
: $this->elements;
$args = func_get_args();
$args = array_slice($args, 1);
foreach ($args as $callback) {
if (is_array($return))
foreach ($return as $k => $v)
$return[$k] = phpQuery::callbackRun($callback, array($v));
else
$return = phpQuery::callbackRun($callback, array($return));
}
return $return;
}
/**
* Return matched DOM nodes.
* jQuery difference.
*
* @param int $index
* @param null $callback1
* @param null $callback2
* @param null $callback3
* @return array|string Returns string if $index != null
* @throws Exception
* @todo implement callbacks
* @todo return only arrays ?
* @todo maybe other name...
*/
public function getString($index = null, $callback1 = null, $callback2 = null, $callback3 = null)
{
if ($index)
$return = $this->eq($index)->text();
else {
$return = array();
for ($i = 0; $i < $this->size(); $i++) {
$return[] = $this->eq($i)->text();
}
}
// pass thou callbacks
$args = func_get_args();
$args = array_slice($args, 1);
foreach ($args as $callback) {
$return = phpQuery::callbackRun($callback, array($return));
}
return $return;
}
/**
* Return matched DOM nodes.
* jQuery difference.
*
* @param int $index
* @param null $callback1
* @param null $callback2
* @param null $callback3
* @return array|string Returns string if $index != null
* @throws Exception
* @todo implement callbacks
* @todo return only arrays ?
* @todo maybe other name...
*/
public function getStrings($index = null, $callback1 = null, $callback2 = null, $callback3 = null)
{
$args = null;
if ($index)
$return = $this->eq($index)->text();
else {
$return = array();
for ($i = 0; $i < $this->size(); $i++) {
$return[] = $this->eq($i)->text();
}
// pass thou callbacks
$args = func_get_args();
$args = array_slice($args, 1);
}
foreach ($args as $callback) {
if (is_array($return))
foreach ($return as $k => $v)
$return[$k] = phpQuery::callbackRun($callback, array($v));
else
$return = phpQuery::callbackRun($callback, array($return));
}
return $return;
}
/**
* Returns new instance of actual class.
*
* @param array $newStack Optional. Will replace old stack with new and move old one to history.c
* @return phpQueryObject
* @throws Exception
*/
public function newInstance($newStack = null)
{
$class = get_class($this);
// support inheritance by passing old object to overloaded constructor
$new = $class != 'phpQuery'
? new $class($this, $this->getDocumentID())
: new phpQueryObject($this->getDocumentID());
$new->previous = $this;
if (is_null($newStack)) {
$new->elements = $this->elements;
if ($this->elementsBackup)
$this->elements = $this->elementsBackup;
} else if (is_string($newStack)) {
$new->elements = phpQuery::pq($newStack, $this->getDocumentID())->stack();
} else {
$new->elements = $newStack;
}
return $new;
}
/**
* @param $class
* @param $node
* @return bool
*/
protected function matchClasses($class, $node)
{
// multi-class
if (mb_strpos($class, '.', 1)) {
$classes = explode('.', substr($class, 1));
$classesCount = count($classes);
$nodeClasses = explode(' ', $node->getAttribute('class'));
$nodeClassesCount = count($nodeClasses);
if ($classesCount > $nodeClassesCount)
return false;
$diff = count(
array_diff(
$classes,
$nodeClasses
)
);
return !$diff;
// single-class
} else {
return in_array(
// strip leading dot from class name
substr($class, 1),
// get classes for element as array
explode(' ', $node->getAttribute('class'))
);
}
}
/**
* @param $XQuery
* @param null $selector
* @param null $compare
* @return bool
*/
protected function runQuery($XQuery, $selector = null, $compare = null)
{
if ($compare && !method_exists($this, $compare))
return false;
$stack = array();
if (!$this->elements)
$this->debug('Stack empty, skipping...');
foreach ($this->stack(array(1, 9, 13)) as $k => $stackNode) {
$detachAfter = false;
$testNode = $stackNode;
while ($testNode) {
if (!$testNode->parentNode && !$this->isRoot($testNode)) {
$this->root->appendChild($testNode);
$detachAfter = $testNode;
break;
}
$testNode = isset($testNode->parentNode)
? $testNode->parentNode
: null;
}
// XXX tmp ?
$xpath = $this->documentWrapper->isXHTML
? $this->getNodeXpath($stackNode)
: $this->getNodeXpath($stackNode);
// FIXME pseudo-classes-only query, support XML
$query = $XQuery == '//' && $xpath == '/html[1]'
? '//*'
: $xpath . $XQuery;
$this->debug("XPATH: {$query}");
// run query, get elements
$nodes = $this->xpath->query($query);
$this->debug("QUERY FETCHED");
if (!$nodes->length)
$this->debug('Nothing found');
$debug = array();
foreach ($nodes as $node) {
$matched = false;
if ($compare) {
phpQuery::$debug ?
$this->debug("Found: " . $this->whois($node) . ", comparing with {$compare}()")
: null;
$phpQueryDebug = phpQuery::$debug;
phpQuery::$debug = false;
// TODO ??? use phpQuery::callbackRun()
if (call_user_func_array(array($this, $compare), array($selector, $node)))
$matched = true;
phpQuery::$debug = $phpQueryDebug;
} else {
$matched = true;
}
if ($matched) {
if (phpQuery::$debug)
$debug[] = $this->whois($node);
$stack[] = $node;
}
}
if (phpQuery::$debug) {
$this->debug("Matched " . count($debug) . ": " . implode(', ', $debug));
}
if ($detachAfter)
$this->root->removeChild($detachAfter);
}
$this->elements = $stack;
}
/**
* @param $selectors
* @param null $context
* @param bool $noHistory
* @return phpQueryObject
* @throws Exception
*/
public function find($selectors, $context = null, $noHistory = false)
{
if (!$noHistory)
// backup last stack /for end()/
$this->elementsBackup = $this->elements;
// allow to define context
// TODO combine code below with phpQuery::pq() context guessing code
// as generic function
if ($context) {
if (!is_array($context) && $context instanceof DOMELEMENT)
$this->elements = array($context);
else if (is_array($context)) {
$this->elements = array();
foreach ($context as $c)
if ($c instanceof DOMELEMENT)
$this->elements[] = $c;
} else if ($context instanceof self)
$this->elements = $context->elements;
}
$queries = $this->parseSelector($selectors);
$this->debug(array('FIND', $selectors, $queries));
$XQuery = '';
// remember stack state because of multi-queries
$oldStack = $this->elements;
// here we will be keeping found elements
$stack = array();
foreach ($queries as $selector) {
$this->elements = $oldStack;
$delimiterBefore = false;
foreach ($selector as $s) {
// TAG
$isTag = extension_loaded('mbstring') && phpQuery::$mbstringSupport
? mb_ereg_match('^[\w|\||-]+$', $s) || $s == '*'
: preg_match('@^[\w|\||-]+$@', $s) || $s == '*';
if ($isTag) {
if ($this->isXML()) {
// namespace support
if (mb_strpos($s, '|') !== false) {
list($ns, $tag) = explode('|', $s);
$XQuery .= "$ns:$tag";
} else if ($s == '*') {
$XQuery .= "*";
} else {
$XQuery .= "*[local-name()='$s']";
}
} else {
$XQuery .= $s;
}
// ID
} else if ($s[0] == '#') {
if ($delimiterBefore)
$XQuery .= '*';
$XQuery .= "[@id='" . substr($s, 1) . "']";
// ATTRIBUTES
} else if ($s[0] == '[') {
if ($delimiterBefore)
$XQuery .= '*';
// strip side brackets
$attr = trim($s, '][');
$execute = false;
// attr with specifed value
if (mb_strpos($s, '=')) {
$value = null;
list($attr, $value) = explode('=', $attr);
$value = trim($value, "'\"");
if ($this->isRegexp($attr)) {
// cut regexp character
$attr = substr($attr, 0, -1);
$execute = true;
$XQuery .= "[@{$attr}]";
} else {
$XQuery .= "[@{$attr}='{$value}']";
}
// attr without specified value
} else {
$XQuery .= "[@{$attr}]";
}
if ($execute) {
$this->runQuery($XQuery, $s, 'is');
$XQuery = '';
if (!$this->size())
break;
}
// CLASSES
} else if ($s[0] == '.') {
// TODO use return $this->find("./self::*[contains(concat(\" \",@class,\" \"), \" $class \")]");
// thx wizDom ;)
if ($delimiterBefore)
$XQuery .= '*';
$XQuery .= '[@class]';
$this->runQuery($XQuery, $s, 'matchClasses');
$XQuery = '';
if (!$this->size())
break;
// ~ General Sibling Selector
} else if ($s[0] == '~') {
$this->runQuery($XQuery);
$XQuery = '';
$this->elements = $this
->siblings(
substr($s, 1)
)->elements;
if (!$this->size())
break;
// + Adjacent sibling selectors
} else if ($s[0] == '+') {
// TODO /following-sibling::
$this->runQuery($XQuery);
$XQuery = '';
$subSelector = substr($s, 1);
$subElements = $this->elements;
$this->elements = array();
foreach ($subElements as $node) {
// search first DOMElement sibling
$test = $node->nextSibling;
while ($test && !($test instanceof DOMELEMENT))
$test = $test->nextSibling;
if ($test && $this->is($subSelector, $test))
$this->elements[] = $test;
}
if (!$this->size())
break;
// PSEUDO CLASSES
} else if ($s[0] == ':') {
// TODO optimization for :first :last
if ($XQuery) {
$this->runQuery($XQuery);
$XQuery = '';
}
if (!$this->size())
break;
$this->pseudoClasses($s);
if (!$this->size())
break;
// DIRECT DESCENDANDS
} else if ($s == '>') {
$XQuery .= '/';
$delimiterBefore = 2;
// ALL DESCENDANDS
} else if ($s == ' ') {
$XQuery .= '//';
$delimiterBefore = 2;
// ERRORS
} else {
phpQuery::debug("Unrecognized token '$s'");
}
$delimiterBefore = $delimiterBefore === 2;
}
// run query if any
if ($XQuery && $XQuery != '//') {
$this->runQuery($XQuery);
$XQuery = '';
}
foreach ($this->elements as $node)
if (!$this->elementsContainsNode($node, $stack))
$stack[] = $node;
}
$this->elements = $stack;
return $this->newInstance();
}
/**
* @param $class
* @throws Exception
*/
protected function pseudoClasses($class)
{
$args = null;
// TODO clean args parsing ?
$class = ltrim($class, ':');
$haveArgs = mb_strpos($class, '(');
if ($haveArgs !== false) {
$args = substr($class, $haveArgs + 1, -1);
$class = substr($class, 0, $haveArgs);
}
switch ($class) {
case 'even':
case 'odd':
$stack = array();
foreach ($this->elements as $i => $node) {
if ($class == 'even' && ($i % 2) == 0)
$stack[] = $node;
else if ($class == 'odd' && $i % 2)
$stack[] = $node;
}
$this->elements = $stack;
break;
case 'eq':
$k = intval($args);
$this->elements = isset($this->elements[$k])
? array($this->elements[$k])
: array();
break;
case 'gt':
$this->elements = array_slice($this->elements, $args + 1);
break;
case 'lt':
$this->elements = array_slice($this->elements, 0, $args + 1);
break;
case 'first':
if (isset($this->elements[0]))
$this->elements = array($this->elements[0]);
break;
case 'last':
if ($this->elements)
$this->elements = array($this->elements[count($this->elements) - 1]);
break;
/*case 'parent':
$stack = array();
foreach($this->elements as $node) {
if ( $node->childNodes->length )
$stack[] = $node;
}
$this->elements = $stack;
break;*/
case 'contains':
$text = trim($args, "\"'");
$stack = array();
foreach ($this->elements as $node) {
if (mb_stripos($node->textContent, $text) === false)
continue;
$stack[] = $node;
}
$this->elements = $stack;
break;
case 'not':
$selector = self::unQuote($args);
$this->elements = $this->not($selector)->stack();
break;
case 'slice':
// TODO jQuery difference ?
$args = explode(',',
str_replace(', ', ',', trim($args, "\"'"))
);
$start = $args[0];
$end = isset($args[1])
? $args[1]
: null;
if ($end > 0)
$end = $end - $start;
$this->elements = array_slice($this->elements, $start, $end);
break;
case 'has':
$selector = trim($args, "\"'");
$stack = array();
foreach ($this->stack(1) as $el) {
if ($this->find($selector, $el, true)->length)
$stack[] = $el;
}
$this->elements = $stack;
break;
case 'submit':
case 'reset':
$this->elements = phpQuery::merge(
$this->map(array($this, 'is'),
"input[type=$class]", new CallbackParam()
),
$this->map(array($this, 'is'),
"button[type=$class]", new CallbackParam()
)
);
break;
case 'input':
$this->elements = $this->map(
array($this, 'is'),
'input', new CallbackParam()
)->elements;
break;
case 'password':
case 'checkbox':
case 'radio':
case 'hidden':
case 'image':
case 'file':
$this->elements = $this->map(
array($this, 'is'),
"input[type=$class]", new CallbackParam()
)->elements;
break;
case 'parent':
$this->elements = $this->map(
function ($node) {
return $node instanceof DOMELEMENT && $node->childNodes->length
? $node : null;
}
)->elements;
break;
case 'empty':
$this->elements = $this->map(
function ($node) {
return $node instanceof DOMELEMENT && $node->childNodes->length
? null : $node;
}
)->elements;
break;
case 'disabled':
case 'selected':
case 'checked':
$this->elements = $this->map(
array($this, 'is'),
"[$class]", new CallbackParam()
)->elements;
break;
case 'enabled':
$this->elements = $this->map(
function ($node) {
return pq($node)->not(":disabled") ? $node : null;
}
)->elements;
break;
case 'header':
$this->elements = $this->map(
function ($node) {
$isHeader = isset($node->tagName) && in_array($node->tagName, array(
"h1", "h2", "h3", "h4", "h5", "h6", "h7"
));
return $isHeader
? $node
: null;
}
)->elements;
// Commented for some reason
// $this->elements = $this->map(
// function ($node) {
// $node = pq($node);
// return $node->is("h1")
// || $node->is("h2")
// || $node->is("h3")
// || $node->is("h4")
// || $node->is("h5")
// || $node->is("h6")
// || $node->is("h7")
// ? $node
// : null;
// }
// )->elements;
break;
case 'only-child':
$this->elements = $this->map(
function ($node) {
return pq($node)->siblings()->size() == 0 ? $node : null;
}
)->elements;
break;
case 'first-child':
$this->elements = $this->map(
function ($node) {
return pq($node)->prevAll()->size() == 0 ? $node : null;
}
)->elements;
break;
case 'last-child':
$this->elements = $this->map(
function ($node) {
return pq($node)->nextAll()->size() == 0 ? $node : null;
}
)->elements;
break;
case 'nth-child':
$param = trim($args, "\"'");
if (!$param)
break;
if ($param{0} == 'n')
$param = '1' . $param;
if ($param == 'even' || $param == 'odd')
$mapped = $this->map(
function ($node, $param) {
$index = pq($node)->prevAll()->size() + 1;
if ($param == "even" && ($index % 2) == 0) {
return $node;
} else if ($param == "odd" && $index % 2 == 1) {
return $node;
} else {
return null;
}
},
new CallbackParam(), $param
);
else if (mb_strlen($param) > 1 && $param{1} == 'n')
// an+b
$mapped = $this->map(
function ($node) use ($param) {
$prevs = pq($node)->prevAll()->size();
$index = 1 + $prevs;
$b = mb_strlen($param) > 3
? $param{3}
: 0;
$a = $param{0};
if ($b && $param{2} == "-")
$b = -$b;
if ($a > 0) {
return ($index - $b) % $a == 0
? $node
: null;
} else if ($a == 0)
return $index == $b
? $node
: null;
else
// negative value
return $index <= $b
? $node
: null;
},
new CallbackParam(), $param
);
else
// index
$mapped = $this->map(
function ($node, $index) {
$prevs = pq($node)->prevAll()->size();
if ($prevs && $prevs == $index - 1)
return $node;
else if (!$prevs && $index == 1)
return $node;
else
return null;
},
new CallbackParam(), $param
);
$this->elements = $mapped->elements;
break;
default:
$this->debug("Unknown pseudoclass '{$class}', skipping...");
}
}
/**
* @access private
* @param $paramsString
*/
protected function __pseudoClassParam($paramsString)
{
// TODO;
}
/**
* Enter description here...
*
* @param $selector
* @param null $nodes
* @return array|bool|null
* @throws Exception
*/
public function is($selector, $nodes = null)
{
phpQuery::debug(array("Is:", $selector));
if (!$selector)
return false;
$oldStack = $this->elements;
if ($nodes && is_array($nodes)) {
$this->elements = $nodes;
} else if ($nodes)
$this->elements = array($nodes);
$this->filter($selector, true);
$stack = $this->elements;
$this->elements = $oldStack;
if ($nodes)
return $stack ? $stack : null;
return (bool)count($stack);
}
/**
* Enter description here...
* jQuery difference.
*
* Callback:
* - $index int
* - $node DOMNode
*
* @param $callback
* @param bool $_skipHistory
* @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
* @throws Exception
* @link http://docs.jquery.com/Traversing/filter
*/
public function filterCallback($callback, $_skipHistory = false)
{
if (!$_skipHistory) {
$this->elementsBackup = $this->elements;
$this->debug("Filtering by callback");
}
$newStack = array();
foreach ($this->elements as $index => $node) {
$result = phpQuery::callbackRun($callback, array($index, $node));
if (is_null($result) || (!is_null($result) && $result))
$newStack[] = $node;
}
$this->elements = $newStack;
return $_skipHistory
? $this
: $this->newInstance();
}
/**
* Enter description here...
*
* @param $selectors
* @param bool $_skipHistory
* @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
* @throws Exception
* @link http://docs.jquery.com/Traversing/filter
*/
public function filter($selectors, $_skipHistory = false)
{
$pattern = null;
if ($selectors instanceof Callback OR $selectors instanceof Closure)
return $this->filterCallback($selectors, $_skipHistory);
if (!$_skipHistory)
$this->elementsBackup = $this->elements;
$notSimpleSelector = array(' ', '>', '~', '+', '/');
if (!is_array($selectors))
$selectors = $this->parseSelector($selectors);
if (!$_skipHistory)
$this->debug(array("Filtering:", $selectors));
$finalStack = array();
foreach ($selectors as $selector) {
$stack = array();
if (!$selector)
break;
// avoid first space or /
if (in_array($selector[0], $notSimpleSelector))
$selector = array_slice($selector, 1);
// PER NODE selector chunks
foreach ($this->stack() as $node) {
$break = false;
foreach ($selector as $s) {
if (!($node instanceof DOMELEMENT)) {
// all besides DOMElement
if ($s[0] == '[') {
$attr = trim($s, '[]');
if (mb_strpos($attr, '=')) {
list($attr, $val) = explode('=', $attr);
if ($attr == 'nodeType' && $node->nodeType != $val)
$break = true;
}
} else
$break = true;
} else {
// DOMElement only
// ID
if ($s[0] == '#') {
if ($node->getAttribute('id') != substr($s, 1))
$break = true;
// CLASSES
} else if ($s[0] == '.') {
if (!$this->matchClasses($s, $node))
$break = true;
// ATTRS
} else if ($s[0] == '[') {
// strip side brackets
$attr = trim($s, '[]');
if (mb_strpos($attr, '=')) {
list($attr, $val) = explode('=', $attr);
$val = self::unQuote($val);
if ($attr == 'nodeType') {
if ($val != $node->nodeType)
$break = true;
} else if ($this->isRegexp($attr)) {
$val = extension_loaded('mbstring') && phpQuery::$mbstringSupport
? quotemeta(trim($val, '"\''))
: preg_quote(trim($val, '"\''), '@');
// switch last character
switch (substr($attr, -1)) {
// quotemeta used insted of preg_quote
// http://code.google.com/p/phpquery/issues/detail?id=76
case '^':
$pattern = '^' . $val;
break;
case '*':
$pattern = '.*' . $val . '.*';
break;
case '$':
$pattern = '.*' . $val . '$';
break;
}
// cut last character
$attr = substr($attr, 0, -1);
$isMatch = extension_loaded('mbstring') && phpQuery::$mbstringSupport
? mb_ereg_match($pattern, $node->getAttribute($attr))
: preg_match("@{$pattern}@", $node->getAttribute($attr));
if (!$isMatch)
$break = true;
} else if ($node->getAttribute($attr) != $val)
$break = true;
} else if (!$node->hasAttribute($attr))
$break = true;
// PSEUDO CLASSES
} else if ($s[0] == ':') {
// skip
// TAG
} else if (trim($s)) {
if ($s != '*') {
// TODO namespaces
if (isset($node->tagName)) {
if ($node->tagName != $s)
$break = true;
} else if ($s == 'html' && !$this->isRoot($node))
$break = true;
}
// AVOID NON-SIMPLE SELECTORS
} else if (in_array($s, $notSimpleSelector)) {
$break = true;
$this->debug(array('Skipping non simple selector', $selector));
}
}
if ($break)
break;
}
// if element passed all chunks of selector - add it to new stack
if (!$break)
$stack[] = $node;
}
$tmpStack = $this->elements;
$this->elements = $stack;
// PER ALL NODES selector chunks
foreach ($selector as $s)
// PSEUDO CLASSES
if ($s[0] == ':')
$this->pseudoClasses($s);
foreach ($this->elements as $node)
// XXX it should be merged without duplicates
// but jQuery doesnt do that
$finalStack[] = $node;
$this->elements = $tmpStack;
}
$this->elements = $finalStack;
if ($_skipHistory) {
return $this;
} else {
$this->debug("Stack length after filter(): " . count($finalStack));
return $this->newInstance();
}
}
/**
*
* @param $value
* @return string
* @TODO implement in all methods using passed parameters
*/
protected static function unQuote($value)
{
return $value[0] == '\'' || $value[0] == '"'
? substr($value, 1, -1)
: $value;
}
/**
* Enter description here...
*
* @link http://docs.jquery.com/Ajax/load
* @param $url
* @param null $data
* @param null $callback
* @return phpQueryObject
* @throws Exception
* @todo Support $selector
*/
public function load($url, $data = null, $callback = null)
{
if ($data && !is_array($data)) {
$callback = $data;
$data = null;
}
if (mb_strpos($url, ' ') !== false) {
$matches = null;
if (extension_loaded('mbstring') && phpQuery::$mbstringSupport)
mb_ereg('^([^ ]+) (.*)$', $url, $matches);
else
preg_match('^([^ ]+) (.*)$', $url, $matches);
$url = $matches[1];
$selector = $matches[2];
// FIXME this sucks, pass as callback param
$this->_loadSelector = $selector;
}
$ajax = array(
'url' => $url,
'type' => $data ? 'POST' : 'GET',
'data' => $data,
'complete' => $callback,
'success' => array($this, '__loadSuccess')
);
phpQuery::ajax($ajax);
return $this;
}
/**
* @access private
* @param $html
* @return void
* @throws Exception
*/
public function __loadSuccess($html)
{
if ($this->_loadSelector) {
$html = phpQuery::newDocument($html)->find($this->_loadSelector);
unset($this->_loadSelector);
}
foreach ($this->stack(1) as $node) {
phpQuery::pq($node, $this->getDocumentID())
->markup($html);
}
}
/**
* Enter description here...
*
* @return phpQueryObject
* @todo
*/
public function css()
{
return $this;
}
/**
* @return $this
*/
public function show()
{
return $this;
}
/**
* @return $this
*/
public function hide()
{
return $this;
}
/**
* Trigger a type of event on every matched element.
*
* @param string $type
* @param array $data
* @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
* @throws Exception
* @TODO support more than event in $type (space-separated)
*/
public function trigger($type, $data = array())
{
foreach ($this->elements as $node)
phpQueryEvents::trigger($this->getDocumentID(), $type, $data, $node);
return $this;
}
/**
* This particular method triggers all bound event handlers on an element (for a specific event type) WITHOUT executing the browsers default actions.
*
* @param string $type
* @param array $data
* @return void
* @TODO
*/
public function triggerHandler($type, $data = array())
{
// TODO;
}
/**
* @param $type
* @param $data
* @param null $callback
* @return $this
*/
public function bind($type, $data, $callback = null)
{
// TODO check if $data is callable, not using is_callable
if (!isset($callback)) {
$callback = $data;
$data = null;
}
foreach ($this->elements as $node)
phpQueryEvents::add($this->getDocumentID(), $node, $type, $data, $callback);
return $this;
}
/**
* Enter description here...
*
* @param string $type
* @param mixed $callback
* @return phpQueryObject
* @TODO namespace events
* @TODO support more than event in $type (space-separated)
*/
public function unbind($type = null, $callback = null)
{
foreach ($this->elements as $node)
phpQueryEvents::remove($this->getDocumentID(), $node, $type, $callback);
return $this;
}
/**
* @param null $callback
* @return phpQueryObject|QueryTemplatesParse|QueryTemplatesSource|QueryTemplatesSourceQuery
* @throws Exception
*/
public function change($callback = null)
{
if ($callback)
return $this->bind('change', $callback);
return $this->trigger('change');
}
/**
* @param null $callback
* @return phpQueryObject|QueryTemplatesParse|QueryTemplatesSource|QueryTemplatesSourceQuery
* @throws Exception
*/
public function submit($callback = null)
{
if ($callback)
return $this->bind('submit', $callback);
return $this->trigger('submit');
}
/**
* @param null $callback
* @return phpQueryObject|QueryTemplatesParse|QueryTemplatesSource|QueryTemplatesSourceQuery
* @throws Exception
*/
public function click($callback = null)
{
if ($callback)
return $this->bind('click', $callback);
return $this->trigger('click');
}
/**
* Enter description here...
*
* @param String|phpQuery
* @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
* @throws Exception
*/
public function wrapAllOld($wrapper)
{
$wrapper = pq($wrapper)->_clone();
if (!$wrapper->size() || !$this->size())
return $this;
$wrapper->insertBefore($this->elements[0]);
$deepest = $wrapper->elements[0];
while ($deepest->firstChild && $deepest->firstChild instanceof DOMELEMENT)
$deepest = $deepest->firstChild;
pq($deepest)->append($this);
return $this;
}
/**
* Enter description here...
*
* TODO testme...
* @param String|phpQuery
* @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
* @throws Exception
*/
public function wrapAll($wrapper)
{
if (!$this->size())
return $this;
return phpQuery::pq($wrapper, $this->getDocumentID())
->clone()
->insertBefore($this->get(0))
->map(array($this, '___wrapAllCallback'))
->append($this);
}
/**
*
* @param $node
* @return unknown_type
* @access private
*/
public function ___wrapAllCallback($node)
{
$deepest = $node;
while ($deepest->firstChild && $deepest->firstChild instanceof DOMELEMENT)
$deepest = $deepest->firstChild;
return $deepest;
}
/**
* Enter description here...
* NON JQUERY METHOD
*
* @param $codeBefore
* @param $codeAfter
* @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
* @throws Exception
*/
public function wrapAllPHP($codeBefore, $codeAfter)
{
return $this
->slice(0, 1)
->beforePHP($codeBefore)
->end()
->slice(-1)
->afterPHP($codeAfter)
->end();
}
/**
* Enter description here...
*
* @param String|phpQuery
* @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
* @throws Exception
*/
public function wrap($wrapper)
{
foreach ($this->stack() as $node)
phpQuery::pq($node, $this->getDocumentID())->wrapAll($wrapper);
return $this;
}
/**
* Enter description here...
*
* @param $codeBefore
* @param $codeAfter
* @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
* @throws Exception
*/
public function wrapPHP($codeBefore, $codeAfter)
{
foreach ($this->stack() as $node)
phpQuery::pq($node, $this->getDocumentID())->wrapAllPHP($codeBefore, $codeAfter);
return $this;
}
/**
* Enter description here...
*
* @param String|phpQuery
* @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
* @throws Exception
*/
public function wrapInner($wrapper)
{
foreach ($this->stack() as $node)
phpQuery::pq($node, $this->getDocumentID())->contents()->wrapAll($wrapper);
return $this;
}
/**
* Enter description here...
*
* @param $codeBefore
* @param $codeAfter
* @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
* @throws Exception
*/
public function wrapInnerPHP($codeBefore, $codeAfter)
{
foreach ($this->stack(1) as $node)
phpQuery::pq($node, $this->getDocumentID())->contents()
->wrapAllPHP($codeBefore, $codeAfter);
return $this;
}
/**
* Enter description here...
*
* @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
* @throws Exception
* @testme Support for text nodes
*/
public function contents()
{
$stack = array();
foreach ($this->stack(1) as $el) {
// FIXME (fixed) http://code.google.com/p/phpquery/issues/detail?id=56
// if (! isset($el->childNodes))
// continue;
foreach ($el->childNodes as $node) {
$stack[] = $node;
}
}
return $this->newInstance($stack);
}
/**
* Enter description here...
*
* jQuery difference.
*
* @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
*/
public function contentsUnwrap()
{
foreach ($this->stack(1) as $node) {
if (!$node->parentNode)
continue;
$childNodes = array();
// any modification in DOM tree breaks childNodes iteration, so cache them first
foreach ($node->childNodes as $chNode)
$childNodes[] = $chNode;
foreach ($childNodes as $chNode)
$node->parentNode->insertBefore($chNode, $node);
$node->parentNode->removeChild($node);
}
return $this;
}
/**
* Enter description here...
*
* jQuery difference.
* @param $markup
* @return phpQueryObject
* @throws Exception
*/
public function switchWith($markup)
{
$markup = pq($markup, $this->getDocumentID());
$content = null;
foreach ($this->stack(1) as $node) {
pq($node)
->contents()->toReference($content)->end()
->replaceWith($markup->clone()->append($content));
}
return $this;
}
/**
* Enter description here...
*
* @param $num
* @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
* @throws Exception
*/
public function eq($num)
{
$oldStack = $this->elements;
$this->elementsBackup = $this->elements;
$this->elements = array();
if (isset($oldStack[$num]))
$this->elements[] = $oldStack[$num];
return $this->newInstance();
}
/**
* Enter description here...
*
* @return int
*/
public function size()
{
return count($this->elements);
}
/**
* @return int|phpQueryObject|QueryTemplatesParse|QueryTemplatesSource|QueryTemplatesSourceQuery
*/
public function count()
{
return $this->size();
}
/**
* Enter description here...
*
* @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
* @todo $level
*/
public function end()
{
return $this->previous
? $this->previous
: $this;
}
/**
* Enter description here...
* Normal use ->clone() .
*
* @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
* @throws Exception
* @access private
*/
public function _clone()
{
$newStack = array();
$this->elementsBackup = $this->elements;
foreach ($this->elements as $node) {
$newStack[] = $node->cloneNode(true);
}
$this->elements = $newStack;
return $this->newInstance();
}
/**
* Enter description here...
*
* @param $code
* @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
* @throws Exception
*/
public function replaceWithPHP($code)
{
return $this->replaceWith(phpQuery::php($code));
}
/**
* Enter description here...
*
* @param String|phpQuery $content
* @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
* @throws Exception
* @link http://docs.jquery.com/Manipulation/replaceWith#content
*/
public function replaceWith($content)
{
return $this->after($content)->remove();
}
/**
* Enter description here...
*
* @param String $selector
* @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
* @throws Exception
* @todo this works ?
*/
public function replaceAll($selector)
{
foreach (phpQuery::pq($selector, $this->getDocumentID()) as $node)
phpQuery::pq($node, $this->getDocumentID())
->after($this->_clone())
->remove();
return $this;
}
/**
* Enter description here...
*
* @param null $selector
* @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
* @throws Exception
*/
public function remove($selector = null)
{
$loop = $selector
? $this->filter($selector)->elements
: $this->elements;
foreach ($loop as $node) {
if (!$node->parentNode)
continue;
if (isset($node->tagName))
$this->debug("Removing '{$node->tagName}'");
$node->parentNode->removeChild($node);
// Mutation event
$event = new DOMEvent(array(
'target' => $node,
'type' => 'DOMNodeRemoved'
));
phpQueryEvents::trigger($this->getDocumentID(),
$event->type, array($event), $node
);
}
return $this;
}
/**
* @param $newMarkup
* @param $oldMarkup
* @param $node
* @throws Exception
*/
protected function markupEvents($newMarkup, $oldMarkup, $node)
{
if ($node->tagName == 'textarea' && $newMarkup != $oldMarkup) {
$event = new DOMEvent(array(
'target' => $node,
'type' => 'change'
));
phpQueryEvents::trigger($this->getDocumentID(),
$event->type, array($event), $node
);
}
}
/**
* jQuey difference
*
* @param $markup
* @param null $callback1
* @param null $callback2
* @param null $callback3
* @return mixed
* @TODO trigger change event for textarea
*/
public function markup($markup = null, $callback1 = null, $callback2 = null, $callback3 = null)
{
$args = func_get_args();
if ($this->documentWrapper->isXML)
return call_user_func_array(array($this, 'xml'), $args);
else
return call_user_func_array(array($this, 'html'), $args);
}
/**
* jQuey difference
*
* @param null $callback1
* @param null $callback2
* @param null $callback3
* @return string
*/
public function markupOuter($callback1 = null, $callback2 = null, $callback3 = null)
{
$args = func_get_args();
if ($this->documentWrapper->isXML)
return call_user_func_array(array($this, 'xmlOuter'), $args);
else
return call_user_func_array(array($this, 'htmlOuter'), $args);
}
/**
* Enter description here...
*
* @param mixed $html
* @param null $callback1
* @param null $callback2
* @param null $callback3
* @return string|phpQuery|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
* @throws Exception
* @TODO force html result
*/
public function html($html = null, $callback1 = null, $callback2 = null, $callback3 = null)
{
$oldHtml = null;
if (isset($html)) {
// INSERT
$nodes = $this->documentWrapper->import($html);
$this->empty();
foreach ($this->stack(1) as $alreadyAdded => $node) {
// for now, limit events for textarea
if (($this->isXHTML() || $this->isHTML()) && $node->tagName == 'textarea')
$oldHtml = pq($node, $this->getDocumentID())->markup();
foreach ($nodes as $newNode) {
$node->appendChild($alreadyAdded
? $newNode->cloneNode(true)
: $newNode
);
}
// for now, limit events for textarea
if (($this->isXHTML() || $this->isHTML()) && $node->tagName == 'textarea')
$this->markupEvents($html, $oldHtml, $node);
}
return $this;
} else {
// FETCH
$return = $this->documentWrapper->markup($this->elements, true);
$args = func_get_args();
foreach (array_slice($args, 1) as $callback) {
$return = phpQuery::callbackRun($callback, array($return));
}
return $return;
}
}
/**
* @TODO force xml result
* @param null $xml
* @param null $callback1
* @param null $callback2
* @param null $callback3
* @return mixed
*/
public function xml($xml = null, $callback1 = null, $callback2 = null, $callback3 = null)
{
$args = func_get_args();
return call_user_func_array(array($this, 'html'), $args);
}
/**
* Enter description here...
* @TODO force html result
*
* @param null $callback1
* @param null $callback2
* @param null $callback3
* @return String
*/
public function htmlOuter($callback1 = null, $callback2 = null, $callback3 = null)
{
$markup = $this->documentWrapper->markup($this->elements);
// pass thou callbacks
$args = func_get_args();
foreach ($args as $callback) {
$markup = phpQuery::callbackRun($callback, array($markup));
}
return $markup;
}
/**
* @TODO force xml result
* @param null $callback1
* @param null $callback2
* @param null $callback3
* @return mixed
*/
public function xmlOuter($callback1 = null, $callback2 = null, $callback3 = null)
{
$args = func_get_args();
return call_user_func_array(array($this, 'htmlOuter'), $args);
}
/**
* @return string
*/
public function __toString()
{
return $this->markupOuter();
}
/**
* Just like html(), but returns markup with VALID (dangerous) PHP tags.
*
* @param null $code
* @todo support returning markup with PHP tags when called without param
* @return mixed
*/
public function php($code = null)
{
return $this->markupPHP($code);
}
/**
* Enter description here...
*
* @param $code
* @return mixed
*/
public function markupPHP($code = null)
{
return isset($code)
? $this->markup(phpQuery::php($code))
: phpQuery::markupToPHP($this->markup());
}
/**
* Enter description here...
*
* @return mixed
*/
public function markupOuterPHP()
{
return phpQuery::markupToPHP($this->markupOuter());
}
/**
* Enter description here...
*
* @param null $selector
* @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
* @throws Exception
*/
public function children($selector = null)
{
$stack = array();
foreach ($this->stack(1) as $node) {
foreach ($node->childNodes as $newNode) {
if ($newNode->nodeType != 1)
continue;
if ($selector && !$this->is($selector, $newNode))
continue;
if ($this->elementsContainsNode($newNode, $stack))
continue;
$stack[] = $newNode;
}
}
$this->elementsBackup = $this->elements;
$this->elements = $stack;
return $this->newInstance();
}
/**
* Enter description here...
*
* @param null $selector
* @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
* @throws Exception
*/
public function ancestors($selector = null)
{
return $this->children($selector);
}
/**
* Enter description here...
*
* @param $content
* @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
* @throws Exception
*/
public function append($content)
{
return $this->insert($content, __FUNCTION__);
}
/**
* Enter description here...
*
* @param $content
* @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
* @throws Exception
*/
public function appendPHP($content)
{
return $this->insert("Hello, Person and person
* * Result: * [ ] * * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery * @access private */ public function _empty() { foreach ($this->stack(1) as $node) { // thx to 'dave at dgx dot cz' $node->nodeValue = ''; } return $this; } /** * Enter description here... * * @param array|string $callback Expects $node as first param, $index as second * @param null $param1 * @param null $param2 * @param null $param3 * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery */ public function each($callback, $param1 = null, $param2 = null, $param3 = null) { $paramStructure = null; if (func_num_args() > 1) { $paramStructure = func_get_args(); $paramStructure = array_slice($paramStructure, 1); } foreach ($this->elements as $v) phpQuery::callbackRun($callback, array($v), $paramStructure); return $this; } /** * Run callback on actual object. * * @param $callback * @param null $param1 * @param null $param2 * @param null $param3 * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery */ public function callback($callback, $param1 = null, $param2 = null, $param3 = null) { $params = func_get_args(); $params[0] = $this; phpQuery::callbackRun($callback, $params); return $this; } /** * Enter description here... * * @param $callback * @param null $param1 * @param null $param2 * @param null $param3 * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery * @throws Exception * @todo add $scope and $args as in each() ??? */ public function map($callback, $param1 = null, $param2 = null, $param3 = null) { $params = func_get_args(); array_unshift($params, $this->elements); return $this->newInstance( call_user_func_array(array('phpQuery', 'map'), $params) ); } /** * Enter description here... * * @param string $key * @param mixed $value * @return mixed|phpQueryObject */ public function data($key, $value = null) { if (!isset($value)) { // TODO? implement specific jQuery behavior od returning parent values return phpQuery::data($this->get(0), $key, $value, $this->getDocumentID()); } else { foreach ($this as $node) phpQuery::data($node, $key, $value, $this->getDocumentID()); return $this; } } /** * Enter description here... * * @param string $key * @return phpQueryObject */ public function removeData($key) { foreach ($this as $node) phpQuery::removeData($node, $key, $this->getDocumentID()); return $this; } // INTERFACE IMPLEMENTATIONS // ITERATOR INTERFACE /** * @access private */ public function rewind() { $this->debug('iterating foreach'); $this->elementsBackup = $this->elements; $this->elementsIterator = $this->elements; $this->valid = isset($this->elements[0]) ? 1 : 0; $this->current = 0; } /** * @access private */ public function current() { return $this->elementsIterator[$this->current]; } /** * @access private */ public function key() { return $this->current; } /** * Double-function method. * * First: main iterator interface method. * Second: Returning next sibling, alias for _next(). * * Proper functionality is choosed automagicaly. * * @see phpQueryObject::_next() * @param null $cssSelector * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery * @throws Exception */ public function next($cssSelector = null) { $this->valid = isset($this->elementsIterator[$this->current + 1]) ? true : false; if (!$this->valid && $this->elementsIterator) { $this->elementsIterator = null; } else if ($this->valid) { $this->current++; } else { return $this->_next($cssSelector); } } /** * @access private */ public function valid() { return $this->valid; } // ITERATOR INTERFACE END // ARRAYACCESS INTERFACE /** * @access private * @param $offset * @return bool * @throws Exception */ public function offsetExists($offset) { return $this->find($offset)->size() > 0; } /** * @access private * @param $offset * @return phpQueryObject * @throws Exception */ public function offsetGet($offset) { return $this->find($offset); } /** * @access private * @param $offset * @param $value * @throws Exception */ public function offsetSet($offset, $value) { $this->find($offset)->html($value); } /** * @access private * @param $offset * @throws Exception */ public function offsetUnset($offset) { throw new Exception("Can't do unset, use array interface only for calling queries and replacing HTML."); } // ARRAYACCESS INTERFACE END /** * Returns node's XPath. * * @param mixed $oneNode * @return mixed * @TODO use native getNodePath is available * @access private */ protected function getNodeXpath($oneNode = null) { $return = array(); $loop = $oneNode ? array($oneNode) : $this->elements; foreach ($loop as $node) { if ($node instanceof DOMDOCUMENT) { $return[] = ''; continue; } $xpath = array(); while (!($node instanceof DOMDOCUMENT)) { $i = 1; $sibling = $node; while ($sibling->previousSibling) { $sibling = $sibling->previousSibling; $isElement = $sibling instanceof DOMELEMENT; if ($isElement && $sibling->tagName == $node->tagName) $i++; } $xpath[] = $this->isXML() ? "*[local-name()='{$node->tagName}'][{$i}]" : "{$node->tagName}[{$i}]"; $node = $node->parentNode; } $xpath = join('/', array_reverse($xpath)); $return[] = '/' . $xpath; } return $oneNode ? $return[0] : $return; } // HELPERS /** * @param null $oneNode * @return array|mixed */ public function whois($oneNode = null) { $return = array(); $loop = $oneNode ? array($oneNode) : $this->elements; foreach ($loop as $node) { if (isset($node->tagName)) { $tag = in_array($node->tagName, array('php', 'js')) ? strtoupper($node->tagName) : $node->tagName; $return[] = $tag . ($node->getAttribute('id') ? '#' . $node->getAttribute('id') : '') . ($node->getAttribute('class') ? '.' . join('.', explode(' ', $node->getAttribute('class'))) : '') . ($node->getAttribute('name') ? '[name="' . $node->getAttribute('name') . '"]' : '') . ($node->getAttribute('value') && strpos($node->getAttribute('value'), '<' . '?php') === false ? '[value="' . substr(str_replace("\n", '', $node->getAttribute('value')), 0, 15) . '"]' : '') . ($node->getAttribute('value') && strpos($node->getAttribute('value'), '<' . '?php') !== false ? '[value=PHP]' : '') . ($node->getAttribute('selected') ? '[selected]' : '') . ($node->getAttribute('checked') ? '[checked]' : ''); } else if ($node instanceof DOMTEXT) { if (trim($node->textContent)) $return[] = 'Text:' . substr(str_replace("\n", ' ', $node->textContent), 0, 15); } } return $oneNode && isset($return[0]) ? $return[0] : $return; } /** * Dump htmlOuter and preserve chain. Usefull for debugging. * * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery * */ public function dump() { print 'DUMP #' . (phpQuery::$dumpCount++) . ' '; phpQuery::$debug = false; var_dump($this->htmlOuter()); return $this; } /** * @return $this */ public function dumpWhois() { print 'DUMP #' . (phpQuery::$dumpCount++) . ' '; $debug = phpQuery::$debug; phpQuery::$debug = false; var_dump('whois', $this->whois()); phpQuery::$debug = $debug; return $this; } /** * @return $this */ public function dumpLength() { print 'DUMP #' . (phpQuery::$dumpCount++) . ' '; $debug = phpQuery::$debug; phpQuery::$debug = false; var_dump('length', $this->size()); phpQuery::$debug = $debug; return $this; } /** * @param bool $html * @param bool $title * @return $this */ public function dumpTree($html = true, $title = true) { $output = $title ? 'DUMP #' . (phpQuery::$dumpCount++) . " \n" : ''; $debug = phpQuery::$debug; phpQuery::$debug = false; foreach ($this->stack() as $node) $output .= $this->__dumpTree($node); phpQuery::$debug = $debug; print $html ? nl2br(str_replace(' ', ' ', $output)) : $output; return $this; } /** * @param $node * @param int $intend * @return string */ private function __dumpTree($node, $intend = 0) { $whois = $this->whois($node); $return = ''; if ($whois) $return .= str_repeat(' - ', $intend) . $whois . "\n"; if (isset($node->childNodes)) foreach ($node->childNodes as $chNode) $return .= $this->__dumpTree($chNode, $intend + 1); return $return; } /** * Dump htmlOuter and stop script execution. Usefull for debugging. * */ public function dumpDie() { print __FILE__ . ':' . __LINE__; var_dump($this->htmlOuter()); die(); } }