xref: /dokuwiki/_test/core/phpQuery-onefile.php (revision a3095052107885a26e7a2fa9d9cb6a3f63b9c5d5)
1f8369d7dSTobias Sarnowski<?php
2f8369d7dSTobias Sarnowski/**
3f8369d7dSTobias Sarnowski * phpQuery is a server-side, chainable, CSS3 selector driven
4f8369d7dSTobias Sarnowski * Document Object Model (DOM) API based on jQuery JavaScript Library.
5f8369d7dSTobias Sarnowski *
6f8369d7dSTobias Sarnowski * @version 0.9.5
7f8369d7dSTobias Sarnowski * @link http://code.google.com/p/phpquery/
8f8369d7dSTobias Sarnowski * @link http://phpquery-library.blogspot.com/
9f8369d7dSTobias Sarnowski * @link http://jquery.com/
10f8369d7dSTobias Sarnowski * @author Tobiasz Cudnik <tobiasz.cudnik/gmail.com>
11f8369d7dSTobias Sarnowski * @license http://www.opensource.org/licenses/mit-license.php MIT License
12f8369d7dSTobias Sarnowski * @package phpQuery
13f8369d7dSTobias Sarnowski */
14f8369d7dSTobias Sarnowski
15f8369d7dSTobias Sarnowski// class names for instanceof
16f8369d7dSTobias Sarnowski// TODO move them as class constants into phpQuery
17f8369d7dSTobias Sarnowskidefine('DOMDOCUMENT', 'DOMDocument');
18f8369d7dSTobias Sarnowskidefine('DOMELEMENT', 'DOMElement');
19f8369d7dSTobias Sarnowskidefine('DOMNODELIST', 'DOMNodeList');
20f8369d7dSTobias Sarnowskidefine('DOMNODE', 'DOMNode');
21f8369d7dSTobias Sarnowski
22f8369d7dSTobias Sarnowski/**
23f8369d7dSTobias Sarnowski * DOMEvent class.
24f8369d7dSTobias Sarnowski *
25f8369d7dSTobias Sarnowski * Based on
26f8369d7dSTobias Sarnowski * @link http://developer.mozilla.org/En/DOM:event
27f8369d7dSTobias Sarnowski * @author Tobiasz Cudnik <tobiasz.cudnik/gmail.com>
28f8369d7dSTobias Sarnowski * @package phpQuery
29f8369d7dSTobias Sarnowski * @todo implement ArrayAccess ?
30f8369d7dSTobias Sarnowski */
31f8369d7dSTobias Sarnowskiclass DOMEvent {
32f8369d7dSTobias Sarnowski    /**
33f8369d7dSTobias Sarnowski     * Returns a boolean indicating whether the event bubbles up through the DOM or not.
34f8369d7dSTobias Sarnowski     *
35f8369d7dSTobias Sarnowski     * @var unknown_type
36f8369d7dSTobias Sarnowski     */
37f8369d7dSTobias Sarnowski    public $bubbles = true;
38f8369d7dSTobias Sarnowski    /**
39f8369d7dSTobias Sarnowski     * Returns a boolean indicating whether the event is cancelable.
40f8369d7dSTobias Sarnowski     *
41f8369d7dSTobias Sarnowski     * @var unknown_type
42f8369d7dSTobias Sarnowski     */
43f8369d7dSTobias Sarnowski    public $cancelable = true;
44f8369d7dSTobias Sarnowski    /**
45f8369d7dSTobias Sarnowski     * Returns a reference to the currently registered target for the event.
46f8369d7dSTobias Sarnowski     *
47f8369d7dSTobias Sarnowski     * @var unknown_type
48f8369d7dSTobias Sarnowski     */
49f8369d7dSTobias Sarnowski    public $currentTarget;
50f8369d7dSTobias Sarnowski    /**
51f8369d7dSTobias Sarnowski     * Returns detail about the event, depending on the type of event.
52f8369d7dSTobias Sarnowski     *
53f8369d7dSTobias Sarnowski     * @var unknown_type
54f8369d7dSTobias Sarnowski     * @link http://developer.mozilla.org/en/DOM/event.detail
55f8369d7dSTobias Sarnowski     */
56f8369d7dSTobias Sarnowski    public $detail; // ???
57f8369d7dSTobias Sarnowski    /**
58f8369d7dSTobias Sarnowski     * Used to indicate which phase of the event flow is currently being evaluated.
59f8369d7dSTobias Sarnowski     *
60f8369d7dSTobias Sarnowski     * NOT IMPLEMENTED
61f8369d7dSTobias Sarnowski     *
62f8369d7dSTobias Sarnowski     * @var unknown_type
63f8369d7dSTobias Sarnowski     * @link http://developer.mozilla.org/en/DOM/event.eventPhase
64f8369d7dSTobias Sarnowski     */
65f8369d7dSTobias Sarnowski    public $eventPhase; // ???
66f8369d7dSTobias Sarnowski    /**
67f8369d7dSTobias Sarnowski     * The explicit original target of the event (Mozilla-specific).
68f8369d7dSTobias Sarnowski     *
69f8369d7dSTobias Sarnowski     * NOT IMPLEMENTED
70f8369d7dSTobias Sarnowski     *
71f8369d7dSTobias Sarnowski     * @var unknown_type
72f8369d7dSTobias Sarnowski     */
73f8369d7dSTobias Sarnowski    public $explicitOriginalTarget; // moz only
74f8369d7dSTobias Sarnowski    /**
75f8369d7dSTobias Sarnowski     * The original target of the event, before any retargetings (Mozilla-specific).
76f8369d7dSTobias Sarnowski     *
77f8369d7dSTobias Sarnowski     * NOT IMPLEMENTED
78f8369d7dSTobias Sarnowski     *
79f8369d7dSTobias Sarnowski     * @var unknown_type
80f8369d7dSTobias Sarnowski     */
81f8369d7dSTobias Sarnowski    public $originalTarget; // moz only
82f8369d7dSTobias Sarnowski    /**
83f8369d7dSTobias Sarnowski     * Identifies a secondary target for the event.
84f8369d7dSTobias Sarnowski     *
85f8369d7dSTobias Sarnowski     * @var unknown_type
86f8369d7dSTobias Sarnowski     */
87f8369d7dSTobias Sarnowski    public $relatedTarget;
88f8369d7dSTobias Sarnowski    /**
89f8369d7dSTobias Sarnowski     * Returns a reference to the target to which the event was originally dispatched.
90f8369d7dSTobias Sarnowski     *
91f8369d7dSTobias Sarnowski     * @var unknown_type
92f8369d7dSTobias Sarnowski     */
93f8369d7dSTobias Sarnowski    public $target;
94f8369d7dSTobias Sarnowski    /**
95f8369d7dSTobias Sarnowski     * Returns the time that the event was created.
96f8369d7dSTobias Sarnowski     *
97f8369d7dSTobias Sarnowski     * @var unknown_type
98f8369d7dSTobias Sarnowski     */
99f8369d7dSTobias Sarnowski    public $timeStamp;
100f8369d7dSTobias Sarnowski    /**
101f8369d7dSTobias Sarnowski     * Returns the name of the event (case-insensitive).
102f8369d7dSTobias Sarnowski     */
103f8369d7dSTobias Sarnowski    public $type;
104f8369d7dSTobias Sarnowski    public $runDefault = true;
105f8369d7dSTobias Sarnowski    public $data = null;
106f8369d7dSTobias Sarnowski    public function __construct($data) {
107f8369d7dSTobias Sarnowski        foreach($data as $k => $v) {
108f8369d7dSTobias Sarnowski            $this->$k = $v;
109f8369d7dSTobias Sarnowski        }
110f8369d7dSTobias Sarnowski        if (! $this->timeStamp)
111f8369d7dSTobias Sarnowski            $this->timeStamp = time();
112f8369d7dSTobias Sarnowski    }
113f8369d7dSTobias Sarnowski    /**
114f8369d7dSTobias Sarnowski     * Cancels the event (if it is cancelable).
115f8369d7dSTobias Sarnowski     *
116f8369d7dSTobias Sarnowski     */
117f8369d7dSTobias Sarnowski    public function preventDefault() {
118f8369d7dSTobias Sarnowski        $this->runDefault = false;
119f8369d7dSTobias Sarnowski    }
120f8369d7dSTobias Sarnowski    /**
121f8369d7dSTobias Sarnowski     * Stops the propagation of events further along in the DOM.
122f8369d7dSTobias Sarnowski     *
123f8369d7dSTobias Sarnowski     */
124f8369d7dSTobias Sarnowski    public function stopPropagation() {
125f8369d7dSTobias Sarnowski        $this->bubbles = false;
126f8369d7dSTobias Sarnowski    }
127f8369d7dSTobias Sarnowski}
128f8369d7dSTobias Sarnowski
129f8369d7dSTobias Sarnowski
130f8369d7dSTobias Sarnowski/**
131f8369d7dSTobias Sarnowski * DOMDocumentWrapper class simplifies work with DOMDocument.
132f8369d7dSTobias Sarnowski *
133f8369d7dSTobias Sarnowski * Know bug:
134f8369d7dSTobias Sarnowski * - in XHTML fragments, <br /> changes to <br clear="none" />
135f8369d7dSTobias Sarnowski *
136f8369d7dSTobias Sarnowski * @todo check XML catalogs compatibility
137f8369d7dSTobias Sarnowski * @author Tobiasz Cudnik <tobiasz.cudnik/gmail.com>
138f8369d7dSTobias Sarnowski * @package phpQuery
139f8369d7dSTobias Sarnowski */
140f8369d7dSTobias Sarnowskiclass DOMDocumentWrapper {
141f8369d7dSTobias Sarnowski    /**
142f8369d7dSTobias Sarnowski     * @var DOMDocument
143f8369d7dSTobias Sarnowski     */
144f8369d7dSTobias Sarnowski    public $document;
145f8369d7dSTobias Sarnowski    public $id;
146f8369d7dSTobias Sarnowski    /**
147f8369d7dSTobias Sarnowski     * @todo Rewrite as method and quess if null.
148f8369d7dSTobias Sarnowski     * @var unknown_type
149f8369d7dSTobias Sarnowski     */
150f8369d7dSTobias Sarnowski    public $contentType = '';
151f8369d7dSTobias Sarnowski    public $xpath;
152f8369d7dSTobias Sarnowski    public $uuid = 0;
153f8369d7dSTobias Sarnowski    public $data = array();
154f8369d7dSTobias Sarnowski    public $dataNodes = array();
155f8369d7dSTobias Sarnowski    public $events = array();
156f8369d7dSTobias Sarnowski    public $eventsNodes = array();
157f8369d7dSTobias Sarnowski    public $eventsGlobal = array();
158f8369d7dSTobias Sarnowski    /**
159f8369d7dSTobias Sarnowski     * @TODO iframes support http://code.google.com/p/phpquery/issues/detail?id=28
160f8369d7dSTobias Sarnowski     * @var unknown_type
161f8369d7dSTobias Sarnowski     */
162f8369d7dSTobias Sarnowski    public $frames = array();
163f8369d7dSTobias Sarnowski    /**
164f8369d7dSTobias Sarnowski     * Document root, by default equals to document itself.
165f8369d7dSTobias Sarnowski     * Used by documentFragments.
166f8369d7dSTobias Sarnowski     *
167f8369d7dSTobias Sarnowski     * @var DOMNode
168f8369d7dSTobias Sarnowski     */
169f8369d7dSTobias Sarnowski    public $root;
170f8369d7dSTobias Sarnowski    public $isDocumentFragment;
171f8369d7dSTobias Sarnowski    public $isXML = false;
172f8369d7dSTobias Sarnowski    public $isXHTML = false;
173f8369d7dSTobias Sarnowski    public $isHTML = false;
174f8369d7dSTobias Sarnowski    public $charset;
175f8369d7dSTobias Sarnowski    public function __construct($markup = null, $contentType = null, $newDocumentID = null) {
176f8369d7dSTobias Sarnowski        if (isset($markup))
177f8369d7dSTobias Sarnowski            $this->load($markup, $contentType, $newDocumentID);
178f8369d7dSTobias Sarnowski        $this->id = $newDocumentID
179f8369d7dSTobias Sarnowski            ? $newDocumentID
180f8369d7dSTobias Sarnowski            : md5(microtime());
181f8369d7dSTobias Sarnowski    }
182f8369d7dSTobias Sarnowski    public function load($markup, $contentType = null, $newDocumentID = null) {
183f8369d7dSTobias Sarnowski//      phpQuery::$documents[$id] = $this;
184f8369d7dSTobias Sarnowski        $this->contentType = strtolower($contentType);
185f8369d7dSTobias Sarnowski        if ($markup instanceof DOMDOCUMENT) {
186f8369d7dSTobias Sarnowski            $this->document = $markup;
187f8369d7dSTobias Sarnowski            $this->root = $this->document;
188f8369d7dSTobias Sarnowski            $this->charset = $this->document->encoding;
189f8369d7dSTobias Sarnowski            // TODO isDocumentFragment
190f8369d7dSTobias Sarnowski        } else {
191f8369d7dSTobias Sarnowski            $loaded = $this->loadMarkup($markup);
192f8369d7dSTobias Sarnowski        }
193f8369d7dSTobias Sarnowski        if ($loaded) {
194f8369d7dSTobias Sarnowski//          $this->document->formatOutput = true;
195f8369d7dSTobias Sarnowski            $this->document->preserveWhiteSpace = true;
196f8369d7dSTobias Sarnowski            $this->xpath = new DOMXPath($this->document);
197f8369d7dSTobias Sarnowski            $this->afterMarkupLoad();
198f8369d7dSTobias Sarnowski            return true;
199f8369d7dSTobias Sarnowski            // remember last loaded document
200f8369d7dSTobias Sarnowski//          return phpQuery::selectDocument($id);
201f8369d7dSTobias Sarnowski        }
202f8369d7dSTobias Sarnowski        return false;
203f8369d7dSTobias Sarnowski    }
204f8369d7dSTobias Sarnowski    protected function afterMarkupLoad() {
205f8369d7dSTobias Sarnowski        if ($this->isXHTML) {
206f8369d7dSTobias Sarnowski            $this->xpath->registerNamespace("html", "http://www.w3.org/1999/xhtml");
207f8369d7dSTobias Sarnowski        }
208f8369d7dSTobias Sarnowski    }
209f8369d7dSTobias Sarnowski    protected function loadMarkup($markup) {
210f8369d7dSTobias Sarnowski        $loaded = false;
211f8369d7dSTobias Sarnowski        if ($this->contentType) {
212f8369d7dSTobias Sarnowski            self::debug("Load markup for content type {$this->contentType}");
213f8369d7dSTobias Sarnowski            // content determined by contentType
214f8369d7dSTobias Sarnowski            list($contentType, $charset) = $this->contentTypeToArray($this->contentType);
215f8369d7dSTobias Sarnowski            switch($contentType) {
216f8369d7dSTobias Sarnowski                case 'text/html':
217f8369d7dSTobias Sarnowski                    phpQuery::debug("Loading HTML, content type '{$this->contentType}'");
218f8369d7dSTobias Sarnowski                    $loaded = $this->loadMarkupHTML($markup, $charset);
219f8369d7dSTobias Sarnowski                break;
220f8369d7dSTobias Sarnowski                case 'text/xml':
221f8369d7dSTobias Sarnowski                case 'application/xhtml+xml':
222f8369d7dSTobias Sarnowski                    phpQuery::debug("Loading XML, content type '{$this->contentType}'");
223f8369d7dSTobias Sarnowski                    $loaded = $this->loadMarkupXML($markup, $charset);
224f8369d7dSTobias Sarnowski                break;
225f8369d7dSTobias Sarnowski                default:
226f8369d7dSTobias Sarnowski                    // for feeds or anything that sometimes doesn't use text/xml
227f8369d7dSTobias Sarnowski                    if (strpos('xml', $this->contentType) !== false) {
228f8369d7dSTobias Sarnowski                        phpQuery::debug("Loading XML, content type '{$this->contentType}'");
229f8369d7dSTobias Sarnowski                        $loaded = $this->loadMarkupXML($markup, $charset);
230f8369d7dSTobias Sarnowski                    } else
231f8369d7dSTobias Sarnowski                        phpQuery::debug("Could not determine document type from content type '{$this->contentType}'");
232f8369d7dSTobias Sarnowski            }
233f8369d7dSTobias Sarnowski        } else {
234f8369d7dSTobias Sarnowski            // content type autodetection
235f8369d7dSTobias Sarnowski            if ($this->isXML($markup)) {
236f8369d7dSTobias Sarnowski                phpQuery::debug("Loading XML, isXML() == true");
237f8369d7dSTobias Sarnowski                $loaded = $this->loadMarkupXML($markup);
238f8369d7dSTobias Sarnowski                if (! $loaded && $this->isXHTML) {
239f8369d7dSTobias Sarnowski                    phpQuery::debug('Loading as XML failed, trying to load as HTML, isXHTML == true');
240f8369d7dSTobias Sarnowski                    $loaded = $this->loadMarkupHTML($markup);
241f8369d7dSTobias Sarnowski                }
242f8369d7dSTobias Sarnowski            } else {
243f8369d7dSTobias Sarnowski                phpQuery::debug("Loading HTML, isXML() == false");
244f8369d7dSTobias Sarnowski                $loaded = $this->loadMarkupHTML($markup);
245f8369d7dSTobias Sarnowski            }
246f8369d7dSTobias Sarnowski        }
247f8369d7dSTobias Sarnowski        return $loaded;
248f8369d7dSTobias Sarnowski    }
249f8369d7dSTobias Sarnowski    protected function loadMarkupReset() {
250f8369d7dSTobias Sarnowski        $this->isXML = $this->isXHTML = $this->isHTML = false;
251f8369d7dSTobias Sarnowski    }
252f8369d7dSTobias Sarnowski    protected function documentCreate($charset, $version = '1.0') {
253f8369d7dSTobias Sarnowski        if (! $version)
254f8369d7dSTobias Sarnowski            $version = '1.0';
255f8369d7dSTobias Sarnowski        $this->document = new DOMDocument($version, $charset);
256f8369d7dSTobias Sarnowski        $this->charset = $this->document->encoding;
257f8369d7dSTobias Sarnowski//      $this->document->encoding = $charset;
258f8369d7dSTobias Sarnowski        $this->document->formatOutput = true;
259f8369d7dSTobias Sarnowski        $this->document->preserveWhiteSpace = true;
260f8369d7dSTobias Sarnowski    }
261f8369d7dSTobias Sarnowski    protected function loadMarkupHTML($markup, $requestedCharset = null) {
262f8369d7dSTobias Sarnowski        if (phpQuery::$debug)
263f8369d7dSTobias Sarnowski            phpQuery::debug('Full markup load (HTML): '.substr($markup, 0, 250));
264f8369d7dSTobias Sarnowski        $this->loadMarkupReset();
265f8369d7dSTobias Sarnowski        $this->isHTML = true;
266f8369d7dSTobias Sarnowski        if (!isset($this->isDocumentFragment))
267f8369d7dSTobias Sarnowski            $this->isDocumentFragment = self::isDocumentFragmentHTML($markup);
268f8369d7dSTobias Sarnowski        $charset = null;
269f8369d7dSTobias Sarnowski        $documentCharset = $this->charsetFromHTML($markup);
270f8369d7dSTobias Sarnowski        $addDocumentCharset = false;
271f8369d7dSTobias Sarnowski        if ($documentCharset) {
272f8369d7dSTobias Sarnowski            $charset = $documentCharset;
273f8369d7dSTobias Sarnowski            $markup = $this->charsetFixHTML($markup);
274f8369d7dSTobias Sarnowski        } else if ($requestedCharset) {
275f8369d7dSTobias Sarnowski            $charset = $requestedCharset;
276f8369d7dSTobias Sarnowski        }
277f8369d7dSTobias Sarnowski        if (! $charset)
278f8369d7dSTobias Sarnowski            $charset = phpQuery::$defaultCharset;
279f8369d7dSTobias Sarnowski        // HTTP 1.1 says that the default charset is ISO-8859-1
280f8369d7dSTobias Sarnowski        // @see http://www.w3.org/International/O-HTTP-charset
281f8369d7dSTobias Sarnowski        if (! $documentCharset) {
282f8369d7dSTobias Sarnowski            $documentCharset = 'ISO-8859-1';
283f8369d7dSTobias Sarnowski            $addDocumentCharset = true;
284f8369d7dSTobias Sarnowski        }
285f8369d7dSTobias Sarnowski        // Should be careful here, still need 'magic encoding detection' since lots of pages have other 'default encoding'
286f8369d7dSTobias Sarnowski        // Worse, some pages can have mixed encodings... we'll try not to worry about that
287f8369d7dSTobias Sarnowski        $requestedCharset = strtoupper($requestedCharset);
288f8369d7dSTobias Sarnowski        $documentCharset = strtoupper($documentCharset);
289f8369d7dSTobias Sarnowski        phpQuery::debug("DOC: $documentCharset REQ: $requestedCharset");
290f8369d7dSTobias Sarnowski        if ($requestedCharset && $documentCharset && $requestedCharset !== $documentCharset) {
291f8369d7dSTobias Sarnowski            phpQuery::debug("CHARSET CONVERT");
292f8369d7dSTobias Sarnowski            // Document Encoding Conversion
293f8369d7dSTobias Sarnowski            // http://code.google.com/p/phpquery/issues/detail?id=86
294f8369d7dSTobias Sarnowski            if (function_exists('mb_detect_encoding')) {
295f8369d7dSTobias Sarnowski                $possibleCharsets = array($documentCharset, $requestedCharset, 'AUTO');
296f8369d7dSTobias Sarnowski                $docEncoding = mb_detect_encoding($markup, implode(', ', $possibleCharsets));
297f8369d7dSTobias Sarnowski                if (! $docEncoding)
298f8369d7dSTobias Sarnowski                    $docEncoding = $documentCharset; // ok trust the document
299f8369d7dSTobias Sarnowski                phpQuery::debug("DETECTED '$docEncoding'");
300f8369d7dSTobias Sarnowski                // Detected does not match what document says...
301f8369d7dSTobias Sarnowski                if ($docEncoding !== $documentCharset) {
302f8369d7dSTobias Sarnowski                    // Tricky..
303f8369d7dSTobias Sarnowski                }
304f8369d7dSTobias Sarnowski                if ($docEncoding !== $requestedCharset) {
305f8369d7dSTobias Sarnowski                    phpQuery::debug("CONVERT $docEncoding => $requestedCharset");
306f8369d7dSTobias Sarnowski                    $markup = mb_convert_encoding($markup, $requestedCharset, $docEncoding);
307f8369d7dSTobias Sarnowski                    $markup = $this->charsetAppendToHTML($markup, $requestedCharset);
308f8369d7dSTobias Sarnowski                    $charset = $requestedCharset;
309f8369d7dSTobias Sarnowski                }
310f8369d7dSTobias Sarnowski            } else {
311f8369d7dSTobias Sarnowski                phpQuery::debug("TODO: charset conversion without mbstring...");
312f8369d7dSTobias Sarnowski            }
313f8369d7dSTobias Sarnowski        }
314f8369d7dSTobias Sarnowski        $return = false;
315f8369d7dSTobias Sarnowski        if ($this->isDocumentFragment) {
316f8369d7dSTobias Sarnowski            phpQuery::debug("Full markup load (HTML), DocumentFragment detected, using charset '$charset'");
317f8369d7dSTobias Sarnowski            $return = $this->documentFragmentLoadMarkup($this, $charset, $markup);
318f8369d7dSTobias Sarnowski        } else {
319f8369d7dSTobias Sarnowski            if ($addDocumentCharset) {
320f8369d7dSTobias Sarnowski                phpQuery::debug("Full markup load (HTML), appending charset: '$charset'");
321f8369d7dSTobias Sarnowski                $markup = $this->charsetAppendToHTML($markup, $charset);
322f8369d7dSTobias Sarnowski            }
323f8369d7dSTobias Sarnowski            phpQuery::debug("Full markup load (HTML), documentCreate('$charset')");
324f8369d7dSTobias Sarnowski            $this->documentCreate($charset);
325f8369d7dSTobias Sarnowski            $return = phpQuery::$debug === 2
326f8369d7dSTobias Sarnowski                ? $this->document->loadHTML($markup)
327f8369d7dSTobias Sarnowski                : @$this->document->loadHTML($markup);
328f8369d7dSTobias Sarnowski            if ($return)
329f8369d7dSTobias Sarnowski                $this->root = $this->document;
330f8369d7dSTobias Sarnowski        }
331f8369d7dSTobias Sarnowski        if ($return && ! $this->contentType)
332f8369d7dSTobias Sarnowski            $this->contentType = 'text/html';
333f8369d7dSTobias Sarnowski        return $return;
334f8369d7dSTobias Sarnowski    }
335f8369d7dSTobias Sarnowski    protected function loadMarkupXML($markup, $requestedCharset = null) {
336f8369d7dSTobias Sarnowski        if (phpQuery::$debug)
337f8369d7dSTobias Sarnowski            phpQuery::debug('Full markup load (XML): '.substr($markup, 0, 250));
338f8369d7dSTobias Sarnowski        $this->loadMarkupReset();
339f8369d7dSTobias Sarnowski        $this->isXML = true;
340f8369d7dSTobias Sarnowski        // check agains XHTML in contentType or markup
341f8369d7dSTobias Sarnowski        $isContentTypeXHTML = $this->isXHTML();
342f8369d7dSTobias Sarnowski        $isMarkupXHTML = $this->isXHTML($markup);
343f8369d7dSTobias Sarnowski        if ($isContentTypeXHTML || $isMarkupXHTML) {
344f8369d7dSTobias Sarnowski            self::debug('Full markup load (XML), XHTML detected');
345f8369d7dSTobias Sarnowski            $this->isXHTML = true;
346f8369d7dSTobias Sarnowski        }
347f8369d7dSTobias Sarnowski        // determine document fragment
348f8369d7dSTobias Sarnowski        if (! isset($this->isDocumentFragment))
349f8369d7dSTobias Sarnowski            $this->isDocumentFragment = $this->isXHTML
350f8369d7dSTobias Sarnowski                ? self::isDocumentFragmentXHTML($markup)
351f8369d7dSTobias Sarnowski                : self::isDocumentFragmentXML($markup);
352f8369d7dSTobias Sarnowski        // this charset will be used
353f8369d7dSTobias Sarnowski        $charset = null;
354f8369d7dSTobias Sarnowski        // charset from XML declaration @var string
355f8369d7dSTobias Sarnowski        $documentCharset = $this->charsetFromXML($markup);
356f8369d7dSTobias Sarnowski        if (! $documentCharset) {
357f8369d7dSTobias Sarnowski            if ($this->isXHTML) {
358f8369d7dSTobias Sarnowski                // this is XHTML, try to get charset from content-type meta header
359f8369d7dSTobias Sarnowski                $documentCharset = $this->charsetFromHTML($markup);
360f8369d7dSTobias Sarnowski                if ($documentCharset) {
361f8369d7dSTobias Sarnowski                    phpQuery::debug("Full markup load (XML), appending XHTML charset '$documentCharset'");
362f8369d7dSTobias Sarnowski                    $this->charsetAppendToXML($markup, $documentCharset);
363f8369d7dSTobias Sarnowski                    $charset = $documentCharset;
364f8369d7dSTobias Sarnowski                }
365f8369d7dSTobias Sarnowski            }
366f8369d7dSTobias Sarnowski            if (! $documentCharset) {
367f8369d7dSTobias Sarnowski                // if still no document charset...
368f8369d7dSTobias Sarnowski                $charset = $requestedCharset;
369f8369d7dSTobias Sarnowski            }
370f8369d7dSTobias Sarnowski        } else if ($requestedCharset) {
371f8369d7dSTobias Sarnowski            $charset = $requestedCharset;
372f8369d7dSTobias Sarnowski        }
373f8369d7dSTobias Sarnowski        if (! $charset) {
374f8369d7dSTobias Sarnowski            $charset = phpQuery::$defaultCharset;
375f8369d7dSTobias Sarnowski        }
376f8369d7dSTobias Sarnowski        if ($requestedCharset && $documentCharset && $requestedCharset != $documentCharset) {
377f8369d7dSTobias Sarnowski            // TODO place for charset conversion
378f8369d7dSTobias Sarnowski//          $charset = $requestedCharset;
379f8369d7dSTobias Sarnowski        }
380f8369d7dSTobias Sarnowski        $return = false;
381f8369d7dSTobias Sarnowski        if ($this->isDocumentFragment) {
382f8369d7dSTobias Sarnowski            phpQuery::debug("Full markup load (XML), DocumentFragment detected, using charset '$charset'");
383f8369d7dSTobias Sarnowski            $return = $this->documentFragmentLoadMarkup($this, $charset, $markup);
384f8369d7dSTobias Sarnowski        } else {
385f8369d7dSTobias Sarnowski            // FIXME ???
386f8369d7dSTobias Sarnowski            if ($isContentTypeXHTML && ! $isMarkupXHTML)
387f8369d7dSTobias Sarnowski            if (! $documentCharset) {
388f8369d7dSTobias Sarnowski                phpQuery::debug("Full markup load (XML), appending charset '$charset'");
389f8369d7dSTobias Sarnowski                $markup = $this->charsetAppendToXML($markup, $charset);
390f8369d7dSTobias Sarnowski            }
39159752844SAnders Sandblad            // see http://php.net/manual/en/book.dom.php#78929
392f8369d7dSTobias Sarnowski            // LIBXML_DTDLOAD (>= PHP 5.1)
393f8369d7dSTobias Sarnowski            // does XML ctalogues works with LIBXML_NONET
394f8369d7dSTobias Sarnowski    //      $this->document->resolveExternals = true;
395f8369d7dSTobias Sarnowski            // TODO test LIBXML_COMPACT for performance improvement
396f8369d7dSTobias Sarnowski            // create document
397f8369d7dSTobias Sarnowski            $this->documentCreate($charset);
398f8369d7dSTobias Sarnowski            if (phpversion() < 5.1) {
399f8369d7dSTobias Sarnowski                $this->document->resolveExternals = true;
400f8369d7dSTobias Sarnowski                $return = phpQuery::$debug === 2
401f8369d7dSTobias Sarnowski                    ? $this->document->loadXML($markup)
402f8369d7dSTobias Sarnowski                    : @$this->document->loadXML($markup);
403f8369d7dSTobias Sarnowski            } else {
40459752844SAnders Sandblad                /** @link http://php.net/manual/en/libxml.constants.php */
405f8369d7dSTobias Sarnowski                $libxmlStatic = phpQuery::$debug === 2
406f8369d7dSTobias Sarnowski                    ? LIBXML_DTDLOAD|LIBXML_DTDATTR|LIBXML_NONET
407f8369d7dSTobias Sarnowski                    : LIBXML_DTDLOAD|LIBXML_DTDATTR|LIBXML_NONET|LIBXML_NOWARNING|LIBXML_NOERROR;
408f8369d7dSTobias Sarnowski                $return = $this->document->loadXML($markup, $libxmlStatic);
409f8369d7dSTobias Sarnowski//              if (! $return)
410f8369d7dSTobias Sarnowski//                  $return = $this->document->loadHTML($markup);
411f8369d7dSTobias Sarnowski            }
412f8369d7dSTobias Sarnowski            if ($return)
413f8369d7dSTobias Sarnowski                $this->root = $this->document;
414f8369d7dSTobias Sarnowski        }
415f8369d7dSTobias Sarnowski        if ($return) {
416f8369d7dSTobias Sarnowski            if (! $this->contentType) {
417f8369d7dSTobias Sarnowski                if ($this->isXHTML)
418f8369d7dSTobias Sarnowski                    $this->contentType = 'application/xhtml+xml';
419f8369d7dSTobias Sarnowski                else
420f8369d7dSTobias Sarnowski                    $this->contentType = 'text/xml';
421f8369d7dSTobias Sarnowski            }
422f8369d7dSTobias Sarnowski            return $return;
423f8369d7dSTobias Sarnowski        } else {
424f8369d7dSTobias Sarnowski            throw new Exception("Error loading XML markup");
425f8369d7dSTobias Sarnowski        }
426f8369d7dSTobias Sarnowski    }
427f8369d7dSTobias Sarnowski    protected function isXHTML($markup = null) {
428f8369d7dSTobias Sarnowski        if (! isset($markup)) {
429f8369d7dSTobias Sarnowski            return strpos($this->contentType, 'xhtml') !== false;
430f8369d7dSTobias Sarnowski        }
431f8369d7dSTobias Sarnowski        // XXX ok ?
432f8369d7dSTobias Sarnowski        return strpos($markup, "<!DOCTYPE html") !== false;
433f8369d7dSTobias Sarnowski//      return stripos($doctype, 'xhtml') !== false;
434f8369d7dSTobias Sarnowski//      $doctype = isset($dom->doctype) && is_object($dom->doctype)
435f8369d7dSTobias Sarnowski//          ? $dom->doctype->publicId
436f8369d7dSTobias Sarnowski//          : self::$defaultDoctype;
437f8369d7dSTobias Sarnowski    }
438f8369d7dSTobias Sarnowski    protected function isXML($markup) {
439f8369d7dSTobias Sarnowski//      return strpos($markup, '<?xml') !== false && stripos($markup, 'xhtml') === false;
440f8369d7dSTobias Sarnowski        return strpos(substr($markup, 0, 100), '<'.'?xml') !== false;
441f8369d7dSTobias Sarnowski    }
442f8369d7dSTobias Sarnowski    protected function contentTypeToArray($contentType) {
443f8369d7dSTobias Sarnowski        $matches = explode(';', trim(strtolower($contentType)));
444f8369d7dSTobias Sarnowski        if (isset($matches[1])) {
445f8369d7dSTobias Sarnowski            $matches[1] = explode('=', $matches[1]);
446f8369d7dSTobias Sarnowski            // strip 'charset='
447f8369d7dSTobias Sarnowski            $matches[1] = isset($matches[1][1]) && trim($matches[1][1])
448f8369d7dSTobias Sarnowski                ? $matches[1][1]
449f8369d7dSTobias Sarnowski                : $matches[1][0];
450f8369d7dSTobias Sarnowski        } else
451f8369d7dSTobias Sarnowski            $matches[1] = null;
452f8369d7dSTobias Sarnowski        return $matches;
453f8369d7dSTobias Sarnowski    }
454f8369d7dSTobias Sarnowski    /**
455f8369d7dSTobias Sarnowski     *
456f8369d7dSTobias Sarnowski     * @param $markup
457f8369d7dSTobias Sarnowski     * @return array contentType, charset
458f8369d7dSTobias Sarnowski     */
459f8369d7dSTobias Sarnowski    protected function contentTypeFromHTML($markup) {
460f8369d7dSTobias Sarnowski        $matches = array();
461f8369d7dSTobias Sarnowski        // find meta tag
462f8369d7dSTobias Sarnowski        preg_match('@<meta[^>]+http-equiv\\s*=\\s*(["|\'])Content-Type\\1([^>]+?)>@i',
463f8369d7dSTobias Sarnowski            $markup, $matches
464f8369d7dSTobias Sarnowski        );
465f8369d7dSTobias Sarnowski        if (! isset($matches[0]))
466f8369d7dSTobias Sarnowski            return array(null, null);
467f8369d7dSTobias Sarnowski        // get attr 'content'
468f8369d7dSTobias Sarnowski        preg_match('@content\\s*=\\s*(["|\'])(.+?)\\1@', $matches[0], $matches);
469f8369d7dSTobias Sarnowski        if (! isset($matches[0]))
470f8369d7dSTobias Sarnowski            return array(null, null);
471f8369d7dSTobias Sarnowski        return $this->contentTypeToArray($matches[2]);
472f8369d7dSTobias Sarnowski    }
473f8369d7dSTobias Sarnowski    protected function charsetFromHTML($markup) {
474f8369d7dSTobias Sarnowski        $contentType = $this->contentTypeFromHTML($markup);
475f8369d7dSTobias Sarnowski        return $contentType[1];
476f8369d7dSTobias Sarnowski    }
477f8369d7dSTobias Sarnowski    protected function charsetFromXML($markup) {
478f8369d7dSTobias Sarnowski        $matches;
479f8369d7dSTobias Sarnowski        // find declaration
480f8369d7dSTobias Sarnowski        preg_match('@<'.'?xml[^>]+encoding\\s*=\\s*(["|\'])(.*?)\\1@i',
481f8369d7dSTobias Sarnowski            $markup, $matches
482f8369d7dSTobias Sarnowski        );
483f8369d7dSTobias Sarnowski        return isset($matches[2])
484f8369d7dSTobias Sarnowski            ? strtolower($matches[2])
485f8369d7dSTobias Sarnowski            : null;
486f8369d7dSTobias Sarnowski    }
487f8369d7dSTobias Sarnowski    /**
488f8369d7dSTobias Sarnowski     * Repositions meta[type=charset] at the start of head. Bypasses DOMDocument bug.
489f8369d7dSTobias Sarnowski     *
490f8369d7dSTobias Sarnowski     * @link http://code.google.com/p/phpquery/issues/detail?id=80
491f8369d7dSTobias Sarnowski     * @param $html
492f8369d7dSTobias Sarnowski     */
493f8369d7dSTobias Sarnowski    protected function charsetFixHTML($markup) {
494f8369d7dSTobias Sarnowski        $matches = array();
495f8369d7dSTobias Sarnowski        // find meta tag
496f8369d7dSTobias Sarnowski        preg_match('@\s*<meta[^>]+http-equiv\\s*=\\s*(["|\'])Content-Type\\1([^>]+?)>@i',
497f8369d7dSTobias Sarnowski            $markup, $matches, PREG_OFFSET_CAPTURE
498f8369d7dSTobias Sarnowski        );
499f8369d7dSTobias Sarnowski        if (! isset($matches[0]))
500f8369d7dSTobias Sarnowski            return;
501f8369d7dSTobias Sarnowski        $metaContentType = $matches[0][0];
502f8369d7dSTobias Sarnowski        $markup = substr($markup, 0, $matches[0][1])
503f8369d7dSTobias Sarnowski            .substr($markup, $matches[0][1]+strlen($metaContentType));
504f8369d7dSTobias Sarnowski        $headStart = stripos($markup, '<head>');
505f8369d7dSTobias Sarnowski        $markup = substr($markup, 0, $headStart+6).$metaContentType
506f8369d7dSTobias Sarnowski            .substr($markup, $headStart+6);
507f8369d7dSTobias Sarnowski        return $markup;
508f8369d7dSTobias Sarnowski    }
509f8369d7dSTobias Sarnowski    protected function charsetAppendToHTML($html, $charset, $xhtml = false) {
510f8369d7dSTobias Sarnowski        // remove existing meta[type=content-type]
511f8369d7dSTobias Sarnowski        $html = preg_replace('@\s*<meta[^>]+http-equiv\\s*=\\s*(["|\'])Content-Type\\1([^>]+?)>@i', '', $html);
512f8369d7dSTobias Sarnowski        $meta = '<meta http-equiv="Content-Type" content="text/html;charset='
513f8369d7dSTobias Sarnowski            .$charset.'" '
514f8369d7dSTobias Sarnowski            .($xhtml ? '/' : '')
515f8369d7dSTobias Sarnowski            .'>';
516f8369d7dSTobias Sarnowski        if (strpos($html, '<head') === false) {
517f8369d7dSTobias Sarnowski            if (strpos($hltml, '<html') === false) {
518f8369d7dSTobias Sarnowski                return $meta.$html;
519f8369d7dSTobias Sarnowski            } else {
520f8369d7dSTobias Sarnowski                return preg_replace(
521f8369d7dSTobias Sarnowski                    '@<html(.*?)(?(?<!\?)>)@s',
522f8369d7dSTobias Sarnowski                    "<html\\1><head>{$meta}</head>",
523f8369d7dSTobias Sarnowski                    $html
524f8369d7dSTobias Sarnowski                );
525f8369d7dSTobias Sarnowski            }
526f8369d7dSTobias Sarnowski        } else {
527f8369d7dSTobias Sarnowski            return preg_replace(
528f8369d7dSTobias Sarnowski                '@<head(.*?)(?(?<!\?)>)@s',
529f8369d7dSTobias Sarnowski                '<head\\1>'.$meta,
530f8369d7dSTobias Sarnowski                $html
531f8369d7dSTobias Sarnowski            );
532f8369d7dSTobias Sarnowski        }
533f8369d7dSTobias Sarnowski    }
534f8369d7dSTobias Sarnowski    protected function charsetAppendToXML($markup, $charset) {
535f8369d7dSTobias Sarnowski        $declaration = '<'.'?xml version="1.0" encoding="'.$charset.'"?'.'>';
536f8369d7dSTobias Sarnowski        return $declaration.$markup;
537f8369d7dSTobias Sarnowski    }
538f8369d7dSTobias Sarnowski    public static function isDocumentFragmentHTML($markup) {
539f8369d7dSTobias Sarnowski        return stripos($markup, '<html') === false && stripos($markup, '<!doctype') === false;
540f8369d7dSTobias Sarnowski    }
541f8369d7dSTobias Sarnowski    public static function isDocumentFragmentXML($markup) {
542f8369d7dSTobias Sarnowski        return stripos($markup, '<'.'?xml') === false;
543f8369d7dSTobias Sarnowski    }
544f8369d7dSTobias Sarnowski    public static function isDocumentFragmentXHTML($markup) {
545f8369d7dSTobias Sarnowski        return self::isDocumentFragmentHTML($markup);
546f8369d7dSTobias Sarnowski    }
547f8369d7dSTobias Sarnowski    public function importAttr($value) {
548f8369d7dSTobias Sarnowski        // TODO
549f8369d7dSTobias Sarnowski    }
550f8369d7dSTobias Sarnowski    /**
551f8369d7dSTobias Sarnowski     *
552f8369d7dSTobias Sarnowski     * @param $source
553f8369d7dSTobias Sarnowski     * @param $target
554f8369d7dSTobias Sarnowski     * @param $sourceCharset
555f8369d7dSTobias Sarnowski     * @return array Array of imported nodes.
556f8369d7dSTobias Sarnowski     */
557f8369d7dSTobias Sarnowski    public function import($source, $sourceCharset = null) {
558f8369d7dSTobias Sarnowski        // TODO charset conversions
559f8369d7dSTobias Sarnowski        $return = array();
560f8369d7dSTobias Sarnowski        if ($source instanceof DOMNODE && !($source instanceof DOMNODELIST))
561f8369d7dSTobias Sarnowski            $source = array($source);
562f8369d7dSTobias Sarnowski//      if (is_array($source)) {
563f8369d7dSTobias Sarnowski//          foreach($source as $node) {
564f8369d7dSTobias Sarnowski//              if (is_string($node)) {
565f8369d7dSTobias Sarnowski//                  // string markup
566f8369d7dSTobias Sarnowski//                  $fake = $this->documentFragmentCreate($node, $sourceCharset);
567f8369d7dSTobias Sarnowski//                  if ($fake === false)
568f8369d7dSTobias Sarnowski//                      throw new Exception("Error loading documentFragment markup");
569f8369d7dSTobias Sarnowski//                  else
570f8369d7dSTobias Sarnowski//                      $return = array_merge($return,
571f8369d7dSTobias Sarnowski//                          $this->import($fake->root->childNodes)
572f8369d7dSTobias Sarnowski//                      );
573f8369d7dSTobias Sarnowski//              } else {
574f8369d7dSTobias Sarnowski//                  $return[] = $this->document->importNode($node, true);
575f8369d7dSTobias Sarnowski//              }
576f8369d7dSTobias Sarnowski//          }
577f8369d7dSTobias Sarnowski//          return $return;
578f8369d7dSTobias Sarnowski//      } else {
579f8369d7dSTobias Sarnowski//          // string markup
580f8369d7dSTobias Sarnowski//          $fake = $this->documentFragmentCreate($source, $sourceCharset);
581f8369d7dSTobias Sarnowski//          if ($fake === false)
582f8369d7dSTobias Sarnowski//              throw new Exception("Error loading documentFragment markup");
583f8369d7dSTobias Sarnowski//          else
584f8369d7dSTobias Sarnowski//              return $this->import($fake->root->childNodes);
585f8369d7dSTobias Sarnowski//      }
586f8369d7dSTobias Sarnowski        if (is_array($source) || $source instanceof DOMNODELIST) {
587f8369d7dSTobias Sarnowski            // dom nodes
588f8369d7dSTobias Sarnowski            self::debug('Importing nodes to document');
589f8369d7dSTobias Sarnowski            foreach($source as $node)
590f8369d7dSTobias Sarnowski                $return[] = $this->document->importNode($node, true);
591f8369d7dSTobias Sarnowski        } else {
592f8369d7dSTobias Sarnowski            // string markup
593f8369d7dSTobias Sarnowski            $fake = $this->documentFragmentCreate($source, $sourceCharset);
594f8369d7dSTobias Sarnowski            if ($fake === false)
595f8369d7dSTobias Sarnowski                throw new Exception("Error loading documentFragment markup");
596f8369d7dSTobias Sarnowski            else
597f8369d7dSTobias Sarnowski                return $this->import($fake->root->childNodes);
598f8369d7dSTobias Sarnowski        }
599f8369d7dSTobias Sarnowski        return $return;
600f8369d7dSTobias Sarnowski    }
601f8369d7dSTobias Sarnowski    /**
602f8369d7dSTobias Sarnowski     * Creates new document fragment.
603f8369d7dSTobias Sarnowski     *
604f8369d7dSTobias Sarnowski     * @param $source
605f8369d7dSTobias Sarnowski     * @return DOMDocumentWrapper
606f8369d7dSTobias Sarnowski     */
607f8369d7dSTobias Sarnowski    protected function documentFragmentCreate($source, $charset = null) {
608f8369d7dSTobias Sarnowski        $fake = new DOMDocumentWrapper();
609f8369d7dSTobias Sarnowski        $fake->contentType = $this->contentType;
610f8369d7dSTobias Sarnowski        $fake->isXML = $this->isXML;
611f8369d7dSTobias Sarnowski        $fake->isHTML = $this->isHTML;
612f8369d7dSTobias Sarnowski        $fake->isXHTML = $this->isXHTML;
613f8369d7dSTobias Sarnowski        $fake->root = $fake->document;
614f8369d7dSTobias Sarnowski        if (! $charset)
615f8369d7dSTobias Sarnowski            $charset = $this->charset;
616f8369d7dSTobias Sarnowski//  $fake->documentCreate($this->charset);
617f8369d7dSTobias Sarnowski        if ($source instanceof DOMNODE && !($source instanceof DOMNODELIST))
618f8369d7dSTobias Sarnowski            $source = array($source);
619f8369d7dSTobias Sarnowski        if (is_array($source) || $source instanceof DOMNODELIST) {
620f8369d7dSTobias Sarnowski            // dom nodes
621f8369d7dSTobias Sarnowski            // load fake document
622f8369d7dSTobias Sarnowski            if (! $this->documentFragmentLoadMarkup($fake, $charset))
623f8369d7dSTobias Sarnowski                return false;
624f8369d7dSTobias Sarnowski            $nodes = $fake->import($source);
625f8369d7dSTobias Sarnowski            foreach($nodes as $node)
626f8369d7dSTobias Sarnowski                $fake->root->appendChild($node);
627f8369d7dSTobias Sarnowski        } else {
628f8369d7dSTobias Sarnowski            // string markup
629f8369d7dSTobias Sarnowski            $this->documentFragmentLoadMarkup($fake, $charset, $source);
630f8369d7dSTobias Sarnowski        }
631f8369d7dSTobias Sarnowski        return $fake;
632f8369d7dSTobias Sarnowski    }
633f8369d7dSTobias Sarnowski    /**
634f8369d7dSTobias Sarnowski     *
635f8369d7dSTobias Sarnowski     * @param $document DOMDocumentWrapper
636f8369d7dSTobias Sarnowski     * @param $markup
637f8369d7dSTobias Sarnowski     * @return $document
638f8369d7dSTobias Sarnowski     */
639f8369d7dSTobias Sarnowski    private function documentFragmentLoadMarkup($fragment, $charset, $markup = null) {
640f8369d7dSTobias Sarnowski        // TODO error handling
641f8369d7dSTobias Sarnowski        // TODO copy doctype
642f8369d7dSTobias Sarnowski        // tempolary turn off
643f8369d7dSTobias Sarnowski        $fragment->isDocumentFragment = false;
644f8369d7dSTobias Sarnowski        if ($fragment->isXML) {
645f8369d7dSTobias Sarnowski            if ($fragment->isXHTML) {
646f8369d7dSTobias Sarnowski                // add FAKE element to set default namespace
647f8369d7dSTobias Sarnowski                $fragment->loadMarkupXML('<?xml version="1.0" encoding="'.$charset.'"?>'
648f8369d7dSTobias Sarnowski                    .'<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" '
649f8369d7dSTobias Sarnowski                    .'"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">'
650f8369d7dSTobias Sarnowski                    .'<fake xmlns="http://www.w3.org/1999/xhtml">'.$markup.'</fake>');
651f8369d7dSTobias Sarnowski                $fragment->root = $fragment->document->firstChild->nextSibling;
652f8369d7dSTobias Sarnowski            } else {
653f8369d7dSTobias Sarnowski                $fragment->loadMarkupXML('<?xml version="1.0" encoding="'.$charset.'"?><fake>'.$markup.'</fake>');
654f8369d7dSTobias Sarnowski                $fragment->root = $fragment->document->firstChild;
655f8369d7dSTobias Sarnowski            }
656f8369d7dSTobias Sarnowski        } else {
657f8369d7dSTobias Sarnowski            $markup2 = phpQuery::$defaultDoctype.'<html><head><meta http-equiv="Content-Type" content="text/html;charset='
658f8369d7dSTobias Sarnowski                .$charset.'"></head>';
659f8369d7dSTobias Sarnowski            $noBody = strpos($markup, '<body') === false;
660f8369d7dSTobias Sarnowski            if ($noBody)
661f8369d7dSTobias Sarnowski                $markup2 .= '<body>';
662f8369d7dSTobias Sarnowski            $markup2 .= $markup;
663f8369d7dSTobias Sarnowski            if ($noBody)
664f8369d7dSTobias Sarnowski                $markup2 .= '</body>';
665f8369d7dSTobias Sarnowski            $markup2 .= '</html>';
666f8369d7dSTobias Sarnowski            $fragment->loadMarkupHTML($markup2);
667f8369d7dSTobias Sarnowski            // TODO resolv body tag merging issue
668f8369d7dSTobias Sarnowski            $fragment->root = $noBody
669f8369d7dSTobias Sarnowski                ? $fragment->document->firstChild->nextSibling->firstChild->nextSibling
670f8369d7dSTobias Sarnowski                : $fragment->document->firstChild->nextSibling->firstChild->nextSibling;
671f8369d7dSTobias Sarnowski        }
672f8369d7dSTobias Sarnowski        if (! $fragment->root)
673f8369d7dSTobias Sarnowski            return false;
674f8369d7dSTobias Sarnowski        $fragment->isDocumentFragment = true;
675f8369d7dSTobias Sarnowski        return true;
676f8369d7dSTobias Sarnowski    }
677f8369d7dSTobias Sarnowski    protected function documentFragmentToMarkup($fragment) {
678f8369d7dSTobias Sarnowski        phpQuery::debug('documentFragmentToMarkup');
679f8369d7dSTobias Sarnowski        $tmp = $fragment->isDocumentFragment;
680f8369d7dSTobias Sarnowski        $fragment->isDocumentFragment = false;
681f8369d7dSTobias Sarnowski        $markup = $fragment->markup();
682f8369d7dSTobias Sarnowski        if ($fragment->isXML) {
683f8369d7dSTobias Sarnowski            $markup = substr($markup, 0, strrpos($markup, '</fake>'));
684f8369d7dSTobias Sarnowski            if ($fragment->isXHTML) {
685f8369d7dSTobias Sarnowski                $markup = substr($markup, strpos($markup, '<fake')+43);
686f8369d7dSTobias Sarnowski            } else {
687f8369d7dSTobias Sarnowski                $markup = substr($markup, strpos($markup, '<fake>')+6);
688f8369d7dSTobias Sarnowski            }
689f8369d7dSTobias Sarnowski        } else {
690f8369d7dSTobias Sarnowski                $markup = substr($markup, strpos($markup, '<body>')+6);
691f8369d7dSTobias Sarnowski                $markup = substr($markup, 0, strrpos($markup, '</body>'));
692f8369d7dSTobias Sarnowski        }
693f8369d7dSTobias Sarnowski        $fragment->isDocumentFragment = $tmp;
694f8369d7dSTobias Sarnowski        if (phpQuery::$debug)
695f8369d7dSTobias Sarnowski            phpQuery::debug('documentFragmentToMarkup: '.substr($markup, 0, 150));
696f8369d7dSTobias Sarnowski        return $markup;
697f8369d7dSTobias Sarnowski    }
698f8369d7dSTobias Sarnowski    /**
699f8369d7dSTobias Sarnowski     * Return document markup, starting with optional $nodes as root.
700f8369d7dSTobias Sarnowski     *
701f8369d7dSTobias Sarnowski     * @param $nodes    DOMNode|DOMNodeList
702f8369d7dSTobias Sarnowski     * @return string
703f8369d7dSTobias Sarnowski     */
704f8369d7dSTobias Sarnowski    public function markup($nodes = null, $innerMarkup = false) {
705f8369d7dSTobias Sarnowski        if (isset($nodes) && count($nodes) == 1 && $nodes[0] instanceof DOMDOCUMENT)
706f8369d7dSTobias Sarnowski            $nodes = null;
707f8369d7dSTobias Sarnowski        if (isset($nodes)) {
708f8369d7dSTobias Sarnowski            $markup = '';
709f8369d7dSTobias Sarnowski            if (!is_array($nodes) && !($nodes instanceof DOMNODELIST) )
710f8369d7dSTobias Sarnowski                $nodes = array($nodes);
711f8369d7dSTobias Sarnowski            if ($this->isDocumentFragment && ! $innerMarkup)
712f8369d7dSTobias Sarnowski                foreach($nodes as $i => $node)
713f8369d7dSTobias Sarnowski                    if ($node->isSameNode($this->root)) {
714f8369d7dSTobias Sarnowski                    //  var_dump($node);
715f8369d7dSTobias Sarnowski                        $nodes = array_slice($nodes, 0, $i)
716f8369d7dSTobias Sarnowski                            + phpQuery::DOMNodeListToArray($node->childNodes)
717f8369d7dSTobias Sarnowski                            + array_slice($nodes, $i+1);
718f8369d7dSTobias Sarnowski                        }
719f8369d7dSTobias Sarnowski            if ($this->isXML && ! $innerMarkup) {
720f8369d7dSTobias Sarnowski                self::debug("Getting outerXML with charset '{$this->charset}'");
721f8369d7dSTobias Sarnowski                // we need outerXML, so we can benefit from
722f8369d7dSTobias Sarnowski                // $node param support in saveXML()
723f8369d7dSTobias Sarnowski                foreach($nodes as $node)
724f8369d7dSTobias Sarnowski                    $markup .= $this->document->saveXML($node);
725f8369d7dSTobias Sarnowski            } else {
726f8369d7dSTobias Sarnowski                $loop = array();
727f8369d7dSTobias Sarnowski                if ($innerMarkup)
728f8369d7dSTobias Sarnowski                    foreach($nodes as $node) {
729f8369d7dSTobias Sarnowski                        if ($node->childNodes)
730f8369d7dSTobias Sarnowski                            foreach($node->childNodes as $child)
731f8369d7dSTobias Sarnowski                                $loop[] = $child;
732f8369d7dSTobias Sarnowski                        else
733f8369d7dSTobias Sarnowski                            $loop[] = $node;
734f8369d7dSTobias Sarnowski                    }
735f8369d7dSTobias Sarnowski                else
736f8369d7dSTobias Sarnowski                    $loop = $nodes;
737f8369d7dSTobias Sarnowski                self::debug("Getting markup, moving selected nodes (".count($loop).") to new DocumentFragment");
738f8369d7dSTobias Sarnowski                $fake = $this->documentFragmentCreate($loop);
739f8369d7dSTobias Sarnowski                $markup = $this->documentFragmentToMarkup($fake);
740f8369d7dSTobias Sarnowski            }
741f8369d7dSTobias Sarnowski            if ($this->isXHTML) {
742f8369d7dSTobias Sarnowski                self::debug("Fixing XHTML");
743f8369d7dSTobias Sarnowski                $markup = self::markupFixXHTML($markup);
744f8369d7dSTobias Sarnowski            }
745f8369d7dSTobias Sarnowski            self::debug("Markup: ".substr($markup, 0, 250));
746f8369d7dSTobias Sarnowski            return $markup;
747f8369d7dSTobias Sarnowski        } else {
748f8369d7dSTobias Sarnowski            if ($this->isDocumentFragment) {
749f8369d7dSTobias Sarnowski                // documentFragment, html only...
750f8369d7dSTobias Sarnowski                self::debug("Getting markup, DocumentFragment detected");
751f8369d7dSTobias Sarnowski//              return $this->markup(
752f8369d7dSTobias Sarnowski////                    $this->document->getElementsByTagName('body')->item(0)
753f8369d7dSTobias Sarnowski//                  $this->document->root, true
754f8369d7dSTobias Sarnowski//              );
755f8369d7dSTobias Sarnowski                $markup = $this->documentFragmentToMarkup($this);
756f8369d7dSTobias Sarnowski                // no need for markupFixXHTML, as it's done thought markup($nodes) method
757f8369d7dSTobias Sarnowski                return $markup;
758f8369d7dSTobias Sarnowski            } else {
759f8369d7dSTobias Sarnowski                self::debug("Getting markup (".($this->isXML?'XML':'HTML')."), final with charset '{$this->charset}'");
760f8369d7dSTobias Sarnowski                $markup = $this->isXML
761f8369d7dSTobias Sarnowski                    ? $this->document->saveXML()
762f8369d7dSTobias Sarnowski                    : $this->document->saveHTML();
763f8369d7dSTobias Sarnowski                if ($this->isXHTML) {
764f8369d7dSTobias Sarnowski                    self::debug("Fixing XHTML");
765f8369d7dSTobias Sarnowski                    $markup = self::markupFixXHTML($markup);
766f8369d7dSTobias Sarnowski                }
767f8369d7dSTobias Sarnowski                self::debug("Markup: ".substr($markup, 0, 250));
768f8369d7dSTobias Sarnowski                return $markup;
769f8369d7dSTobias Sarnowski            }
770f8369d7dSTobias Sarnowski        }
771f8369d7dSTobias Sarnowski    }
772f8369d7dSTobias Sarnowski    protected static function markupFixXHTML($markup) {
773f8369d7dSTobias Sarnowski        $markup = self::expandEmptyTag('script', $markup);
774f8369d7dSTobias Sarnowski        $markup = self::expandEmptyTag('select', $markup);
775f8369d7dSTobias Sarnowski        $markup = self::expandEmptyTag('textarea', $markup);
776f8369d7dSTobias Sarnowski        return $markup;
777f8369d7dSTobias Sarnowski    }
778f8369d7dSTobias Sarnowski    public static function debug($text) {
779f8369d7dSTobias Sarnowski        phpQuery::debug($text);
780f8369d7dSTobias Sarnowski    }
781f8369d7dSTobias Sarnowski    /**
782f8369d7dSTobias Sarnowski     * expandEmptyTag
783f8369d7dSTobias Sarnowski     *
784f8369d7dSTobias Sarnowski     * @param $tag
785f8369d7dSTobias Sarnowski     * @param $xml
786f8369d7dSTobias Sarnowski     * @return unknown_type
787f8369d7dSTobias Sarnowski     * @author mjaque at ilkebenson dot com
788f8369d7dSTobias Sarnowski     * @link http://php.net/manual/en/domdocument.savehtml.php#81256
789f8369d7dSTobias Sarnowski     */
790f8369d7dSTobias Sarnowski    public static function expandEmptyTag($tag, $xml){
791f8369d7dSTobias Sarnowski        $indice = 0;
792f8369d7dSTobias Sarnowski        while ($indice< strlen($xml)){
793f8369d7dSTobias Sarnowski            $pos = strpos($xml, "<$tag ", $indice);
794f8369d7dSTobias Sarnowski            if ($pos){
795f8369d7dSTobias Sarnowski                $posCierre = strpos($xml, ">", $pos);
796f8369d7dSTobias Sarnowski                if ($xml[$posCierre-1] == "/"){
797f8369d7dSTobias Sarnowski                    $xml = substr_replace($xml, "></$tag>", $posCierre-1, 2);
798f8369d7dSTobias Sarnowski                }
799f8369d7dSTobias Sarnowski                $indice = $posCierre;
800f8369d7dSTobias Sarnowski            }
801f8369d7dSTobias Sarnowski            else break;
802f8369d7dSTobias Sarnowski        }
803f8369d7dSTobias Sarnowski        return $xml;
804f8369d7dSTobias Sarnowski    }
805f8369d7dSTobias Sarnowski}
806f8369d7dSTobias Sarnowski
807f8369d7dSTobias Sarnowski/**
808f8369d7dSTobias Sarnowski * Event handling class.
809f8369d7dSTobias Sarnowski *
810f8369d7dSTobias Sarnowski * @author Tobiasz Cudnik
811f8369d7dSTobias Sarnowski * @package phpQuery
812f8369d7dSTobias Sarnowski * @static
813f8369d7dSTobias Sarnowski */
814f8369d7dSTobias Sarnowskiabstract class phpQueryEvents {
815f8369d7dSTobias Sarnowski    /**
816f8369d7dSTobias Sarnowski     * Trigger a type of event on every matched element.
817f8369d7dSTobias Sarnowski     *
818f8369d7dSTobias Sarnowski     * @param DOMNode|phpQueryObject|string $document
819f8369d7dSTobias Sarnowski     * @param unknown_type $type
820f8369d7dSTobias Sarnowski     * @param unknown_type $data
821f8369d7dSTobias Sarnowski     *
822f8369d7dSTobias Sarnowski     * @TODO exclusive events (with !)
823f8369d7dSTobias Sarnowski     * @TODO global events (test)
824f8369d7dSTobias Sarnowski     * @TODO support more than event in $type (space-separated)
825f8369d7dSTobias Sarnowski     */
826f8369d7dSTobias Sarnowski    public static function trigger($document, $type, $data = array(), $node = null) {
827f8369d7dSTobias Sarnowski        // trigger: function(type, data, elem, donative, extra) {
828f8369d7dSTobias Sarnowski        $documentID = phpQuery::getDocumentID($document);
829f8369d7dSTobias Sarnowski        $namespace = null;
830f8369d7dSTobias Sarnowski        if (strpos($type, '.') !== false)
831f8369d7dSTobias Sarnowski            list($name, $namespace) = explode('.', $type);
832f8369d7dSTobias Sarnowski        else
833f8369d7dSTobias Sarnowski            $name = $type;
834f8369d7dSTobias Sarnowski        if (! $node) {
835f8369d7dSTobias Sarnowski            if (self::issetGlobal($documentID, $type)) {
836f8369d7dSTobias Sarnowski                $pq = phpQuery::getDocument($documentID);
837f8369d7dSTobias Sarnowski                // TODO check add($pq->document)
838f8369d7dSTobias Sarnowski                $pq->find('*')->add($pq->document)
839f8369d7dSTobias Sarnowski                    ->trigger($type, $data);
840f8369d7dSTobias Sarnowski            }
841f8369d7dSTobias Sarnowski        } else {
842f8369d7dSTobias Sarnowski            if (isset($data[0]) && $data[0] instanceof DOMEvent) {
843f8369d7dSTobias Sarnowski                $event = $data[0];
844f8369d7dSTobias Sarnowski                $event->relatedTarget = $event->target;
845f8369d7dSTobias Sarnowski                $event->target = $node;
846f8369d7dSTobias Sarnowski                $data = array_slice($data, 1);
847f8369d7dSTobias Sarnowski            } else {
848f8369d7dSTobias Sarnowski                $event = new DOMEvent(array(
849f8369d7dSTobias Sarnowski                    'type' => $type,
850f8369d7dSTobias Sarnowski                    'target' => $node,
851f8369d7dSTobias Sarnowski                    'timeStamp' => time(),
852f8369d7dSTobias Sarnowski                ));
853f8369d7dSTobias Sarnowski            }
854f8369d7dSTobias Sarnowski            $i = 0;
855f8369d7dSTobias Sarnowski            while($node) {
856f8369d7dSTobias Sarnowski                // TODO whois
857f8369d7dSTobias Sarnowski                phpQuery::debug("Triggering ".($i?"bubbled ":'')."event '{$type}' on "
858f8369d7dSTobias Sarnowski                    ."node \n");//.phpQueryObject::whois($node)."\n");
859f8369d7dSTobias Sarnowski                $event->currentTarget = $node;
860f8369d7dSTobias Sarnowski                $eventNode = self::getNode($documentID, $node);
861f8369d7dSTobias Sarnowski                if (isset($eventNode->eventHandlers)) {
862f8369d7dSTobias Sarnowski                    foreach($eventNode->eventHandlers as $eventType => $handlers) {
863f8369d7dSTobias Sarnowski                        $eventNamespace = null;
864f8369d7dSTobias Sarnowski                        if (strpos($type, '.') !== false)
865f8369d7dSTobias Sarnowski                            list($eventName, $eventNamespace) = explode('.', $eventType);
866f8369d7dSTobias Sarnowski                        else
867f8369d7dSTobias Sarnowski                            $eventName = $eventType;
868f8369d7dSTobias Sarnowski                        if ($name != $eventName)
869f8369d7dSTobias Sarnowski                            continue;
870f8369d7dSTobias Sarnowski                        if ($namespace && $eventNamespace && $namespace != $eventNamespace)
871f8369d7dSTobias Sarnowski                            continue;
872f8369d7dSTobias Sarnowski                        foreach($handlers as $handler) {
873f8369d7dSTobias Sarnowski                            phpQuery::debug("Calling event handler\n");
874f8369d7dSTobias Sarnowski                            $event->data = $handler['data']
875f8369d7dSTobias Sarnowski                                ? $handler['data']
876f8369d7dSTobias Sarnowski                                : null;
877f8369d7dSTobias Sarnowski                            $params = array_merge(array($event), $data);
878f8369d7dSTobias Sarnowski                            $return = phpQuery::callbackRun($handler['callback'], $params);
879f8369d7dSTobias Sarnowski                            if ($return === false) {
880f8369d7dSTobias Sarnowski                                $event->bubbles = false;
881f8369d7dSTobias Sarnowski                            }
882f8369d7dSTobias Sarnowski                        }
883f8369d7dSTobias Sarnowski                    }
884f8369d7dSTobias Sarnowski                }
885f8369d7dSTobias Sarnowski                // to bubble or not to bubble...
886f8369d7dSTobias Sarnowski                if (! $event->bubbles)
887f8369d7dSTobias Sarnowski                    break;
888f8369d7dSTobias Sarnowski                $node = $node->parentNode;
889f8369d7dSTobias Sarnowski                $i++;
890f8369d7dSTobias Sarnowski            }
891f8369d7dSTobias Sarnowski        }
892f8369d7dSTobias Sarnowski    }
893f8369d7dSTobias Sarnowski    /**
894f8369d7dSTobias Sarnowski     * Binds a handler to one or more events (like click) for each matched element.
895f8369d7dSTobias Sarnowski     * Can also bind custom events.
896f8369d7dSTobias Sarnowski     *
897f8369d7dSTobias Sarnowski     * @param DOMNode|phpQueryObject|string $document
898f8369d7dSTobias Sarnowski     * @param unknown_type $type
899f8369d7dSTobias Sarnowski     * @param unknown_type $data Optional
900f8369d7dSTobias Sarnowski     * @param unknown_type $callback
901f8369d7dSTobias Sarnowski     *
902f8369d7dSTobias Sarnowski     * @TODO support '!' (exclusive) events
903f8369d7dSTobias Sarnowski     * @TODO support more than event in $type (space-separated)
904f8369d7dSTobias Sarnowski     * @TODO support binding to global events
905f8369d7dSTobias Sarnowski     */
906f8369d7dSTobias Sarnowski    public static function add($document, $node, $type, $data, $callback = null) {
907f8369d7dSTobias Sarnowski        phpQuery::debug("Binding '$type' event");
908f8369d7dSTobias Sarnowski        $documentID = phpQuery::getDocumentID($document);
909f8369d7dSTobias Sarnowski//      if (is_null($callback) && is_callable($data)) {
910f8369d7dSTobias Sarnowski//          $callback = $data;
911f8369d7dSTobias Sarnowski//          $data = null;
912f8369d7dSTobias Sarnowski//      }
913f8369d7dSTobias Sarnowski        $eventNode = self::getNode($documentID, $node);
914f8369d7dSTobias Sarnowski        if (! $eventNode)
915f8369d7dSTobias Sarnowski            $eventNode = self::setNode($documentID, $node);
916f8369d7dSTobias Sarnowski        if (!isset($eventNode->eventHandlers[$type]))
917f8369d7dSTobias Sarnowski            $eventNode->eventHandlers[$type] = array();
918f8369d7dSTobias Sarnowski        $eventNode->eventHandlers[$type][] = array(
919f8369d7dSTobias Sarnowski            'callback' => $callback,
920f8369d7dSTobias Sarnowski            'data' => $data,
921f8369d7dSTobias Sarnowski        );
922f8369d7dSTobias Sarnowski    }
923f8369d7dSTobias Sarnowski    /**
924f8369d7dSTobias Sarnowski     * Enter description here...
925f8369d7dSTobias Sarnowski     *
926f8369d7dSTobias Sarnowski     * @param DOMNode|phpQueryObject|string $document
927f8369d7dSTobias Sarnowski     * @param unknown_type $type
928f8369d7dSTobias Sarnowski     * @param unknown_type $callback
929f8369d7dSTobias Sarnowski     *
930f8369d7dSTobias Sarnowski     * @TODO namespace events
931f8369d7dSTobias Sarnowski     * @TODO support more than event in $type (space-separated)
932f8369d7dSTobias Sarnowski     */
933f8369d7dSTobias Sarnowski    public static function remove($document, $node, $type = null, $callback = null) {
934f8369d7dSTobias Sarnowski        $documentID = phpQuery::getDocumentID($document);
935f8369d7dSTobias Sarnowski        $eventNode = self::getNode($documentID, $node);
936f8369d7dSTobias Sarnowski        if (is_object($eventNode) && isset($eventNode->eventHandlers[$type])) {
937f8369d7dSTobias Sarnowski            if ($callback) {
938f8369d7dSTobias Sarnowski                foreach($eventNode->eventHandlers[$type] as $k => $handler)
939f8369d7dSTobias Sarnowski                    if ($handler['callback'] == $callback)
940f8369d7dSTobias Sarnowski                        unset($eventNode->eventHandlers[$type][$k]);
941f8369d7dSTobias Sarnowski            } else {
942f8369d7dSTobias Sarnowski                unset($eventNode->eventHandlers[$type]);
943f8369d7dSTobias Sarnowski            }
944f8369d7dSTobias Sarnowski        }
945f8369d7dSTobias Sarnowski    }
946f8369d7dSTobias Sarnowski    protected static function getNode($documentID, $node) {
947f8369d7dSTobias Sarnowski        foreach(phpQuery::$documents[$documentID]->eventsNodes as $eventNode) {
948f8369d7dSTobias Sarnowski            if ($node->isSameNode($eventNode))
949f8369d7dSTobias Sarnowski                return $eventNode;
950f8369d7dSTobias Sarnowski        }
951f8369d7dSTobias Sarnowski    }
952f8369d7dSTobias Sarnowski    protected static function setNode($documentID, $node) {
953f8369d7dSTobias Sarnowski        phpQuery::$documents[$documentID]->eventsNodes[] = $node;
954f8369d7dSTobias Sarnowski        return phpQuery::$documents[$documentID]->eventsNodes[
955f8369d7dSTobias Sarnowski            count(phpQuery::$documents[$documentID]->eventsNodes)-1
956f8369d7dSTobias Sarnowski        ];
957f8369d7dSTobias Sarnowski    }
958f8369d7dSTobias Sarnowski    protected static function issetGlobal($documentID, $type) {
959f8369d7dSTobias Sarnowski        return isset(phpQuery::$documents[$documentID])
960f8369d7dSTobias Sarnowski            ? in_array($type, phpQuery::$documents[$documentID]->eventsGlobal)
961f8369d7dSTobias Sarnowski            : false;
962f8369d7dSTobias Sarnowski    }
963f8369d7dSTobias Sarnowski}
964f8369d7dSTobias Sarnowski
965f8369d7dSTobias Sarnowski
966f8369d7dSTobias Sarnowskiinterface ICallbackNamed {
967f8369d7dSTobias Sarnowski    function hasName();
968f8369d7dSTobias Sarnowski    function getName();
969f8369d7dSTobias Sarnowski}
970f8369d7dSTobias Sarnowski/**
971f8369d7dSTobias Sarnowski * Callback class introduces currying-like pattern.
972f8369d7dSTobias Sarnowski *
973f8369d7dSTobias Sarnowski * Example:
974f8369d7dSTobias Sarnowski * function foo($param1, $param2, $param3) {
975f8369d7dSTobias Sarnowski *   var_dump($param1, $param2, $param3);
976f8369d7dSTobias Sarnowski * }
977f8369d7dSTobias Sarnowski * $fooCurried = new Callback('foo',
978f8369d7dSTobias Sarnowski *   'param1 is now statically set',
979f8369d7dSTobias Sarnowski *   new CallbackParam, new CallbackParam
980f8369d7dSTobias Sarnowski * );
981f8369d7dSTobias Sarnowski * phpQuery::callbackRun($fooCurried,
982f8369d7dSTobias Sarnowski *  array('param2 value', 'param3 value'
983f8369d7dSTobias Sarnowski * );
984f8369d7dSTobias Sarnowski *
985f8369d7dSTobias Sarnowski * Callback class is supported in all phpQuery methods which accepts callbacks.
986f8369d7dSTobias Sarnowski *
987f8369d7dSTobias Sarnowski * @link http://code.google.com/p/phpquery/wiki/Callbacks#Param_Structures
988f8369d7dSTobias Sarnowski * @author Tobiasz Cudnik <tobiasz.cudnik/gmail.com>
989f8369d7dSTobias Sarnowski *
990f8369d7dSTobias Sarnowski * @TODO??? return fake forwarding function created via create_function
991f8369d7dSTobias Sarnowski * @TODO honor paramStructure
992f8369d7dSTobias Sarnowski */
993f8369d7dSTobias Sarnowskiclass Callback
994f8369d7dSTobias Sarnowski    implements ICallbackNamed {
995f8369d7dSTobias Sarnowski    public $callback = null;
996f8369d7dSTobias Sarnowski    public $params = null;
997f8369d7dSTobias Sarnowski    protected $name;
998f8369d7dSTobias Sarnowski    public function __construct($callback, $param1 = null, $param2 = null,
999f8369d7dSTobias Sarnowski            $param3 = null) {
1000f8369d7dSTobias Sarnowski        $params = func_get_args();
1001f8369d7dSTobias Sarnowski        $params = array_slice($params, 1);
1002f8369d7dSTobias Sarnowski        if ($callback instanceof Callback) {
1003f8369d7dSTobias Sarnowski            // TODO implement recurention
1004f8369d7dSTobias Sarnowski        } else {
1005f8369d7dSTobias Sarnowski            $this->callback = $callback;
1006f8369d7dSTobias Sarnowski            $this->params = $params;
1007f8369d7dSTobias Sarnowski        }
1008f8369d7dSTobias Sarnowski    }
1009f8369d7dSTobias Sarnowski    public function getName() {
1010f8369d7dSTobias Sarnowski        return 'Callback: '.$this->name;
1011f8369d7dSTobias Sarnowski    }
1012f8369d7dSTobias Sarnowski    public function hasName() {
1013f8369d7dSTobias Sarnowski        return isset($this->name) && $this->name;
1014f8369d7dSTobias Sarnowski    }
1015f8369d7dSTobias Sarnowski    public function setName($name) {
1016f8369d7dSTobias Sarnowski        $this->name = $name;
1017f8369d7dSTobias Sarnowski        return $this;
1018f8369d7dSTobias Sarnowski    }
1019f8369d7dSTobias Sarnowski    // TODO test me
1020f8369d7dSTobias Sarnowski//  public function addParams() {
1021f8369d7dSTobias Sarnowski//      $params = func_get_args();
1022f8369d7dSTobias Sarnowski//      return new Callback($this->callback, $this->params+$params);
1023f8369d7dSTobias Sarnowski//  }
1024f8369d7dSTobias Sarnowski}
1025*a3095052SOscar Merida
1026f8369d7dSTobias Sarnowski/**
1027f8369d7dSTobias Sarnowski * Callback type which on execution returns reference passed during creation.
1028f8369d7dSTobias Sarnowski *
1029f8369d7dSTobias Sarnowski * @author Tobiasz Cudnik <tobiasz.cudnik/gmail.com>
1030f8369d7dSTobias Sarnowski */
1031f8369d7dSTobias Sarnowskiclass CallbackReturnReference extends Callback
1032f8369d7dSTobias Sarnowski    implements ICallbackNamed {
1033f8369d7dSTobias Sarnowski    protected $reference;
1034f8369d7dSTobias Sarnowski    public function __construct(&$reference, $name = null){
1035f8369d7dSTobias Sarnowski        $this->reference =& $reference;
1036f8369d7dSTobias Sarnowski        $this->callback = array($this, 'callback');
1037f8369d7dSTobias Sarnowski    }
1038f8369d7dSTobias Sarnowski    public function callback() {
1039f8369d7dSTobias Sarnowski        return $this->reference;
1040f8369d7dSTobias Sarnowski    }
1041f8369d7dSTobias Sarnowski    public function getName() {
1042f8369d7dSTobias Sarnowski        return 'Callback: '.$this->name;
1043f8369d7dSTobias Sarnowski    }
1044f8369d7dSTobias Sarnowski    public function hasName() {
1045f8369d7dSTobias Sarnowski        return isset($this->name) && $this->name;
1046f8369d7dSTobias Sarnowski    }
1047f8369d7dSTobias Sarnowski}
1048f8369d7dSTobias Sarnowski/**
1049f8369d7dSTobias Sarnowski * Callback type which on execution returns value passed during creation.
1050f8369d7dSTobias Sarnowski *
1051f8369d7dSTobias Sarnowski * @author Tobiasz Cudnik <tobiasz.cudnik/gmail.com>
1052f8369d7dSTobias Sarnowski */
1053f8369d7dSTobias Sarnowskiclass CallbackReturnValue extends Callback
1054f8369d7dSTobias Sarnowski    implements ICallbackNamed {
1055f8369d7dSTobias Sarnowski    protected $value;
1056f8369d7dSTobias Sarnowski    protected $name;
1057f8369d7dSTobias Sarnowski    public function __construct($value, $name = null){
1058f8369d7dSTobias Sarnowski        $this->value =& $value;
1059f8369d7dSTobias Sarnowski        $this->name = $name;
1060f8369d7dSTobias Sarnowski        $this->callback = array($this, 'callback');
1061f8369d7dSTobias Sarnowski    }
1062f8369d7dSTobias Sarnowski    public function callback() {
1063f8369d7dSTobias Sarnowski        return $this->value;
1064f8369d7dSTobias Sarnowski    }
1065f8369d7dSTobias Sarnowski    public function __toString() {
1066f8369d7dSTobias Sarnowski        return $this->getName();
1067f8369d7dSTobias Sarnowski    }
1068f8369d7dSTobias Sarnowski    public function getName() {
1069f8369d7dSTobias Sarnowski        return 'Callback: '.$this->name;
1070f8369d7dSTobias Sarnowski    }
1071f8369d7dSTobias Sarnowski    public function hasName() {
1072f8369d7dSTobias Sarnowski        return isset($this->name) && $this->name;
1073f8369d7dSTobias Sarnowski    }
1074f8369d7dSTobias Sarnowski}
1075f8369d7dSTobias Sarnowski/**
1076f8369d7dSTobias Sarnowski * CallbackParameterToReference can be used when we don't really want a callback,
1077f8369d7dSTobias Sarnowski * only parameter passed to it. CallbackParameterToReference takes first
1078f8369d7dSTobias Sarnowski * parameter's value and passes it to reference.
1079f8369d7dSTobias Sarnowski *
1080f8369d7dSTobias Sarnowski * @author Tobiasz Cudnik <tobiasz.cudnik/gmail.com>
1081f8369d7dSTobias Sarnowski */
1082f8369d7dSTobias Sarnowskiclass CallbackParameterToReference extends Callback {
1083f8369d7dSTobias Sarnowski    /**
1084f8369d7dSTobias Sarnowski     * @param $reference
1085f8369d7dSTobias Sarnowski     * @TODO implement $paramIndex;
1086f8369d7dSTobias Sarnowski     * param index choose which callback param will be passed to reference
1087f8369d7dSTobias Sarnowski     */
1088f8369d7dSTobias Sarnowski    public function __construct(&$reference){
1089f8369d7dSTobias Sarnowski        $this->callback =& $reference;
1090f8369d7dSTobias Sarnowski    }
1091f8369d7dSTobias Sarnowski}
1092f8369d7dSTobias Sarnowski//class CallbackReference extends Callback {
1093f8369d7dSTobias Sarnowski//  /**
1094f8369d7dSTobias Sarnowski//   *
1095f8369d7dSTobias Sarnowski//   * @param $reference
1096f8369d7dSTobias Sarnowski//   * @param $paramIndex
1097f8369d7dSTobias Sarnowski//   * @todo implement $paramIndex; param index choose which callback param will be passed to reference
1098f8369d7dSTobias Sarnowski//   */
1099f8369d7dSTobias Sarnowski//  public function __construct(&$reference, $name = null){
1100f8369d7dSTobias Sarnowski//      $this->callback =& $reference;
1101f8369d7dSTobias Sarnowski//  }
1102f8369d7dSTobias Sarnowski//}
1103f8369d7dSTobias Sarnowskiclass CallbackParam {}
1104f8369d7dSTobias Sarnowski
1105f8369d7dSTobias Sarnowski/**
1106f8369d7dSTobias Sarnowski * Class representing phpQuery objects.
1107f8369d7dSTobias Sarnowski *
1108f8369d7dSTobias Sarnowski * @author Tobiasz Cudnik <tobiasz.cudnik/gmail.com>
1109f8369d7dSTobias Sarnowski * @package phpQuery
1110f8369d7dSTobias Sarnowski * @method phpQueryObject clone() clone()
1111f8369d7dSTobias Sarnowski * @method phpQueryObject empty() empty()
1112f8369d7dSTobias Sarnowski * @method phpQueryObject next() next($selector = null)
1113f8369d7dSTobias Sarnowski * @method phpQueryObject prev() prev($selector = null)
1114f8369d7dSTobias Sarnowski * @property Int $length
1115f8369d7dSTobias Sarnowski */
1116f8369d7dSTobias Sarnowskiclass phpQueryObject
1117f8369d7dSTobias Sarnowski    implements Iterator, Countable, ArrayAccess {
1118f8369d7dSTobias Sarnowski    public $documentID = null;
1119f8369d7dSTobias Sarnowski    /**
1120f8369d7dSTobias Sarnowski     * DOMDocument class.
1121f8369d7dSTobias Sarnowski     *
1122f8369d7dSTobias Sarnowski     * @var DOMDocument
1123f8369d7dSTobias Sarnowski     */
1124f8369d7dSTobias Sarnowski    public $document = null;
1125f8369d7dSTobias Sarnowski    public $charset = null;
1126f8369d7dSTobias Sarnowski    /**
1127f8369d7dSTobias Sarnowski     *
1128f8369d7dSTobias Sarnowski     * @var DOMDocumentWrapper
1129f8369d7dSTobias Sarnowski     */
1130f8369d7dSTobias Sarnowski    public $documentWrapper = null;
1131f8369d7dSTobias Sarnowski    /**
1132f8369d7dSTobias Sarnowski     * XPath interface.
1133f8369d7dSTobias Sarnowski     *
1134f8369d7dSTobias Sarnowski     * @var DOMXPath
1135f8369d7dSTobias Sarnowski     */
1136f8369d7dSTobias Sarnowski    public $xpath = null;
1137f8369d7dSTobias Sarnowski    /**
1138f8369d7dSTobias Sarnowski     * Stack of selected elements.
1139f8369d7dSTobias Sarnowski     * @TODO refactor to ->nodes
1140f8369d7dSTobias Sarnowski     * @var array
1141f8369d7dSTobias Sarnowski     */
1142f8369d7dSTobias Sarnowski    public $elements = array();
1143f8369d7dSTobias Sarnowski    /**
1144f8369d7dSTobias Sarnowski     * @access private
1145f8369d7dSTobias Sarnowski     */
1146f8369d7dSTobias Sarnowski    protected $elementsBackup = array();
1147f8369d7dSTobias Sarnowski    /**
1148f8369d7dSTobias Sarnowski     * @access private
1149f8369d7dSTobias Sarnowski     */
1150f8369d7dSTobias Sarnowski    protected $previous = null;
1151f8369d7dSTobias Sarnowski    /**
1152f8369d7dSTobias Sarnowski     * @access private
1153f8369d7dSTobias Sarnowski     * @TODO deprecate
1154f8369d7dSTobias Sarnowski     */
1155f8369d7dSTobias Sarnowski    protected $root = array();
1156f8369d7dSTobias Sarnowski    /**
1157f8369d7dSTobias Sarnowski     * Indicated if doument is just a fragment (no <html> tag).
1158f8369d7dSTobias Sarnowski     *
1159f8369d7dSTobias Sarnowski     * Every document is realy a full document, so even documentFragments can
1160f8369d7dSTobias Sarnowski     * be queried against <html>, but getDocument(id)->htmlOuter() will return
1161f8369d7dSTobias Sarnowski     * only contents of <body>.
1162f8369d7dSTobias Sarnowski     *
1163f8369d7dSTobias Sarnowski     * @var bool
1164f8369d7dSTobias Sarnowski     */
1165f8369d7dSTobias Sarnowski    public $documentFragment = true;
1166f8369d7dSTobias Sarnowski    /**
1167f8369d7dSTobias Sarnowski     * Iterator interface helper
1168f8369d7dSTobias Sarnowski     * @access private
1169f8369d7dSTobias Sarnowski     */
1170f8369d7dSTobias Sarnowski    protected $elementsInterator = array();
1171f8369d7dSTobias Sarnowski    /**
1172f8369d7dSTobias Sarnowski     * Iterator interface helper
1173f8369d7dSTobias Sarnowski     * @access private
1174f8369d7dSTobias Sarnowski     */
1175f8369d7dSTobias Sarnowski    protected $valid = false;
1176f8369d7dSTobias Sarnowski    /**
1177f8369d7dSTobias Sarnowski     * Iterator interface helper
1178f8369d7dSTobias Sarnowski     * @access private
1179f8369d7dSTobias Sarnowski     */
1180f8369d7dSTobias Sarnowski    protected $current = null;
1181f8369d7dSTobias Sarnowski    /**
1182f8369d7dSTobias Sarnowski     * Enter description here...
1183f8369d7dSTobias Sarnowski     *
1184f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
1185f8369d7dSTobias Sarnowski     */
1186f8369d7dSTobias Sarnowski    public function __construct($documentID) {
1187f8369d7dSTobias Sarnowski//      if ($documentID instanceof self)
1188f8369d7dSTobias Sarnowski//          var_dump($documentID->getDocumentID());
1189f8369d7dSTobias Sarnowski        $id = $documentID instanceof self
1190f8369d7dSTobias Sarnowski            ? $documentID->getDocumentID()
1191f8369d7dSTobias Sarnowski            : $documentID;
1192f8369d7dSTobias Sarnowski//      var_dump($id);
1193f8369d7dSTobias Sarnowski        if (! isset(phpQuery::$documents[$id] )) {
1194f8369d7dSTobias Sarnowski//          var_dump(phpQuery::$documents);
1195f8369d7dSTobias Sarnowski            throw new Exception("Document with ID '{$id}' isn't loaded. Use phpQuery::newDocument(\$html) or phpQuery::newDocumentFile(\$file) first.");
1196f8369d7dSTobias Sarnowski        }
1197f8369d7dSTobias Sarnowski        $this->documentID = $id;
1198f8369d7dSTobias Sarnowski        $this->documentWrapper =& phpQuery::$documents[$id];
1199f8369d7dSTobias Sarnowski        $this->document =& $this->documentWrapper->document;
1200f8369d7dSTobias Sarnowski        $this->xpath =& $this->documentWrapper->xpath;
1201f8369d7dSTobias Sarnowski        $this->charset =& $this->documentWrapper->charset;
1202f8369d7dSTobias Sarnowski        $this->documentFragment =& $this->documentWrapper->isDocumentFragment;
1203f8369d7dSTobias Sarnowski        // TODO check $this->DOM->documentElement;
1204f8369d7dSTobias Sarnowski//      $this->root = $this->document->documentElement;
1205f8369d7dSTobias Sarnowski        $this->root =& $this->documentWrapper->root;
1206f8369d7dSTobias Sarnowski//      $this->toRoot();
1207f8369d7dSTobias Sarnowski        $this->elements = array($this->root);
1208f8369d7dSTobias Sarnowski    }
1209f8369d7dSTobias Sarnowski    /**
1210f8369d7dSTobias Sarnowski     *
1211f8369d7dSTobias Sarnowski     * @access private
1212f8369d7dSTobias Sarnowski     * @param $attr
1213f8369d7dSTobias Sarnowski     * @return unknown_type
1214f8369d7dSTobias Sarnowski     */
1215f8369d7dSTobias Sarnowski    public function __get($attr) {
1216f8369d7dSTobias Sarnowski        switch($attr) {
1217f8369d7dSTobias Sarnowski            // FIXME doesnt work at all ?
1218f8369d7dSTobias Sarnowski            case 'length':
1219f8369d7dSTobias Sarnowski                return $this->size();
1220f8369d7dSTobias Sarnowski            break;
1221f8369d7dSTobias Sarnowski            default:
1222f8369d7dSTobias Sarnowski                return $this->$attr;
1223f8369d7dSTobias Sarnowski        }
1224f8369d7dSTobias Sarnowski    }
1225f8369d7dSTobias Sarnowski    /**
1226f8369d7dSTobias Sarnowski     * Saves actual object to $var by reference.
1227f8369d7dSTobias Sarnowski     * Useful when need to break chain.
1228f8369d7dSTobias Sarnowski     * @param phpQueryObject $var
1229f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
1230f8369d7dSTobias Sarnowski     */
1231f8369d7dSTobias Sarnowski    public function toReference(&$var) {
1232f8369d7dSTobias Sarnowski        return $var = $this;
1233f8369d7dSTobias Sarnowski    }
1234f8369d7dSTobias Sarnowski    public function documentFragment($state = null) {
1235f8369d7dSTobias Sarnowski        if ($state) {
1236f8369d7dSTobias Sarnowski            phpQuery::$documents[$this->getDocumentID()]['documentFragment'] = $state;
1237f8369d7dSTobias Sarnowski            return $this;
1238f8369d7dSTobias Sarnowski        }
1239f8369d7dSTobias Sarnowski        return $this->documentFragment;
1240f8369d7dSTobias Sarnowski    }
1241f8369d7dSTobias Sarnowski    /**
1242f8369d7dSTobias Sarnowski   * @access private
1243f8369d7dSTobias Sarnowski   * @TODO documentWrapper
1244f8369d7dSTobias Sarnowski     */
1245f8369d7dSTobias Sarnowski    protected function isRoot( $node) {
1246f8369d7dSTobias Sarnowski//      return $node instanceof DOMDOCUMENT || $node->tagName == 'html';
1247f8369d7dSTobias Sarnowski        return $node instanceof DOMDOCUMENT
1248f8369d7dSTobias Sarnowski            || ($node instanceof DOMELEMENT && $node->tagName == 'html')
1249f8369d7dSTobias Sarnowski            || $this->root->isSameNode($node);
1250f8369d7dSTobias Sarnowski    }
1251f8369d7dSTobias Sarnowski    /**
1252f8369d7dSTobias Sarnowski   * @access private
1253f8369d7dSTobias Sarnowski     */
1254f8369d7dSTobias Sarnowski    protected function stackIsRoot() {
1255f8369d7dSTobias Sarnowski        return $this->size() == 1 && $this->isRoot($this->elements[0]);
1256f8369d7dSTobias Sarnowski    }
1257f8369d7dSTobias Sarnowski    /**
1258f8369d7dSTobias Sarnowski     * Enter description here...
1259f8369d7dSTobias Sarnowski     * NON JQUERY METHOD
1260f8369d7dSTobias Sarnowski     *
1261f8369d7dSTobias Sarnowski     * Watch out, it doesn't creates new instance, can be reverted with end().
1262f8369d7dSTobias Sarnowski     *
1263f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
1264f8369d7dSTobias Sarnowski     */
1265f8369d7dSTobias Sarnowski    public function toRoot() {
1266f8369d7dSTobias Sarnowski        $this->elements = array($this->root);
1267f8369d7dSTobias Sarnowski        return $this;
1268f8369d7dSTobias Sarnowski//      return $this->newInstance(array($this->root));
1269f8369d7dSTobias Sarnowski    }
1270f8369d7dSTobias Sarnowski    /**
1271f8369d7dSTobias Sarnowski     * Saves object's DocumentID to $var by reference.
1272f8369d7dSTobias Sarnowski     * <code>
1273f8369d7dSTobias Sarnowski     * $myDocumentId;
1274f8369d7dSTobias Sarnowski     * phpQuery::newDocument('<div/>')
1275f8369d7dSTobias Sarnowski     *     ->getDocumentIDRef($myDocumentId)
1276f8369d7dSTobias Sarnowski     *     ->find('div')->...
1277f8369d7dSTobias Sarnowski     * </code>
1278f8369d7dSTobias Sarnowski     *
1279f8369d7dSTobias Sarnowski     * @param unknown_type $domId
1280f8369d7dSTobias Sarnowski     * @see phpQuery::newDocument
1281f8369d7dSTobias Sarnowski     * @see phpQuery::newDocumentFile
1282f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
1283f8369d7dSTobias Sarnowski     */
1284f8369d7dSTobias Sarnowski    public function getDocumentIDRef(&$documentID) {
1285f8369d7dSTobias Sarnowski        $documentID = $this->getDocumentID();
1286f8369d7dSTobias Sarnowski        return $this;
1287f8369d7dSTobias Sarnowski    }
1288f8369d7dSTobias Sarnowski    /**
1289f8369d7dSTobias Sarnowski     * Returns object with stack set to document root.
1290f8369d7dSTobias Sarnowski     *
1291f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
1292f8369d7dSTobias Sarnowski     */
1293f8369d7dSTobias Sarnowski    public function getDocument() {
1294f8369d7dSTobias Sarnowski        return phpQuery::getDocument($this->getDocumentID());
1295f8369d7dSTobias Sarnowski    }
1296f8369d7dSTobias Sarnowski    /**
1297f8369d7dSTobias Sarnowski     *
1298f8369d7dSTobias Sarnowski     * @return DOMDocument
1299f8369d7dSTobias Sarnowski     */
1300f8369d7dSTobias Sarnowski    public function getDOMDocument() {
1301f8369d7dSTobias Sarnowski        return $this->document;
1302f8369d7dSTobias Sarnowski    }
1303f8369d7dSTobias Sarnowski    /**
1304f8369d7dSTobias Sarnowski     * Get object's Document ID.
1305f8369d7dSTobias Sarnowski     *
1306f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
1307f8369d7dSTobias Sarnowski     */
1308f8369d7dSTobias Sarnowski    public function getDocumentID() {
1309f8369d7dSTobias Sarnowski        return $this->documentID;
1310f8369d7dSTobias Sarnowski    }
1311f8369d7dSTobias Sarnowski    /**
1312f8369d7dSTobias Sarnowski     * Unloads whole document from memory.
1313f8369d7dSTobias Sarnowski     * CAUTION! None further operations will be possible on this document.
1314f8369d7dSTobias Sarnowski     * All objects refering to it will be useless.
1315f8369d7dSTobias Sarnowski     *
1316f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
1317f8369d7dSTobias Sarnowski     */
1318f8369d7dSTobias Sarnowski    public function unloadDocument() {
1319f8369d7dSTobias Sarnowski        phpQuery::unloadDocuments($this->getDocumentID());
1320f8369d7dSTobias Sarnowski    }
1321f8369d7dSTobias Sarnowski    public function isHTML() {
1322f8369d7dSTobias Sarnowski        return $this->documentWrapper->isHTML;
1323f8369d7dSTobias Sarnowski    }
1324f8369d7dSTobias Sarnowski    public function isXHTML() {
1325f8369d7dSTobias Sarnowski        return $this->documentWrapper->isXHTML;
1326f8369d7dSTobias Sarnowski    }
1327f8369d7dSTobias Sarnowski    public function isXML() {
1328f8369d7dSTobias Sarnowski        return $this->documentWrapper->isXML;
1329f8369d7dSTobias Sarnowski    }
1330f8369d7dSTobias Sarnowski    /**
1331f8369d7dSTobias Sarnowski     * Enter description here...
1332f8369d7dSTobias Sarnowski     *
1333f8369d7dSTobias Sarnowski     * @link http://docs.jquery.com/Ajax/serialize
1334f8369d7dSTobias Sarnowski     * @return string
1335f8369d7dSTobias Sarnowski     */
1336f8369d7dSTobias Sarnowski    public function serialize() {
1337f8369d7dSTobias Sarnowski        return phpQuery::param($this->serializeArray());
1338f8369d7dSTobias Sarnowski    }
1339f8369d7dSTobias Sarnowski    /**
1340f8369d7dSTobias Sarnowski     * Enter description here...
1341f8369d7dSTobias Sarnowski     *
1342f8369d7dSTobias Sarnowski     * @link http://docs.jquery.com/Ajax/serializeArray
1343f8369d7dSTobias Sarnowski     * @return array
1344f8369d7dSTobias Sarnowski     */
1345f8369d7dSTobias Sarnowski    public function serializeArray($submit = null) {
1346f8369d7dSTobias Sarnowski        $source = $this->filter('form, input, select, textarea')
1347f8369d7dSTobias Sarnowski            ->find('input, select, textarea')
1348f8369d7dSTobias Sarnowski            ->andSelf()
1349f8369d7dSTobias Sarnowski            ->not('form');
1350f8369d7dSTobias Sarnowski        $return = array();
1351f8369d7dSTobias Sarnowski//      $source->dumpDie();
1352f8369d7dSTobias Sarnowski        foreach($source as $input) {
1353f8369d7dSTobias Sarnowski            $input = phpQuery::pq($input);
1354f8369d7dSTobias Sarnowski            if ($input->is('[disabled]'))
1355f8369d7dSTobias Sarnowski                continue;
1356f8369d7dSTobias Sarnowski            if (!$input->is('[name]'))
1357f8369d7dSTobias Sarnowski                continue;
1358f8369d7dSTobias Sarnowski            if ($input->is('[type=checkbox]') && !$input->is('[checked]'))
1359f8369d7dSTobias Sarnowski                continue;
1360f8369d7dSTobias Sarnowski            // jquery diff
1361f8369d7dSTobias Sarnowski            if ($submit && $input->is('[type=submit]')) {
1362f8369d7dSTobias Sarnowski                if ($submit instanceof DOMELEMENT && ! $input->elements[0]->isSameNode($submit))
1363f8369d7dSTobias Sarnowski                    continue;
1364f8369d7dSTobias Sarnowski                else if (is_string($submit) && $input->attr('name') != $submit)
1365f8369d7dSTobias Sarnowski                    continue;
1366f8369d7dSTobias Sarnowski            }
1367f8369d7dSTobias Sarnowski            $return[] = array(
1368f8369d7dSTobias Sarnowski                'name' => $input->attr('name'),
1369f8369d7dSTobias Sarnowski                'value' => $input->val(),
1370f8369d7dSTobias Sarnowski            );
1371f8369d7dSTobias Sarnowski        }
1372f8369d7dSTobias Sarnowski        return $return;
1373f8369d7dSTobias Sarnowski    }
1374f8369d7dSTobias Sarnowski    /**
1375f8369d7dSTobias Sarnowski     * @access private
1376f8369d7dSTobias Sarnowski     */
1377f8369d7dSTobias Sarnowski    protected function debug($in) {
1378f8369d7dSTobias Sarnowski        if (! phpQuery::$debug )
1379f8369d7dSTobias Sarnowski            return;
1380f8369d7dSTobias Sarnowski        print('<pre>');
1381f8369d7dSTobias Sarnowski        print_r($in);
1382f8369d7dSTobias Sarnowski        // file debug
1383f8369d7dSTobias Sarnowski//      file_put_contents(dirname(__FILE__).'/phpQuery.log', print_r($in, true)."\n", FILE_APPEND);
1384f8369d7dSTobias Sarnowski        // quite handy debug trace
1385f8369d7dSTobias Sarnowski//      if ( is_array($in))
1386f8369d7dSTobias Sarnowski//          print_r(array_slice(debug_backtrace(), 3));
1387f8369d7dSTobias Sarnowski        print("</pre>\n");
1388f8369d7dSTobias Sarnowski    }
1389f8369d7dSTobias Sarnowski    /**
1390f8369d7dSTobias Sarnowski     * @access private
1391f8369d7dSTobias Sarnowski     */
1392f8369d7dSTobias Sarnowski    protected function isRegexp($pattern) {
1393f8369d7dSTobias Sarnowski        return in_array(
1394f8369d7dSTobias Sarnowski            $pattern[ mb_strlen($pattern)-1 ],
1395f8369d7dSTobias Sarnowski            array('^','*','$')
1396f8369d7dSTobias Sarnowski        );
1397f8369d7dSTobias Sarnowski    }
1398f8369d7dSTobias Sarnowski    /**
1399f8369d7dSTobias Sarnowski     * Determines if $char is really a char.
1400f8369d7dSTobias Sarnowski     *
1401f8369d7dSTobias Sarnowski     * @param string $char
1402f8369d7dSTobias Sarnowski     * @return bool
1403f8369d7dSTobias Sarnowski     * @todo rewrite me to charcode range ! ;)
1404f8369d7dSTobias Sarnowski     * @access private
1405f8369d7dSTobias Sarnowski     */
1406f8369d7dSTobias Sarnowski    protected function isChar($char) {
1407f8369d7dSTobias Sarnowski        return extension_loaded('mbstring') && phpQuery::$mbstringSupport
1408f8369d7dSTobias Sarnowski            ? mb_eregi('\w', $char)
1409f8369d7dSTobias Sarnowski            : preg_match('@\w@', $char);
1410f8369d7dSTobias Sarnowski    }
1411f8369d7dSTobias Sarnowski    /**
1412f8369d7dSTobias Sarnowski     * @access private
1413f8369d7dSTobias Sarnowski     */
1414f8369d7dSTobias Sarnowski    protected function parseSelector($query) {
1415f8369d7dSTobias Sarnowski        // clean spaces
1416f8369d7dSTobias Sarnowski        // TODO include this inside parsing ?
1417f8369d7dSTobias Sarnowski        $query = trim(
1418f8369d7dSTobias Sarnowski            preg_replace('@\s+@', ' ',
1419f8369d7dSTobias Sarnowski                preg_replace('@\s*(>|\\+|~)\s*@', '\\1', $query)
1420f8369d7dSTobias Sarnowski            )
1421f8369d7dSTobias Sarnowski        );
1422f8369d7dSTobias Sarnowski        $queries = array(array());
1423f8369d7dSTobias Sarnowski        if (! $query)
1424f8369d7dSTobias Sarnowski            return $queries;
1425f8369d7dSTobias Sarnowski        $return =& $queries[0];
1426f8369d7dSTobias Sarnowski        $specialChars = array('>',' ');
1427f8369d7dSTobias Sarnowski//      $specialCharsMapping = array('/' => '>');
1428f8369d7dSTobias Sarnowski        $specialCharsMapping = array();
1429f8369d7dSTobias Sarnowski        $strlen = mb_strlen($query);
1430f8369d7dSTobias Sarnowski        $classChars = array('.', '-');
1431f8369d7dSTobias Sarnowski        $pseudoChars = array('-');
1432f8369d7dSTobias Sarnowski        $tagChars = array('*', '|', '-');
1433f8369d7dSTobias Sarnowski        // split multibyte string
1434f8369d7dSTobias Sarnowski        // http://code.google.com/p/phpquery/issues/detail?id=76
1435f8369d7dSTobias Sarnowski        $_query = array();
1436f8369d7dSTobias Sarnowski        for ($i=0; $i<$strlen; $i++)
1437f8369d7dSTobias Sarnowski            $_query[] = mb_substr($query, $i, 1);
1438f8369d7dSTobias Sarnowski        $query = $_query;
1439f8369d7dSTobias Sarnowski        // it works, but i dont like it...
1440f8369d7dSTobias Sarnowski        $i = 0;
1441f8369d7dSTobias Sarnowski        while( $i < $strlen) {
1442f8369d7dSTobias Sarnowski            $c = $query[$i];
1443f8369d7dSTobias Sarnowski            $tmp = '';
1444f8369d7dSTobias Sarnowski            // TAG
1445f8369d7dSTobias Sarnowski            if ($this->isChar($c) || in_array($c, $tagChars)) {
1446f8369d7dSTobias Sarnowski                while(isset($query[$i])
1447f8369d7dSTobias Sarnowski                    && ($this->isChar($query[$i]) || in_array($query[$i], $tagChars))) {
1448f8369d7dSTobias Sarnowski                    $tmp .= $query[$i];
1449f8369d7dSTobias Sarnowski                    $i++;
1450f8369d7dSTobias Sarnowski                }
1451f8369d7dSTobias Sarnowski                $return[] = $tmp;
1452f8369d7dSTobias Sarnowski            // IDs
1453f8369d7dSTobias Sarnowski            } else if ( $c == '#') {
1454f8369d7dSTobias Sarnowski                $i++;
1455f8369d7dSTobias Sarnowski                while( isset($query[$i]) && ($this->isChar($query[$i]) || $query[$i] == '-')) {
1456f8369d7dSTobias Sarnowski                    $tmp .= $query[$i];
1457f8369d7dSTobias Sarnowski                    $i++;
1458f8369d7dSTobias Sarnowski                }
1459f8369d7dSTobias Sarnowski                $return[] = '#'.$tmp;
1460f8369d7dSTobias Sarnowski            // SPECIAL CHARS
1461f8369d7dSTobias Sarnowski            } else if (in_array($c, $specialChars)) {
1462f8369d7dSTobias Sarnowski                $return[] = $c;
1463f8369d7dSTobias Sarnowski                $i++;
1464f8369d7dSTobias Sarnowski            // MAPPED SPECIAL MULTICHARS
1465f8369d7dSTobias Sarnowski//          } else if ( $c.$query[$i+1] == '//') {
1466f8369d7dSTobias Sarnowski//              $return[] = ' ';
1467f8369d7dSTobias Sarnowski//              $i = $i+2;
1468f8369d7dSTobias Sarnowski            // MAPPED SPECIAL CHARS
1469f8369d7dSTobias Sarnowski            } else if ( isset($specialCharsMapping[$c])) {
1470f8369d7dSTobias Sarnowski                $return[] = $specialCharsMapping[$c];
1471f8369d7dSTobias Sarnowski                $i++;
1472f8369d7dSTobias Sarnowski            // COMMA
1473f8369d7dSTobias Sarnowski            } else if ( $c == ',') {
1474f8369d7dSTobias Sarnowski                $queries[] = array();
1475f8369d7dSTobias Sarnowski                $return =& $queries[ count($queries)-1 ];
1476f8369d7dSTobias Sarnowski                $i++;
1477f8369d7dSTobias Sarnowski                while( isset($query[$i]) && $query[$i] == ' ')
1478f8369d7dSTobias Sarnowski                    $i++;
1479f8369d7dSTobias Sarnowski            // CLASSES
1480f8369d7dSTobias Sarnowski            } else if ($c == '.') {
1481f8369d7dSTobias Sarnowski                while( isset($query[$i]) && ($this->isChar($query[$i]) || in_array($query[$i], $classChars))) {
1482f8369d7dSTobias Sarnowski                    $tmp .= $query[$i];
1483f8369d7dSTobias Sarnowski                    $i++;
1484f8369d7dSTobias Sarnowski                }
1485f8369d7dSTobias Sarnowski                $return[] = $tmp;
1486f8369d7dSTobias Sarnowski            // ~ General Sibling Selector
1487f8369d7dSTobias Sarnowski            } else if ($c == '~') {
1488f8369d7dSTobias Sarnowski                $spaceAllowed = true;
1489f8369d7dSTobias Sarnowski                $tmp .= $query[$i++];
1490f8369d7dSTobias Sarnowski                while( isset($query[$i])
1491f8369d7dSTobias Sarnowski                    && ($this->isChar($query[$i])
1492f8369d7dSTobias Sarnowski                        || in_array($query[$i], $classChars)
1493f8369d7dSTobias Sarnowski                        || $query[$i] == '*'
1494f8369d7dSTobias Sarnowski                        || ($query[$i] == ' ' && $spaceAllowed)
1495f8369d7dSTobias Sarnowski                    )) {
1496f8369d7dSTobias Sarnowski                    if ($query[$i] != ' ')
1497f8369d7dSTobias Sarnowski                        $spaceAllowed = false;
1498f8369d7dSTobias Sarnowski                    $tmp .= $query[$i];
1499f8369d7dSTobias Sarnowski                    $i++;
1500f8369d7dSTobias Sarnowski                }
1501f8369d7dSTobias Sarnowski                $return[] = $tmp;
1502f8369d7dSTobias Sarnowski            // + Adjacent sibling selectors
1503f8369d7dSTobias Sarnowski            } else if ($c == '+') {
1504f8369d7dSTobias Sarnowski                $spaceAllowed = true;
1505f8369d7dSTobias Sarnowski                $tmp .= $query[$i++];
1506f8369d7dSTobias Sarnowski                while( isset($query[$i])
1507f8369d7dSTobias Sarnowski                    && ($this->isChar($query[$i])
1508f8369d7dSTobias Sarnowski                        || in_array($query[$i], $classChars)
1509f8369d7dSTobias Sarnowski                        || $query[$i] == '*'
1510f8369d7dSTobias Sarnowski                        || ($spaceAllowed && $query[$i] == ' ')
1511f8369d7dSTobias Sarnowski                    )) {
1512f8369d7dSTobias Sarnowski                    if ($query[$i] != ' ')
1513f8369d7dSTobias Sarnowski                        $spaceAllowed = false;
1514f8369d7dSTobias Sarnowski                    $tmp .= $query[$i];
1515f8369d7dSTobias Sarnowski                    $i++;
1516f8369d7dSTobias Sarnowski                }
1517f8369d7dSTobias Sarnowski                $return[] = $tmp;
1518f8369d7dSTobias Sarnowski            // ATTRS
1519f8369d7dSTobias Sarnowski            } else if ($c == '[') {
1520f8369d7dSTobias Sarnowski                $stack = 1;
1521f8369d7dSTobias Sarnowski                $tmp .= $c;
1522f8369d7dSTobias Sarnowski                while( isset($query[++$i])) {
1523f8369d7dSTobias Sarnowski                    $tmp .= $query[$i];
1524f8369d7dSTobias Sarnowski                    if ( $query[$i] == '[') {
1525f8369d7dSTobias Sarnowski                        $stack++;
1526f8369d7dSTobias Sarnowski                    } else if ( $query[$i] == ']') {
1527f8369d7dSTobias Sarnowski                        $stack--;
1528f8369d7dSTobias Sarnowski                        if (! $stack )
1529f8369d7dSTobias Sarnowski                            break;
1530f8369d7dSTobias Sarnowski                    }
1531f8369d7dSTobias Sarnowski                }
1532f8369d7dSTobias Sarnowski                $return[] = $tmp;
1533f8369d7dSTobias Sarnowski                $i++;
1534f8369d7dSTobias Sarnowski            // PSEUDO CLASSES
1535f8369d7dSTobias Sarnowski            } else if ($c == ':') {
1536f8369d7dSTobias Sarnowski                $stack = 1;
1537f8369d7dSTobias Sarnowski                $tmp .= $query[$i++];
1538f8369d7dSTobias Sarnowski                while( isset($query[$i]) && ($this->isChar($query[$i]) || in_array($query[$i], $pseudoChars))) {
1539f8369d7dSTobias Sarnowski                    $tmp .= $query[$i];
1540f8369d7dSTobias Sarnowski                    $i++;
1541f8369d7dSTobias Sarnowski                }
1542f8369d7dSTobias Sarnowski                // with arguments ?
1543f8369d7dSTobias Sarnowski                if ( isset($query[$i]) && $query[$i] == '(') {
1544f8369d7dSTobias Sarnowski                    $tmp .= $query[$i];
1545f8369d7dSTobias Sarnowski                    $stack = 1;
1546f8369d7dSTobias Sarnowski                    while( isset($query[++$i])) {
1547f8369d7dSTobias Sarnowski                        $tmp .= $query[$i];
1548f8369d7dSTobias Sarnowski                        if ( $query[$i] == '(') {
1549f8369d7dSTobias Sarnowski                            $stack++;
1550f8369d7dSTobias Sarnowski                        } else if ( $query[$i] == ')') {
1551f8369d7dSTobias Sarnowski                            $stack--;
1552f8369d7dSTobias Sarnowski                            if (! $stack )
1553f8369d7dSTobias Sarnowski                                break;
1554f8369d7dSTobias Sarnowski                        }
1555f8369d7dSTobias Sarnowski                    }
1556f8369d7dSTobias Sarnowski                    $return[] = $tmp;
1557f8369d7dSTobias Sarnowski                    $i++;
1558f8369d7dSTobias Sarnowski                } else {
1559f8369d7dSTobias Sarnowski                    $return[] = $tmp;
1560f8369d7dSTobias Sarnowski                }
1561f8369d7dSTobias Sarnowski            } else {
1562f8369d7dSTobias Sarnowski                $i++;
1563f8369d7dSTobias Sarnowski            }
1564f8369d7dSTobias Sarnowski        }
1565f8369d7dSTobias Sarnowski        foreach($queries as $k => $q) {
1566f8369d7dSTobias Sarnowski            if (isset($q[0])) {
1567f8369d7dSTobias Sarnowski                if (isset($q[0][0]) && $q[0][0] == ':')
1568f8369d7dSTobias Sarnowski                    array_unshift($queries[$k], '*');
1569f8369d7dSTobias Sarnowski                if ($q[0] != '>')
1570f8369d7dSTobias Sarnowski                    array_unshift($queries[$k], ' ');
1571f8369d7dSTobias Sarnowski            }
1572f8369d7dSTobias Sarnowski        }
1573f8369d7dSTobias Sarnowski        return $queries;
1574f8369d7dSTobias Sarnowski    }
1575f8369d7dSTobias Sarnowski    /**
1576f8369d7dSTobias Sarnowski     * Return matched DOM nodes.
1577f8369d7dSTobias Sarnowski     *
1578f8369d7dSTobias Sarnowski     * @param int $index
1579f8369d7dSTobias Sarnowski     * @return array|DOMElement Single DOMElement or array of DOMElement.
1580f8369d7dSTobias Sarnowski     */
1581f8369d7dSTobias Sarnowski    public function get($index = null, $callback1 = null, $callback2 = null, $callback3 = null) {
1582f8369d7dSTobias Sarnowski        $return = isset($index)
1583f8369d7dSTobias Sarnowski            ? (isset($this->elements[$index]) ? $this->elements[$index] : null)
1584f8369d7dSTobias Sarnowski            : $this->elements;
1585f8369d7dSTobias Sarnowski        // pass thou callbacks
1586f8369d7dSTobias Sarnowski        $args = func_get_args();
1587f8369d7dSTobias Sarnowski        $args = array_slice($args, 1);
1588f8369d7dSTobias Sarnowski        foreach($args as $callback) {
1589f8369d7dSTobias Sarnowski            if (is_array($return))
1590f8369d7dSTobias Sarnowski                foreach($return as $k => $v)
1591f8369d7dSTobias Sarnowski                    $return[$k] = phpQuery::callbackRun($callback, array($v));
1592f8369d7dSTobias Sarnowski            else
1593f8369d7dSTobias Sarnowski                $return = phpQuery::callbackRun($callback, array($return));
1594f8369d7dSTobias Sarnowski        }
1595f8369d7dSTobias Sarnowski        return $return;
1596f8369d7dSTobias Sarnowski    }
1597f8369d7dSTobias Sarnowski    /**
1598f8369d7dSTobias Sarnowski     * Return matched DOM nodes.
1599f8369d7dSTobias Sarnowski     * jQuery difference.
1600f8369d7dSTobias Sarnowski     *
1601f8369d7dSTobias Sarnowski     * @param int $index
1602f8369d7dSTobias Sarnowski     * @return array|string Returns string if $index != null
1603f8369d7dSTobias Sarnowski     * @todo implement callbacks
1604f8369d7dSTobias Sarnowski     * @todo return only arrays ?
1605f8369d7dSTobias Sarnowski     * @todo maybe other name...
1606f8369d7dSTobias Sarnowski     */
1607f8369d7dSTobias Sarnowski    public function getString($index = null, $callback1 = null, $callback2 = null, $callback3 = null) {
1608f8369d7dSTobias Sarnowski        if ($index)
1609f8369d7dSTobias Sarnowski            $return = $this->eq($index)->text();
1610f8369d7dSTobias Sarnowski        else {
1611f8369d7dSTobias Sarnowski            $return = array();
1612f8369d7dSTobias Sarnowski            for($i = 0; $i < $this->size(); $i++) {
1613f8369d7dSTobias Sarnowski                $return[] = $this->eq($i)->text();
1614f8369d7dSTobias Sarnowski            }
1615f8369d7dSTobias Sarnowski        }
1616f8369d7dSTobias Sarnowski        // pass thou callbacks
1617f8369d7dSTobias Sarnowski        $args = func_get_args();
1618f8369d7dSTobias Sarnowski        $args = array_slice($args, 1);
1619f8369d7dSTobias Sarnowski        foreach($args as $callback) {
1620f8369d7dSTobias Sarnowski            $return = phpQuery::callbackRun($callback, array($return));
1621f8369d7dSTobias Sarnowski        }
1622f8369d7dSTobias Sarnowski        return $return;
1623f8369d7dSTobias Sarnowski    }
1624f8369d7dSTobias Sarnowski    /**
1625f8369d7dSTobias Sarnowski     * Return matched DOM nodes.
1626f8369d7dSTobias Sarnowski     * jQuery difference.
1627f8369d7dSTobias Sarnowski     *
1628f8369d7dSTobias Sarnowski     * @param int $index
1629f8369d7dSTobias Sarnowski     * @return array|string Returns string if $index != null
1630f8369d7dSTobias Sarnowski     * @todo implement callbacks
1631f8369d7dSTobias Sarnowski     * @todo return only arrays ?
1632f8369d7dSTobias Sarnowski     * @todo maybe other name...
1633f8369d7dSTobias Sarnowski     */
1634f8369d7dSTobias Sarnowski    public function getStrings($index = null, $callback1 = null, $callback2 = null, $callback3 = null) {
1635f8369d7dSTobias Sarnowski        if ($index)
1636f8369d7dSTobias Sarnowski            $return = $this->eq($index)->text();
1637f8369d7dSTobias Sarnowski        else {
1638f8369d7dSTobias Sarnowski            $return = array();
1639f8369d7dSTobias Sarnowski            for($i = 0; $i < $this->size(); $i++) {
1640f8369d7dSTobias Sarnowski                $return[] = $this->eq($i)->text();
1641f8369d7dSTobias Sarnowski            }
1642f8369d7dSTobias Sarnowski            // pass thou callbacks
1643f8369d7dSTobias Sarnowski            $args = func_get_args();
1644f8369d7dSTobias Sarnowski            $args = array_slice($args, 1);
1645f8369d7dSTobias Sarnowski        }
1646f8369d7dSTobias Sarnowski        foreach($args as $callback) {
1647f8369d7dSTobias Sarnowski            if (is_array($return))
1648f8369d7dSTobias Sarnowski                foreach($return as $k => $v)
1649f8369d7dSTobias Sarnowski                    $return[$k] = phpQuery::callbackRun($callback, array($v));
1650f8369d7dSTobias Sarnowski            else
1651f8369d7dSTobias Sarnowski                $return = phpQuery::callbackRun($callback, array($return));
1652f8369d7dSTobias Sarnowski        }
1653f8369d7dSTobias Sarnowski        return $return;
1654f8369d7dSTobias Sarnowski    }
1655f8369d7dSTobias Sarnowski    /**
1656f8369d7dSTobias Sarnowski     * Returns new instance of actual class.
1657f8369d7dSTobias Sarnowski     *
1658f8369d7dSTobias Sarnowski     * @param array $newStack Optional. Will replace old stack with new and move old one to history.c
1659f8369d7dSTobias Sarnowski     */
1660f8369d7dSTobias Sarnowski    public function newInstance($newStack = null) {
1661f8369d7dSTobias Sarnowski        $class = get_class($this);
1662f8369d7dSTobias Sarnowski        // support inheritance by passing old object to overloaded constructor
1663f8369d7dSTobias Sarnowski        $new = $class != 'phpQuery'
1664f8369d7dSTobias Sarnowski            ? new $class($this, $this->getDocumentID())
1665f8369d7dSTobias Sarnowski            : new phpQueryObject($this->getDocumentID());
1666f8369d7dSTobias Sarnowski        $new->previous = $this;
1667f8369d7dSTobias Sarnowski        if (is_null($newStack)) {
1668f8369d7dSTobias Sarnowski            $new->elements = $this->elements;
1669f8369d7dSTobias Sarnowski            if ($this->elementsBackup)
1670f8369d7dSTobias Sarnowski                $this->elements = $this->elementsBackup;
1671f8369d7dSTobias Sarnowski        } else if (is_string($newStack)) {
1672f8369d7dSTobias Sarnowski            $new->elements = phpQuery::pq($newStack, $this->getDocumentID())->stack();
1673f8369d7dSTobias Sarnowski        } else {
1674f8369d7dSTobias Sarnowski            $new->elements = $newStack;
1675f8369d7dSTobias Sarnowski        }
1676f8369d7dSTobias Sarnowski        return $new;
1677f8369d7dSTobias Sarnowski    }
1678f8369d7dSTobias Sarnowski    /**
1679f8369d7dSTobias Sarnowski     * Enter description here...
1680f8369d7dSTobias Sarnowski     *
1681f8369d7dSTobias Sarnowski     * In the future, when PHP will support XLS 2.0, then we would do that this way:
1682f8369d7dSTobias Sarnowski     * contains(tokenize(@class, '\s'), "something")
1683f8369d7dSTobias Sarnowski     * @param unknown_type $class
1684f8369d7dSTobias Sarnowski     * @param unknown_type $node
1685f8369d7dSTobias Sarnowski     * @return boolean
1686f8369d7dSTobias Sarnowski     * @access private
1687f8369d7dSTobias Sarnowski     */
1688f8369d7dSTobias Sarnowski    protected function matchClasses($class, $node) {
1689f8369d7dSTobias Sarnowski        // multi-class
1690f8369d7dSTobias Sarnowski        if ( mb_strpos($class, '.', 1)) {
1691f8369d7dSTobias Sarnowski            $classes = explode('.', substr($class, 1));
1692f8369d7dSTobias Sarnowski            $classesCount = count( $classes );
1693f8369d7dSTobias Sarnowski            $nodeClasses = explode(' ', $node->getAttribute('class') );
1694f8369d7dSTobias Sarnowski            $nodeClassesCount = count( $nodeClasses );
1695f8369d7dSTobias Sarnowski            if ( $classesCount > $nodeClassesCount )
1696f8369d7dSTobias Sarnowski                return false;
1697f8369d7dSTobias Sarnowski            $diff = count(
1698f8369d7dSTobias Sarnowski                array_diff(
1699f8369d7dSTobias Sarnowski                    $classes,
1700f8369d7dSTobias Sarnowski                    $nodeClasses
1701f8369d7dSTobias Sarnowski                )
1702f8369d7dSTobias Sarnowski            );
1703f8369d7dSTobias Sarnowski            if (! $diff )
1704f8369d7dSTobias Sarnowski                return true;
1705f8369d7dSTobias Sarnowski        // single-class
1706f8369d7dSTobias Sarnowski        } else {
1707f8369d7dSTobias Sarnowski            return in_array(
1708f8369d7dSTobias Sarnowski                // strip leading dot from class name
1709f8369d7dSTobias Sarnowski                substr($class, 1),
1710f8369d7dSTobias Sarnowski                // get classes for element as array
1711f8369d7dSTobias Sarnowski                explode(' ', $node->getAttribute('class') )
1712f8369d7dSTobias Sarnowski            );
1713f8369d7dSTobias Sarnowski        }
1714f8369d7dSTobias Sarnowski    }
1715f8369d7dSTobias Sarnowski    /**
1716f8369d7dSTobias Sarnowski     * @access private
1717f8369d7dSTobias Sarnowski     */
1718f8369d7dSTobias Sarnowski    protected function runQuery($XQuery, $selector = null, $compare = null) {
1719f8369d7dSTobias Sarnowski        if ($compare && ! method_exists($this, $compare))
1720f8369d7dSTobias Sarnowski            return false;
1721f8369d7dSTobias Sarnowski        $stack = array();
1722f8369d7dSTobias Sarnowski        if (! $this->elements)
1723f8369d7dSTobias Sarnowski            $this->debug('Stack empty, skipping...');
1724f8369d7dSTobias Sarnowski//      var_dump($this->elements[0]->nodeType);
1725f8369d7dSTobias Sarnowski        // element, document
1726f8369d7dSTobias Sarnowski        foreach($this->stack(array(1, 9, 13)) as $k => $stackNode) {
1727f8369d7dSTobias Sarnowski            $detachAfter = false;
1728f8369d7dSTobias Sarnowski            // to work on detached nodes we need temporary place them somewhere
1729f8369d7dSTobias Sarnowski            // thats because context xpath queries sucks ;]
1730f8369d7dSTobias Sarnowski            $testNode = $stackNode;
1731f8369d7dSTobias Sarnowski            while ($testNode) {
1732f8369d7dSTobias Sarnowski                if (! $testNode->parentNode && ! $this->isRoot($testNode)) {
1733f8369d7dSTobias Sarnowski                    $this->root->appendChild($testNode);
1734f8369d7dSTobias Sarnowski                    $detachAfter = $testNode;
1735f8369d7dSTobias Sarnowski                    break;
1736f8369d7dSTobias Sarnowski                }
1737f8369d7dSTobias Sarnowski                $testNode = isset($testNode->parentNode)
1738f8369d7dSTobias Sarnowski                    ? $testNode->parentNode
1739f8369d7dSTobias Sarnowski                    : null;
1740f8369d7dSTobias Sarnowski            }
1741f8369d7dSTobias Sarnowski            // XXX tmp ?
1742f8369d7dSTobias Sarnowski            $xpath = $this->documentWrapper->isXHTML
1743f8369d7dSTobias Sarnowski                ? $this->getNodeXpath($stackNode, 'html')
1744f8369d7dSTobias Sarnowski                : $this->getNodeXpath($stackNode);
1745f8369d7dSTobias Sarnowski            // FIXME pseudoclasses-only query, support XML
1746f8369d7dSTobias Sarnowski            $query = $XQuery == '//' && $xpath == '/html[1]'
1747f8369d7dSTobias Sarnowski                ? '//*'
1748f8369d7dSTobias Sarnowski                : $xpath.$XQuery;
1749f8369d7dSTobias Sarnowski            $this->debug("XPATH: {$query}");
1750f8369d7dSTobias Sarnowski            // run query, get elements
1751f8369d7dSTobias Sarnowski            $nodes = $this->xpath->query($query);
1752f8369d7dSTobias Sarnowski            $this->debug("QUERY FETCHED");
1753f8369d7dSTobias Sarnowski            if (! $nodes->length )
1754f8369d7dSTobias Sarnowski                $this->debug('Nothing found');
1755f8369d7dSTobias Sarnowski            $debug = array();
1756f8369d7dSTobias Sarnowski            foreach($nodes as $node) {
1757f8369d7dSTobias Sarnowski                $matched = false;
1758f8369d7dSTobias Sarnowski                if ( $compare) {
1759f8369d7dSTobias Sarnowski                    phpQuery::$debug ?
1760f8369d7dSTobias Sarnowski                        $this->debug("Found: ".$this->whois( $node ).", comparing with {$compare}()")
1761f8369d7dSTobias Sarnowski                        : null;
1762f8369d7dSTobias Sarnowski                    $phpQueryDebug = phpQuery::$debug;
1763f8369d7dSTobias Sarnowski                    phpQuery::$debug = false;
1764f8369d7dSTobias Sarnowski                    // TODO ??? use phpQuery::callbackRun()
1765f8369d7dSTobias Sarnowski                    if (call_user_func_array(array($this, $compare), array($selector, $node)))
1766f8369d7dSTobias Sarnowski                        $matched = true;
1767f8369d7dSTobias Sarnowski                    phpQuery::$debug = $phpQueryDebug;
1768f8369d7dSTobias Sarnowski                } else {
1769f8369d7dSTobias Sarnowski                    $matched = true;
1770f8369d7dSTobias Sarnowski                }
1771f8369d7dSTobias Sarnowski                if ( $matched) {
1772f8369d7dSTobias Sarnowski                    if (phpQuery::$debug)
1773f8369d7dSTobias Sarnowski                        $debug[] = $this->whois( $node );
1774f8369d7dSTobias Sarnowski                    $stack[] = $node;
1775f8369d7dSTobias Sarnowski                }
1776f8369d7dSTobias Sarnowski            }
1777f8369d7dSTobias Sarnowski            if (phpQuery::$debug) {
1778f8369d7dSTobias Sarnowski                $this->debug("Matched ".count($debug).": ".implode(', ', $debug));
1779f8369d7dSTobias Sarnowski            }
1780f8369d7dSTobias Sarnowski            if ($detachAfter)
1781f8369d7dSTobias Sarnowski                $this->root->removeChild($detachAfter);
1782f8369d7dSTobias Sarnowski        }
1783f8369d7dSTobias Sarnowski        $this->elements = $stack;
1784f8369d7dSTobias Sarnowski    }
1785f8369d7dSTobias Sarnowski    /**
1786f8369d7dSTobias Sarnowski     * Enter description here...
1787f8369d7dSTobias Sarnowski     *
1788f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
1789f8369d7dSTobias Sarnowski     */
1790f8369d7dSTobias Sarnowski    public function find($selectors, $context = null, $noHistory = false) {
1791f8369d7dSTobias Sarnowski        if (!$noHistory)
1792f8369d7dSTobias Sarnowski            // backup last stack /for end()/
1793f8369d7dSTobias Sarnowski            $this->elementsBackup = $this->elements;
1794f8369d7dSTobias Sarnowski        // allow to define context
1795f8369d7dSTobias Sarnowski        // TODO combine code below with phpQuery::pq() context guessing code
1796f8369d7dSTobias Sarnowski        //   as generic function
1797f8369d7dSTobias Sarnowski        if ($context) {
1798f8369d7dSTobias Sarnowski            if (! is_array($context) && $context instanceof DOMELEMENT)
1799f8369d7dSTobias Sarnowski                $this->elements = array($context);
1800f8369d7dSTobias Sarnowski            else if (is_array($context)) {
1801f8369d7dSTobias Sarnowski                $this->elements = array();
1802f8369d7dSTobias Sarnowski                foreach ($context as $c)
1803f8369d7dSTobias Sarnowski                    if ($c instanceof DOMELEMENT)
1804f8369d7dSTobias Sarnowski                        $this->elements[] = $c;
1805f8369d7dSTobias Sarnowski            } else if ( $context instanceof self )
1806f8369d7dSTobias Sarnowski                $this->elements = $context->elements;
1807f8369d7dSTobias Sarnowski        }
1808f8369d7dSTobias Sarnowski        $queries = $this->parseSelector($selectors);
1809f8369d7dSTobias Sarnowski        $this->debug(array('FIND', $selectors, $queries));
1810f8369d7dSTobias Sarnowski        $XQuery = '';
1811f8369d7dSTobias Sarnowski        // remember stack state because of multi-queries
1812f8369d7dSTobias Sarnowski        $oldStack = $this->elements;
1813f8369d7dSTobias Sarnowski        // here we will be keeping found elements
1814f8369d7dSTobias Sarnowski        $stack = array();
1815f8369d7dSTobias Sarnowski        foreach($queries as $selector) {
1816f8369d7dSTobias Sarnowski            $this->elements = $oldStack;
1817f8369d7dSTobias Sarnowski            $delimiterBefore = false;
1818f8369d7dSTobias Sarnowski            foreach($selector as $s) {
1819f8369d7dSTobias Sarnowski                // TAG
1820f8369d7dSTobias Sarnowski                $isTag = extension_loaded('mbstring') && phpQuery::$mbstringSupport
1821f8369d7dSTobias Sarnowski                    ? mb_ereg_match('^[\w|\||-]+$', $s) || $s == '*'
1822f8369d7dSTobias Sarnowski                    : preg_match('@^[\w|\||-]+$@', $s) || $s == '*';
1823f8369d7dSTobias Sarnowski                if ($isTag) {
1824f8369d7dSTobias Sarnowski                    if ($this->isXML()) {
1825f8369d7dSTobias Sarnowski                        // namespace support
1826f8369d7dSTobias Sarnowski                        if (mb_strpos($s, '|') !== false) {
1827f8369d7dSTobias Sarnowski                            $ns = $tag = null;
1828f8369d7dSTobias Sarnowski                            list($ns, $tag) = explode('|', $s);
1829f8369d7dSTobias Sarnowski                            $XQuery .= "$ns:$tag";
1830f8369d7dSTobias Sarnowski                        } else if ($s == '*') {
1831f8369d7dSTobias Sarnowski                            $XQuery .= "*";
1832f8369d7dSTobias Sarnowski                        } else {
1833f8369d7dSTobias Sarnowski                            $XQuery .= "*[local-name()='$s']";
1834f8369d7dSTobias Sarnowski                        }
1835f8369d7dSTobias Sarnowski                    } else {
1836f8369d7dSTobias Sarnowski                        $XQuery .= $s;
1837f8369d7dSTobias Sarnowski                    }
1838f8369d7dSTobias Sarnowski                // ID
1839f8369d7dSTobias Sarnowski                } else if ($s[0] == '#') {
1840f8369d7dSTobias Sarnowski                    if ($delimiterBefore)
1841f8369d7dSTobias Sarnowski                        $XQuery .= '*';
1842f8369d7dSTobias Sarnowski                    $XQuery .= "[@id='".substr($s, 1)."']";
1843f8369d7dSTobias Sarnowski                // ATTRIBUTES
1844f8369d7dSTobias Sarnowski                } else if ($s[0] == '[') {
1845f8369d7dSTobias Sarnowski                    if ($delimiterBefore)
1846f8369d7dSTobias Sarnowski                        $XQuery .= '*';
1847f8369d7dSTobias Sarnowski                    // strip side brackets
1848f8369d7dSTobias Sarnowski                    $attr = trim($s, '][');
1849f8369d7dSTobias Sarnowski                    $execute = false;
1850f8369d7dSTobias Sarnowski                    // attr with specifed value
1851f8369d7dSTobias Sarnowski                    if (mb_strpos($s, '=')) {
1852f8369d7dSTobias Sarnowski                        $value = null;
1853f8369d7dSTobias Sarnowski                        list($attr, $value) = explode('=', $attr);
1854f8369d7dSTobias Sarnowski                        $value = trim($value, "'\"");
1855f8369d7dSTobias Sarnowski                        if ($this->isRegexp($attr)) {
1856f8369d7dSTobias Sarnowski                            // cut regexp character
1857f8369d7dSTobias Sarnowski                            $attr = substr($attr, 0, -1);
1858f8369d7dSTobias Sarnowski                            $execute = true;
1859f8369d7dSTobias Sarnowski                            $XQuery .= "[@{$attr}]";
1860f8369d7dSTobias Sarnowski                        } else {
1861f8369d7dSTobias Sarnowski                            $XQuery .= "[@{$attr}='{$value}']";
1862f8369d7dSTobias Sarnowski                        }
1863f8369d7dSTobias Sarnowski                    // attr without specified value
1864f8369d7dSTobias Sarnowski                    } else {
1865f8369d7dSTobias Sarnowski                        $XQuery .= "[@{$attr}]";
1866f8369d7dSTobias Sarnowski                    }
1867f8369d7dSTobias Sarnowski                    if ($execute) {
1868f8369d7dSTobias Sarnowski                        $this->runQuery($XQuery, $s, 'is');
1869f8369d7dSTobias Sarnowski                        $XQuery = '';
1870f8369d7dSTobias Sarnowski                        if (! $this->length())
1871f8369d7dSTobias Sarnowski                            break;
1872f8369d7dSTobias Sarnowski                    }
1873f8369d7dSTobias Sarnowski                // CLASSES
1874f8369d7dSTobias Sarnowski                } else if ($s[0] == '.') {
1875f8369d7dSTobias Sarnowski                    // TODO use return $this->find("./self::*[contains(concat(\" \",@class,\" \"), \" $class \")]");
1876f8369d7dSTobias Sarnowski                    // thx wizDom ;)
1877f8369d7dSTobias Sarnowski                    if ($delimiterBefore)
1878f8369d7dSTobias Sarnowski                        $XQuery .= '*';
1879f8369d7dSTobias Sarnowski                    $XQuery .= '[@class]';
1880f8369d7dSTobias Sarnowski                    $this->runQuery($XQuery, $s, 'matchClasses');
1881f8369d7dSTobias Sarnowski                    $XQuery = '';
1882f8369d7dSTobias Sarnowski                    if (! $this->length() )
1883f8369d7dSTobias Sarnowski                        break;
1884f8369d7dSTobias Sarnowski                // ~ General Sibling Selector
1885f8369d7dSTobias Sarnowski                } else if ($s[0] == '~') {
1886f8369d7dSTobias Sarnowski                    $this->runQuery($XQuery);
1887f8369d7dSTobias Sarnowski                    $XQuery = '';
1888f8369d7dSTobias Sarnowski                    $this->elements = $this
1889f8369d7dSTobias Sarnowski                        ->siblings(
1890f8369d7dSTobias Sarnowski                            substr($s, 1)
1891f8369d7dSTobias Sarnowski                        )->elements;
1892f8369d7dSTobias Sarnowski                    if (! $this->length() )
1893f8369d7dSTobias Sarnowski                        break;
1894f8369d7dSTobias Sarnowski                // + Adjacent sibling selectors
1895f8369d7dSTobias Sarnowski                } else if ($s[0] == '+') {
1896f8369d7dSTobias Sarnowski                    // TODO /following-sibling::
1897f8369d7dSTobias Sarnowski                    $this->runQuery($XQuery);
1898f8369d7dSTobias Sarnowski                    $XQuery = '';
1899f8369d7dSTobias Sarnowski                    $subSelector = substr($s, 1);
1900f8369d7dSTobias Sarnowski                    $subElements = $this->elements;
1901f8369d7dSTobias Sarnowski                    $this->elements = array();
1902f8369d7dSTobias Sarnowski                    foreach($subElements as $node) {
1903f8369d7dSTobias Sarnowski                        // search first DOMElement sibling
1904f8369d7dSTobias Sarnowski                        $test = $node->nextSibling;
1905f8369d7dSTobias Sarnowski                        while($test && ! ($test instanceof DOMELEMENT))
1906f8369d7dSTobias Sarnowski                            $test = $test->nextSibling;
1907f8369d7dSTobias Sarnowski                        if ($test && $this->is($subSelector, $test))
1908f8369d7dSTobias Sarnowski                            $this->elements[] = $test;
1909f8369d7dSTobias Sarnowski                    }
1910f8369d7dSTobias Sarnowski                    if (! $this->length() )
1911f8369d7dSTobias Sarnowski                        break;
1912f8369d7dSTobias Sarnowski                // PSEUDO CLASSES
1913f8369d7dSTobias Sarnowski                } else if ($s[0] == ':') {
1914f8369d7dSTobias Sarnowski                    // TODO optimization for :first :last
1915f8369d7dSTobias Sarnowski                    if ($XQuery) {
1916f8369d7dSTobias Sarnowski                        $this->runQuery($XQuery);
1917f8369d7dSTobias Sarnowski                        $XQuery = '';
1918f8369d7dSTobias Sarnowski                    }
1919f8369d7dSTobias Sarnowski                    if (! $this->length())
1920f8369d7dSTobias Sarnowski                        break;
1921f8369d7dSTobias Sarnowski                    $this->pseudoClasses($s);
1922f8369d7dSTobias Sarnowski                    if (! $this->length())
1923f8369d7dSTobias Sarnowski                        break;
1924f8369d7dSTobias Sarnowski                // DIRECT DESCENDANDS
1925f8369d7dSTobias Sarnowski                } else if ($s == '>') {
1926f8369d7dSTobias Sarnowski                    $XQuery .= '/';
1927f8369d7dSTobias Sarnowski                    $delimiterBefore = 2;
1928f8369d7dSTobias Sarnowski                // ALL DESCENDANDS
1929f8369d7dSTobias Sarnowski                } else if ($s == ' ') {
1930f8369d7dSTobias Sarnowski                    $XQuery .= '//';
1931f8369d7dSTobias Sarnowski                    $delimiterBefore = 2;
1932f8369d7dSTobias Sarnowski                // ERRORS
1933f8369d7dSTobias Sarnowski                } else {
1934f8369d7dSTobias Sarnowski                    phpQuery::debug("Unrecognized token '$s'");
1935f8369d7dSTobias Sarnowski                }
1936f8369d7dSTobias Sarnowski                $delimiterBefore = $delimiterBefore === 2;
1937f8369d7dSTobias Sarnowski            }
1938f8369d7dSTobias Sarnowski            // run query if any
1939f8369d7dSTobias Sarnowski            if ($XQuery && $XQuery != '//') {
1940f8369d7dSTobias Sarnowski                $this->runQuery($XQuery);
1941f8369d7dSTobias Sarnowski                $XQuery = '';
1942f8369d7dSTobias Sarnowski            }
1943f8369d7dSTobias Sarnowski            foreach($this->elements as $node)
1944f8369d7dSTobias Sarnowski                if (! $this->elementsContainsNode($node, $stack))
1945f8369d7dSTobias Sarnowski                    $stack[] = $node;
1946f8369d7dSTobias Sarnowski        }
1947f8369d7dSTobias Sarnowski        $this->elements = $stack;
1948f8369d7dSTobias Sarnowski        return $this->newInstance();
1949f8369d7dSTobias Sarnowski    }
1950f8369d7dSTobias Sarnowski    /**
1951f8369d7dSTobias Sarnowski     * @todo create API for classes with pseudoselectors
1952f8369d7dSTobias Sarnowski     * @access private
1953f8369d7dSTobias Sarnowski     */
1954f8369d7dSTobias Sarnowski    protected function pseudoClasses($class) {
1955f8369d7dSTobias Sarnowski        // TODO clean args parsing ?
1956f8369d7dSTobias Sarnowski        $class = ltrim($class, ':');
1957f8369d7dSTobias Sarnowski        $haveArgs = mb_strpos($class, '(');
1958f8369d7dSTobias Sarnowski        if ($haveArgs !== false) {
1959f8369d7dSTobias Sarnowski            $args = substr($class, $haveArgs+1, -1);
1960f8369d7dSTobias Sarnowski            $class = substr($class, 0, $haveArgs);
1961f8369d7dSTobias Sarnowski        }
1962f8369d7dSTobias Sarnowski        switch($class) {
1963f8369d7dSTobias Sarnowski            case 'even':
1964f8369d7dSTobias Sarnowski            case 'odd':
1965f8369d7dSTobias Sarnowski                $stack = array();
1966f8369d7dSTobias Sarnowski                foreach($this->elements as $i => $node) {
1967f8369d7dSTobias Sarnowski                    if ($class == 'even' && ($i%2) == 0)
1968f8369d7dSTobias Sarnowski                        $stack[] = $node;
1969f8369d7dSTobias Sarnowski                    else if ( $class == 'odd' && $i % 2 )
1970f8369d7dSTobias Sarnowski                        $stack[] = $node;
1971f8369d7dSTobias Sarnowski                }
1972f8369d7dSTobias Sarnowski                $this->elements = $stack;
1973f8369d7dSTobias Sarnowski                break;
1974f8369d7dSTobias Sarnowski            case 'eq':
1975f8369d7dSTobias Sarnowski                $k = intval($args);
1976f8369d7dSTobias Sarnowski                $this->elements = isset( $this->elements[$k] )
1977f8369d7dSTobias Sarnowski                    ? array( $this->elements[$k] )
1978f8369d7dSTobias Sarnowski                    : array();
1979f8369d7dSTobias Sarnowski                break;
1980f8369d7dSTobias Sarnowski            case 'gt':
1981f8369d7dSTobias Sarnowski                $this->elements = array_slice($this->elements, $args+1);
1982f8369d7dSTobias Sarnowski                break;
1983f8369d7dSTobias Sarnowski            case 'lt':
1984f8369d7dSTobias Sarnowski                $this->elements = array_slice($this->elements, 0, $args+1);
1985f8369d7dSTobias Sarnowski                break;
1986f8369d7dSTobias Sarnowski            case 'first':
1987f8369d7dSTobias Sarnowski                if (isset($this->elements[0]))
1988f8369d7dSTobias Sarnowski                    $this->elements = array($this->elements[0]);
1989f8369d7dSTobias Sarnowski                break;
1990f8369d7dSTobias Sarnowski            case 'last':
1991f8369d7dSTobias Sarnowski                if ($this->elements)
1992f8369d7dSTobias Sarnowski                    $this->elements = array($this->elements[count($this->elements)-1]);
1993f8369d7dSTobias Sarnowski                break;
1994f8369d7dSTobias Sarnowski            /*case 'parent':
1995f8369d7dSTobias Sarnowski                $stack = array();
1996f8369d7dSTobias Sarnowski                foreach($this->elements as $node) {
1997f8369d7dSTobias Sarnowski                    if ( $node->childNodes->length )
1998f8369d7dSTobias Sarnowski                        $stack[] = $node;
1999f8369d7dSTobias Sarnowski                }
2000f8369d7dSTobias Sarnowski                $this->elements = $stack;
2001f8369d7dSTobias Sarnowski                break;*/
2002f8369d7dSTobias Sarnowski            case 'contains':
2003f8369d7dSTobias Sarnowski                $text = trim($args, "\"'");
2004f8369d7dSTobias Sarnowski                $stack = array();
2005f8369d7dSTobias Sarnowski                foreach($this->elements as $node) {
2006f8369d7dSTobias Sarnowski                    if (mb_stripos($node->textContent, $text) === false)
2007f8369d7dSTobias Sarnowski                        continue;
2008f8369d7dSTobias Sarnowski                    $stack[] = $node;
2009f8369d7dSTobias Sarnowski                }
2010f8369d7dSTobias Sarnowski                $this->elements = $stack;
2011f8369d7dSTobias Sarnowski                break;
2012f8369d7dSTobias Sarnowski            case 'not':
2013f8369d7dSTobias Sarnowski                $selector = self::unQuote($args);
2014f8369d7dSTobias Sarnowski                $this->elements = $this->not($selector)->stack();
2015f8369d7dSTobias Sarnowski                break;
2016f8369d7dSTobias Sarnowski            case 'slice':
2017f8369d7dSTobias Sarnowski                // TODO jQuery difference ?
2018f8369d7dSTobias Sarnowski                $args = explode(',',
2019f8369d7dSTobias Sarnowski                    str_replace(', ', ',', trim($args, "\"'"))
2020f8369d7dSTobias Sarnowski                );
2021f8369d7dSTobias Sarnowski                $start = $args[0];
2022f8369d7dSTobias Sarnowski                $end = isset($args[1])
2023f8369d7dSTobias Sarnowski                    ? $args[1]
2024f8369d7dSTobias Sarnowski                    : null;
2025f8369d7dSTobias Sarnowski                if ($end > 0)
2026f8369d7dSTobias Sarnowski                    $end = $end-$start;
2027f8369d7dSTobias Sarnowski                $this->elements = array_slice($this->elements, $start, $end);
2028f8369d7dSTobias Sarnowski                break;
2029f8369d7dSTobias Sarnowski            case 'has':
2030f8369d7dSTobias Sarnowski                $selector = trim($args, "\"'");
2031f8369d7dSTobias Sarnowski                $stack = array();
2032f8369d7dSTobias Sarnowski                foreach($this->stack(1) as $el) {
2033f8369d7dSTobias Sarnowski                    if ($this->find($selector, $el, true)->length)
2034f8369d7dSTobias Sarnowski                        $stack[] = $el;
2035f8369d7dSTobias Sarnowski                }
2036f8369d7dSTobias Sarnowski                $this->elements = $stack;
2037f8369d7dSTobias Sarnowski                break;
2038f8369d7dSTobias Sarnowski            case 'submit':
2039f8369d7dSTobias Sarnowski            case 'reset':
2040f8369d7dSTobias Sarnowski                $this->elements = phpQuery::merge(
2041f8369d7dSTobias Sarnowski                    $this->map(array($this, 'is'),
2042f8369d7dSTobias Sarnowski                        "input[type=$class]", new CallbackParam()
2043f8369d7dSTobias Sarnowski                    ),
2044f8369d7dSTobias Sarnowski                    $this->map(array($this, 'is'),
2045f8369d7dSTobias Sarnowski                        "button[type=$class]", new CallbackParam()
2046f8369d7dSTobias Sarnowski                    )
2047f8369d7dSTobias Sarnowski                );
2048f8369d7dSTobias Sarnowski            break;
2049f8369d7dSTobias Sarnowski//              $stack = array();
2050f8369d7dSTobias Sarnowski//              foreach($this->elements as $node)
2051f8369d7dSTobias Sarnowski//                  if ($node->is('input[type=submit]') || $node->is('button[type=submit]'))
2052f8369d7dSTobias Sarnowski//                      $stack[] = $el;
2053f8369d7dSTobias Sarnowski//              $this->elements = $stack;
2054f8369d7dSTobias Sarnowski            case 'input':
2055f8369d7dSTobias Sarnowski                $this->elements = $this->map(
2056f8369d7dSTobias Sarnowski                    array($this, 'is'),
2057f8369d7dSTobias Sarnowski                    'input', new CallbackParam()
2058f8369d7dSTobias Sarnowski                )->elements;
2059f8369d7dSTobias Sarnowski            break;
2060f8369d7dSTobias Sarnowski            case 'password':
2061f8369d7dSTobias Sarnowski            case 'checkbox':
2062f8369d7dSTobias Sarnowski            case 'radio':
2063f8369d7dSTobias Sarnowski            case 'hidden':
2064f8369d7dSTobias Sarnowski            case 'image':
2065f8369d7dSTobias Sarnowski            case 'file':
2066f8369d7dSTobias Sarnowski                $this->elements = $this->map(
2067f8369d7dSTobias Sarnowski                    array($this, 'is'),
2068f8369d7dSTobias Sarnowski                    "input[type=$class]", new CallbackParam()
2069f8369d7dSTobias Sarnowski                )->elements;
2070f8369d7dSTobias Sarnowski            break;
2071f8369d7dSTobias Sarnowski            case 'parent':
2072f8369d7dSTobias Sarnowski                $this->elements = $this->map(
2073*a3095052SOscar Merida                    function ($node) {
2074f8369d7dSTobias Sarnowski                        return $node instanceof DOMELEMENT && $node->childNodes->length
2075*a3095052SOscar Merida                            ? $node : null;
2076*a3095052SOscar Merida                    }
2077f8369d7dSTobias Sarnowski                )->elements;
2078f8369d7dSTobias Sarnowski            break;
2079f8369d7dSTobias Sarnowski            case 'empty':
2080f8369d7dSTobias Sarnowski                $this->elements = $this->map(
2081*a3095052SOscar Merida                    function ($node) {
2082f8369d7dSTobias Sarnowski                        return $node instanceof DOMELEMENT && $node->childNodes->length
2083*a3095052SOscar Merida                            ? null : $node;
2084*a3095052SOscar Merida                    }
2085f8369d7dSTobias Sarnowski                )->elements;
2086f8369d7dSTobias Sarnowski            break;
2087f8369d7dSTobias Sarnowski            case 'disabled':
2088f8369d7dSTobias Sarnowski            case 'selected':
2089f8369d7dSTobias Sarnowski            case 'checked':
2090f8369d7dSTobias Sarnowski                $this->elements = $this->map(
2091f8369d7dSTobias Sarnowski                    array($this, 'is'),
2092f8369d7dSTobias Sarnowski                    "[$class]", new CallbackParam()
2093f8369d7dSTobias Sarnowski                )->elements;
2094f8369d7dSTobias Sarnowski            break;
2095f8369d7dSTobias Sarnowski            case 'enabled':
2096f8369d7dSTobias Sarnowski                $this->elements = $this->map(
2097*a3095052SOscar Merida                    function ($node) {
2098*a3095052SOscar Merida                        return pq($node)->not(":disabled") ? $node : null;
2099*a3095052SOscar Merida                    }
2100f8369d7dSTobias Sarnowski                )->elements;
2101f8369d7dSTobias Sarnowski            break;
2102f8369d7dSTobias Sarnowski            case 'header':
2103f8369d7dSTobias Sarnowski                $this->elements = $this->map(
2104*a3095052SOscar Merida                    function ($node) {
2105*a3095052SOscar Merida                        $isHeader = isset($node->tagName) && in_array($node->tagName, array(
2106f8369d7dSTobias Sarnowski                                "h1", "h2", "h3", "h4", "h5", "h6", "h7"
2107f8369d7dSTobias Sarnowski                            ));
2108f8369d7dSTobias Sarnowski                        return $isHeader
2109f8369d7dSTobias Sarnowski                            ? $node
2110*a3095052SOscar Merida                            : null;
2111*a3095052SOscar Merida                    }
2112f8369d7dSTobias Sarnowski                )->elements;
2113f8369d7dSTobias Sarnowski//              $this->elements = $this->map(
2114f8369d7dSTobias Sarnowski//                  create_function('$node', '$node = pq($node);
2115f8369d7dSTobias Sarnowski//                      return $node->is("h1")
2116f8369d7dSTobias Sarnowski//                          || $node->is("h2")
2117f8369d7dSTobias Sarnowski//                          || $node->is("h3")
2118f8369d7dSTobias Sarnowski//                          || $node->is("h4")
2119f8369d7dSTobias Sarnowski//                          || $node->is("h5")
2120f8369d7dSTobias Sarnowski//                          || $node->is("h6")
2121f8369d7dSTobias Sarnowski//                          || $node->is("h7")
2122f8369d7dSTobias Sarnowski//                          ? $node
2123f8369d7dSTobias Sarnowski//                          : null;')
2124f8369d7dSTobias Sarnowski//              )->elements;
2125f8369d7dSTobias Sarnowski            break;
2126f8369d7dSTobias Sarnowski            case 'only-child':
2127f8369d7dSTobias Sarnowski                $this->elements = $this->map(
2128*a3095052SOscar Merida                    function ($node) {
2129*a3095052SOscar Merida                        return pq($node)->siblings()->size() == 0 ? $node : null;
2130*a3095052SOscar Merida                    }
2131f8369d7dSTobias Sarnowski                )->elements;
2132f8369d7dSTobias Sarnowski            break;
2133f8369d7dSTobias Sarnowski            case 'first-child':
2134f8369d7dSTobias Sarnowski                $this->elements = $this->map(
2135*a3095052SOscar Merida                    function ($node) {
2136*a3095052SOscar Merida                        return pq($node)->prevAll()->size() == 0 ? $node : null;
2137*a3095052SOscar Merida                    }
2138f8369d7dSTobias Sarnowski                )->elements;
2139f8369d7dSTobias Sarnowski            break;
2140f8369d7dSTobias Sarnowski            case 'last-child':
2141f8369d7dSTobias Sarnowski                $this->elements = $this->map(
2142*a3095052SOscar Merida                    function ($node) {
2143*a3095052SOscar Merida                        return pq($node)->nextAll()->size() == 0 ? $node : null;
2144*a3095052SOscar Merida                    }
2145f8369d7dSTobias Sarnowski                )->elements;
2146f8369d7dSTobias Sarnowski            break;
2147f8369d7dSTobias Sarnowski            case 'nth-child':
2148f8369d7dSTobias Sarnowski                $param = trim($args, "\"'");
2149f8369d7dSTobias Sarnowski                if (! $param)
2150f8369d7dSTobias Sarnowski                    break;
2151f8369d7dSTobias Sarnowski                    // nth-child(n+b) to nth-child(1n+b)
215263b6cc52SSyntaxseed                if ($param[0] == 'n')
2153f8369d7dSTobias Sarnowski                    $param = '1'.$param;
2154f8369d7dSTobias Sarnowski                // :nth-child(index/even/odd/equation)
2155f8369d7dSTobias Sarnowski                if ($param == 'even' || $param == 'odd')
2156f8369d7dSTobias Sarnowski                    $mapped = $this->map(
2157*a3095052SOscar Merida                        function ($node, $param) {
2158*a3095052SOscar Merida                            $index = pq($node)->prevAll()->size() + 1;
2159f8369d7dSTobias Sarnowski                            if ($param == "even" && ($index % 2) == 0)
2160f8369d7dSTobias Sarnowski                                return $node;
2161f8369d7dSTobias Sarnowski                            else if ($param == "odd" && $index % 2 == 1)
2162f8369d7dSTobias Sarnowski                                return $node;
2163f8369d7dSTobias Sarnowski                            else
2164*a3095052SOscar Merida                                return null;
2165*a3095052SOscar Merida                        }, new CallbackParam(), $param
2166f8369d7dSTobias Sarnowski                    );
216763b6cc52SSyntaxseed                else if (mb_strlen($param) > 1 && $param[1] == 'n')
2168f8369d7dSTobias Sarnowski                    // an+b
2169f8369d7dSTobias Sarnowski                    $mapped = $this->map(
2170*a3095052SOscar Merida                        function ($node, $param) {
2171*a3095052SOscar Merida                            $prevs = pq($node)->prevAll()->size();
2172f8369d7dSTobias Sarnowski                            $index = 1 + $prevs;
2173f8369d7dSTobias Sarnowski                            $b = mb_strlen($param) > 3
2174*a3095052SOscar Merida                                ? $param[3]
2175f8369d7dSTobias Sarnowski                                : 0;
2176*a3095052SOscar Merida                            $a = $param[0];
2177*a3095052SOscar Merida                            if ($b && $param[2] == "-")
2178f8369d7dSTobias Sarnowski                                $b = -$b;
2179f8369d7dSTobias Sarnowski                            if ($a > 0) {
2180f8369d7dSTobias Sarnowski                                return ($index - $b) % $a == 0
2181f8369d7dSTobias Sarnowski                                    ? $node
2182f8369d7dSTobias Sarnowski                                    : null;
2183f8369d7dSTobias Sarnowski                                phpQuery::debug($a . "*" . floor($index / $a) . "+$b-1 == " . ($a * floor($index / $a) + $b - 1) . " ?= $prevs");
2184f8369d7dSTobias Sarnowski                                return $a * floor($index / $a) + $b - 1 == $prevs
2185f8369d7dSTobias Sarnowski                                    ? $node
2186f8369d7dSTobias Sarnowski                                    : null;
2187*a3095052SOscar Merida                            } else if ($a == 0) {
2188f8369d7dSTobias Sarnowski                                return $index == $b
2189f8369d7dSTobias Sarnowski                                    ? $node
2190f8369d7dSTobias Sarnowski                                    : null;
2191*a3095052SOscar Merida                            } else {
2192f8369d7dSTobias Sarnowski                                // negative value
2193f8369d7dSTobias Sarnowski                                return $index <= $b
2194f8369d7dSTobias Sarnowski                                    ? $node
2195f8369d7dSTobias Sarnowski                                    : null;
2196*a3095052SOscar Merida                            }
2197f8369d7dSTobias Sarnowski//                          if (! $b)
2198f8369d7dSTobias Sarnowski//                              return $index%$a == 0
2199f8369d7dSTobias Sarnowski//                                  ? $node
2200f8369d7dSTobias Sarnowski//                                  : null;
2201f8369d7dSTobias Sarnowski//                          else
2202f8369d7dSTobias Sarnowski//                              return ($index-$b)%$a == 0
2203f8369d7dSTobias Sarnowski//                                  ? $node
2204f8369d7dSTobias Sarnowski//                                  : null;
2205*a3095052SOscar Merida                        },
2206f8369d7dSTobias Sarnowski                        new CallbackParam(), $param
2207f8369d7dSTobias Sarnowski                    );
2208f8369d7dSTobias Sarnowski                else
2209f8369d7dSTobias Sarnowski                    // index
2210f8369d7dSTobias Sarnowski                    $mapped = $this->map(
2211*a3095052SOscar Merida                        function ($node, $index) {
2212*a3095052SOscar Merida                            $prevs = pq($node)->prevAll()->size();
2213f8369d7dSTobias Sarnowski                            if ($prevs && $prevs == $index - 1)
2214f8369d7dSTobias Sarnowski                                return $node;
2215f8369d7dSTobias Sarnowski                            else if (!$prevs && $index == 1)
2216f8369d7dSTobias Sarnowski                                return $node;
2217f8369d7dSTobias Sarnowski                            else
2218*a3095052SOscar Merida                                return null;
2219*a3095052SOscar Merida                        },
2220f8369d7dSTobias Sarnowski                        new CallbackParam(), $param
2221f8369d7dSTobias Sarnowski                    );
2222f8369d7dSTobias Sarnowski                $this->elements = $mapped->elements;
2223f8369d7dSTobias Sarnowski            break;
2224f8369d7dSTobias Sarnowski            default:
2225f8369d7dSTobias Sarnowski                $this->debug("Unknown pseudoclass '{$class}', skipping...");
2226f8369d7dSTobias Sarnowski        }
2227f8369d7dSTobias Sarnowski    }
2228f8369d7dSTobias Sarnowski    /**
2229f8369d7dSTobias Sarnowski     * @access private
2230f8369d7dSTobias Sarnowski     */
2231e6a9d76fSSyntaxseed    protected function pseudoClassParam($paramsString) {
2232f8369d7dSTobias Sarnowski        // TODO;
2233f8369d7dSTobias Sarnowski    }
2234f8369d7dSTobias Sarnowski    /**
2235f8369d7dSTobias Sarnowski     * Enter description here...
2236f8369d7dSTobias Sarnowski     *
2237f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2238f8369d7dSTobias Sarnowski     */
2239f8369d7dSTobias Sarnowski    public function is($selector, $nodes = null) {
2240f8369d7dSTobias Sarnowski        phpQuery::debug(array("Is:", $selector));
2241f8369d7dSTobias Sarnowski        if (! $selector)
2242f8369d7dSTobias Sarnowski            return false;
2243f8369d7dSTobias Sarnowski        $oldStack = $this->elements;
2244f8369d7dSTobias Sarnowski        $returnArray = false;
2245f8369d7dSTobias Sarnowski        if ($nodes && is_array($nodes)) {
2246f8369d7dSTobias Sarnowski            $this->elements = $nodes;
2247f8369d7dSTobias Sarnowski        } else if ($nodes)
2248f8369d7dSTobias Sarnowski            $this->elements = array($nodes);
2249f8369d7dSTobias Sarnowski        $this->filter($selector, true);
2250f8369d7dSTobias Sarnowski        $stack = $this->elements;
2251f8369d7dSTobias Sarnowski        $this->elements = $oldStack;
2252f8369d7dSTobias Sarnowski        if ($nodes)
2253f8369d7dSTobias Sarnowski            return $stack ? $stack : null;
2254f8369d7dSTobias Sarnowski        return (bool)count($stack);
2255f8369d7dSTobias Sarnowski    }
2256f8369d7dSTobias Sarnowski    /**
2257f8369d7dSTobias Sarnowski     * Enter description here...
2258f8369d7dSTobias Sarnowski     * jQuery difference.
2259f8369d7dSTobias Sarnowski     *
2260f8369d7dSTobias Sarnowski     * Callback:
2261f8369d7dSTobias Sarnowski     * - $index int
2262f8369d7dSTobias Sarnowski     * - $node DOMNode
2263f8369d7dSTobias Sarnowski     *
2264f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2265f8369d7dSTobias Sarnowski     * @link http://docs.jquery.com/Traversing/filter
2266f8369d7dSTobias Sarnowski     */
2267f8369d7dSTobias Sarnowski    public function filterCallback($callback, $_skipHistory = false) {
2268f8369d7dSTobias Sarnowski        if (! $_skipHistory) {
2269f8369d7dSTobias Sarnowski            $this->elementsBackup = $this->elements;
2270f8369d7dSTobias Sarnowski            $this->debug("Filtering by callback");
2271f8369d7dSTobias Sarnowski        }
2272f8369d7dSTobias Sarnowski        $newStack = array();
2273f8369d7dSTobias Sarnowski        foreach($this->elements as $index => $node) {
2274f8369d7dSTobias Sarnowski            $result = phpQuery::callbackRun($callback, array($index, $node));
2275f8369d7dSTobias Sarnowski            if (is_null($result) || (! is_null($result) && $result))
2276f8369d7dSTobias Sarnowski                $newStack[] = $node;
2277f8369d7dSTobias Sarnowski        }
2278f8369d7dSTobias Sarnowski        $this->elements = $newStack;
2279f8369d7dSTobias Sarnowski        return $_skipHistory
2280f8369d7dSTobias Sarnowski            ? $this
2281f8369d7dSTobias Sarnowski            : $this->newInstance();
2282f8369d7dSTobias Sarnowski    }
2283f8369d7dSTobias Sarnowski    /**
2284f8369d7dSTobias Sarnowski     * Enter description here...
2285f8369d7dSTobias Sarnowski     *
2286f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2287f8369d7dSTobias Sarnowski     * @link http://docs.jquery.com/Traversing/filter
2288f8369d7dSTobias Sarnowski     */
2289f8369d7dSTobias Sarnowski    public function filter($selectors, $_skipHistory = false) {
2290f8369d7dSTobias Sarnowski        if ($selectors instanceof Callback OR $selectors instanceof Closure)
2291f8369d7dSTobias Sarnowski            return $this->filterCallback($selectors, $_skipHistory);
2292f8369d7dSTobias Sarnowski        if (! $_skipHistory)
2293f8369d7dSTobias Sarnowski            $this->elementsBackup = $this->elements;
2294f8369d7dSTobias Sarnowski        $notSimpleSelector = array(' ', '>', '~', '+', '/');
2295f8369d7dSTobias Sarnowski        if (! is_array($selectors))
2296f8369d7dSTobias Sarnowski            $selectors = $this->parseSelector($selectors);
2297f8369d7dSTobias Sarnowski        if (! $_skipHistory)
2298f8369d7dSTobias Sarnowski            $this->debug(array("Filtering:", $selectors));
2299f8369d7dSTobias Sarnowski        $finalStack = array();
2300f8369d7dSTobias Sarnowski        foreach($selectors as $selector) {
2301f8369d7dSTobias Sarnowski            $stack = array();
2302f8369d7dSTobias Sarnowski            if (! $selector)
2303f8369d7dSTobias Sarnowski                break;
2304f8369d7dSTobias Sarnowski            // avoid first space or /
2305f8369d7dSTobias Sarnowski            if (in_array($selector[0], $notSimpleSelector))
2306f8369d7dSTobias Sarnowski                $selector = array_slice($selector, 1);
2307f8369d7dSTobias Sarnowski            // PER NODE selector chunks
2308f8369d7dSTobias Sarnowski            foreach($this->stack() as $node) {
2309f8369d7dSTobias Sarnowski                $break = false;
2310f8369d7dSTobias Sarnowski                foreach($selector as $s) {
2311f8369d7dSTobias Sarnowski                    if (!($node instanceof DOMELEMENT)) {
2312f8369d7dSTobias Sarnowski                        // all besides DOMElement
2313f8369d7dSTobias Sarnowski                        if ( $s[0] == '[') {
2314f8369d7dSTobias Sarnowski                            $attr = trim($s, '[]');
2315f8369d7dSTobias Sarnowski                            if ( mb_strpos($attr, '=')) {
2316f8369d7dSTobias Sarnowski                                list( $attr, $val ) = explode('=', $attr);
2317f8369d7dSTobias Sarnowski                                if ($attr == 'nodeType' && $node->nodeType != $val)
2318f8369d7dSTobias Sarnowski                                    $break = true;
2319f8369d7dSTobias Sarnowski                            }
2320f8369d7dSTobias Sarnowski                        } else
2321f8369d7dSTobias Sarnowski                            $break = true;
2322f8369d7dSTobias Sarnowski                    } else {
2323f8369d7dSTobias Sarnowski                        // DOMElement only
2324f8369d7dSTobias Sarnowski                        // ID
2325f8369d7dSTobias Sarnowski                        if ( $s[0] == '#') {
2326f8369d7dSTobias Sarnowski                            if ( $node->getAttribute('id') != substr($s, 1) )
2327f8369d7dSTobias Sarnowski                                $break = true;
2328f8369d7dSTobias Sarnowski                        // CLASSES
2329f8369d7dSTobias Sarnowski                        } else if ( $s[0] == '.') {
2330f8369d7dSTobias Sarnowski                            if (! $this->matchClasses( $s, $node ) )
2331f8369d7dSTobias Sarnowski                                $break = true;
2332f8369d7dSTobias Sarnowski                        // ATTRS
2333f8369d7dSTobias Sarnowski                        } else if ( $s[0] == '[') {
2334f8369d7dSTobias Sarnowski                            // strip side brackets
2335f8369d7dSTobias Sarnowski                            $attr = trim($s, '[]');
2336f8369d7dSTobias Sarnowski                            if (mb_strpos($attr, '=')) {
2337f8369d7dSTobias Sarnowski                                list($attr, $val) = explode('=', $attr);
2338f8369d7dSTobias Sarnowski                                $val = self::unQuote($val);
2339f8369d7dSTobias Sarnowski                                if ($attr == 'nodeType') {
2340f8369d7dSTobias Sarnowski                                    if ($val != $node->nodeType)
2341f8369d7dSTobias Sarnowski                                        $break = true;
2342f8369d7dSTobias Sarnowski                                } else if ($this->isRegexp($attr)) {
2343f8369d7dSTobias Sarnowski                                    $val = extension_loaded('mbstring') && phpQuery::$mbstringSupport
2344f8369d7dSTobias Sarnowski                                        ? quotemeta(trim($val, '"\''))
2345f8369d7dSTobias Sarnowski                                        : preg_quote(trim($val, '"\''), '@');
2346f8369d7dSTobias Sarnowski                                    // switch last character
2347f8369d7dSTobias Sarnowski                                    switch( substr($attr, -1)) {
2348f8369d7dSTobias Sarnowski                                        // quotemeta used insted of preg_quote
2349f8369d7dSTobias Sarnowski                                        // http://code.google.com/p/phpquery/issues/detail?id=76
2350f8369d7dSTobias Sarnowski                                        case '^':
2351f8369d7dSTobias Sarnowski                                            $pattern = '^'.$val;
2352f8369d7dSTobias Sarnowski                                            break;
2353f8369d7dSTobias Sarnowski                                        case '*':
2354f8369d7dSTobias Sarnowski                                            $pattern = '.*'.$val.'.*';
2355f8369d7dSTobias Sarnowski                                            break;
2356f8369d7dSTobias Sarnowski                                        case '$':
2357f8369d7dSTobias Sarnowski                                            $pattern = '.*'.$val.'$';
2358f8369d7dSTobias Sarnowski                                            break;
2359f8369d7dSTobias Sarnowski                                    }
2360f8369d7dSTobias Sarnowski                                    // cut last character
2361f8369d7dSTobias Sarnowski                                    $attr = substr($attr, 0, -1);
2362f8369d7dSTobias Sarnowski                                    $isMatch = extension_loaded('mbstring') && phpQuery::$mbstringSupport
2363f8369d7dSTobias Sarnowski                                        ? mb_ereg_match($pattern, $node->getAttribute($attr))
2364f8369d7dSTobias Sarnowski                                        : preg_match("@{$pattern}@", $node->getAttribute($attr));
2365f8369d7dSTobias Sarnowski                                    if (! $isMatch)
2366f8369d7dSTobias Sarnowski                                        $break = true;
2367f8369d7dSTobias Sarnowski                                } else if ($node->getAttribute($attr) != $val)
2368f8369d7dSTobias Sarnowski                                    $break = true;
2369f8369d7dSTobias Sarnowski                            } else if (! $node->hasAttribute($attr))
2370f8369d7dSTobias Sarnowski                                $break = true;
2371f8369d7dSTobias Sarnowski                        // PSEUDO CLASSES
2372f8369d7dSTobias Sarnowski                        } else if ( $s[0] == ':') {
2373f8369d7dSTobias Sarnowski                            // skip
2374f8369d7dSTobias Sarnowski                        // TAG
2375f8369d7dSTobias Sarnowski                        } else if (trim($s)) {
2376f8369d7dSTobias Sarnowski                            if ($s != '*') {
2377f8369d7dSTobias Sarnowski                                // TODO namespaces
2378f8369d7dSTobias Sarnowski                                if (isset($node->tagName)) {
2379f8369d7dSTobias Sarnowski                                    if ($node->tagName != $s)
2380f8369d7dSTobias Sarnowski                                        $break = true;
2381f8369d7dSTobias Sarnowski                                } else if ($s == 'html' && ! $this->isRoot($node))
2382f8369d7dSTobias Sarnowski                                    $break = true;
2383f8369d7dSTobias Sarnowski                            }
2384f8369d7dSTobias Sarnowski                        // AVOID NON-SIMPLE SELECTORS
2385f8369d7dSTobias Sarnowski                        } else if (in_array($s, $notSimpleSelector)) {
2386f8369d7dSTobias Sarnowski                            $break = true;
2387f8369d7dSTobias Sarnowski                            $this->debug(array('Skipping non simple selector', $selector));
2388f8369d7dSTobias Sarnowski                        }
2389f8369d7dSTobias Sarnowski                    }
2390f8369d7dSTobias Sarnowski                    if ($break)
2391f8369d7dSTobias Sarnowski                        break;
2392f8369d7dSTobias Sarnowski                }
2393f8369d7dSTobias Sarnowski                // if element passed all chunks of selector - add it to new stack
2394f8369d7dSTobias Sarnowski                if (! $break )
2395f8369d7dSTobias Sarnowski                    $stack[] = $node;
2396f8369d7dSTobias Sarnowski            }
2397f8369d7dSTobias Sarnowski            $tmpStack = $this->elements;
2398f8369d7dSTobias Sarnowski            $this->elements = $stack;
2399f8369d7dSTobias Sarnowski            // PER ALL NODES selector chunks
2400f8369d7dSTobias Sarnowski            foreach($selector as $s)
2401f8369d7dSTobias Sarnowski                // PSEUDO CLASSES
2402f8369d7dSTobias Sarnowski                if ($s[0] == ':')
2403f8369d7dSTobias Sarnowski                    $this->pseudoClasses($s);
2404f8369d7dSTobias Sarnowski            foreach($this->elements as $node)
2405f8369d7dSTobias Sarnowski                // XXX it should be merged without duplicates
2406f8369d7dSTobias Sarnowski                // but jQuery doesnt do that
2407f8369d7dSTobias Sarnowski                $finalStack[] = $node;
2408f8369d7dSTobias Sarnowski            $this->elements = $tmpStack;
2409f8369d7dSTobias Sarnowski        }
2410f8369d7dSTobias Sarnowski        $this->elements = $finalStack;
2411f8369d7dSTobias Sarnowski        if ($_skipHistory) {
2412f8369d7dSTobias Sarnowski            return $this;
2413f8369d7dSTobias Sarnowski        } else {
2414f8369d7dSTobias Sarnowski            $this->debug("Stack length after filter(): ".count($finalStack));
2415f8369d7dSTobias Sarnowski            return $this->newInstance();
2416f8369d7dSTobias Sarnowski        }
2417f8369d7dSTobias Sarnowski    }
2418f8369d7dSTobias Sarnowski    /**
2419f8369d7dSTobias Sarnowski     *
2420f8369d7dSTobias Sarnowski     * @param $value
2421f8369d7dSTobias Sarnowski     * @return unknown_type
2422f8369d7dSTobias Sarnowski     * @TODO implement in all methods using passed parameters
2423f8369d7dSTobias Sarnowski     */
2424f8369d7dSTobias Sarnowski    protected static function unQuote($value) {
2425f8369d7dSTobias Sarnowski        return $value[0] == '\'' || $value[0] == '"'
2426f8369d7dSTobias Sarnowski            ? substr($value, 1, -1)
2427f8369d7dSTobias Sarnowski            : $value;
2428f8369d7dSTobias Sarnowski    }
2429f8369d7dSTobias Sarnowski    /**
2430f8369d7dSTobias Sarnowski     * Enter description here...
2431f8369d7dSTobias Sarnowski     *
2432f8369d7dSTobias Sarnowski     * @link http://docs.jquery.com/Ajax/load
2433f8369d7dSTobias Sarnowski     * @return phpQuery|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2434f8369d7dSTobias Sarnowski     * @todo Support $selector
2435f8369d7dSTobias Sarnowski     */
2436f8369d7dSTobias Sarnowski    public function load($url, $data = null, $callback = null) {
2437f8369d7dSTobias Sarnowski        if ($data && ! is_array($data)) {
2438f8369d7dSTobias Sarnowski            $callback = $data;
2439f8369d7dSTobias Sarnowski            $data = null;
2440f8369d7dSTobias Sarnowski        }
2441f8369d7dSTobias Sarnowski        if (mb_strpos($url, ' ') !== false) {
2442f8369d7dSTobias Sarnowski            $matches = null;
2443f8369d7dSTobias Sarnowski            if (extension_loaded('mbstring') && phpQuery::$mbstringSupport)
2444f8369d7dSTobias Sarnowski                mb_ereg('^([^ ]+) (.*)$', $url, $matches);
2445f8369d7dSTobias Sarnowski            else
2446f8369d7dSTobias Sarnowski                preg_match('^([^ ]+) (.*)$', $url, $matches);
2447f8369d7dSTobias Sarnowski            $url = $matches[1];
2448f8369d7dSTobias Sarnowski            $selector = $matches[2];
2449f8369d7dSTobias Sarnowski            // FIXME this sucks, pass as callback param
2450f8369d7dSTobias Sarnowski            $this->_loadSelector = $selector;
2451f8369d7dSTobias Sarnowski        }
2452f8369d7dSTobias Sarnowski        $ajax = array(
2453f8369d7dSTobias Sarnowski            'url' => $url,
2454f8369d7dSTobias Sarnowski            'type' => $data ? 'POST' : 'GET',
2455f8369d7dSTobias Sarnowski            'data' => $data,
2456f8369d7dSTobias Sarnowski            'complete' => $callback,
2457e6a9d76fSSyntaxseed            'success' => array($this, 'loadSuccess')
2458f8369d7dSTobias Sarnowski        );
2459f8369d7dSTobias Sarnowski        phpQuery::ajax($ajax);
2460f8369d7dSTobias Sarnowski        return $this;
2461f8369d7dSTobias Sarnowski    }
2462f8369d7dSTobias Sarnowski    /**
2463f8369d7dSTobias Sarnowski     * @access private
2464f8369d7dSTobias Sarnowski     * @param $html
2465f8369d7dSTobias Sarnowski     * @return unknown_type
2466f8369d7dSTobias Sarnowski     */
2467e6a9d76fSSyntaxseed    public function loadSuccess($html) {
2468f8369d7dSTobias Sarnowski        if ($this->_loadSelector) {
2469f8369d7dSTobias Sarnowski            $html = phpQuery::newDocument($html)->find($this->_loadSelector);
2470f8369d7dSTobias Sarnowski            unset($this->_loadSelector);
2471f8369d7dSTobias Sarnowski        }
2472f8369d7dSTobias Sarnowski        foreach($this->stack(1) as $node) {
2473f8369d7dSTobias Sarnowski            phpQuery::pq($node, $this->getDocumentID())
2474f8369d7dSTobias Sarnowski                ->markup($html);
2475f8369d7dSTobias Sarnowski        }
2476f8369d7dSTobias Sarnowski    }
2477f8369d7dSTobias Sarnowski    /**
2478f8369d7dSTobias Sarnowski     * Enter description here...
2479f8369d7dSTobias Sarnowski     *
2480f8369d7dSTobias Sarnowski     * @return phpQuery|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2481f8369d7dSTobias Sarnowski     * @todo
2482f8369d7dSTobias Sarnowski     */
2483f8369d7dSTobias Sarnowski    public function css() {
2484f8369d7dSTobias Sarnowski        // TODO
2485f8369d7dSTobias Sarnowski        return $this;
2486f8369d7dSTobias Sarnowski    }
2487f8369d7dSTobias Sarnowski    /**
2488f8369d7dSTobias Sarnowski     * @todo
2489f8369d7dSTobias Sarnowski     *
2490f8369d7dSTobias Sarnowski     */
2491f8369d7dSTobias Sarnowski    public function show(){
2492f8369d7dSTobias Sarnowski        // TODO
2493f8369d7dSTobias Sarnowski        return $this;
2494f8369d7dSTobias Sarnowski    }
2495f8369d7dSTobias Sarnowski    /**
2496f8369d7dSTobias Sarnowski     * @todo
2497f8369d7dSTobias Sarnowski     *
2498f8369d7dSTobias Sarnowski     */
2499f8369d7dSTobias Sarnowski    public function hide(){
2500f8369d7dSTobias Sarnowski        // TODO
2501f8369d7dSTobias Sarnowski        return $this;
2502f8369d7dSTobias Sarnowski    }
2503f8369d7dSTobias Sarnowski    /**
2504f8369d7dSTobias Sarnowski     * Trigger a type of event on every matched element.
2505f8369d7dSTobias Sarnowski     *
2506f8369d7dSTobias Sarnowski     * @param unknown_type $type
2507f8369d7dSTobias Sarnowski     * @param unknown_type $data
2508f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2509f8369d7dSTobias Sarnowski     * @TODO support more than event in $type (space-separated)
2510f8369d7dSTobias Sarnowski     */
2511f8369d7dSTobias Sarnowski    public function trigger($type, $data = array()) {
2512f8369d7dSTobias Sarnowski        foreach($this->elements as $node)
2513f8369d7dSTobias Sarnowski            phpQueryEvents::trigger($this->getDocumentID(), $type, $data, $node);
2514f8369d7dSTobias Sarnowski        return $this;
2515f8369d7dSTobias Sarnowski    }
2516f8369d7dSTobias Sarnowski    /**
2517f8369d7dSTobias Sarnowski     * This particular method triggers all bound event handlers on an element (for a specific event type) WITHOUT executing the browsers default actions.
2518f8369d7dSTobias Sarnowski     *
2519f8369d7dSTobias Sarnowski     * @param unknown_type $type
2520f8369d7dSTobias Sarnowski     * @param unknown_type $data
2521f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2522f8369d7dSTobias Sarnowski     * @TODO
2523f8369d7dSTobias Sarnowski     */
2524f8369d7dSTobias Sarnowski    public function triggerHandler($type, $data = array()) {
2525f8369d7dSTobias Sarnowski        // TODO;
2526f8369d7dSTobias Sarnowski    }
2527f8369d7dSTobias Sarnowski    /**
2528f8369d7dSTobias Sarnowski     * Binds a handler to one or more events (like click) for each matched element.
2529f8369d7dSTobias Sarnowski     * Can also bind custom events.
2530f8369d7dSTobias Sarnowski     *
2531f8369d7dSTobias Sarnowski     * @param unknown_type $type
2532f8369d7dSTobias Sarnowski     * @param unknown_type $data Optional
2533f8369d7dSTobias Sarnowski     * @param unknown_type $callback
2534f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2535f8369d7dSTobias Sarnowski     * @TODO support '!' (exclusive) events
2536f8369d7dSTobias Sarnowski     * @TODO support more than event in $type (space-separated)
2537f8369d7dSTobias Sarnowski     */
2538f8369d7dSTobias Sarnowski    public function bind($type, $data, $callback = null) {
2539f8369d7dSTobias Sarnowski        // TODO check if $data is callable, not using is_callable
2540f8369d7dSTobias Sarnowski        if (! isset($callback)) {
2541f8369d7dSTobias Sarnowski            $callback = $data;
2542f8369d7dSTobias Sarnowski            $data = null;
2543f8369d7dSTobias Sarnowski        }
2544f8369d7dSTobias Sarnowski        foreach($this->elements as $node)
2545f8369d7dSTobias Sarnowski            phpQueryEvents::add($this->getDocumentID(), $node, $type, $data, $callback);
2546f8369d7dSTobias Sarnowski        return $this;
2547f8369d7dSTobias Sarnowski    }
2548f8369d7dSTobias Sarnowski    /**
2549f8369d7dSTobias Sarnowski     * Enter description here...
2550f8369d7dSTobias Sarnowski     *
2551f8369d7dSTobias Sarnowski     * @param unknown_type $type
2552f8369d7dSTobias Sarnowski     * @param unknown_type $callback
2553f8369d7dSTobias Sarnowski     * @return unknown
2554f8369d7dSTobias Sarnowski     * @TODO namespace events
2555f8369d7dSTobias Sarnowski     * @TODO support more than event in $type (space-separated)
2556f8369d7dSTobias Sarnowski     */
2557f8369d7dSTobias Sarnowski    public function unbind($type = null, $callback = null) {
2558f8369d7dSTobias Sarnowski        foreach($this->elements as $node)
2559f8369d7dSTobias Sarnowski            phpQueryEvents::remove($this->getDocumentID(), $node, $type, $callback);
2560f8369d7dSTobias Sarnowski        return $this;
2561f8369d7dSTobias Sarnowski    }
2562f8369d7dSTobias Sarnowski    /**
2563f8369d7dSTobias Sarnowski     * Enter description here...
2564f8369d7dSTobias Sarnowski     *
2565f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2566f8369d7dSTobias Sarnowski     */
2567f8369d7dSTobias Sarnowski    public function change($callback = null) {
2568f8369d7dSTobias Sarnowski        if ($callback)
2569f8369d7dSTobias Sarnowski            return $this->bind('change', $callback);
2570f8369d7dSTobias Sarnowski        return $this->trigger('change');
2571f8369d7dSTobias Sarnowski    }
2572f8369d7dSTobias Sarnowski    /**
2573f8369d7dSTobias Sarnowski     * Enter description here...
2574f8369d7dSTobias Sarnowski     *
2575f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2576f8369d7dSTobias Sarnowski     */
2577f8369d7dSTobias Sarnowski    public function submit($callback = null) {
2578f8369d7dSTobias Sarnowski        if ($callback)
2579f8369d7dSTobias Sarnowski            return $this->bind('submit', $callback);
2580f8369d7dSTobias Sarnowski        return $this->trigger('submit');
2581f8369d7dSTobias Sarnowski    }
2582f8369d7dSTobias Sarnowski    /**
2583f8369d7dSTobias Sarnowski     * Enter description here...
2584f8369d7dSTobias Sarnowski     *
2585f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2586f8369d7dSTobias Sarnowski     */
2587f8369d7dSTobias Sarnowski    public function click($callback = null) {
2588f8369d7dSTobias Sarnowski        if ($callback)
2589f8369d7dSTobias Sarnowski            return $this->bind('click', $callback);
2590f8369d7dSTobias Sarnowski        return $this->trigger('click');
2591f8369d7dSTobias Sarnowski    }
2592f8369d7dSTobias Sarnowski    /**
2593f8369d7dSTobias Sarnowski     * Enter description here...
2594f8369d7dSTobias Sarnowski     *
2595f8369d7dSTobias Sarnowski     * @param String|phpQuery
2596f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2597f8369d7dSTobias Sarnowski     */
2598f8369d7dSTobias Sarnowski    public function wrapAllOld($wrapper) {
2599f8369d7dSTobias Sarnowski        $wrapper = pq($wrapper)->_clone();
2600f8369d7dSTobias Sarnowski        if (! $wrapper->length() || ! $this->length() )
2601f8369d7dSTobias Sarnowski            return $this;
2602f8369d7dSTobias Sarnowski        $wrapper->insertBefore($this->elements[0]);
2603f8369d7dSTobias Sarnowski        $deepest = $wrapper->elements[0];
2604f8369d7dSTobias Sarnowski        while($deepest->firstChild && $deepest->firstChild instanceof DOMELEMENT)
2605f8369d7dSTobias Sarnowski            $deepest = $deepest->firstChild;
2606f8369d7dSTobias Sarnowski        pq($deepest)->append($this);
2607f8369d7dSTobias Sarnowski        return $this;
2608f8369d7dSTobias Sarnowski    }
2609f8369d7dSTobias Sarnowski    /**
2610f8369d7dSTobias Sarnowski     * Enter description here...
2611f8369d7dSTobias Sarnowski     *
2612f8369d7dSTobias Sarnowski     * TODO testme...
2613f8369d7dSTobias Sarnowski     * @param String|phpQuery
2614f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2615f8369d7dSTobias Sarnowski     */
2616f8369d7dSTobias Sarnowski    public function wrapAll($wrapper) {
2617f8369d7dSTobias Sarnowski        if (! $this->length())
2618f8369d7dSTobias Sarnowski            return $this;
2619f8369d7dSTobias Sarnowski        return phpQuery::pq($wrapper, $this->getDocumentID())
2620f8369d7dSTobias Sarnowski            ->clone()
2621f8369d7dSTobias Sarnowski            ->insertBefore($this->get(0))
2622f8369d7dSTobias Sarnowski            ->map(array($this, '___wrapAllCallback'))
2623f8369d7dSTobias Sarnowski            ->append($this);
2624f8369d7dSTobias Sarnowski    }
2625f8369d7dSTobias Sarnowski  /**
2626f8369d7dSTobias Sarnowski   *
2627f8369d7dSTobias Sarnowski     * @param $node
2628f8369d7dSTobias Sarnowski     * @return unknown_type
2629f8369d7dSTobias Sarnowski     * @access private
2630f8369d7dSTobias Sarnowski   */
2631f8369d7dSTobias Sarnowski    public function ___wrapAllCallback($node) {
2632f8369d7dSTobias Sarnowski        $deepest = $node;
2633f8369d7dSTobias Sarnowski        while($deepest->firstChild && $deepest->firstChild instanceof DOMELEMENT)
2634f8369d7dSTobias Sarnowski            $deepest = $deepest->firstChild;
2635f8369d7dSTobias Sarnowski        return $deepest;
2636f8369d7dSTobias Sarnowski    }
2637f8369d7dSTobias Sarnowski    /**
2638f8369d7dSTobias Sarnowski     * Enter description here...
2639f8369d7dSTobias Sarnowski     * NON JQUERY METHOD
2640f8369d7dSTobias Sarnowski     *
2641f8369d7dSTobias Sarnowski     * @param String|phpQuery
2642f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2643f8369d7dSTobias Sarnowski     */
2644f8369d7dSTobias Sarnowski    public function wrapAllPHP($codeBefore, $codeAfter) {
2645f8369d7dSTobias Sarnowski        return $this
2646f8369d7dSTobias Sarnowski            ->slice(0, 1)
2647f8369d7dSTobias Sarnowski                ->beforePHP($codeBefore)
2648f8369d7dSTobias Sarnowski            ->end()
2649f8369d7dSTobias Sarnowski            ->slice(-1)
2650f8369d7dSTobias Sarnowski                ->afterPHP($codeAfter)
2651f8369d7dSTobias Sarnowski            ->end();
2652f8369d7dSTobias Sarnowski    }
2653f8369d7dSTobias Sarnowski    /**
2654f8369d7dSTobias Sarnowski     * Enter description here...
2655f8369d7dSTobias Sarnowski     *
2656f8369d7dSTobias Sarnowski     * @param String|phpQuery
2657f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2658f8369d7dSTobias Sarnowski     */
2659f8369d7dSTobias Sarnowski    public function wrap($wrapper) {
2660f8369d7dSTobias Sarnowski        foreach($this->stack() as $node)
2661f8369d7dSTobias Sarnowski            phpQuery::pq($node, $this->getDocumentID())->wrapAll($wrapper);
2662f8369d7dSTobias Sarnowski        return $this;
2663f8369d7dSTobias Sarnowski    }
2664f8369d7dSTobias Sarnowski    /**
2665f8369d7dSTobias Sarnowski     * Enter description here...
2666f8369d7dSTobias Sarnowski     *
2667f8369d7dSTobias Sarnowski     * @param String|phpQuery
2668f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2669f8369d7dSTobias Sarnowski     */
2670f8369d7dSTobias Sarnowski    public function wrapPHP($codeBefore, $codeAfter) {
2671f8369d7dSTobias Sarnowski        foreach($this->stack() as $node)
2672f8369d7dSTobias Sarnowski            phpQuery::pq($node, $this->getDocumentID())->wrapAllPHP($codeBefore, $codeAfter);
2673f8369d7dSTobias Sarnowski        return $this;
2674f8369d7dSTobias Sarnowski    }
2675f8369d7dSTobias Sarnowski    /**
2676f8369d7dSTobias Sarnowski     * Enter description here...
2677f8369d7dSTobias Sarnowski     *
2678f8369d7dSTobias Sarnowski     * @param String|phpQuery
2679f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2680f8369d7dSTobias Sarnowski     */
2681f8369d7dSTobias Sarnowski    public function wrapInner($wrapper) {
2682f8369d7dSTobias Sarnowski        foreach($this->stack() as $node)
2683f8369d7dSTobias Sarnowski            phpQuery::pq($node, $this->getDocumentID())->contents()->wrapAll($wrapper);
2684f8369d7dSTobias Sarnowski        return $this;
2685f8369d7dSTobias Sarnowski    }
2686f8369d7dSTobias Sarnowski    /**
2687f8369d7dSTobias Sarnowski     * Enter description here...
2688f8369d7dSTobias Sarnowski     *
2689f8369d7dSTobias Sarnowski     * @param String|phpQuery
2690f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2691f8369d7dSTobias Sarnowski     */
2692f8369d7dSTobias Sarnowski    public function wrapInnerPHP($codeBefore, $codeAfter) {
2693f8369d7dSTobias Sarnowski        foreach($this->stack(1) as $node)
2694f8369d7dSTobias Sarnowski            phpQuery::pq($node, $this->getDocumentID())->contents()
2695f8369d7dSTobias Sarnowski                ->wrapAllPHP($codeBefore, $codeAfter);
2696f8369d7dSTobias Sarnowski        return $this;
2697f8369d7dSTobias Sarnowski    }
2698f8369d7dSTobias Sarnowski    /**
2699f8369d7dSTobias Sarnowski     * Enter description here...
2700f8369d7dSTobias Sarnowski     *
2701f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2702f8369d7dSTobias Sarnowski     * @testme Support for text nodes
2703f8369d7dSTobias Sarnowski     */
2704f8369d7dSTobias Sarnowski    public function contents() {
2705f8369d7dSTobias Sarnowski        $stack = array();
2706f8369d7dSTobias Sarnowski        foreach($this->stack(1) as $el) {
2707f8369d7dSTobias Sarnowski            // FIXME (fixed) http://code.google.com/p/phpquery/issues/detail?id=56
2708f8369d7dSTobias Sarnowski//          if (! isset($el->childNodes))
2709f8369d7dSTobias Sarnowski//              continue;
2710f8369d7dSTobias Sarnowski            foreach($el->childNodes as $node) {
2711f8369d7dSTobias Sarnowski                $stack[] = $node;
2712f8369d7dSTobias Sarnowski            }
2713f8369d7dSTobias Sarnowski        }
2714f8369d7dSTobias Sarnowski        return $this->newInstance($stack);
2715f8369d7dSTobias Sarnowski    }
2716f8369d7dSTobias Sarnowski    /**
2717f8369d7dSTobias Sarnowski     * Enter description here...
2718f8369d7dSTobias Sarnowski     *
2719f8369d7dSTobias Sarnowski     * jQuery difference.
2720f8369d7dSTobias Sarnowski     *
2721f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2722f8369d7dSTobias Sarnowski     */
2723f8369d7dSTobias Sarnowski    public function contentsUnwrap() {
2724f8369d7dSTobias Sarnowski        foreach($this->stack(1) as $node) {
2725f8369d7dSTobias Sarnowski            if (! $node->parentNode )
2726f8369d7dSTobias Sarnowski                continue;
2727f8369d7dSTobias Sarnowski            $childNodes = array();
2728f8369d7dSTobias Sarnowski            // any modification in DOM tree breaks childNodes iteration, so cache them first
2729f8369d7dSTobias Sarnowski            foreach($node->childNodes as $chNode )
2730f8369d7dSTobias Sarnowski                $childNodes[] = $chNode;
2731f8369d7dSTobias Sarnowski            foreach($childNodes as $chNode )
2732f8369d7dSTobias Sarnowski//              $node->parentNode->appendChild($chNode);
2733f8369d7dSTobias Sarnowski                $node->parentNode->insertBefore($chNode, $node);
2734f8369d7dSTobias Sarnowski            $node->parentNode->removeChild($node);
2735f8369d7dSTobias Sarnowski        }
2736f8369d7dSTobias Sarnowski        return $this;
2737f8369d7dSTobias Sarnowski    }
2738f8369d7dSTobias Sarnowski    /**
2739f8369d7dSTobias Sarnowski     * Enter description here...
2740f8369d7dSTobias Sarnowski     *
2741f8369d7dSTobias Sarnowski     * jQuery difference.
2742f8369d7dSTobias Sarnowski     */
2743f8369d7dSTobias Sarnowski    public function switchWith($markup) {
2744f8369d7dSTobias Sarnowski        $markup = pq($markup, $this->getDocumentID());
2745f8369d7dSTobias Sarnowski        $content = null;
2746f8369d7dSTobias Sarnowski        foreach($this->stack(1) as $node) {
2747f8369d7dSTobias Sarnowski            pq($node)
2748f8369d7dSTobias Sarnowski                ->contents()->toReference($content)->end()
2749f8369d7dSTobias Sarnowski                ->replaceWith($markup->clone()->append($content));
2750f8369d7dSTobias Sarnowski        }
2751f8369d7dSTobias Sarnowski        return $this;
2752f8369d7dSTobias Sarnowski    }
2753f8369d7dSTobias Sarnowski    /**
2754f8369d7dSTobias Sarnowski     * Enter description here...
2755f8369d7dSTobias Sarnowski     *
2756f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2757f8369d7dSTobias Sarnowski     */
2758f8369d7dSTobias Sarnowski    public function eq($num) {
2759f8369d7dSTobias Sarnowski        $oldStack = $this->elements;
2760f8369d7dSTobias Sarnowski        $this->elementsBackup = $this->elements;
2761f8369d7dSTobias Sarnowski        $this->elements = array();
2762f8369d7dSTobias Sarnowski        if ( isset($oldStack[$num]) )
2763f8369d7dSTobias Sarnowski            $this->elements[] = $oldStack[$num];
2764f8369d7dSTobias Sarnowski        return $this->newInstance();
2765f8369d7dSTobias Sarnowski    }
2766f8369d7dSTobias Sarnowski    /**
2767f8369d7dSTobias Sarnowski     * Enter description here...
2768f8369d7dSTobias Sarnowski     *
2769f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2770f8369d7dSTobias Sarnowski     */
2771f8369d7dSTobias Sarnowski    public function size() {
2772f8369d7dSTobias Sarnowski        return count($this->elements);
2773f8369d7dSTobias Sarnowski    }
2774f8369d7dSTobias Sarnowski    /**
2775f8369d7dSTobias Sarnowski     * Enter description here...
2776f8369d7dSTobias Sarnowski     *
2777f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2778f8369d7dSTobias Sarnowski     * @deprecated Use length as attribute
2779f8369d7dSTobias Sarnowski     */
2780f8369d7dSTobias Sarnowski    public function length() {
2781f8369d7dSTobias Sarnowski        return $this->size();
2782f8369d7dSTobias Sarnowski    }
2783f8369d7dSTobias Sarnowski    public function count() {
2784f8369d7dSTobias Sarnowski        return $this->size();
2785f8369d7dSTobias Sarnowski    }
2786f8369d7dSTobias Sarnowski    /**
2787f8369d7dSTobias Sarnowski     * Enter description here...
2788f8369d7dSTobias Sarnowski     *
2789f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2790f8369d7dSTobias Sarnowski     * @todo $level
2791f8369d7dSTobias Sarnowski     */
2792f8369d7dSTobias Sarnowski    public function end($level = 1) {
2793f8369d7dSTobias Sarnowski//      $this->elements = array_pop( $this->history );
2794f8369d7dSTobias Sarnowski//      return $this;
2795f8369d7dSTobias Sarnowski//      $this->previous->DOM = $this->DOM;
2796f8369d7dSTobias Sarnowski//      $this->previous->XPath = $this->XPath;
2797f8369d7dSTobias Sarnowski        return $this->previous
2798f8369d7dSTobias Sarnowski            ? $this->previous
2799f8369d7dSTobias Sarnowski            : $this;
2800f8369d7dSTobias Sarnowski    }
2801f8369d7dSTobias Sarnowski    /**
2802f8369d7dSTobias Sarnowski     * Enter description here...
2803f8369d7dSTobias Sarnowski     * Normal use ->clone() .
2804f8369d7dSTobias Sarnowski     *
2805f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2806f8369d7dSTobias Sarnowski     * @access private
2807f8369d7dSTobias Sarnowski     */
2808f8369d7dSTobias Sarnowski    public function _clone() {
2809f8369d7dSTobias Sarnowski        $newStack = array();
2810f8369d7dSTobias Sarnowski        //pr(array('copy... ', $this->whois()));
2811f8369d7dSTobias Sarnowski        //$this->dumpHistory('copy');
2812f8369d7dSTobias Sarnowski        $this->elementsBackup = $this->elements;
2813f8369d7dSTobias Sarnowski        foreach($this->elements as $node) {
2814f8369d7dSTobias Sarnowski            $newStack[] = $node->cloneNode(true);
2815f8369d7dSTobias Sarnowski        }
2816f8369d7dSTobias Sarnowski        $this->elements = $newStack;
2817f8369d7dSTobias Sarnowski        return $this->newInstance();
2818f8369d7dSTobias Sarnowski    }
2819f8369d7dSTobias Sarnowski    /**
2820f8369d7dSTobias Sarnowski     * Enter description here...
2821f8369d7dSTobias Sarnowski     *
2822f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2823f8369d7dSTobias Sarnowski     */
2824f8369d7dSTobias Sarnowski    public function replaceWithPHP($code) {
2825f8369d7dSTobias Sarnowski        return $this->replaceWith(phpQuery::php($code));
2826f8369d7dSTobias Sarnowski    }
2827f8369d7dSTobias Sarnowski    /**
2828f8369d7dSTobias Sarnowski     * Enter description here...
2829f8369d7dSTobias Sarnowski     *
2830f8369d7dSTobias Sarnowski     * @param String|phpQuery $content
2831f8369d7dSTobias Sarnowski     * @link http://docs.jquery.com/Manipulation/replaceWith#content
2832f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2833f8369d7dSTobias Sarnowski     */
2834f8369d7dSTobias Sarnowski    public function replaceWith($content) {
2835f8369d7dSTobias Sarnowski        return $this->after($content)->remove();
2836f8369d7dSTobias Sarnowski    }
2837f8369d7dSTobias Sarnowski    /**
2838f8369d7dSTobias Sarnowski     * Enter description here...
2839f8369d7dSTobias Sarnowski     *
2840f8369d7dSTobias Sarnowski     * @param String $selector
2841f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2842f8369d7dSTobias Sarnowski     * @todo this works ?
2843f8369d7dSTobias Sarnowski     */
2844f8369d7dSTobias Sarnowski    public function replaceAll($selector) {
2845f8369d7dSTobias Sarnowski        foreach(phpQuery::pq($selector, $this->getDocumentID()) as $node)
2846f8369d7dSTobias Sarnowski            phpQuery::pq($node, $this->getDocumentID())
2847f8369d7dSTobias Sarnowski                ->after($this->_clone())
2848f8369d7dSTobias Sarnowski                ->remove();
2849f8369d7dSTobias Sarnowski        return $this;
2850f8369d7dSTobias Sarnowski    }
2851f8369d7dSTobias Sarnowski    /**
2852f8369d7dSTobias Sarnowski     * Enter description here...
2853f8369d7dSTobias Sarnowski     *
2854f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2855f8369d7dSTobias Sarnowski     */
2856f8369d7dSTobias Sarnowski    public function remove($selector = null) {
2857f8369d7dSTobias Sarnowski        $loop = $selector
2858f8369d7dSTobias Sarnowski            ? $this->filter($selector)->elements
2859f8369d7dSTobias Sarnowski            : $this->elements;
2860f8369d7dSTobias Sarnowski        foreach($loop as $node) {
2861f8369d7dSTobias Sarnowski            if (! $node->parentNode )
2862f8369d7dSTobias Sarnowski                continue;
2863f8369d7dSTobias Sarnowski            if (isset($node->tagName))
2864f8369d7dSTobias Sarnowski                $this->debug("Removing '{$node->tagName}'");
2865f8369d7dSTobias Sarnowski            $node->parentNode->removeChild($node);
2866f8369d7dSTobias Sarnowski            // Mutation event
2867f8369d7dSTobias Sarnowski            $event = new DOMEvent(array(
2868f8369d7dSTobias Sarnowski                'target' => $node,
2869f8369d7dSTobias Sarnowski                'type' => 'DOMNodeRemoved'
2870f8369d7dSTobias Sarnowski            ));
2871f8369d7dSTobias Sarnowski            phpQueryEvents::trigger($this->getDocumentID(),
2872f8369d7dSTobias Sarnowski                $event->type, array($event), $node
2873f8369d7dSTobias Sarnowski            );
2874f8369d7dSTobias Sarnowski        }
2875f8369d7dSTobias Sarnowski        return $this;
2876f8369d7dSTobias Sarnowski    }
2877f8369d7dSTobias Sarnowski    protected function markupEvents($newMarkup, $oldMarkup, $node) {
2878f8369d7dSTobias Sarnowski        if ($node->tagName == 'textarea' && $newMarkup != $oldMarkup) {
2879f8369d7dSTobias Sarnowski            $event = new DOMEvent(array(
2880f8369d7dSTobias Sarnowski                'target' => $node,
2881f8369d7dSTobias Sarnowski                'type' => 'change'
2882f8369d7dSTobias Sarnowski            ));
2883f8369d7dSTobias Sarnowski            phpQueryEvents::trigger($this->getDocumentID(),
2884f8369d7dSTobias Sarnowski                $event->type, array($event), $node
2885f8369d7dSTobias Sarnowski            );
2886f8369d7dSTobias Sarnowski        }
2887f8369d7dSTobias Sarnowski    }
2888f8369d7dSTobias Sarnowski    /**
2889f8369d7dSTobias Sarnowski     * jQuey difference
2890f8369d7dSTobias Sarnowski     *
2891f8369d7dSTobias Sarnowski     * @param $markup
2892f8369d7dSTobias Sarnowski     * @return unknown_type
2893f8369d7dSTobias Sarnowski     * @TODO trigger change event for textarea
2894f8369d7dSTobias Sarnowski     */
2895f8369d7dSTobias Sarnowski    public function markup($markup = null, $callback1 = null, $callback2 = null, $callback3 = null) {
2896f8369d7dSTobias Sarnowski        $args = func_get_args();
2897f8369d7dSTobias Sarnowski        if ($this->documentWrapper->isXML)
2898f8369d7dSTobias Sarnowski            return call_user_func_array(array($this, 'xml'), $args);
2899f8369d7dSTobias Sarnowski        else
2900f8369d7dSTobias Sarnowski            return call_user_func_array(array($this, 'html'), $args);
2901f8369d7dSTobias Sarnowski    }
2902f8369d7dSTobias Sarnowski    /**
2903f8369d7dSTobias Sarnowski     * jQuey difference
2904f8369d7dSTobias Sarnowski     *
2905f8369d7dSTobias Sarnowski     * @param $markup
2906f8369d7dSTobias Sarnowski     * @return unknown_type
2907f8369d7dSTobias Sarnowski     */
2908f8369d7dSTobias Sarnowski    public function markupOuter($callback1 = null, $callback2 = null, $callback3 = null) {
2909f8369d7dSTobias Sarnowski        $args = func_get_args();
2910f8369d7dSTobias Sarnowski        if ($this->documentWrapper->isXML)
2911f8369d7dSTobias Sarnowski            return call_user_func_array(array($this, 'xmlOuter'), $args);
2912f8369d7dSTobias Sarnowski        else
2913f8369d7dSTobias Sarnowski            return call_user_func_array(array($this, 'htmlOuter'), $args);
2914f8369d7dSTobias Sarnowski    }
2915f8369d7dSTobias Sarnowski    /**
2916f8369d7dSTobias Sarnowski     * Enter description here...
2917f8369d7dSTobias Sarnowski     *
2918f8369d7dSTobias Sarnowski     * @param unknown_type $html
2919f8369d7dSTobias Sarnowski     * @return string|phpQuery|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2920f8369d7dSTobias Sarnowski     * @TODO force html result
2921f8369d7dSTobias Sarnowski     */
2922f8369d7dSTobias Sarnowski    public function html($html = null, $callback1 = null, $callback2 = null, $callback3 = null) {
2923f8369d7dSTobias Sarnowski        if (isset($html)) {
2924f8369d7dSTobias Sarnowski            // INSERT
2925f8369d7dSTobias Sarnowski            $nodes = $this->documentWrapper->import($html);
2926f8369d7dSTobias Sarnowski            $this->empty();
2927f8369d7dSTobias Sarnowski            foreach($this->stack(1) as $alreadyAdded => $node) {
2928f8369d7dSTobias Sarnowski                // for now, limit events for textarea
2929f8369d7dSTobias Sarnowski                if (($this->isXHTML() || $this->isHTML()) && $node->tagName == 'textarea')
2930f8369d7dSTobias Sarnowski                    $oldHtml = pq($node, $this->getDocumentID())->markup();
2931f8369d7dSTobias Sarnowski                foreach($nodes as $newNode) {
2932f8369d7dSTobias Sarnowski                    $node->appendChild($alreadyAdded
2933f8369d7dSTobias Sarnowski                        ? $newNode->cloneNode(true)
2934f8369d7dSTobias Sarnowski                        : $newNode
2935f8369d7dSTobias Sarnowski                    );
2936f8369d7dSTobias Sarnowski                }
2937f8369d7dSTobias Sarnowski                // for now, limit events for textarea
2938f8369d7dSTobias Sarnowski                if (($this->isXHTML() || $this->isHTML()) && $node->tagName == 'textarea')
2939f8369d7dSTobias Sarnowski                    $this->markupEvents($html, $oldHtml, $node);
2940f8369d7dSTobias Sarnowski            }
2941f8369d7dSTobias Sarnowski            return $this;
2942f8369d7dSTobias Sarnowski        } else {
2943f8369d7dSTobias Sarnowski            // FETCH
2944f8369d7dSTobias Sarnowski            $return = $this->documentWrapper->markup($this->elements, true);
2945f8369d7dSTobias Sarnowski            $args = func_get_args();
2946f8369d7dSTobias Sarnowski            foreach(array_slice($args, 1) as $callback) {
2947f8369d7dSTobias Sarnowski                $return = phpQuery::callbackRun($callback, array($return));
2948f8369d7dSTobias Sarnowski            }
2949f8369d7dSTobias Sarnowski            return $return;
2950f8369d7dSTobias Sarnowski        }
2951f8369d7dSTobias Sarnowski    }
2952f8369d7dSTobias Sarnowski    /**
2953f8369d7dSTobias Sarnowski     * @TODO force xml result
2954f8369d7dSTobias Sarnowski     */
2955f8369d7dSTobias Sarnowski    public function xml($xml = null, $callback1 = null, $callback2 = null, $callback3 = null) {
2956f8369d7dSTobias Sarnowski        $args = func_get_args();
2957f8369d7dSTobias Sarnowski        return call_user_func_array(array($this, 'html'), $args);
2958f8369d7dSTobias Sarnowski    }
2959f8369d7dSTobias Sarnowski    /**
2960f8369d7dSTobias Sarnowski     * Enter description here...
2961f8369d7dSTobias Sarnowski     * @TODO force html result
2962f8369d7dSTobias Sarnowski     *
2963f8369d7dSTobias Sarnowski     * @return String
2964f8369d7dSTobias Sarnowski     */
2965f8369d7dSTobias Sarnowski    public function htmlOuter($callback1 = null, $callback2 = null, $callback3 = null) {
2966f8369d7dSTobias Sarnowski        $markup = $this->documentWrapper->markup($this->elements);
2967f8369d7dSTobias Sarnowski        // pass thou callbacks
2968f8369d7dSTobias Sarnowski        $args = func_get_args();
2969f8369d7dSTobias Sarnowski        foreach($args as $callback) {
2970f8369d7dSTobias Sarnowski            $markup = phpQuery::callbackRun($callback, array($markup));
2971f8369d7dSTobias Sarnowski        }
2972f8369d7dSTobias Sarnowski        return $markup;
2973f8369d7dSTobias Sarnowski    }
2974f8369d7dSTobias Sarnowski    /**
2975f8369d7dSTobias Sarnowski     * @TODO force xml result
2976f8369d7dSTobias Sarnowski     */
2977f8369d7dSTobias Sarnowski    public function xmlOuter($callback1 = null, $callback2 = null, $callback3 = null) {
2978f8369d7dSTobias Sarnowski        $args = func_get_args();
2979f8369d7dSTobias Sarnowski        return call_user_func_array(array($this, 'htmlOuter'), $args);
2980f8369d7dSTobias Sarnowski    }
2981f8369d7dSTobias Sarnowski    public function __toString() {
2982f8369d7dSTobias Sarnowski        return $this->markupOuter();
2983f8369d7dSTobias Sarnowski    }
2984f8369d7dSTobias Sarnowski    /**
2985f8369d7dSTobias Sarnowski     * Just like html(), but returns markup with VALID (dangerous) PHP tags.
2986f8369d7dSTobias Sarnowski     *
2987f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
2988f8369d7dSTobias Sarnowski     * @todo support returning markup with PHP tags when called without param
2989f8369d7dSTobias Sarnowski     */
2990f8369d7dSTobias Sarnowski    public function php($code = null) {
2991f8369d7dSTobias Sarnowski        return $this->markupPHP($code);
2992f8369d7dSTobias Sarnowski    }
2993f8369d7dSTobias Sarnowski    /**
2994f8369d7dSTobias Sarnowski     * Enter description here...
2995f8369d7dSTobias Sarnowski     *
2996f8369d7dSTobias Sarnowski     * @param $code
2997f8369d7dSTobias Sarnowski     * @return unknown_type
2998f8369d7dSTobias Sarnowski     */
2999f8369d7dSTobias Sarnowski    public function markupPHP($code = null) {
3000f8369d7dSTobias Sarnowski        return isset($code)
3001f8369d7dSTobias Sarnowski            ? $this->markup(phpQuery::php($code))
3002f8369d7dSTobias Sarnowski            : phpQuery::markupToPHP($this->markup());
3003f8369d7dSTobias Sarnowski    }
3004f8369d7dSTobias Sarnowski    /**
3005f8369d7dSTobias Sarnowski     * Enter description here...
3006f8369d7dSTobias Sarnowski     *
3007f8369d7dSTobias Sarnowski     * @param $code
3008f8369d7dSTobias Sarnowski     * @return unknown_type
3009f8369d7dSTobias Sarnowski     */
3010f8369d7dSTobias Sarnowski    public function markupOuterPHP() {
3011f8369d7dSTobias Sarnowski        return phpQuery::markupToPHP($this->markupOuter());
3012f8369d7dSTobias Sarnowski    }
3013f8369d7dSTobias Sarnowski    /**
3014f8369d7dSTobias Sarnowski     * Enter description here...
3015f8369d7dSTobias Sarnowski     *
3016f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3017f8369d7dSTobias Sarnowski     */
3018f8369d7dSTobias Sarnowski    public function children($selector = null) {
3019f8369d7dSTobias Sarnowski        $stack = array();
3020f8369d7dSTobias Sarnowski        foreach($this->stack(1) as $node) {
3021f8369d7dSTobias Sarnowski//          foreach($node->getElementsByTagName('*') as $newNode) {
3022f8369d7dSTobias Sarnowski            foreach($node->childNodes as $newNode) {
3023f8369d7dSTobias Sarnowski                if ($newNode->nodeType != 1)
3024f8369d7dSTobias Sarnowski                    continue;
3025f8369d7dSTobias Sarnowski                if ($selector && ! $this->is($selector, $newNode))
3026f8369d7dSTobias Sarnowski                    continue;
3027f8369d7dSTobias Sarnowski                if ($this->elementsContainsNode($newNode, $stack))
3028f8369d7dSTobias Sarnowski                    continue;
3029f8369d7dSTobias Sarnowski                $stack[] = $newNode;
3030f8369d7dSTobias Sarnowski            }
3031f8369d7dSTobias Sarnowski        }
3032f8369d7dSTobias Sarnowski        $this->elementsBackup = $this->elements;
3033f8369d7dSTobias Sarnowski        $this->elements = $stack;
3034f8369d7dSTobias Sarnowski        return $this->newInstance();
3035f8369d7dSTobias Sarnowski    }
3036f8369d7dSTobias Sarnowski    /**
3037f8369d7dSTobias Sarnowski     * Enter description here...
3038f8369d7dSTobias Sarnowski     *
3039f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3040f8369d7dSTobias Sarnowski     */
3041f8369d7dSTobias Sarnowski    public function ancestors($selector = null) {
3042f8369d7dSTobias Sarnowski        return $this->children( $selector );
3043f8369d7dSTobias Sarnowski    }
3044f8369d7dSTobias Sarnowski    /**
3045f8369d7dSTobias Sarnowski     * Enter description here...
3046f8369d7dSTobias Sarnowski     *
3047f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3048f8369d7dSTobias Sarnowski     */
3049f8369d7dSTobias Sarnowski    public function append( $content) {
3050f8369d7dSTobias Sarnowski        return $this->insert($content, __FUNCTION__);
3051f8369d7dSTobias Sarnowski    }
3052f8369d7dSTobias Sarnowski    /**
3053f8369d7dSTobias Sarnowski     * Enter description here...
3054f8369d7dSTobias Sarnowski     *
3055f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3056f8369d7dSTobias Sarnowski     */
3057f8369d7dSTobias Sarnowski    public function appendPHP( $content) {
3058f8369d7dSTobias Sarnowski        return $this->insert("<php><!-- {$content} --></php>", 'append');
3059f8369d7dSTobias Sarnowski    }
3060f8369d7dSTobias Sarnowski    /**
3061f8369d7dSTobias Sarnowski     * Enter description here...
3062f8369d7dSTobias Sarnowski     *
3063f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3064f8369d7dSTobias Sarnowski     */
3065f8369d7dSTobias Sarnowski    public function appendTo( $seletor) {
3066f8369d7dSTobias Sarnowski        return $this->insert($seletor, __FUNCTION__);
3067f8369d7dSTobias Sarnowski    }
3068f8369d7dSTobias Sarnowski    /**
3069f8369d7dSTobias Sarnowski     * Enter description here...
3070f8369d7dSTobias Sarnowski     *
3071f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3072f8369d7dSTobias Sarnowski     */
3073f8369d7dSTobias Sarnowski    public function prepend( $content) {
3074f8369d7dSTobias Sarnowski        return $this->insert($content, __FUNCTION__);
3075f8369d7dSTobias Sarnowski    }
3076f8369d7dSTobias Sarnowski    /**
3077f8369d7dSTobias Sarnowski     * Enter description here...
3078f8369d7dSTobias Sarnowski     *
3079f8369d7dSTobias Sarnowski     * @todo accept many arguments, which are joined, arrays maybe also
3080f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3081f8369d7dSTobias Sarnowski     */
3082f8369d7dSTobias Sarnowski    public function prependPHP( $content) {
3083f8369d7dSTobias Sarnowski        return $this->insert("<php><!-- {$content} --></php>", 'prepend');
3084f8369d7dSTobias Sarnowski    }
3085f8369d7dSTobias Sarnowski    /**
3086f8369d7dSTobias Sarnowski     * Enter description here...
3087f8369d7dSTobias Sarnowski     *
3088f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3089f8369d7dSTobias Sarnowski     */
3090f8369d7dSTobias Sarnowski    public function prependTo( $seletor) {
3091f8369d7dSTobias Sarnowski        return $this->insert($seletor, __FUNCTION__);
3092f8369d7dSTobias Sarnowski    }
3093f8369d7dSTobias Sarnowski    /**
3094f8369d7dSTobias Sarnowski     * Enter description here...
3095f8369d7dSTobias Sarnowski     *
3096f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3097f8369d7dSTobias Sarnowski     */
3098f8369d7dSTobias Sarnowski    public function before($content) {
3099f8369d7dSTobias Sarnowski        return $this->insert($content, __FUNCTION__);
3100f8369d7dSTobias Sarnowski    }
3101f8369d7dSTobias Sarnowski    /**
3102f8369d7dSTobias Sarnowski     * Enter description here...
3103f8369d7dSTobias Sarnowski     *
3104f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3105f8369d7dSTobias Sarnowski     */
3106f8369d7dSTobias Sarnowski    public function beforePHP( $content) {
3107f8369d7dSTobias Sarnowski        return $this->insert("<php><!-- {$content} --></php>", 'before');
3108f8369d7dSTobias Sarnowski    }
3109f8369d7dSTobias Sarnowski    /**
3110f8369d7dSTobias Sarnowski     * Enter description here...
3111f8369d7dSTobias Sarnowski     *
3112f8369d7dSTobias Sarnowski     * @param String|phpQuery
3113f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3114f8369d7dSTobias Sarnowski     */
3115f8369d7dSTobias Sarnowski    public function insertBefore( $seletor) {
3116f8369d7dSTobias Sarnowski        return $this->insert($seletor, __FUNCTION__);
3117f8369d7dSTobias Sarnowski    }
3118f8369d7dSTobias Sarnowski    /**
3119f8369d7dSTobias Sarnowski     * Enter description here...
3120f8369d7dSTobias Sarnowski     *
3121f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3122f8369d7dSTobias Sarnowski     */
3123f8369d7dSTobias Sarnowski    public function after( $content) {
3124f8369d7dSTobias Sarnowski        return $this->insert($content, __FUNCTION__);
3125f8369d7dSTobias Sarnowski    }
3126f8369d7dSTobias Sarnowski    /**
3127f8369d7dSTobias Sarnowski     * Enter description here...
3128f8369d7dSTobias Sarnowski     *
3129f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3130f8369d7dSTobias Sarnowski     */
3131f8369d7dSTobias Sarnowski    public function afterPHP( $content) {
3132f8369d7dSTobias Sarnowski        return $this->insert("<php><!-- {$content} --></php>", 'after');
3133f8369d7dSTobias Sarnowski    }
3134f8369d7dSTobias Sarnowski    /**
3135f8369d7dSTobias Sarnowski     * Enter description here...
3136f8369d7dSTobias Sarnowski     *
3137f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3138f8369d7dSTobias Sarnowski     */
3139f8369d7dSTobias Sarnowski    public function insertAfter( $seletor) {
3140f8369d7dSTobias Sarnowski        return $this->insert($seletor, __FUNCTION__);
3141f8369d7dSTobias Sarnowski    }
3142f8369d7dSTobias Sarnowski    /**
3143f8369d7dSTobias Sarnowski     * Internal insert method. Don't use it.
3144f8369d7dSTobias Sarnowski     *
3145f8369d7dSTobias Sarnowski     * @param unknown_type $target
3146f8369d7dSTobias Sarnowski     * @param unknown_type $type
3147f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3148f8369d7dSTobias Sarnowski     * @access private
3149f8369d7dSTobias Sarnowski     */
3150f8369d7dSTobias Sarnowski    public function insert($target, $type) {
3151f8369d7dSTobias Sarnowski        $this->debug("Inserting data with '{$type}'");
3152f8369d7dSTobias Sarnowski        $to = false;
3153f8369d7dSTobias Sarnowski        switch( $type) {
3154f8369d7dSTobias Sarnowski            case 'appendTo':
3155f8369d7dSTobias Sarnowski            case 'prependTo':
3156f8369d7dSTobias Sarnowski            case 'insertBefore':
3157f8369d7dSTobias Sarnowski            case 'insertAfter':
3158f8369d7dSTobias Sarnowski                $to = true;
3159f8369d7dSTobias Sarnowski        }
3160f8369d7dSTobias Sarnowski        switch(gettype($target)) {
3161f8369d7dSTobias Sarnowski            case 'string':
3162f8369d7dSTobias Sarnowski                $insertFrom = $insertTo = array();
3163f8369d7dSTobias Sarnowski                if ($to) {
3164f8369d7dSTobias Sarnowski                    // INSERT TO
3165f8369d7dSTobias Sarnowski                    $insertFrom = $this->elements;
3166f8369d7dSTobias Sarnowski                    if (phpQuery::isMarkup($target)) {
3167f8369d7dSTobias Sarnowski                        // $target is new markup, import it
3168f8369d7dSTobias Sarnowski                        $insertTo = $this->documentWrapper->import($target);
3169f8369d7dSTobias Sarnowski                    // insert into selected element
3170f8369d7dSTobias Sarnowski                    } else {
3171f8369d7dSTobias Sarnowski                        // $tagret is a selector
3172f8369d7dSTobias Sarnowski                        $thisStack = $this->elements;
3173f8369d7dSTobias Sarnowski                        $this->toRoot();
3174f8369d7dSTobias Sarnowski                        $insertTo = $this->find($target)->elements;
3175f8369d7dSTobias Sarnowski                        $this->elements = $thisStack;
3176f8369d7dSTobias Sarnowski                    }
3177f8369d7dSTobias Sarnowski                } else {
3178f8369d7dSTobias Sarnowski                    // INSERT FROM
3179f8369d7dSTobias Sarnowski                    $insertTo = $this->elements;
3180f8369d7dSTobias Sarnowski                    $insertFrom = $this->documentWrapper->import($target);
3181f8369d7dSTobias Sarnowski                }
3182f8369d7dSTobias Sarnowski                break;
3183f8369d7dSTobias Sarnowski            case 'object':
3184f8369d7dSTobias Sarnowski                $insertFrom = $insertTo = array();
3185f8369d7dSTobias Sarnowski                // phpQuery
3186f8369d7dSTobias Sarnowski                if ($target instanceof self) {
3187f8369d7dSTobias Sarnowski                    if ($to) {
3188f8369d7dSTobias Sarnowski                        $insertTo = $target->elements;
3189f8369d7dSTobias Sarnowski                        if ($this->documentFragment && $this->stackIsRoot())
3190f8369d7dSTobias Sarnowski                            // get all body children
3191f8369d7dSTobias Sarnowski//                          $loop = $this->find('body > *')->elements;
3192f8369d7dSTobias Sarnowski                            // TODO test it, test it hard...
3193f8369d7dSTobias Sarnowski//                          $loop = $this->newInstance($this->root)->find('> *')->elements;
3194f8369d7dSTobias Sarnowski                            $loop = $this->root->childNodes;
3195f8369d7dSTobias Sarnowski                        else
3196f8369d7dSTobias Sarnowski                            $loop = $this->elements;
3197f8369d7dSTobias Sarnowski                        // import nodes if needed
3198f8369d7dSTobias Sarnowski                        $insertFrom = $this->getDocumentID() == $target->getDocumentID()
3199f8369d7dSTobias Sarnowski                            ? $loop
3200f8369d7dSTobias Sarnowski                            : $target->documentWrapper->import($loop);
3201f8369d7dSTobias Sarnowski                    } else {
3202f8369d7dSTobias Sarnowski                        $insertTo = $this->elements;
3203f8369d7dSTobias Sarnowski                        if ( $target->documentFragment && $target->stackIsRoot() )
3204f8369d7dSTobias Sarnowski                            // get all body children
3205f8369d7dSTobias Sarnowski//                          $loop = $target->find('body > *')->elements;
3206f8369d7dSTobias Sarnowski                            $loop = $target->root->childNodes;
3207f8369d7dSTobias Sarnowski                        else
3208f8369d7dSTobias Sarnowski                            $loop = $target->elements;
3209f8369d7dSTobias Sarnowski                        // import nodes if needed
3210f8369d7dSTobias Sarnowski                        $insertFrom = $this->getDocumentID() == $target->getDocumentID()
3211f8369d7dSTobias Sarnowski                            ? $loop
3212f8369d7dSTobias Sarnowski                            : $this->documentWrapper->import($loop);
3213f8369d7dSTobias Sarnowski                    }
3214f8369d7dSTobias Sarnowski                // DOMNODE
3215f8369d7dSTobias Sarnowski                } elseif ($target instanceof DOMNODE) {
3216f8369d7dSTobias Sarnowski                    // import node if needed
3217f8369d7dSTobias Sarnowski//                  if ( $target->ownerDocument != $this->DOM )
3218f8369d7dSTobias Sarnowski//                      $target = $this->DOM->importNode($target, true);
3219f8369d7dSTobias Sarnowski                    if ( $to) {
3220f8369d7dSTobias Sarnowski                        $insertTo = array($target);
3221f8369d7dSTobias Sarnowski                        if ($this->documentFragment && $this->stackIsRoot())
3222f8369d7dSTobias Sarnowski                            // get all body children
3223f8369d7dSTobias Sarnowski                            $loop = $this->root->childNodes;
3224f8369d7dSTobias Sarnowski//                          $loop = $this->find('body > *')->elements;
3225f8369d7dSTobias Sarnowski                        else
3226f8369d7dSTobias Sarnowski                            $loop = $this->elements;
3227f8369d7dSTobias Sarnowski                        foreach($loop as $fromNode)
3228f8369d7dSTobias Sarnowski                            // import nodes if needed
3229f8369d7dSTobias Sarnowski                            $insertFrom[] = ! $fromNode->ownerDocument->isSameNode($target->ownerDocument)
3230f8369d7dSTobias Sarnowski                                ? $target->ownerDocument->importNode($fromNode, true)
3231f8369d7dSTobias Sarnowski                                : $fromNode;
3232f8369d7dSTobias Sarnowski                    } else {
3233f8369d7dSTobias Sarnowski                        // import node if needed
3234f8369d7dSTobias Sarnowski                        if (! $target->ownerDocument->isSameNode($this->document))
3235f8369d7dSTobias Sarnowski                            $target = $this->document->importNode($target, true);
3236f8369d7dSTobias Sarnowski                        $insertTo = $this->elements;
3237f8369d7dSTobias Sarnowski                        $insertFrom[] = $target;
3238f8369d7dSTobias Sarnowski                    }
3239f8369d7dSTobias Sarnowski                }
3240f8369d7dSTobias Sarnowski                break;
3241f8369d7dSTobias Sarnowski        }
3242f8369d7dSTobias Sarnowski        phpQuery::debug("From ".count($insertFrom)."; To ".count($insertTo)." nodes");
3243f8369d7dSTobias Sarnowski        foreach($insertTo as $insertNumber => $toNode) {
3244f8369d7dSTobias Sarnowski            // we need static relative elements in some cases
3245f8369d7dSTobias Sarnowski            switch( $type) {
3246f8369d7dSTobias Sarnowski                case 'prependTo':
3247f8369d7dSTobias Sarnowski                case 'prepend':
3248f8369d7dSTobias Sarnowski                    $firstChild = $toNode->firstChild;
3249f8369d7dSTobias Sarnowski                    break;
3250f8369d7dSTobias Sarnowski                case 'insertAfter':
3251f8369d7dSTobias Sarnowski                case 'after':
3252f8369d7dSTobias Sarnowski                    $nextSibling = $toNode->nextSibling;
3253f8369d7dSTobias Sarnowski                    break;
3254f8369d7dSTobias Sarnowski            }
3255f8369d7dSTobias Sarnowski            foreach($insertFrom as $fromNode) {
3256f8369d7dSTobias Sarnowski                // clone if inserted already before
3257f8369d7dSTobias Sarnowski                $insert = $insertNumber
3258f8369d7dSTobias Sarnowski                    ? $fromNode->cloneNode(true)
3259f8369d7dSTobias Sarnowski                    : $fromNode;
3260f8369d7dSTobias Sarnowski                switch($type) {
3261f8369d7dSTobias Sarnowski                    case 'appendTo':
3262f8369d7dSTobias Sarnowski                    case 'append':
3263f8369d7dSTobias Sarnowski//                      $toNode->insertBefore(
3264f8369d7dSTobias Sarnowski//                          $fromNode,
3265f8369d7dSTobias Sarnowski//                          $toNode->lastChild->nextSibling
3266f8369d7dSTobias Sarnowski//                      );
3267f8369d7dSTobias Sarnowski                        $toNode->appendChild($insert);
3268f8369d7dSTobias Sarnowski                        $eventTarget = $insert;
3269f8369d7dSTobias Sarnowski                        break;
3270f8369d7dSTobias Sarnowski                    case 'prependTo':
3271f8369d7dSTobias Sarnowski                    case 'prepend':
3272f8369d7dSTobias Sarnowski                        $toNode->insertBefore(
3273f8369d7dSTobias Sarnowski                            $insert,
3274f8369d7dSTobias Sarnowski                            $firstChild
3275f8369d7dSTobias Sarnowski                        );
3276f8369d7dSTobias Sarnowski                        break;
3277f8369d7dSTobias Sarnowski                    case 'insertBefore':
3278f8369d7dSTobias Sarnowski                    case 'before':
3279f8369d7dSTobias Sarnowski                        if (! $toNode->parentNode)
3280f8369d7dSTobias Sarnowski                            throw new Exception("No parentNode, can't do {$type}()");
3281f8369d7dSTobias Sarnowski                        else
3282f8369d7dSTobias Sarnowski                            $toNode->parentNode->insertBefore(
3283f8369d7dSTobias Sarnowski                                $insert,
3284f8369d7dSTobias Sarnowski                                $toNode
3285f8369d7dSTobias Sarnowski                            );
3286f8369d7dSTobias Sarnowski                        break;
3287f8369d7dSTobias Sarnowski                    case 'insertAfter':
3288f8369d7dSTobias Sarnowski                    case 'after':
3289f8369d7dSTobias Sarnowski                        if (! $toNode->parentNode)
3290f8369d7dSTobias Sarnowski                            throw new Exception("No parentNode, can't do {$type}()");
3291f8369d7dSTobias Sarnowski                        else
3292f8369d7dSTobias Sarnowski                            $toNode->parentNode->insertBefore(
3293f8369d7dSTobias Sarnowski                                $insert,
3294f8369d7dSTobias Sarnowski                                $nextSibling
3295f8369d7dSTobias Sarnowski                            );
3296f8369d7dSTobias Sarnowski                        break;
3297f8369d7dSTobias Sarnowski                }
3298f8369d7dSTobias Sarnowski                // Mutation event
3299f8369d7dSTobias Sarnowski                $event = new DOMEvent(array(
3300f8369d7dSTobias Sarnowski                    'target' => $insert,
3301f8369d7dSTobias Sarnowski                    'type' => 'DOMNodeInserted'
3302f8369d7dSTobias Sarnowski                ));
3303f8369d7dSTobias Sarnowski                phpQueryEvents::trigger($this->getDocumentID(),
3304f8369d7dSTobias Sarnowski                    $event->type, array($event), $insert
3305f8369d7dSTobias Sarnowski                );
3306f8369d7dSTobias Sarnowski            }
3307f8369d7dSTobias Sarnowski        }
3308f8369d7dSTobias Sarnowski        return $this;
3309f8369d7dSTobias Sarnowski    }
3310f8369d7dSTobias Sarnowski    /**
3311f8369d7dSTobias Sarnowski     * Enter description here...
3312f8369d7dSTobias Sarnowski     *
3313f8369d7dSTobias Sarnowski     * @return Int
3314f8369d7dSTobias Sarnowski     */
3315f8369d7dSTobias Sarnowski    public function index($subject) {
3316f8369d7dSTobias Sarnowski        $index = -1;
3317f8369d7dSTobias Sarnowski        $subject = $subject instanceof phpQueryObject
3318f8369d7dSTobias Sarnowski            ? $subject->elements[0]
3319f8369d7dSTobias Sarnowski            : $subject;
3320f8369d7dSTobias Sarnowski        foreach($this->newInstance() as $k => $node) {
3321f8369d7dSTobias Sarnowski            if ($node->isSameNode($subject))
3322f8369d7dSTobias Sarnowski                $index = $k;
3323f8369d7dSTobias Sarnowski        }
3324f8369d7dSTobias Sarnowski        return $index;
3325f8369d7dSTobias Sarnowski    }
3326f8369d7dSTobias Sarnowski    /**
3327f8369d7dSTobias Sarnowski     * Enter description here...
3328f8369d7dSTobias Sarnowski     *
3329f8369d7dSTobias Sarnowski     * @param unknown_type $start
3330f8369d7dSTobias Sarnowski     * @param unknown_type $end
3331f8369d7dSTobias Sarnowski     *
3332f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3333f8369d7dSTobias Sarnowski     * @testme
3334f8369d7dSTobias Sarnowski     */
3335f8369d7dSTobias Sarnowski    public function slice($start, $end = null) {
3336f8369d7dSTobias Sarnowski//      $last = count($this->elements)-1;
3337f8369d7dSTobias Sarnowski//      $end = $end
3338f8369d7dSTobias Sarnowski//          ? min($end, $last)
3339f8369d7dSTobias Sarnowski//          : $last;
3340f8369d7dSTobias Sarnowski//      if ($start < 0)
3341f8369d7dSTobias Sarnowski//          $start = $last+$start;
3342f8369d7dSTobias Sarnowski//      if ($start > $last)
3343f8369d7dSTobias Sarnowski//          return array();
3344f8369d7dSTobias Sarnowski        if ($end > 0)
3345f8369d7dSTobias Sarnowski            $end = $end-$start;
3346f8369d7dSTobias Sarnowski        return $this->newInstance(
3347f8369d7dSTobias Sarnowski            array_slice($this->elements, $start, $end)
3348f8369d7dSTobias Sarnowski        );
3349f8369d7dSTobias Sarnowski    }
3350f8369d7dSTobias Sarnowski    /**
3351f8369d7dSTobias Sarnowski     * Enter description here...
3352f8369d7dSTobias Sarnowski     *
3353f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3354f8369d7dSTobias Sarnowski     */
3355f8369d7dSTobias Sarnowski    public function reverse() {
3356f8369d7dSTobias Sarnowski        $this->elementsBackup = $this->elements;
3357f8369d7dSTobias Sarnowski        $this->elements = array_reverse($this->elements);
3358f8369d7dSTobias Sarnowski        return $this->newInstance();
3359f8369d7dSTobias Sarnowski    }
3360f8369d7dSTobias Sarnowski    /**
3361f8369d7dSTobias Sarnowski     * Return joined text content.
3362f8369d7dSTobias Sarnowski     * @return String
3363f8369d7dSTobias Sarnowski     */
3364f8369d7dSTobias Sarnowski    public function text($text = null, $callback1 = null, $callback2 = null, $callback3 = null) {
3365f8369d7dSTobias Sarnowski        if (isset($text))
3366f8369d7dSTobias Sarnowski            return $this->html(htmlspecialchars($text));
3367f8369d7dSTobias Sarnowski        $args = func_get_args();
3368f8369d7dSTobias Sarnowski        $args = array_slice($args, 1);
3369f8369d7dSTobias Sarnowski        $return = '';
3370f8369d7dSTobias Sarnowski        foreach($this->elements as $node) {
3371f8369d7dSTobias Sarnowski            $text = $node->textContent;
3372f8369d7dSTobias Sarnowski            if (count($this->elements) > 1 && $text)
3373f8369d7dSTobias Sarnowski                $text .= "\n";
3374f8369d7dSTobias Sarnowski            foreach($args as $callback) {
3375f8369d7dSTobias Sarnowski                $text = phpQuery::callbackRun($callback, array($text));
3376f8369d7dSTobias Sarnowski            }
3377f8369d7dSTobias Sarnowski            $return .= $text;
3378f8369d7dSTobias Sarnowski        }
3379f8369d7dSTobias Sarnowski        return $return;
3380f8369d7dSTobias Sarnowski    }
3381f8369d7dSTobias Sarnowski    /**
3382f8369d7dSTobias Sarnowski     * Enter description here...
3383f8369d7dSTobias Sarnowski     *
3384f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3385f8369d7dSTobias Sarnowski     */
3386f8369d7dSTobias Sarnowski    public function plugin($class, $file = null) {
3387f8369d7dSTobias Sarnowski        phpQuery::plugin($class, $file);
3388f8369d7dSTobias Sarnowski        return $this;
3389f8369d7dSTobias Sarnowski    }
3390f8369d7dSTobias Sarnowski    /**
3391f8369d7dSTobias Sarnowski     * Deprecated, use $pq->plugin() instead.
3392f8369d7dSTobias Sarnowski     *
3393f8369d7dSTobias Sarnowski     * @deprecated
3394f8369d7dSTobias Sarnowski     * @param $class
3395f8369d7dSTobias Sarnowski     * @param $file
3396f8369d7dSTobias Sarnowski     * @return unknown_type
3397f8369d7dSTobias Sarnowski     */
3398f8369d7dSTobias Sarnowski    public static function extend($class, $file = null) {
3399f8369d7dSTobias Sarnowski        return $this->plugin($class, $file);
3400f8369d7dSTobias Sarnowski    }
3401f8369d7dSTobias Sarnowski    /**
3402f8369d7dSTobias Sarnowski     *
3403f8369d7dSTobias Sarnowski     * @access private
3404f8369d7dSTobias Sarnowski     * @param $method
3405f8369d7dSTobias Sarnowski     * @param $args
3406f8369d7dSTobias Sarnowski     * @return unknown_type
3407f8369d7dSTobias Sarnowski     */
3408f8369d7dSTobias Sarnowski    public function __call($method, $args) {
3409f8369d7dSTobias Sarnowski        $aliasMethods = array('clone', 'empty');
3410f8369d7dSTobias Sarnowski        if (isset(phpQuery::$extendMethods[$method])) {
3411f8369d7dSTobias Sarnowski            array_unshift($args, $this);
3412f8369d7dSTobias Sarnowski            return phpQuery::callbackRun(
3413f8369d7dSTobias Sarnowski                phpQuery::$extendMethods[$method], $args
3414f8369d7dSTobias Sarnowski            );
3415f8369d7dSTobias Sarnowski        } else if (isset(phpQuery::$pluginsMethods[$method])) {
3416f8369d7dSTobias Sarnowski            array_unshift($args, $this);
3417f8369d7dSTobias Sarnowski            $class = phpQuery::$pluginsMethods[$method];
3418f8369d7dSTobias Sarnowski            $realClass = "phpQueryObjectPlugin_$class";
3419f8369d7dSTobias Sarnowski            $return = call_user_func_array(
3420f8369d7dSTobias Sarnowski                array($realClass, $method),
3421f8369d7dSTobias Sarnowski                $args
3422f8369d7dSTobias Sarnowski            );
3423f8369d7dSTobias Sarnowski            // XXX deprecate ?
3424f8369d7dSTobias Sarnowski            return is_null($return)
3425f8369d7dSTobias Sarnowski                ? $this
3426f8369d7dSTobias Sarnowski                : $return;
3427f8369d7dSTobias Sarnowski        } else if (in_array($method, $aliasMethods)) {
3428f8369d7dSTobias Sarnowski            return call_user_func_array(array($this, '_'.$method), $args);
3429f8369d7dSTobias Sarnowski        } else
3430f8369d7dSTobias Sarnowski            throw new Exception("Method '{$method}' doesnt exist");
3431f8369d7dSTobias Sarnowski    }
3432f8369d7dSTobias Sarnowski    /**
3433f8369d7dSTobias Sarnowski     * Safe rename of next().
3434f8369d7dSTobias Sarnowski     *
3435f8369d7dSTobias Sarnowski     * Use it ONLY when need to call next() on an iterated object (in same time).
3436f8369d7dSTobias Sarnowski     * Normaly there is no need to do such thing ;)
3437f8369d7dSTobias Sarnowski     *
3438f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3439f8369d7dSTobias Sarnowski     * @access private
3440f8369d7dSTobias Sarnowski     */
3441f8369d7dSTobias Sarnowski    public function _next($selector = null) {
3442f8369d7dSTobias Sarnowski        return $this->newInstance(
3443f8369d7dSTobias Sarnowski            $this->getElementSiblings('nextSibling', $selector, true)
3444f8369d7dSTobias Sarnowski        );
3445f8369d7dSTobias Sarnowski    }
3446f8369d7dSTobias Sarnowski    /**
3447f8369d7dSTobias Sarnowski     * Use prev() and next().
3448f8369d7dSTobias Sarnowski     *
3449f8369d7dSTobias Sarnowski     * @deprecated
3450f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3451f8369d7dSTobias Sarnowski     * @access private
3452f8369d7dSTobias Sarnowski     */
3453f8369d7dSTobias Sarnowski    public function _prev($selector = null) {
3454f8369d7dSTobias Sarnowski        return $this->prev($selector);
3455f8369d7dSTobias Sarnowski    }
3456f8369d7dSTobias Sarnowski    /**
3457f8369d7dSTobias Sarnowski     * Enter description here...
3458f8369d7dSTobias Sarnowski     *
3459f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3460f8369d7dSTobias Sarnowski     */
3461f8369d7dSTobias Sarnowski    public function prev($selector = null) {
3462f8369d7dSTobias Sarnowski        return $this->newInstance(
3463f8369d7dSTobias Sarnowski            $this->getElementSiblings('previousSibling', $selector, true)
3464f8369d7dSTobias Sarnowski        );
3465f8369d7dSTobias Sarnowski    }
3466f8369d7dSTobias Sarnowski    /**
3467f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3468f8369d7dSTobias Sarnowski     * @todo
3469f8369d7dSTobias Sarnowski     */
3470f8369d7dSTobias Sarnowski    public function prevAll($selector = null) {
3471f8369d7dSTobias Sarnowski        return $this->newInstance(
3472f8369d7dSTobias Sarnowski            $this->getElementSiblings('previousSibling', $selector)
3473f8369d7dSTobias Sarnowski        );
3474f8369d7dSTobias Sarnowski    }
3475f8369d7dSTobias Sarnowski    /**
3476f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3477f8369d7dSTobias Sarnowski     * @todo FIXME: returns source elements insted of next siblings
3478f8369d7dSTobias Sarnowski     */
3479f8369d7dSTobias Sarnowski    public function nextAll($selector = null) {
3480f8369d7dSTobias Sarnowski        return $this->newInstance(
3481f8369d7dSTobias Sarnowski            $this->getElementSiblings('nextSibling', $selector)
3482f8369d7dSTobias Sarnowski        );
3483f8369d7dSTobias Sarnowski    }
3484f8369d7dSTobias Sarnowski    /**
3485f8369d7dSTobias Sarnowski     * @access private
3486f8369d7dSTobias Sarnowski     */
3487f8369d7dSTobias Sarnowski    protected function getElementSiblings($direction, $selector = null, $limitToOne = false) {
3488f8369d7dSTobias Sarnowski        $stack = array();
3489f8369d7dSTobias Sarnowski        $count = 0;
3490f8369d7dSTobias Sarnowski        foreach($this->stack() as $node) {
3491f8369d7dSTobias Sarnowski            $test = $node;
3492f8369d7dSTobias Sarnowski            while( isset($test->{$direction}) && $test->{$direction}) {
3493f8369d7dSTobias Sarnowski                $test = $test->{$direction};
3494f8369d7dSTobias Sarnowski                if (! $test instanceof DOMELEMENT)
3495f8369d7dSTobias Sarnowski                    continue;
3496f8369d7dSTobias Sarnowski                $stack[] = $test;
3497f8369d7dSTobias Sarnowski                if ($limitToOne)
3498f8369d7dSTobias Sarnowski                    break;
3499f8369d7dSTobias Sarnowski            }
3500f8369d7dSTobias Sarnowski        }
3501f8369d7dSTobias Sarnowski        if ($selector) {
3502f8369d7dSTobias Sarnowski            $stackOld = $this->elements;
3503f8369d7dSTobias Sarnowski            $this->elements = $stack;
3504f8369d7dSTobias Sarnowski            $stack = $this->filter($selector, true)->stack();
3505f8369d7dSTobias Sarnowski            $this->elements = $stackOld;
3506f8369d7dSTobias Sarnowski        }
3507f8369d7dSTobias Sarnowski        return $stack;
3508f8369d7dSTobias Sarnowski    }
3509f8369d7dSTobias Sarnowski    /**
3510f8369d7dSTobias Sarnowski     * Enter description here...
3511f8369d7dSTobias Sarnowski     *
3512f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3513f8369d7dSTobias Sarnowski     */
3514f8369d7dSTobias Sarnowski    public function siblings($selector = null) {
3515f8369d7dSTobias Sarnowski        $stack = array();
3516f8369d7dSTobias Sarnowski        $siblings = array_merge(
3517f8369d7dSTobias Sarnowski            $this->getElementSiblings('previousSibling', $selector),
3518f8369d7dSTobias Sarnowski            $this->getElementSiblings('nextSibling', $selector)
3519f8369d7dSTobias Sarnowski        );
3520f8369d7dSTobias Sarnowski        foreach($siblings as $node) {
3521f8369d7dSTobias Sarnowski            if (! $this->elementsContainsNode($node, $stack))
3522f8369d7dSTobias Sarnowski                $stack[] = $node;
3523f8369d7dSTobias Sarnowski        }
3524f8369d7dSTobias Sarnowski        return $this->newInstance($stack);
3525f8369d7dSTobias Sarnowski    }
3526f8369d7dSTobias Sarnowski    /**
3527f8369d7dSTobias Sarnowski     * Enter description here...
3528f8369d7dSTobias Sarnowski     *
3529f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3530f8369d7dSTobias Sarnowski     */
3531f8369d7dSTobias Sarnowski    public function not($selector = null) {
3532f8369d7dSTobias Sarnowski        if (is_string($selector))
3533f8369d7dSTobias Sarnowski            phpQuery::debug(array('not', $selector));
3534f8369d7dSTobias Sarnowski        else
3535f8369d7dSTobias Sarnowski            phpQuery::debug('not');
3536f8369d7dSTobias Sarnowski        $stack = array();
3537f8369d7dSTobias Sarnowski        if ($selector instanceof self || $selector instanceof DOMNODE) {
3538f8369d7dSTobias Sarnowski            foreach($this->stack() as $node) {
3539f8369d7dSTobias Sarnowski                if ($selector instanceof self) {
3540f8369d7dSTobias Sarnowski                    $matchFound = false;
3541f8369d7dSTobias Sarnowski                    foreach($selector->stack() as $notNode) {
3542f8369d7dSTobias Sarnowski                        if ($notNode->isSameNode($node))
3543f8369d7dSTobias Sarnowski                            $matchFound = true;
3544f8369d7dSTobias Sarnowski                    }
3545f8369d7dSTobias Sarnowski                    if (! $matchFound)
3546f8369d7dSTobias Sarnowski                        $stack[] = $node;
3547f8369d7dSTobias Sarnowski                } else if ($selector instanceof DOMNODE) {
3548f8369d7dSTobias Sarnowski                    if (! $selector->isSameNode($node))
3549f8369d7dSTobias Sarnowski                        $stack[] = $node;
3550f8369d7dSTobias Sarnowski                } else {
3551f8369d7dSTobias Sarnowski                    if (! $this->is($selector))
3552f8369d7dSTobias Sarnowski                        $stack[] = $node;
3553f8369d7dSTobias Sarnowski                }
3554f8369d7dSTobias Sarnowski            }
3555f8369d7dSTobias Sarnowski        } else {
3556f8369d7dSTobias Sarnowski            $orgStack = $this->stack();
3557f8369d7dSTobias Sarnowski            $matched = $this->filter($selector, true)->stack();
3558f8369d7dSTobias Sarnowski//          $matched = array();
3559f8369d7dSTobias Sarnowski//          // simulate OR in filter() instead of AND 5y
3560f8369d7dSTobias Sarnowski//          foreach($this->parseSelector($selector) as $s) {
3561f8369d7dSTobias Sarnowski//              $matched = array_merge($matched,
3562f8369d7dSTobias Sarnowski//                  $this->filter(array($s))->stack()
3563f8369d7dSTobias Sarnowski//              );
3564f8369d7dSTobias Sarnowski//          }
3565f8369d7dSTobias Sarnowski            foreach($orgStack as $node)
3566f8369d7dSTobias Sarnowski                if (! $this->elementsContainsNode($node, $matched))
3567f8369d7dSTobias Sarnowski                    $stack[] = $node;
3568f8369d7dSTobias Sarnowski        }
3569f8369d7dSTobias Sarnowski        return $this->newInstance($stack);
3570f8369d7dSTobias Sarnowski    }
3571f8369d7dSTobias Sarnowski    /**
3572f8369d7dSTobias Sarnowski     * Enter description here...
3573f8369d7dSTobias Sarnowski     *
3574f8369d7dSTobias Sarnowski     * @param string|phpQueryObject
3575f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3576f8369d7dSTobias Sarnowski     */
3577f8369d7dSTobias Sarnowski    public function add($selector = null) {
3578f8369d7dSTobias Sarnowski        if (! $selector)
3579f8369d7dSTobias Sarnowski            return $this;
3580f8369d7dSTobias Sarnowski        $stack = array();
3581f8369d7dSTobias Sarnowski        $this->elementsBackup = $this->elements;
3582f8369d7dSTobias Sarnowski        $found = phpQuery::pq($selector, $this->getDocumentID());
3583f8369d7dSTobias Sarnowski        $this->merge($found->elements);
3584f8369d7dSTobias Sarnowski        return $this->newInstance();
3585f8369d7dSTobias Sarnowski    }
3586f8369d7dSTobias Sarnowski    /**
3587f8369d7dSTobias Sarnowski     * @access private
3588f8369d7dSTobias Sarnowski     */
3589f8369d7dSTobias Sarnowski    protected function merge() {
3590f8369d7dSTobias Sarnowski        foreach(func_get_args() as $nodes)
3591f8369d7dSTobias Sarnowski            foreach($nodes as $newNode )
3592f8369d7dSTobias Sarnowski                if (! $this->elementsContainsNode($newNode) )
3593f8369d7dSTobias Sarnowski                    $this->elements[] = $newNode;
3594f8369d7dSTobias Sarnowski    }
3595f8369d7dSTobias Sarnowski    /**
3596f8369d7dSTobias Sarnowski     * @access private
3597f8369d7dSTobias Sarnowski     * TODO refactor to stackContainsNode
3598f8369d7dSTobias Sarnowski     */
3599f8369d7dSTobias Sarnowski    protected function elementsContainsNode($nodeToCheck, $elementsStack = null) {
3600f8369d7dSTobias Sarnowski        $loop = ! is_null($elementsStack)
3601f8369d7dSTobias Sarnowski            ? $elementsStack
3602f8369d7dSTobias Sarnowski            : $this->elements;
3603f8369d7dSTobias Sarnowski        foreach($loop as $node) {
3604f8369d7dSTobias Sarnowski            if ( $node->isSameNode( $nodeToCheck ) )
3605f8369d7dSTobias Sarnowski                return true;
3606f8369d7dSTobias Sarnowski        }
3607f8369d7dSTobias Sarnowski        return false;
3608f8369d7dSTobias Sarnowski    }
3609f8369d7dSTobias Sarnowski    /**
3610f8369d7dSTobias Sarnowski     * Enter description here...
3611f8369d7dSTobias Sarnowski     *
3612f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3613f8369d7dSTobias Sarnowski     */
3614f8369d7dSTobias Sarnowski    public function parent($selector = null) {
3615f8369d7dSTobias Sarnowski        $stack = array();
3616f8369d7dSTobias Sarnowski        foreach($this->elements as $node )
3617f8369d7dSTobias Sarnowski            if ( $node->parentNode && ! $this->elementsContainsNode($node->parentNode, $stack) )
3618f8369d7dSTobias Sarnowski                $stack[] = $node->parentNode;
3619f8369d7dSTobias Sarnowski        $this->elementsBackup = $this->elements;
3620f8369d7dSTobias Sarnowski        $this->elements = $stack;
3621f8369d7dSTobias Sarnowski        if ( $selector )
3622f8369d7dSTobias Sarnowski            $this->filter($selector, true);
3623f8369d7dSTobias Sarnowski        return $this->newInstance();
3624f8369d7dSTobias Sarnowski    }
3625f8369d7dSTobias Sarnowski    /**
3626f8369d7dSTobias Sarnowski     * Enter description here...
3627f8369d7dSTobias Sarnowski     *
3628f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3629f8369d7dSTobias Sarnowski     */
3630f8369d7dSTobias Sarnowski    public function parents($selector = null) {
3631f8369d7dSTobias Sarnowski        $stack = array();
3632f8369d7dSTobias Sarnowski        if (! $this->elements )
3633f8369d7dSTobias Sarnowski            $this->debug('parents() - stack empty');
3634f8369d7dSTobias Sarnowski        foreach($this->elements as $node) {
3635f8369d7dSTobias Sarnowski            $test = $node;
3636f8369d7dSTobias Sarnowski            while( $test->parentNode) {
3637f8369d7dSTobias Sarnowski                $test = $test->parentNode;
3638f8369d7dSTobias Sarnowski                if ($this->isRoot($test))
3639f8369d7dSTobias Sarnowski                    break;
3640f8369d7dSTobias Sarnowski                if (! $this->elementsContainsNode($test, $stack)) {
3641f8369d7dSTobias Sarnowski                    $stack[] = $test;
3642f8369d7dSTobias Sarnowski                    continue;
3643f8369d7dSTobias Sarnowski                }
3644f8369d7dSTobias Sarnowski            }
3645f8369d7dSTobias Sarnowski        }
3646f8369d7dSTobias Sarnowski        $this->elementsBackup = $this->elements;
3647f8369d7dSTobias Sarnowski        $this->elements = $stack;
3648f8369d7dSTobias Sarnowski        if ( $selector )
3649f8369d7dSTobias Sarnowski            $this->filter($selector, true);
3650f8369d7dSTobias Sarnowski        return $this->newInstance();
3651f8369d7dSTobias Sarnowski    }
3652f8369d7dSTobias Sarnowski    /**
3653f8369d7dSTobias Sarnowski     * Internal stack iterator.
3654f8369d7dSTobias Sarnowski     *
3655f8369d7dSTobias Sarnowski     * @access private
3656f8369d7dSTobias Sarnowski     */
3657f8369d7dSTobias Sarnowski    public function stack($nodeTypes = null) {
3658f8369d7dSTobias Sarnowski        if (!isset($nodeTypes))
3659f8369d7dSTobias Sarnowski            return $this->elements;
3660f8369d7dSTobias Sarnowski        if (!is_array($nodeTypes))
3661f8369d7dSTobias Sarnowski            $nodeTypes = array($nodeTypes);
3662f8369d7dSTobias Sarnowski        $return = array();
3663f8369d7dSTobias Sarnowski        foreach($this->elements as $node) {
3664f8369d7dSTobias Sarnowski            if (in_array($node->nodeType, $nodeTypes))
3665f8369d7dSTobias Sarnowski                $return[] = $node;
3666f8369d7dSTobias Sarnowski        }
3667f8369d7dSTobias Sarnowski        return $return;
3668f8369d7dSTobias Sarnowski    }
3669f8369d7dSTobias Sarnowski    // TODO phpdoc; $oldAttr is result of hasAttribute, before any changes
3670f8369d7dSTobias Sarnowski    protected function attrEvents($attr, $oldAttr, $oldValue, $node) {
3671f8369d7dSTobias Sarnowski        // skip events for XML documents
3672f8369d7dSTobias Sarnowski        if (! $this->isXHTML() && ! $this->isHTML())
3673f8369d7dSTobias Sarnowski            return;
3674f8369d7dSTobias Sarnowski        $event = null;
3675f8369d7dSTobias Sarnowski        // identify
3676f8369d7dSTobias Sarnowski        $isInputValue = $node->tagName == 'input'
3677f8369d7dSTobias Sarnowski            && (
3678f8369d7dSTobias Sarnowski                in_array($node->getAttribute('type'),
3679f8369d7dSTobias Sarnowski                    array('text', 'password', 'hidden'))
3680f8369d7dSTobias Sarnowski                || !$node->getAttribute('type')
3681f8369d7dSTobias Sarnowski                 );
3682f8369d7dSTobias Sarnowski        $isRadio = $node->tagName == 'input'
3683f8369d7dSTobias Sarnowski            && $node->getAttribute('type') == 'radio';
3684f8369d7dSTobias Sarnowski        $isCheckbox = $node->tagName == 'input'
3685f8369d7dSTobias Sarnowski            && $node->getAttribute('type') == 'checkbox';
3686f8369d7dSTobias Sarnowski        $isOption = $node->tagName == 'option';
3687f8369d7dSTobias Sarnowski        if ($isInputValue && $attr == 'value' && $oldValue != $node->getAttribute($attr)) {
3688f8369d7dSTobias Sarnowski            $event = new DOMEvent(array(
3689f8369d7dSTobias Sarnowski                'target' => $node,
3690f8369d7dSTobias Sarnowski                'type' => 'change'
3691f8369d7dSTobias Sarnowski            ));
3692f8369d7dSTobias Sarnowski        } else if (($isRadio || $isCheckbox) && $attr == 'checked' && (
3693f8369d7dSTobias Sarnowski                // check
3694f8369d7dSTobias Sarnowski                (! $oldAttr && $node->hasAttribute($attr))
3695f8369d7dSTobias Sarnowski                // un-check
3696f8369d7dSTobias Sarnowski                || (! $node->hasAttribute($attr) && $oldAttr)
3697f8369d7dSTobias Sarnowski            )) {
3698f8369d7dSTobias Sarnowski            $event = new DOMEvent(array(
3699f8369d7dSTobias Sarnowski                'target' => $node,
3700f8369d7dSTobias Sarnowski                'type' => 'change'
3701f8369d7dSTobias Sarnowski            ));
3702f8369d7dSTobias Sarnowski        } else if ($isOption && $node->parentNode && $attr == 'selected' && (
3703f8369d7dSTobias Sarnowski                // select
3704f8369d7dSTobias Sarnowski                (! $oldAttr && $node->hasAttribute($attr))
3705f8369d7dSTobias Sarnowski                // un-select
3706f8369d7dSTobias Sarnowski                || (! $node->hasAttribute($attr) && $oldAttr)
3707f8369d7dSTobias Sarnowski            )) {
3708f8369d7dSTobias Sarnowski            $event = new DOMEvent(array(
3709f8369d7dSTobias Sarnowski                'target' => $node->parentNode,
3710f8369d7dSTobias Sarnowski                'type' => 'change'
3711f8369d7dSTobias Sarnowski            ));
3712f8369d7dSTobias Sarnowski        }
3713f8369d7dSTobias Sarnowski        if ($event) {
3714f8369d7dSTobias Sarnowski            phpQueryEvents::trigger($this->getDocumentID(),
3715f8369d7dSTobias Sarnowski                $event->type, array($event), $node
3716f8369d7dSTobias Sarnowski            );
3717f8369d7dSTobias Sarnowski        }
3718f8369d7dSTobias Sarnowski    }
3719f8369d7dSTobias Sarnowski    public function attr($attr = null, $value = null) {
3720f8369d7dSTobias Sarnowski        foreach($this->stack(1) as $node) {
3721f8369d7dSTobias Sarnowski            if (! is_null($value)) {
3722f8369d7dSTobias Sarnowski                $loop = $attr == '*'
3723f8369d7dSTobias Sarnowski                    ? $this->getNodeAttrs($node)
3724f8369d7dSTobias Sarnowski                    : array($attr);
3725f8369d7dSTobias Sarnowski                foreach($loop as $a) {
3726f8369d7dSTobias Sarnowski                    $oldValue = $node->getAttribute($a);
3727f8369d7dSTobias Sarnowski                    $oldAttr = $node->hasAttribute($a);
3728f8369d7dSTobias Sarnowski                    // TODO raises an error when charset other than UTF-8
3729f8369d7dSTobias Sarnowski                    // while document's charset is also not UTF-8
3730f8369d7dSTobias Sarnowski                    @$node->setAttribute($a, $value);
3731f8369d7dSTobias Sarnowski                    $this->attrEvents($a, $oldAttr, $oldValue, $node);
3732f8369d7dSTobias Sarnowski                }
3733f8369d7dSTobias Sarnowski            } else if ($attr == '*') {
3734f8369d7dSTobias Sarnowski                // jQuery difference
3735f8369d7dSTobias Sarnowski                $return = array();
3736f8369d7dSTobias Sarnowski                foreach($node->attributes as $n => $v)
3737f8369d7dSTobias Sarnowski                    $return[$n] = $v->value;
3738f8369d7dSTobias Sarnowski                return $return;
3739f8369d7dSTobias Sarnowski            } else
3740f8369d7dSTobias Sarnowski                return $node->hasAttribute($attr)
3741f8369d7dSTobias Sarnowski                    ? $node->getAttribute($attr)
3742f8369d7dSTobias Sarnowski                    : null;
3743f8369d7dSTobias Sarnowski        }
3744f8369d7dSTobias Sarnowski        return is_null($value)
3745f8369d7dSTobias Sarnowski            ? '' : $this;
3746f8369d7dSTobias Sarnowski    }
3747f8369d7dSTobias Sarnowski    /**
3748f8369d7dSTobias Sarnowski     * @access private
3749f8369d7dSTobias Sarnowski     */
3750f8369d7dSTobias Sarnowski    protected function getNodeAttrs($node) {
3751f8369d7dSTobias Sarnowski        $return = array();
3752f8369d7dSTobias Sarnowski        foreach($node->attributes as $n => $o)
3753f8369d7dSTobias Sarnowski            $return[] = $n;
3754f8369d7dSTobias Sarnowski        return $return;
3755f8369d7dSTobias Sarnowski    }
3756f8369d7dSTobias Sarnowski    /**
3757f8369d7dSTobias Sarnowski     * Enter description here...
3758f8369d7dSTobias Sarnowski     *
3759f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3760f8369d7dSTobias Sarnowski     * @todo check CDATA ???
3761f8369d7dSTobias Sarnowski     */
3762f8369d7dSTobias Sarnowski    public function attrPHP($attr, $code) {
3763f8369d7dSTobias Sarnowski        if (! is_null($code)) {
3764f8369d7dSTobias Sarnowski            $value = '<'.'?php '.$code.' ?'.'>';
3765f8369d7dSTobias Sarnowski            // TODO tempolary solution
3766f8369d7dSTobias Sarnowski            // http://code.google.com/p/phpquery/issues/detail?id=17
3767f8369d7dSTobias Sarnowski//          if (function_exists('mb_detect_encoding') && mb_detect_encoding($value) == 'ASCII')
3768f8369d7dSTobias Sarnowski//              $value  = mb_convert_encoding($value, 'UTF-8', 'HTML-ENTITIES');
3769f8369d7dSTobias Sarnowski        }
3770f8369d7dSTobias Sarnowski        foreach($this->stack(1) as $node) {
3771f8369d7dSTobias Sarnowski            if (! is_null($code)) {
3772f8369d7dSTobias Sarnowski//              $attrNode = $this->DOM->createAttribute($attr);
3773f8369d7dSTobias Sarnowski                $node->setAttribute($attr, $value);
3774f8369d7dSTobias Sarnowski//              $attrNode->value = $value;
3775f8369d7dSTobias Sarnowski//              $node->appendChild($attrNode);
3776f8369d7dSTobias Sarnowski            } else if ( $attr == '*') {
3777f8369d7dSTobias Sarnowski                // jQuery diff
3778f8369d7dSTobias Sarnowski                $return = array();
3779f8369d7dSTobias Sarnowski                foreach($node->attributes as $n => $v)
3780f8369d7dSTobias Sarnowski                    $return[$n] = $v->value;
3781f8369d7dSTobias Sarnowski                return $return;
3782f8369d7dSTobias Sarnowski            } else
3783f8369d7dSTobias Sarnowski                return $node->getAttribute($attr);
3784f8369d7dSTobias Sarnowski        }
3785f8369d7dSTobias Sarnowski        return $this;
3786f8369d7dSTobias Sarnowski    }
3787f8369d7dSTobias Sarnowski    /**
3788f8369d7dSTobias Sarnowski     * Enter description here...
3789f8369d7dSTobias Sarnowski     *
3790f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3791f8369d7dSTobias Sarnowski     */
3792f8369d7dSTobias Sarnowski    public function removeAttr($attr) {
3793f8369d7dSTobias Sarnowski        foreach($this->stack(1) as $node) {
3794f8369d7dSTobias Sarnowski            $loop = $attr == '*'
3795f8369d7dSTobias Sarnowski                ? $this->getNodeAttrs($node)
3796f8369d7dSTobias Sarnowski                : array($attr);
3797f8369d7dSTobias Sarnowski            foreach($loop as $a) {
3798f8369d7dSTobias Sarnowski                $oldValue = $node->getAttribute($a);
3799f8369d7dSTobias Sarnowski                $node->removeAttribute($a);
3800f8369d7dSTobias Sarnowski                $this->attrEvents($a, $oldValue, null, $node);
3801f8369d7dSTobias Sarnowski            }
3802f8369d7dSTobias Sarnowski        }
3803f8369d7dSTobias Sarnowski        return $this;
3804f8369d7dSTobias Sarnowski    }
3805f8369d7dSTobias Sarnowski    /**
3806f8369d7dSTobias Sarnowski     * Return form element value.
3807f8369d7dSTobias Sarnowski     *
3808f8369d7dSTobias Sarnowski     * @return String Fields value.
3809f8369d7dSTobias Sarnowski     */
3810f8369d7dSTobias Sarnowski    public function val($val = null) {
3811f8369d7dSTobias Sarnowski        if (! isset($val)) {
3812f8369d7dSTobias Sarnowski            if ($this->eq(0)->is('select')) {
3813f8369d7dSTobias Sarnowski                    $selected = $this->eq(0)->find('option[selected=selected]');
3814f8369d7dSTobias Sarnowski                    if ($selected->is('[value]'))
3815f8369d7dSTobias Sarnowski                        return $selected->attr('value');
3816f8369d7dSTobias Sarnowski                    else
3817f8369d7dSTobias Sarnowski                        return $selected->text();
3818f8369d7dSTobias Sarnowski            } else if ($this->eq(0)->is('textarea'))
3819f8369d7dSTobias Sarnowski                    return $this->eq(0)->markup();
3820f8369d7dSTobias Sarnowski                else
3821f8369d7dSTobias Sarnowski                    return $this->eq(0)->attr('value');
3822f8369d7dSTobias Sarnowski        } else {
3823f8369d7dSTobias Sarnowski            $_val = null;
3824f8369d7dSTobias Sarnowski            foreach($this->stack(1) as $node) {
3825f8369d7dSTobias Sarnowski                $node = pq($node, $this->getDocumentID());
3826f8369d7dSTobias Sarnowski                if (is_array($val) && in_array($node->attr('type'), array('checkbox', 'radio'))) {
3827f8369d7dSTobias Sarnowski                    $isChecked = in_array($node->attr('value'), $val)
3828f8369d7dSTobias Sarnowski                            || in_array($node->attr('name'), $val);
3829f8369d7dSTobias Sarnowski                    if ($isChecked)
3830f8369d7dSTobias Sarnowski                        $node->attr('checked', 'checked');
3831f8369d7dSTobias Sarnowski                    else
3832f8369d7dSTobias Sarnowski                        $node->removeAttr('checked');
3833f8369d7dSTobias Sarnowski                } else if ($node->get(0)->tagName == 'select') {
3834f8369d7dSTobias Sarnowski                    if (! isset($_val)) {
3835f8369d7dSTobias Sarnowski                        $_val = array();
3836f8369d7dSTobias Sarnowski                        if (! is_array($val))
3837f8369d7dSTobias Sarnowski                            $_val = array((string)$val);
3838f8369d7dSTobias Sarnowski                        else
3839f8369d7dSTobias Sarnowski                            foreach($val as $v)
3840f8369d7dSTobias Sarnowski                                $_val[] = $v;
3841f8369d7dSTobias Sarnowski                    }
3842f8369d7dSTobias Sarnowski                    foreach($node['option']->stack(1) as $option) {
3843f8369d7dSTobias Sarnowski                        $option = pq($option, $this->getDocumentID());
3844f8369d7dSTobias Sarnowski                        $selected = false;
3845f8369d7dSTobias Sarnowski                        // XXX: workaround for string comparsion, see issue #96
3846f8369d7dSTobias Sarnowski                        // http://code.google.com/p/phpquery/issues/detail?id=96
3847f8369d7dSTobias Sarnowski                        $selected = is_null($option->attr('value'))
3848f8369d7dSTobias Sarnowski                            ? in_array($option->markup(), $_val)
3849f8369d7dSTobias Sarnowski                            : in_array($option->attr('value'), $_val);
3850f8369d7dSTobias Sarnowski//                      $optionValue = $option->attr('value');
3851f8369d7dSTobias Sarnowski//                      $optionText = $option->text();
3852f8369d7dSTobias Sarnowski//                      $optionTextLenght = mb_strlen($optionText);
3853f8369d7dSTobias Sarnowski//                      foreach($_val as $v)
3854f8369d7dSTobias Sarnowski//                          if ($optionValue == $v)
3855f8369d7dSTobias Sarnowski//                              $selected = true;
3856f8369d7dSTobias Sarnowski//                          else if ($optionText == $v && $optionTextLenght == mb_strlen($v))
3857f8369d7dSTobias Sarnowski//                              $selected = true;
3858f8369d7dSTobias Sarnowski                        if ($selected)
3859f8369d7dSTobias Sarnowski                            $option->attr('selected', 'selected');
3860f8369d7dSTobias Sarnowski                        else
3861f8369d7dSTobias Sarnowski                            $option->removeAttr('selected');
3862f8369d7dSTobias Sarnowski                    }
3863f8369d7dSTobias Sarnowski                } else if ($node->get(0)->tagName == 'textarea')
3864f8369d7dSTobias Sarnowski                    $node->markup($val);
3865f8369d7dSTobias Sarnowski                else
3866f8369d7dSTobias Sarnowski                    $node->attr('value', $val);
3867f8369d7dSTobias Sarnowski            }
3868f8369d7dSTobias Sarnowski        }
3869f8369d7dSTobias Sarnowski        return $this;
3870f8369d7dSTobias Sarnowski    }
3871f8369d7dSTobias Sarnowski    /**
3872f8369d7dSTobias Sarnowski     * Enter description here...
3873f8369d7dSTobias Sarnowski     *
3874f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3875f8369d7dSTobias Sarnowski     */
3876f8369d7dSTobias Sarnowski    public function andSelf() {
3877f8369d7dSTobias Sarnowski        if ( $this->previous )
3878f8369d7dSTobias Sarnowski            $this->elements = array_merge($this->elements, $this->previous->elements);
3879f8369d7dSTobias Sarnowski        return $this;
3880f8369d7dSTobias Sarnowski    }
3881f8369d7dSTobias Sarnowski    /**
3882f8369d7dSTobias Sarnowski     * Enter description here...
3883f8369d7dSTobias Sarnowski     *
3884f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3885f8369d7dSTobias Sarnowski     */
3886f8369d7dSTobias Sarnowski    public function addClass( $className) {
3887f8369d7dSTobias Sarnowski        if (! $className)
3888f8369d7dSTobias Sarnowski            return $this;
3889f8369d7dSTobias Sarnowski        foreach($this->stack(1) as $node) {
3890f8369d7dSTobias Sarnowski            if (! $this->is(".$className", $node))
3891f8369d7dSTobias Sarnowski                $node->setAttribute(
3892f8369d7dSTobias Sarnowski                    'class',
3893f8369d7dSTobias Sarnowski                    trim($node->getAttribute('class').' '.$className)
3894f8369d7dSTobias Sarnowski                );
3895f8369d7dSTobias Sarnowski        }
3896f8369d7dSTobias Sarnowski        return $this;
3897f8369d7dSTobias Sarnowski    }
3898f8369d7dSTobias Sarnowski    /**
3899f8369d7dSTobias Sarnowski     * Enter description here...
3900f8369d7dSTobias Sarnowski     *
3901f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3902f8369d7dSTobias Sarnowski     */
3903f8369d7dSTobias Sarnowski    public function addClassPHP( $className) {
3904f8369d7dSTobias Sarnowski        foreach($this->stack(1) as $node) {
3905f8369d7dSTobias Sarnowski                $classes = $node->getAttribute('class');
3906f8369d7dSTobias Sarnowski                $newValue = $classes
3907f8369d7dSTobias Sarnowski                    ? $classes.' <'.'?php '.$className.' ?'.'>'
3908f8369d7dSTobias Sarnowski                    : '<'.'?php '.$className.' ?'.'>';
3909f8369d7dSTobias Sarnowski                $node->setAttribute('class', $newValue);
3910f8369d7dSTobias Sarnowski        }
3911f8369d7dSTobias Sarnowski        return $this;
3912f8369d7dSTobias Sarnowski    }
3913f8369d7dSTobias Sarnowski    /**
3914f8369d7dSTobias Sarnowski     * Enter description here...
3915f8369d7dSTobias Sarnowski     *
3916f8369d7dSTobias Sarnowski     * @param   string  $className
3917f8369d7dSTobias Sarnowski     * @return  bool
3918f8369d7dSTobias Sarnowski     */
3919f8369d7dSTobias Sarnowski    public function hasClass($className) {
3920f8369d7dSTobias Sarnowski        foreach($this->stack(1) as $node) {
3921f8369d7dSTobias Sarnowski            if ( $this->is(".$className", $node))
3922f8369d7dSTobias Sarnowski                return true;
3923f8369d7dSTobias Sarnowski        }
3924f8369d7dSTobias Sarnowski        return false;
3925f8369d7dSTobias Sarnowski    }
3926f8369d7dSTobias Sarnowski    /**
3927f8369d7dSTobias Sarnowski     * Enter description here...
3928f8369d7dSTobias Sarnowski     *
3929f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3930f8369d7dSTobias Sarnowski     */
3931f8369d7dSTobias Sarnowski    public function removeClass($className) {
3932f8369d7dSTobias Sarnowski        foreach($this->stack(1) as $node) {
3933f8369d7dSTobias Sarnowski            $classes = explode( ' ', $node->getAttribute('class'));
3934f8369d7dSTobias Sarnowski            if ( in_array($className, $classes)) {
3935f8369d7dSTobias Sarnowski                $classes = array_diff($classes, array($className));
3936f8369d7dSTobias Sarnowski                if ( $classes )
3937f8369d7dSTobias Sarnowski                    $node->setAttribute('class', implode(' ', $classes));
3938f8369d7dSTobias Sarnowski                else
3939f8369d7dSTobias Sarnowski                    $node->removeAttribute('class');
3940f8369d7dSTobias Sarnowski            }
3941f8369d7dSTobias Sarnowski        }
3942f8369d7dSTobias Sarnowski        return $this;
3943f8369d7dSTobias Sarnowski    }
3944f8369d7dSTobias Sarnowski    /**
3945f8369d7dSTobias Sarnowski     * Enter description here...
3946f8369d7dSTobias Sarnowski     *
3947f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3948f8369d7dSTobias Sarnowski     */
3949f8369d7dSTobias Sarnowski    public function toggleClass($className) {
3950f8369d7dSTobias Sarnowski        foreach($this->stack(1) as $node) {
3951f8369d7dSTobias Sarnowski            if ( $this->is( $node, '.'.$className ))
3952f8369d7dSTobias Sarnowski                $this->removeClass($className);
3953f8369d7dSTobias Sarnowski            else
3954f8369d7dSTobias Sarnowski                $this->addClass($className);
3955f8369d7dSTobias Sarnowski        }
3956f8369d7dSTobias Sarnowski        return $this;
3957f8369d7dSTobias Sarnowski    }
3958f8369d7dSTobias Sarnowski    /**
3959f8369d7dSTobias Sarnowski     * Proper name without underscore (just ->empty()) also works.
3960f8369d7dSTobias Sarnowski     *
3961f8369d7dSTobias Sarnowski     * Removes all child nodes from the set of matched elements.
3962f8369d7dSTobias Sarnowski     *
3963f8369d7dSTobias Sarnowski     * Example:
3964f8369d7dSTobias Sarnowski     * pq("p")._empty()
3965f8369d7dSTobias Sarnowski     *
3966f8369d7dSTobias Sarnowski     * HTML:
3967f8369d7dSTobias Sarnowski     * <p>Hello, <span>Person</span> <a href="#">and person</a></p>
3968f8369d7dSTobias Sarnowski     *
3969f8369d7dSTobias Sarnowski     * Result:
3970f8369d7dSTobias Sarnowski     * [ <p></p> ]
3971f8369d7dSTobias Sarnowski     *
3972f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3973f8369d7dSTobias Sarnowski     * @access private
3974f8369d7dSTobias Sarnowski     */
3975f8369d7dSTobias Sarnowski    public function _empty() {
3976f8369d7dSTobias Sarnowski        foreach($this->stack(1) as $node) {
3977f8369d7dSTobias Sarnowski            // thx to 'dave at dgx dot cz'
3978f8369d7dSTobias Sarnowski            $node->nodeValue = '';
3979f8369d7dSTobias Sarnowski        }
3980f8369d7dSTobias Sarnowski        return $this;
3981f8369d7dSTobias Sarnowski    }
3982f8369d7dSTobias Sarnowski    /**
3983f8369d7dSTobias Sarnowski     * Enter description here...
3984f8369d7dSTobias Sarnowski     *
3985f8369d7dSTobias Sarnowski     * @param array|string $callback Expects $node as first param, $index as second
3986f8369d7dSTobias Sarnowski     * @param array $scope External variables passed to callback. Use compact('varName1', 'varName2'...) and extract($scope)
3987f8369d7dSTobias Sarnowski     * @param array $arg1 Will ba passed as third and futher args to callback.
3988f8369d7dSTobias Sarnowski     * @param array $arg2 Will ba passed as fourth and futher args to callback, and so on...
3989f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
3990f8369d7dSTobias Sarnowski     */
3991f8369d7dSTobias Sarnowski    public function each($callback, $param1 = null, $param2 = null, $param3 = null) {
3992f8369d7dSTobias Sarnowski        $paramStructure = null;
3993f8369d7dSTobias Sarnowski        if (func_num_args() > 1) {
3994f8369d7dSTobias Sarnowski            $paramStructure = func_get_args();
3995f8369d7dSTobias Sarnowski            $paramStructure = array_slice($paramStructure, 1);
3996f8369d7dSTobias Sarnowski        }
3997f8369d7dSTobias Sarnowski        foreach($this->elements as $v)
3998f8369d7dSTobias Sarnowski            phpQuery::callbackRun($callback, array($v), $paramStructure);
3999f8369d7dSTobias Sarnowski        return $this;
4000f8369d7dSTobias Sarnowski    }
4001f8369d7dSTobias Sarnowski    /**
4002f8369d7dSTobias Sarnowski     * Run callback on actual object.
4003f8369d7dSTobias Sarnowski     *
4004f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
4005f8369d7dSTobias Sarnowski     */
4006f8369d7dSTobias Sarnowski    public function callback($callback, $param1 = null, $param2 = null, $param3 = null) {
4007f8369d7dSTobias Sarnowski        $params = func_get_args();
4008f8369d7dSTobias Sarnowski        $params[0] = $this;
4009f8369d7dSTobias Sarnowski        phpQuery::callbackRun($callback, $params);
4010f8369d7dSTobias Sarnowski        return $this;
4011f8369d7dSTobias Sarnowski    }
4012f8369d7dSTobias Sarnowski    /**
4013f8369d7dSTobias Sarnowski     * Enter description here...
4014f8369d7dSTobias Sarnowski     *
4015f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
4016f8369d7dSTobias Sarnowski     * @todo add $scope and $args as in each() ???
4017f8369d7dSTobias Sarnowski     */
4018f8369d7dSTobias Sarnowski    public function map($callback, $param1 = null, $param2 = null, $param3 = null) {
4019f8369d7dSTobias Sarnowski//      $stack = array();
4020f8369d7dSTobias Sarnowski////        foreach($this->newInstance() as $node) {
4021f8369d7dSTobias Sarnowski//      foreach($this->newInstance() as $node) {
4022f8369d7dSTobias Sarnowski//          $result = call_user_func($callback, $node);
4023f8369d7dSTobias Sarnowski//          if ($result)
4024f8369d7dSTobias Sarnowski//              $stack[] = $result;
4025f8369d7dSTobias Sarnowski//      }
4026f8369d7dSTobias Sarnowski        $params = func_get_args();
4027f8369d7dSTobias Sarnowski        array_unshift($params, $this->elements);
4028f8369d7dSTobias Sarnowski        return $this->newInstance(
4029f8369d7dSTobias Sarnowski            call_user_func_array(array('phpQuery', 'map'), $params)
4030f8369d7dSTobias Sarnowski//          phpQuery::map($this->elements, $callback)
4031f8369d7dSTobias Sarnowski        );
4032f8369d7dSTobias Sarnowski    }
4033f8369d7dSTobias Sarnowski    /**
4034f8369d7dSTobias Sarnowski     * Enter description here...
4035f8369d7dSTobias Sarnowski     *
4036f8369d7dSTobias Sarnowski     * @param <type> $key
4037f8369d7dSTobias Sarnowski     * @param <type> $value
4038f8369d7dSTobias Sarnowski     */
4039f8369d7dSTobias Sarnowski    public function data($key, $value = null) {
4040f8369d7dSTobias Sarnowski        if (! isset($value)) {
4041f8369d7dSTobias Sarnowski            // TODO? implement specific jQuery behavior od returning parent values
4042f8369d7dSTobias Sarnowski            // is child which we look up doesn't exist
4043f8369d7dSTobias Sarnowski            return phpQuery::data($this->get(0), $key, $value, $this->getDocumentID());
4044f8369d7dSTobias Sarnowski        } else {
4045f8369d7dSTobias Sarnowski            foreach($this as $node)
4046f8369d7dSTobias Sarnowski                phpQuery::data($node, $key, $value, $this->getDocumentID());
4047f8369d7dSTobias Sarnowski            return $this;
4048f8369d7dSTobias Sarnowski        }
4049f8369d7dSTobias Sarnowski    }
4050f8369d7dSTobias Sarnowski    /**
4051f8369d7dSTobias Sarnowski     * Enter description here...
4052f8369d7dSTobias Sarnowski     *
4053f8369d7dSTobias Sarnowski     * @param <type> $key
4054f8369d7dSTobias Sarnowski     */
4055f8369d7dSTobias Sarnowski    public function removeData($key) {
4056f8369d7dSTobias Sarnowski        foreach($this as $node)
4057f8369d7dSTobias Sarnowski            phpQuery::removeData($node, $key, $this->getDocumentID());
4058f8369d7dSTobias Sarnowski        return $this;
4059f8369d7dSTobias Sarnowski    }
4060f8369d7dSTobias Sarnowski    // INTERFACE IMPLEMENTATIONS
4061f8369d7dSTobias Sarnowski
4062f8369d7dSTobias Sarnowski    // ITERATOR INTERFACE
4063f8369d7dSTobias Sarnowski    /**
4064f8369d7dSTobias Sarnowski   * @access private
4065f8369d7dSTobias Sarnowski     */
4066f8369d7dSTobias Sarnowski    public function rewind(){
4067f8369d7dSTobias Sarnowski        $this->debug('iterating foreach');
4068f8369d7dSTobias Sarnowski//      phpQuery::selectDocument($this->getDocumentID());
4069f8369d7dSTobias Sarnowski        $this->elementsBackup = $this->elements;
4070f8369d7dSTobias Sarnowski        $this->elementsInterator = $this->elements;
4071f8369d7dSTobias Sarnowski        $this->valid = isset( $this->elements[0] )
4072f8369d7dSTobias Sarnowski            ? 1 : 0;
4073f8369d7dSTobias Sarnowski//      $this->elements = $this->valid
4074f8369d7dSTobias Sarnowski//          ? array($this->elements[0])
4075f8369d7dSTobias Sarnowski//          : array();
4076f8369d7dSTobias Sarnowski        $this->current = 0;
4077f8369d7dSTobias Sarnowski    }
4078f8369d7dSTobias Sarnowski    /**
4079f8369d7dSTobias Sarnowski   * @access private
4080f8369d7dSTobias Sarnowski     */
4081f8369d7dSTobias Sarnowski    public function current(){
4082f8369d7dSTobias Sarnowski        return $this->elementsInterator[ $this->current ];
4083f8369d7dSTobias Sarnowski    }
4084f8369d7dSTobias Sarnowski    /**
4085f8369d7dSTobias Sarnowski   * @access private
4086f8369d7dSTobias Sarnowski     */
4087f8369d7dSTobias Sarnowski    public function key(){
4088f8369d7dSTobias Sarnowski        return $this->current;
4089f8369d7dSTobias Sarnowski    }
4090f8369d7dSTobias Sarnowski    /**
4091f8369d7dSTobias Sarnowski     * Double-function method.
4092f8369d7dSTobias Sarnowski     *
4093f8369d7dSTobias Sarnowski     * First: main iterator interface method.
4094f8369d7dSTobias Sarnowski     * Second: Returning next sibling, alias for _next().
4095f8369d7dSTobias Sarnowski     *
4096f8369d7dSTobias Sarnowski     * Proper functionality is choosed automagicaly.
4097f8369d7dSTobias Sarnowski     *
4098f8369d7dSTobias Sarnowski     * @see phpQueryObject::_next()
4099f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
4100f8369d7dSTobias Sarnowski     */
4101f8369d7dSTobias Sarnowski    public function next($cssSelector = null){
4102f8369d7dSTobias Sarnowski//      if ($cssSelector || $this->valid)
4103f8369d7dSTobias Sarnowski//          return $this->_next($cssSelector);
4104f8369d7dSTobias Sarnowski        $this->valid = isset( $this->elementsInterator[ $this->current+1 ] )
4105f8369d7dSTobias Sarnowski            ? true
4106f8369d7dSTobias Sarnowski            : false;
4107f8369d7dSTobias Sarnowski        if (! $this->valid && $this->elementsInterator) {
4108f8369d7dSTobias Sarnowski            $this->elementsInterator = null;
4109f8369d7dSTobias Sarnowski        } else if ($this->valid) {
4110f8369d7dSTobias Sarnowski            $this->current++;
4111f8369d7dSTobias Sarnowski        } else {
4112f8369d7dSTobias Sarnowski            return $this->_next($cssSelector);
4113f8369d7dSTobias Sarnowski        }
4114f8369d7dSTobias Sarnowski    }
4115f8369d7dSTobias Sarnowski    /**
4116f8369d7dSTobias Sarnowski   * @access private
4117f8369d7dSTobias Sarnowski     */
4118f8369d7dSTobias Sarnowski    public function valid(){
4119f8369d7dSTobias Sarnowski        return $this->valid;
4120f8369d7dSTobias Sarnowski    }
4121f8369d7dSTobias Sarnowski    // ITERATOR INTERFACE END
4122f8369d7dSTobias Sarnowski    // ARRAYACCESS INTERFACE
4123f8369d7dSTobias Sarnowski    /**
4124f8369d7dSTobias Sarnowski   * @access private
4125f8369d7dSTobias Sarnowski     */
4126f8369d7dSTobias Sarnowski    public function offsetExists($offset) {
4127f8369d7dSTobias Sarnowski        return $this->find($offset)->size() > 0;
4128f8369d7dSTobias Sarnowski    }
4129f8369d7dSTobias Sarnowski    /**
4130f8369d7dSTobias Sarnowski   * @access private
4131f8369d7dSTobias Sarnowski     */
4132f8369d7dSTobias Sarnowski    public function offsetGet($offset) {
4133f8369d7dSTobias Sarnowski        return $this->find($offset);
4134f8369d7dSTobias Sarnowski    }
4135f8369d7dSTobias Sarnowski    /**
4136f8369d7dSTobias Sarnowski   * @access private
4137f8369d7dSTobias Sarnowski     */
4138f8369d7dSTobias Sarnowski    public function offsetSet($offset, $value) {
4139f8369d7dSTobias Sarnowski//      $this->find($offset)->replaceWith($value);
4140f8369d7dSTobias Sarnowski        $this->find($offset)->html($value);
4141f8369d7dSTobias Sarnowski    }
4142f8369d7dSTobias Sarnowski    /**
4143f8369d7dSTobias Sarnowski   * @access private
4144f8369d7dSTobias Sarnowski     */
4145f8369d7dSTobias Sarnowski    public function offsetUnset($offset) {
4146f8369d7dSTobias Sarnowski        // empty
4147f8369d7dSTobias Sarnowski        throw new Exception("Can't do unset, use array interface only for calling queries and replacing HTML.");
4148f8369d7dSTobias Sarnowski    }
4149f8369d7dSTobias Sarnowski    // ARRAYACCESS INTERFACE END
4150f8369d7dSTobias Sarnowski    /**
4151f8369d7dSTobias Sarnowski     * Returns node's XPath.
4152f8369d7dSTobias Sarnowski     *
4153f8369d7dSTobias Sarnowski     * @param unknown_type $oneNode
4154f8369d7dSTobias Sarnowski     * @return string
4155f8369d7dSTobias Sarnowski     * @TODO use native getNodePath is avaible
4156f8369d7dSTobias Sarnowski     * @access private
4157f8369d7dSTobias Sarnowski     */
4158f8369d7dSTobias Sarnowski    protected function getNodeXpath($oneNode = null, $namespace = null) {
4159f8369d7dSTobias Sarnowski        $return = array();
4160f8369d7dSTobias Sarnowski        $loop = $oneNode
4161f8369d7dSTobias Sarnowski            ? array($oneNode)
4162f8369d7dSTobias Sarnowski            : $this->elements;
4163f8369d7dSTobias Sarnowski//      if ($namespace)
4164f8369d7dSTobias Sarnowski//          $namespace .= ':';
4165f8369d7dSTobias Sarnowski        foreach($loop as $node) {
4166f8369d7dSTobias Sarnowski            if ($node instanceof DOMDOCUMENT) {
4167f8369d7dSTobias Sarnowski                $return[] = '';
4168f8369d7dSTobias Sarnowski                continue;
4169f8369d7dSTobias Sarnowski            }
4170f8369d7dSTobias Sarnowski            $xpath = array();
4171f8369d7dSTobias Sarnowski            while(! ($node instanceof DOMDOCUMENT)) {
4172f8369d7dSTobias Sarnowski                $i = 1;
4173f8369d7dSTobias Sarnowski                $sibling = $node;
4174f8369d7dSTobias Sarnowski                while($sibling->previousSibling) {
4175f8369d7dSTobias Sarnowski                    $sibling = $sibling->previousSibling;
4176f8369d7dSTobias Sarnowski                    $isElement = $sibling instanceof DOMELEMENT;
4177f8369d7dSTobias Sarnowski                    if ($isElement && $sibling->tagName == $node->tagName)
4178f8369d7dSTobias Sarnowski                        $i++;
4179f8369d7dSTobias Sarnowski                }
4180f8369d7dSTobias Sarnowski                $xpath[] = $this->isXML()
4181f8369d7dSTobias Sarnowski                    ? "*[local-name()='{$node->tagName}'][{$i}]"
4182f8369d7dSTobias Sarnowski                    : "{$node->tagName}[{$i}]";
4183f8369d7dSTobias Sarnowski                $node = $node->parentNode;
4184f8369d7dSTobias Sarnowski            }
4185f8369d7dSTobias Sarnowski            $xpath = join('/', array_reverse($xpath));
4186f8369d7dSTobias Sarnowski            $return[] = '/'.$xpath;
4187f8369d7dSTobias Sarnowski        }
4188f8369d7dSTobias Sarnowski        return $oneNode
4189f8369d7dSTobias Sarnowski            ? $return[0]
4190f8369d7dSTobias Sarnowski            : $return;
4191f8369d7dSTobias Sarnowski    }
4192f8369d7dSTobias Sarnowski    // HELPERS
4193f8369d7dSTobias Sarnowski    public function whois($oneNode = null) {
4194f8369d7dSTobias Sarnowski        $return = array();
4195f8369d7dSTobias Sarnowski        $loop = $oneNode
4196f8369d7dSTobias Sarnowski            ? array( $oneNode )
4197f8369d7dSTobias Sarnowski            : $this->elements;
4198f8369d7dSTobias Sarnowski        foreach($loop as $node) {
4199f8369d7dSTobias Sarnowski            if (isset($node->tagName)) {
4200f8369d7dSTobias Sarnowski                $tag = in_array($node->tagName, array('php', 'js'))
4201f8369d7dSTobias Sarnowski                    ? strtoupper($node->tagName)
4202f8369d7dSTobias Sarnowski                    : $node->tagName;
4203f8369d7dSTobias Sarnowski                $return[] = $tag
4204f8369d7dSTobias Sarnowski                    .($node->getAttribute('id')
4205f8369d7dSTobias Sarnowski                        ? '#'.$node->getAttribute('id'):'')
4206f8369d7dSTobias Sarnowski                    .($node->getAttribute('class')
42070edda900SAndreas Gohr                        ? '.'.join('.', explode(' ', $node->getAttribute('class'))):'')
4208f8369d7dSTobias Sarnowski                    .($node->getAttribute('name')
4209f8369d7dSTobias Sarnowski                        ? '[name="'.$node->getAttribute('name').'"]':'')
4210f8369d7dSTobias Sarnowski                    .($node->getAttribute('value') && strpos($node->getAttribute('value'), '<'.'?php') === false
4211f8369d7dSTobias Sarnowski                        ? '[value="'.substr(str_replace("\n", '', $node->getAttribute('value')), 0, 15).'"]':'')
4212f8369d7dSTobias Sarnowski                    .($node->getAttribute('value') && strpos($node->getAttribute('value'), '<'.'?php') !== false
4213f8369d7dSTobias Sarnowski                        ? '[value=PHP]':'')
4214f8369d7dSTobias Sarnowski                    .($node->getAttribute('selected')
4215f8369d7dSTobias Sarnowski                        ? '[selected]':'')
4216f8369d7dSTobias Sarnowski                    .($node->getAttribute('checked')
4217f8369d7dSTobias Sarnowski                        ? '[checked]':'')
4218f8369d7dSTobias Sarnowski                ;
4219f8369d7dSTobias Sarnowski            } else if ($node instanceof DOMTEXT) {
4220f8369d7dSTobias Sarnowski                if (trim($node->textContent))
4221f8369d7dSTobias Sarnowski                    $return[] = 'Text:'.substr(str_replace("\n", ' ', $node->textContent), 0, 15);
4222f8369d7dSTobias Sarnowski            } else {
4223f8369d7dSTobias Sarnowski
4224f8369d7dSTobias Sarnowski            }
4225f8369d7dSTobias Sarnowski        }
4226f8369d7dSTobias Sarnowski        return $oneNode && isset($return[0])
4227f8369d7dSTobias Sarnowski            ? $return[0]
4228f8369d7dSTobias Sarnowski            : $return;
4229f8369d7dSTobias Sarnowski    }
4230f8369d7dSTobias Sarnowski    /**
4231f8369d7dSTobias Sarnowski     * Dump htmlOuter and preserve chain. Usefull for debugging.
4232f8369d7dSTobias Sarnowski     *
4233f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
4234f8369d7dSTobias Sarnowski     *
4235f8369d7dSTobias Sarnowski     */
4236f8369d7dSTobias Sarnowski    public function dump() {
4237f8369d7dSTobias Sarnowski        print 'DUMP #'.(phpQuery::$dumpCount++).' ';
4238f8369d7dSTobias Sarnowski        $debug = phpQuery::$debug;
4239f8369d7dSTobias Sarnowski        phpQuery::$debug = false;
4240f8369d7dSTobias Sarnowski//      print __FILE__.':'.__LINE__."\n";
4241f8369d7dSTobias Sarnowski        var_dump($this->htmlOuter());
4242f8369d7dSTobias Sarnowski        return $this;
4243f8369d7dSTobias Sarnowski    }
4244f8369d7dSTobias Sarnowski    public function dumpWhois() {
4245f8369d7dSTobias Sarnowski        print 'DUMP #'.(phpQuery::$dumpCount++).' ';
4246f8369d7dSTobias Sarnowski        $debug = phpQuery::$debug;
4247f8369d7dSTobias Sarnowski        phpQuery::$debug = false;
4248f8369d7dSTobias Sarnowski//      print __FILE__.':'.__LINE__."\n";
4249f8369d7dSTobias Sarnowski        var_dump('whois', $this->whois());
4250f8369d7dSTobias Sarnowski        phpQuery::$debug = $debug;
4251f8369d7dSTobias Sarnowski        return $this;
4252f8369d7dSTobias Sarnowski    }
4253f8369d7dSTobias Sarnowski    public function dumpLength() {
4254f8369d7dSTobias Sarnowski        print 'DUMP #'.(phpQuery::$dumpCount++).' ';
4255f8369d7dSTobias Sarnowski        $debug = phpQuery::$debug;
4256f8369d7dSTobias Sarnowski        phpQuery::$debug = false;
4257f8369d7dSTobias Sarnowski//      print __FILE__.':'.__LINE__."\n";
4258f8369d7dSTobias Sarnowski        var_dump('length', $this->length());
4259f8369d7dSTobias Sarnowski        phpQuery::$debug = $debug;
4260f8369d7dSTobias Sarnowski        return $this;
4261f8369d7dSTobias Sarnowski    }
4262f8369d7dSTobias Sarnowski    public function dumpTree($html = true, $title = true) {
4263f8369d7dSTobias Sarnowski        $output = $title
4264f8369d7dSTobias Sarnowski            ? 'DUMP #'.(phpQuery::$dumpCount++)." \n" : '';
4265f8369d7dSTobias Sarnowski        $debug = phpQuery::$debug;
4266f8369d7dSTobias Sarnowski        phpQuery::$debug = false;
4267f8369d7dSTobias Sarnowski        foreach($this->stack() as $node)
4268e32b1b0fSSyntaxseed            $output .= $this->dumpTreeInternal($node);
4269f8369d7dSTobias Sarnowski        phpQuery::$debug = $debug;
4270f8369d7dSTobias Sarnowski        print $html
4271f8369d7dSTobias Sarnowski            ? nl2br(str_replace(' ', '&nbsp;', $output))
4272f8369d7dSTobias Sarnowski            : $output;
4273f8369d7dSTobias Sarnowski        return $this;
4274f8369d7dSTobias Sarnowski    }
4275e32b1b0fSSyntaxseed    private function dumpTreeInternal($node, $intend = 0) {
4276f8369d7dSTobias Sarnowski        $whois = $this->whois($node);
4277f8369d7dSTobias Sarnowski        $return = '';
4278f8369d7dSTobias Sarnowski        if ($whois)
4279f8369d7dSTobias Sarnowski            $return .= str_repeat(' - ', $intend).$whois."\n";
4280f8369d7dSTobias Sarnowski        if (isset($node->childNodes))
4281f8369d7dSTobias Sarnowski            foreach($node->childNodes as $chNode)
4282e32b1b0fSSyntaxseed                $return .= $this->dumpTreeInternal($chNode, $intend+1);
4283f8369d7dSTobias Sarnowski        return $return;
4284f8369d7dSTobias Sarnowski    }
4285f8369d7dSTobias Sarnowski    /**
4286f8369d7dSTobias Sarnowski     * Dump htmlOuter and stop script execution. Usefull for debugging.
4287f8369d7dSTobias Sarnowski     *
4288f8369d7dSTobias Sarnowski     */
4289f8369d7dSTobias Sarnowski    public function dumpDie() {
4290f8369d7dSTobias Sarnowski        print __FILE__.':'.__LINE__;
4291f8369d7dSTobias Sarnowski        var_dump($this->htmlOuter());
4292f8369d7dSTobias Sarnowski        die();
4293f8369d7dSTobias Sarnowski    }
4294f8369d7dSTobias Sarnowski}
4295f8369d7dSTobias Sarnowski
4296f8369d7dSTobias Sarnowski
4297f8369d7dSTobias Sarnowski// -- Multibyte Compatibility functions ---------------------------------------
4298f8369d7dSTobias Sarnowski// http://svn.iphonewebdev.com/lace/lib/mb_compat.php
4299f8369d7dSTobias Sarnowski
4300f8369d7dSTobias Sarnowski/**
4301f8369d7dSTobias Sarnowski *  mb_internal_encoding()
4302f8369d7dSTobias Sarnowski *
4303f8369d7dSTobias Sarnowski *  Included for mbstring pseudo-compatability.
4304f8369d7dSTobias Sarnowski */
4305f8369d7dSTobias Sarnowskiif (!function_exists('mb_internal_encoding'))
4306f8369d7dSTobias Sarnowski{
4307f8369d7dSTobias Sarnowski    function mb_internal_encoding($enc) {return true; }
4308f8369d7dSTobias Sarnowski}
4309f8369d7dSTobias Sarnowski
4310f8369d7dSTobias Sarnowski/**
4311f8369d7dSTobias Sarnowski *  mb_regex_encoding()
4312f8369d7dSTobias Sarnowski *
4313f8369d7dSTobias Sarnowski *  Included for mbstring pseudo-compatability.
4314f8369d7dSTobias Sarnowski */
4315f8369d7dSTobias Sarnowskiif (!function_exists('mb_regex_encoding'))
4316f8369d7dSTobias Sarnowski{
4317f8369d7dSTobias Sarnowski    function mb_regex_encoding($enc) {return true; }
4318f8369d7dSTobias Sarnowski}
4319f8369d7dSTobias Sarnowski
4320f8369d7dSTobias Sarnowski/**
4321f8369d7dSTobias Sarnowski *  mb_strlen()
4322f8369d7dSTobias Sarnowski *
4323f8369d7dSTobias Sarnowski *  Included for mbstring pseudo-compatability.
4324f8369d7dSTobias Sarnowski */
4325f8369d7dSTobias Sarnowskiif (!function_exists('mb_strlen'))
4326f8369d7dSTobias Sarnowski{
4327f8369d7dSTobias Sarnowski    function mb_strlen($str)
4328f8369d7dSTobias Sarnowski    {
4329f8369d7dSTobias Sarnowski        return strlen($str);
4330f8369d7dSTobias Sarnowski    }
4331f8369d7dSTobias Sarnowski}
4332f8369d7dSTobias Sarnowski
4333f8369d7dSTobias Sarnowski/**
4334f8369d7dSTobias Sarnowski *  mb_strpos()
4335f8369d7dSTobias Sarnowski *
4336f8369d7dSTobias Sarnowski *  Included for mbstring pseudo-compatability.
4337f8369d7dSTobias Sarnowski */
4338f8369d7dSTobias Sarnowskiif (!function_exists('mb_strpos'))
4339f8369d7dSTobias Sarnowski{
4340f8369d7dSTobias Sarnowski    function mb_strpos($haystack, $needle, $offset=0)
4341f8369d7dSTobias Sarnowski    {
4342f8369d7dSTobias Sarnowski        return strpos($haystack, $needle, $offset);
4343f8369d7dSTobias Sarnowski    }
4344f8369d7dSTobias Sarnowski}
4345f8369d7dSTobias Sarnowski/**
4346f8369d7dSTobias Sarnowski *  mb_stripos()
4347f8369d7dSTobias Sarnowski *
4348f8369d7dSTobias Sarnowski *  Included for mbstring pseudo-compatability.
4349f8369d7dSTobias Sarnowski */
4350f8369d7dSTobias Sarnowskiif (!function_exists('mb_stripos'))
4351f8369d7dSTobias Sarnowski{
4352f8369d7dSTobias Sarnowski    function mb_stripos($haystack, $needle, $offset=0)
4353f8369d7dSTobias Sarnowski    {
4354f8369d7dSTobias Sarnowski        return stripos($haystack, $needle, $offset);
4355f8369d7dSTobias Sarnowski    }
4356f8369d7dSTobias Sarnowski}
4357f8369d7dSTobias Sarnowski
4358f8369d7dSTobias Sarnowski/**
4359f8369d7dSTobias Sarnowski *  mb_substr()
4360f8369d7dSTobias Sarnowski *
4361f8369d7dSTobias Sarnowski *  Included for mbstring pseudo-compatability.
4362f8369d7dSTobias Sarnowski */
4363f8369d7dSTobias Sarnowskiif (!function_exists('mb_substr'))
4364f8369d7dSTobias Sarnowski{
4365f8369d7dSTobias Sarnowski    function mb_substr($str, $start, $length=0)
4366f8369d7dSTobias Sarnowski    {
4367f8369d7dSTobias Sarnowski        return substr($str, $start, $length);
4368f8369d7dSTobias Sarnowski    }
4369f8369d7dSTobias Sarnowski}
4370f8369d7dSTobias Sarnowski
4371f8369d7dSTobias Sarnowski/**
4372f8369d7dSTobias Sarnowski *  mb_substr_count()
4373f8369d7dSTobias Sarnowski *
4374f8369d7dSTobias Sarnowski *  Included for mbstring pseudo-compatability.
4375f8369d7dSTobias Sarnowski */
4376f8369d7dSTobias Sarnowskiif (!function_exists('mb_substr_count'))
4377f8369d7dSTobias Sarnowski{
4378f8369d7dSTobias Sarnowski    function mb_substr_count($haystack, $needle)
4379f8369d7dSTobias Sarnowski    {
4380f8369d7dSTobias Sarnowski        return substr_count($haystack, $needle);
4381f8369d7dSTobias Sarnowski    }
4382f8369d7dSTobias Sarnowski}
4383f8369d7dSTobias Sarnowski
4384f8369d7dSTobias Sarnowski
4385f8369d7dSTobias Sarnowski/**
4386f8369d7dSTobias Sarnowski * Static namespace for phpQuery functions.
4387f8369d7dSTobias Sarnowski *
4388f8369d7dSTobias Sarnowski * @author Tobiasz Cudnik <tobiasz.cudnik/gmail.com>
4389f8369d7dSTobias Sarnowski * @package phpQuery
4390f8369d7dSTobias Sarnowski */
4391f8369d7dSTobias Sarnowskiabstract class phpQuery {
4392f8369d7dSTobias Sarnowski    /**
4393f8369d7dSTobias Sarnowski     * XXX: Workaround for mbstring problems
4394f8369d7dSTobias Sarnowski     *
4395f8369d7dSTobias Sarnowski     * @var bool
4396f8369d7dSTobias Sarnowski     */
4397f8369d7dSTobias Sarnowski    public static $mbstringSupport = true;
4398f8369d7dSTobias Sarnowski    public static $debug = false;
4399f8369d7dSTobias Sarnowski    public static $documents = array();
4400f8369d7dSTobias Sarnowski    public static $defaultDocumentID = null;
4401f8369d7dSTobias Sarnowski//  public static $defaultDoctype = 'html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"';
4402f8369d7dSTobias Sarnowski    /**
4403f8369d7dSTobias Sarnowski     * Applies only to HTML.
4404f8369d7dSTobias Sarnowski     *
4405f8369d7dSTobias Sarnowski     * @var unknown_type
4406f8369d7dSTobias Sarnowski     */
4407f8369d7dSTobias Sarnowski    public static $defaultDoctype = '<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
4408f8369d7dSTobias Sarnowski"http://www.w3.org/TR/html4/loose.dtd">';
4409f8369d7dSTobias Sarnowski    public static $defaultCharset = 'UTF-8';
4410f8369d7dSTobias Sarnowski    /**
4411f8369d7dSTobias Sarnowski     * Static namespace for plugins.
4412f8369d7dSTobias Sarnowski     *
4413f8369d7dSTobias Sarnowski     * @var object
4414f8369d7dSTobias Sarnowski     */
4415f8369d7dSTobias Sarnowski    public static $plugins = array();
4416f8369d7dSTobias Sarnowski    /**
4417f8369d7dSTobias Sarnowski     * List of loaded plugins.
4418f8369d7dSTobias Sarnowski     *
4419f8369d7dSTobias Sarnowski     * @var unknown_type
4420f8369d7dSTobias Sarnowski     */
4421f8369d7dSTobias Sarnowski    public static $pluginsLoaded = array();
4422f8369d7dSTobias Sarnowski    public static $pluginsMethods = array();
4423f8369d7dSTobias Sarnowski    public static $pluginsStaticMethods = array();
4424f8369d7dSTobias Sarnowski    public static $extendMethods = array();
4425f8369d7dSTobias Sarnowski    /**
4426f8369d7dSTobias Sarnowski     * @TODO implement
4427f8369d7dSTobias Sarnowski     */
4428f8369d7dSTobias Sarnowski    public static $extendStaticMethods = array();
4429f8369d7dSTobias Sarnowski    /**
4430f8369d7dSTobias Sarnowski     * Hosts allowed for AJAX connections.
4431f8369d7dSTobias Sarnowski     * Dot '.' means $_SERVER['HTTP_HOST'] (if any).
4432f8369d7dSTobias Sarnowski     *
4433f8369d7dSTobias Sarnowski     * @var array
4434f8369d7dSTobias Sarnowski     */
4435f8369d7dSTobias Sarnowski    public static $ajaxAllowedHosts = array(
4436f8369d7dSTobias Sarnowski        '.'
4437f8369d7dSTobias Sarnowski    );
4438f8369d7dSTobias Sarnowski    /**
4439f8369d7dSTobias Sarnowski     * AJAX settings.
4440f8369d7dSTobias Sarnowski     *
4441f8369d7dSTobias Sarnowski     * @var array
4442f8369d7dSTobias Sarnowski     * XXX should it be static or not ?
4443f8369d7dSTobias Sarnowski     */
4444f8369d7dSTobias Sarnowski    public static $ajaxSettings = array(
4445f8369d7dSTobias Sarnowski        'url' => '',//TODO
4446f8369d7dSTobias Sarnowski        'global' => true,
4447f8369d7dSTobias Sarnowski        'type' => "GET",
4448f8369d7dSTobias Sarnowski        'timeout' => null,
4449f8369d7dSTobias Sarnowski        'contentType' => "application/x-www-form-urlencoded",
4450f8369d7dSTobias Sarnowski        'processData' => true,
4451f8369d7dSTobias Sarnowski//      'async' => true,
4452f8369d7dSTobias Sarnowski        'data' => null,
4453f8369d7dSTobias Sarnowski        'username' => null,
4454f8369d7dSTobias Sarnowski        'password' => null,
4455f8369d7dSTobias Sarnowski        'accepts' => array(
4456f8369d7dSTobias Sarnowski            'xml' => "application/xml, text/xml",
4457f8369d7dSTobias Sarnowski            'html' => "text/html",
4458f8369d7dSTobias Sarnowski            'script' => "text/javascript, application/javascript",
4459f8369d7dSTobias Sarnowski            'json' => "application/json, text/javascript",
4460f8369d7dSTobias Sarnowski            'text' => "text/plain",
4461f8369d7dSTobias Sarnowski            '_default' => "*/*"
4462f8369d7dSTobias Sarnowski        )
4463f8369d7dSTobias Sarnowski    );
4464f8369d7dSTobias Sarnowski    public static $lastModified = null;
4465f8369d7dSTobias Sarnowski    public static $active = 0;
4466f8369d7dSTobias Sarnowski    public static $dumpCount = 0;
4467f8369d7dSTobias Sarnowski    /**
4468f8369d7dSTobias Sarnowski     * Multi-purpose function.
4469f8369d7dSTobias Sarnowski     * Use pq() as shortcut.
4470f8369d7dSTobias Sarnowski     *
4471f8369d7dSTobias Sarnowski     * In below examples, $pq is any result of pq(); function.
4472f8369d7dSTobias Sarnowski     *
4473f8369d7dSTobias Sarnowski     * 1. Import markup into existing document (without any attaching):
4474f8369d7dSTobias Sarnowski     * - Import into selected document:
4475f8369d7dSTobias Sarnowski     *   pq('<div/>')               // DOESNT accept text nodes at beginning of input string !
4476f8369d7dSTobias Sarnowski     * - Import into document with ID from $pq->getDocumentID():
4477f8369d7dSTobias Sarnowski     *   pq('<div/>', $pq->getDocumentID())
4478f8369d7dSTobias Sarnowski     * - Import into same document as DOMNode belongs to:
4479f8369d7dSTobias Sarnowski     *   pq('<div/>', DOMNode)
4480f8369d7dSTobias Sarnowski     * - Import into document from phpQuery object:
4481f8369d7dSTobias Sarnowski     *   pq('<div/>', $pq)
4482f8369d7dSTobias Sarnowski     *
4483f8369d7dSTobias Sarnowski     * 2. Run query:
4484f8369d7dSTobias Sarnowski     * - Run query on last selected document:
4485f8369d7dSTobias Sarnowski     *   pq('div.myClass')
4486f8369d7dSTobias Sarnowski     * - Run query on document with ID from $pq->getDocumentID():
4487f8369d7dSTobias Sarnowski     *   pq('div.myClass', $pq->getDocumentID())
4488f8369d7dSTobias Sarnowski     * - Run query on same document as DOMNode belongs to and use node(s)as root for query:
4489f8369d7dSTobias Sarnowski     *   pq('div.myClass', DOMNode)
4490f8369d7dSTobias Sarnowski     * - Run query on document from phpQuery object
4491f8369d7dSTobias Sarnowski     *   and use object's stack as root node(s) for query:
4492f8369d7dSTobias Sarnowski     *   pq('div.myClass', $pq)
4493f8369d7dSTobias Sarnowski     *
4494f8369d7dSTobias Sarnowski     * @param string|DOMNode|DOMNodeList|array  $arg1   HTML markup, CSS Selector, DOMNode or array of DOMNodes
4495f8369d7dSTobias Sarnowski     * @param string|phpQueryObject|DOMNode $context    DOM ID from $pq->getDocumentID(), phpQuery object (determines also query root) or DOMNode (determines also query root)
4496f8369d7dSTobias Sarnowski     *
4497f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery|QueryTemplatesPhpQuery|false
4498f8369d7dSTobias Sarnowski   * phpQuery object or false in case of error.
4499f8369d7dSTobias Sarnowski     */
4500f8369d7dSTobias Sarnowski    public static function pq($arg1, $context = null) {
4501f8369d7dSTobias Sarnowski        if ($arg1 instanceof DOMNODE && ! isset($context)) {
4502f8369d7dSTobias Sarnowski            foreach(phpQuery::$documents as $documentWrapper) {
4503f8369d7dSTobias Sarnowski                $compare = $arg1 instanceof DOMDocument
4504f8369d7dSTobias Sarnowski                    ? $arg1 : $arg1->ownerDocument;
4505f8369d7dSTobias Sarnowski                if ($documentWrapper->document->isSameNode($compare))
4506f8369d7dSTobias Sarnowski                    $context = $documentWrapper->id;
4507f8369d7dSTobias Sarnowski            }
4508f8369d7dSTobias Sarnowski        }
4509f8369d7dSTobias Sarnowski        if (! $context) {
4510f8369d7dSTobias Sarnowski            $domId = self::$defaultDocumentID;
4511f8369d7dSTobias Sarnowski            if (! $domId)
4512f8369d7dSTobias Sarnowski                throw new Exception("Can't use last created DOM, because there isn't any. Use phpQuery::newDocument() first.");
4513f8369d7dSTobias Sarnowski//      } else if (is_object($context) && ($context instanceof PHPQUERY || is_subclass_of($context, 'phpQueryObject')))
4514f8369d7dSTobias Sarnowski        } else if (is_object($context) && $context instanceof phpQueryObject)
4515f8369d7dSTobias Sarnowski            $domId = $context->getDocumentID();
4516f8369d7dSTobias Sarnowski        else if ($context instanceof DOMDOCUMENT) {
4517f8369d7dSTobias Sarnowski            $domId = self::getDocumentID($context);
4518f8369d7dSTobias Sarnowski            if (! $domId) {
4519f8369d7dSTobias Sarnowski                //throw new Exception('Orphaned DOMDocument');
4520f8369d7dSTobias Sarnowski                $domId = self::newDocument($context)->getDocumentID();
4521f8369d7dSTobias Sarnowski            }
4522f8369d7dSTobias Sarnowski        } else if ($context instanceof DOMNODE) {
4523f8369d7dSTobias Sarnowski            $domId = self::getDocumentID($context);
4524f8369d7dSTobias Sarnowski            if (! $domId) {
4525f8369d7dSTobias Sarnowski                throw new Exception('Orphaned DOMNode');
4526f8369d7dSTobias Sarnowski//              $domId = self::newDocument($context->ownerDocument);
4527f8369d7dSTobias Sarnowski            }
4528f8369d7dSTobias Sarnowski        } else
4529f8369d7dSTobias Sarnowski            $domId = $context;
4530f8369d7dSTobias Sarnowski        if ($arg1 instanceof phpQueryObject) {
4531f8369d7dSTobias Sarnowski//      if (is_object($arg1) && (get_class($arg1) == 'phpQueryObject' || $arg1 instanceof PHPQUERY || is_subclass_of($arg1, 'phpQueryObject'))) {
4532f8369d7dSTobias Sarnowski            /**
4533f8369d7dSTobias Sarnowski             * Return $arg1 or import $arg1 stack if document differs:
4534f8369d7dSTobias Sarnowski             * pq(pq('<div/>'))
4535f8369d7dSTobias Sarnowski             */
4536f8369d7dSTobias Sarnowski            if ($arg1->getDocumentID() == $domId)
4537f8369d7dSTobias Sarnowski                return $arg1;
4538f8369d7dSTobias Sarnowski            $class = get_class($arg1);
4539f8369d7dSTobias Sarnowski            // support inheritance by passing old object to overloaded constructor
4540f8369d7dSTobias Sarnowski            $phpQuery = $class != 'phpQuery'
4541f8369d7dSTobias Sarnowski                ? new $class($arg1, $domId)
4542f8369d7dSTobias Sarnowski                : new phpQueryObject($domId);
4543f8369d7dSTobias Sarnowski            $phpQuery->elements = array();
4544f8369d7dSTobias Sarnowski            foreach($arg1->elements as $node)
4545f8369d7dSTobias Sarnowski                $phpQuery->elements[] = $phpQuery->document->importNode($node, true);
4546f8369d7dSTobias Sarnowski            return $phpQuery;
4547f8369d7dSTobias Sarnowski        } else if ($arg1 instanceof DOMNODE || (is_array($arg1) && isset($arg1[0]) && $arg1[0] instanceof DOMNODE)) {
4548f8369d7dSTobias Sarnowski            /*
4549f8369d7dSTobias Sarnowski             * Wrap DOM nodes with phpQuery object, import into document when needed:
4550f8369d7dSTobias Sarnowski             * pq(array($domNode1, $domNode2))
4551f8369d7dSTobias Sarnowski             */
4552f8369d7dSTobias Sarnowski            $phpQuery = new phpQueryObject($domId);
4553f8369d7dSTobias Sarnowski            if (!($arg1 instanceof DOMNODELIST) && ! is_array($arg1))
4554f8369d7dSTobias Sarnowski                $arg1 = array($arg1);
4555f8369d7dSTobias Sarnowski            $phpQuery->elements = array();
4556f8369d7dSTobias Sarnowski            foreach($arg1 as $node) {
4557f8369d7dSTobias Sarnowski                $sameDocument = $node->ownerDocument instanceof DOMDOCUMENT
4558f8369d7dSTobias Sarnowski                    && ! $node->ownerDocument->isSameNode($phpQuery->document);
4559f8369d7dSTobias Sarnowski                $phpQuery->elements[] = $sameDocument
4560f8369d7dSTobias Sarnowski                    ? $phpQuery->document->importNode($node, true)
4561f8369d7dSTobias Sarnowski                    : $node;
4562f8369d7dSTobias Sarnowski            }
4563f8369d7dSTobias Sarnowski            return $phpQuery;
4564f8369d7dSTobias Sarnowski        } else if (self::isMarkup($arg1)) {
4565f8369d7dSTobias Sarnowski            /**
4566f8369d7dSTobias Sarnowski             * Import HTML:
4567f8369d7dSTobias Sarnowski             * pq('<div/>')
4568f8369d7dSTobias Sarnowski             */
4569f8369d7dSTobias Sarnowski            $phpQuery = new phpQueryObject($domId);
4570f8369d7dSTobias Sarnowski            return $phpQuery->newInstance(
4571f8369d7dSTobias Sarnowski                $phpQuery->documentWrapper->import($arg1)
4572f8369d7dSTobias Sarnowski            );
4573f8369d7dSTobias Sarnowski        } else {
4574f8369d7dSTobias Sarnowski            /**
4575f8369d7dSTobias Sarnowski             * Run CSS query:
4576f8369d7dSTobias Sarnowski             * pq('div.myClass')
4577f8369d7dSTobias Sarnowski             */
4578f8369d7dSTobias Sarnowski            $phpQuery = new phpQueryObject($domId);
4579f8369d7dSTobias Sarnowski//          if ($context && ($context instanceof PHPQUERY || is_subclass_of($context, 'phpQueryObject')))
4580f8369d7dSTobias Sarnowski            if ($context && $context instanceof phpQueryObject)
4581f8369d7dSTobias Sarnowski                $phpQuery->elements = $context->elements;
4582f8369d7dSTobias Sarnowski            else if ($context && $context instanceof DOMNODELIST) {
4583f8369d7dSTobias Sarnowski                $phpQuery->elements = array();
4584f8369d7dSTobias Sarnowski                foreach($context as $node)
4585f8369d7dSTobias Sarnowski                    $phpQuery->elements[] = $node;
4586f8369d7dSTobias Sarnowski            } else if ($context && $context instanceof DOMNODE)
4587f8369d7dSTobias Sarnowski                $phpQuery->elements = array($context);
4588f8369d7dSTobias Sarnowski            return $phpQuery->find($arg1);
4589f8369d7dSTobias Sarnowski        }
4590f8369d7dSTobias Sarnowski    }
4591f8369d7dSTobias Sarnowski    /**
4592f8369d7dSTobias Sarnowski     * Sets default document to $id. Document has to be loaded prior
4593f8369d7dSTobias Sarnowski     * to using this method.
4594f8369d7dSTobias Sarnowski     * $id can be retrived via getDocumentID() or getDocumentIDRef().
4595f8369d7dSTobias Sarnowski     *
4596f8369d7dSTobias Sarnowski     * @param unknown_type $id
4597f8369d7dSTobias Sarnowski     */
4598f8369d7dSTobias Sarnowski    public static function selectDocument($id) {
4599f8369d7dSTobias Sarnowski        $id = self::getDocumentID($id);
4600f8369d7dSTobias Sarnowski        self::debug("Selecting document '$id' as default one");
4601f8369d7dSTobias Sarnowski        self::$defaultDocumentID = self::getDocumentID($id);
4602f8369d7dSTobias Sarnowski    }
4603f8369d7dSTobias Sarnowski    /**
4604f8369d7dSTobias Sarnowski     * Returns document with id $id or last used as phpQueryObject.
4605f8369d7dSTobias Sarnowski     * $id can be retrived via getDocumentID() or getDocumentIDRef().
4606f8369d7dSTobias Sarnowski     * Chainable.
4607f8369d7dSTobias Sarnowski     *
4608f8369d7dSTobias Sarnowski     * @see phpQuery::selectDocument()
4609f8369d7dSTobias Sarnowski     * @param unknown_type $id
4610f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
4611f8369d7dSTobias Sarnowski     */
4612f8369d7dSTobias Sarnowski    public static function getDocument($id = null) {
4613f8369d7dSTobias Sarnowski        if ($id)
4614f8369d7dSTobias Sarnowski            phpQuery::selectDocument($id);
4615f8369d7dSTobias Sarnowski        else
4616f8369d7dSTobias Sarnowski            $id = phpQuery::$defaultDocumentID;
4617f8369d7dSTobias Sarnowski        return new phpQueryObject($id);
4618f8369d7dSTobias Sarnowski    }
4619f8369d7dSTobias Sarnowski    /**
4620f8369d7dSTobias Sarnowski     * Creates new document from markup.
4621f8369d7dSTobias Sarnowski     * Chainable.
4622f8369d7dSTobias Sarnowski     *
4623f8369d7dSTobias Sarnowski     * @param unknown_type $markup
4624f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
4625f8369d7dSTobias Sarnowski     */
4626f8369d7dSTobias Sarnowski    public static function newDocument($markup = null, $contentType = null) {
4627f8369d7dSTobias Sarnowski        if (! $markup)
4628f8369d7dSTobias Sarnowski            $markup = '';
4629f8369d7dSTobias Sarnowski        $documentID = phpQuery::createDocumentWrapper($markup, $contentType);
4630f8369d7dSTobias Sarnowski        return new phpQueryObject($documentID);
4631f8369d7dSTobias Sarnowski    }
4632f8369d7dSTobias Sarnowski    /**
4633f8369d7dSTobias Sarnowski     * Creates new document from markup.
4634f8369d7dSTobias Sarnowski     * Chainable.
4635f8369d7dSTobias Sarnowski     *
4636f8369d7dSTobias Sarnowski     * @param unknown_type $markup
4637f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
4638f8369d7dSTobias Sarnowski     */
4639f8369d7dSTobias Sarnowski    public static function newDocumentHTML($markup = null, $charset = null) {
4640f8369d7dSTobias Sarnowski        $contentType = $charset
4641f8369d7dSTobias Sarnowski            ? ";charset=$charset"
4642f8369d7dSTobias Sarnowski            : '';
4643f8369d7dSTobias Sarnowski        return self::newDocument($markup, "text/html{$contentType}");
4644f8369d7dSTobias Sarnowski    }
4645f8369d7dSTobias Sarnowski    /**
4646f8369d7dSTobias Sarnowski     * Creates new document from markup.
4647f8369d7dSTobias Sarnowski     * Chainable.
4648f8369d7dSTobias Sarnowski     *
4649f8369d7dSTobias Sarnowski     * @param unknown_type $markup
4650f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
4651f8369d7dSTobias Sarnowski     */
4652f8369d7dSTobias Sarnowski    public static function newDocumentXML($markup = null, $charset = null) {
4653f8369d7dSTobias Sarnowski        $contentType = $charset
4654f8369d7dSTobias Sarnowski            ? ";charset=$charset"
4655f8369d7dSTobias Sarnowski            : '';
4656f8369d7dSTobias Sarnowski        return self::newDocument($markup, "text/xml{$contentType}");
4657f8369d7dSTobias Sarnowski    }
4658f8369d7dSTobias Sarnowski    /**
4659f8369d7dSTobias Sarnowski     * Creates new document from markup.
4660f8369d7dSTobias Sarnowski     * Chainable.
4661f8369d7dSTobias Sarnowski     *
4662f8369d7dSTobias Sarnowski     * @param unknown_type $markup
4663f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
4664f8369d7dSTobias Sarnowski     */
4665f8369d7dSTobias Sarnowski    public static function newDocumentXHTML($markup = null, $charset = null) {
4666f8369d7dSTobias Sarnowski        $contentType = $charset
4667f8369d7dSTobias Sarnowski            ? ";charset=$charset"
4668f8369d7dSTobias Sarnowski            : '';
4669f8369d7dSTobias Sarnowski        return self::newDocument($markup, "application/xhtml+xml{$contentType}");
4670f8369d7dSTobias Sarnowski    }
4671f8369d7dSTobias Sarnowski    /**
4672f8369d7dSTobias Sarnowski     * Creates new document from markup.
4673f8369d7dSTobias Sarnowski     * Chainable.
4674f8369d7dSTobias Sarnowski     *
4675f8369d7dSTobias Sarnowski     * @param unknown_type $markup
4676f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
4677f8369d7dSTobias Sarnowski     */
4678f8369d7dSTobias Sarnowski    public static function newDocumentPHP($markup = null, $contentType = "text/html") {
4679f8369d7dSTobias Sarnowski        // TODO pass charset to phpToMarkup if possible (use DOMDocumentWrapper function)
4680f8369d7dSTobias Sarnowski        $markup = phpQuery::phpToMarkup($markup, self::$defaultCharset);
4681f8369d7dSTobias Sarnowski        return self::newDocument($markup, $contentType);
4682f8369d7dSTobias Sarnowski    }
4683f8369d7dSTobias Sarnowski    public static function phpToMarkup($php, $charset = 'utf-8') {
4684f8369d7dSTobias Sarnowski        $regexes = array(
4685f8369d7dSTobias Sarnowski            '@(<(?!\\?)(?:[^>]|\\?>)+\\w+\\s*=\\s*)(\')([^\']*)<'.'?php?(.*?)(?:\\?>)([^\']*)\'@s',
4686f8369d7dSTobias Sarnowski            '@(<(?!\\?)(?:[^>]|\\?>)+\\w+\\s*=\\s*)(")([^"]*)<'.'?php?(.*?)(?:\\?>)([^"]*)"@s',
4687f8369d7dSTobias Sarnowski        );
4688f8369d7dSTobias Sarnowski        foreach($regexes as $regex)
4689f8369d7dSTobias Sarnowski            while (preg_match($regex, $php, $matches)) {
4690f8369d7dSTobias Sarnowski                $php = preg_replace_callback(
4691f8369d7dSTobias Sarnowski                    $regex,
4692f8369d7dSTobias Sarnowski//                  create_function('$m, $charset = "'.$charset.'"',
4693f8369d7dSTobias Sarnowski//                      'return $m[1].$m[2]
4694f8369d7dSTobias Sarnowski//                          .htmlspecialchars("<"."?php".$m[4]."?".">", ENT_QUOTES|ENT_NOQUOTES, $charset)
4695f8369d7dSTobias Sarnowski//                          .$m[5].$m[2];'
4696f8369d7dSTobias Sarnowski//                  ),
4697f8369d7dSTobias Sarnowski                    array('phpQuery', '_phpToMarkupCallback'),
4698f8369d7dSTobias Sarnowski                    $php
4699f8369d7dSTobias Sarnowski                );
4700f8369d7dSTobias Sarnowski            }
4701f8369d7dSTobias Sarnowski        $regex = '@(^|>[^<]*)+?(<\?php(.*?)(\?>))@s';
4702f8369d7dSTobias Sarnowski//preg_match_all($regex, $php, $matches);
4703f8369d7dSTobias Sarnowski//var_dump($matches);
4704f8369d7dSTobias Sarnowski        $php = preg_replace($regex, '\\1<php><!-- \\3 --></php>', $php);
4705f8369d7dSTobias Sarnowski        return $php;
4706f8369d7dSTobias Sarnowski    }
4707f8369d7dSTobias Sarnowski    public static function _phpToMarkupCallback($php, $charset = 'utf-8') {
4708f8369d7dSTobias Sarnowski        return $m[1].$m[2]
4709f8369d7dSTobias Sarnowski            .htmlspecialchars("<"."?php".$m[4]."?".">", ENT_QUOTES|ENT_NOQUOTES, $charset)
4710f8369d7dSTobias Sarnowski            .$m[5].$m[2];
4711f8369d7dSTobias Sarnowski    }
4712f8369d7dSTobias Sarnowski    public static function _markupToPHPCallback($m) {
4713f8369d7dSTobias Sarnowski        return "<"."?php ".htmlspecialchars_decode($m[1])." ?".">";
4714f8369d7dSTobias Sarnowski    }
4715f8369d7dSTobias Sarnowski    /**
4716f8369d7dSTobias Sarnowski     * Converts document markup containing PHP code generated by phpQuery::php()
4717f8369d7dSTobias Sarnowski     * into valid (executable) PHP code syntax.
4718f8369d7dSTobias Sarnowski     *
4719f8369d7dSTobias Sarnowski     * @param string|phpQueryObject $content
4720f8369d7dSTobias Sarnowski     * @return string PHP code.
4721f8369d7dSTobias Sarnowski     */
4722f8369d7dSTobias Sarnowski    public static function markupToPHP($content) {
4723f8369d7dSTobias Sarnowski        if ($content instanceof phpQueryObject)
4724f8369d7dSTobias Sarnowski            $content = $content->markupOuter();
4725f8369d7dSTobias Sarnowski        /* <php>...</php> to <?php...? > */
4726f8369d7dSTobias Sarnowski        $content = preg_replace_callback(
4727f8369d7dSTobias Sarnowski            '@<php>\s*<!--(.*?)-->\s*</php>@s',
4728f8369d7dSTobias Sarnowski//          create_function('$m',
4729f8369d7dSTobias Sarnowski//              'return "<'.'?php ".htmlspecialchars_decode($m[1])." ?'.'>";'
4730f8369d7dSTobias Sarnowski//          ),
4731f8369d7dSTobias Sarnowski            array('phpQuery', '_markupToPHPCallback'),
4732f8369d7dSTobias Sarnowski            $content
4733f8369d7dSTobias Sarnowski        );
4734f8369d7dSTobias Sarnowski        /* <node attr='< ?php ? >'> extra space added to save highlighters */
4735f8369d7dSTobias Sarnowski        $regexes = array(
4736f8369d7dSTobias Sarnowski            '@(<(?!\\?)(?:[^>]|\\?>)+\\w+\\s*=\\s*)(\')([^\']*)(?:&lt;|%3C)\\?(?:php)?(.*?)(?:\\?(?:&gt;|%3E))([^\']*)\'@s',
4737f8369d7dSTobias Sarnowski            '@(<(?!\\?)(?:[^>]|\\?>)+\\w+\\s*=\\s*)(")([^"]*)(?:&lt;|%3C)\\?(?:php)?(.*?)(?:\\?(?:&gt;|%3E))([^"]*)"@s',
4738f8369d7dSTobias Sarnowski        );
4739f8369d7dSTobias Sarnowski        foreach($regexes as $regex)
4740f8369d7dSTobias Sarnowski            while (preg_match($regex, $content))
4741f8369d7dSTobias Sarnowski                $content = preg_replace_callback(
4742f8369d7dSTobias Sarnowski                    $regex,
4743*a3095052SOscar Merida                    function ($m) {
4744*a3095052SOscar Merida                        return $m[1] . $m[2] . $m[3] . '<?php '
4745f8369d7dSTobias Sarnowski                            . str_replace(
4746f8369d7dSTobias Sarnowski                                array("%20", "%3E", "%09", "&#10;", "&#9;", "%7B", "%24", "%7D", "%22", "%5B", "%5D"),
4747*a3095052SOscar Merida                                array(" ", ">", "   ", "\n", "  ", "{", "$", "}", '"', "[", "]"),
4748f8369d7dSTobias Sarnowski                                htmlspecialchars_decode($m[4])
4749f8369d7dSTobias Sarnowski                            )
4750*a3095052SOscar Merida                            . " ?>" . $m[5] . $m[2];
4751*a3095052SOscar Merida                    },
4752f8369d7dSTobias Sarnowski                    $content
4753f8369d7dSTobias Sarnowski                );
4754f8369d7dSTobias Sarnowski        return $content;
4755f8369d7dSTobias Sarnowski    }
4756f8369d7dSTobias Sarnowski    /**
4757f8369d7dSTobias Sarnowski     * Creates new document from file $file.
4758f8369d7dSTobias Sarnowski     * Chainable.
4759f8369d7dSTobias Sarnowski     *
4760f8369d7dSTobias Sarnowski     * @param string $file URLs allowed. See File wrapper page at php.net for more supported sources.
4761f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
4762f8369d7dSTobias Sarnowski     */
4763f8369d7dSTobias Sarnowski    public static function newDocumentFile($file, $contentType = null) {
4764f8369d7dSTobias Sarnowski        $documentID = self::createDocumentWrapper(
4765f8369d7dSTobias Sarnowski            file_get_contents($file), $contentType
4766f8369d7dSTobias Sarnowski        );
4767f8369d7dSTobias Sarnowski        return new phpQueryObject($documentID);
4768f8369d7dSTobias Sarnowski    }
4769f8369d7dSTobias Sarnowski    /**
4770f8369d7dSTobias Sarnowski     * Creates new document from markup.
4771f8369d7dSTobias Sarnowski     * Chainable.
4772f8369d7dSTobias Sarnowski     *
4773f8369d7dSTobias Sarnowski     * @param unknown_type $markup
4774f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
4775f8369d7dSTobias Sarnowski     */
4776f8369d7dSTobias Sarnowski    public static function newDocumentFileHTML($file, $charset = null) {
4777f8369d7dSTobias Sarnowski        $contentType = $charset
4778f8369d7dSTobias Sarnowski            ? ";charset=$charset"
4779f8369d7dSTobias Sarnowski            : '';
4780f8369d7dSTobias Sarnowski        return self::newDocumentFile($file, "text/html{$contentType}");
4781f8369d7dSTobias Sarnowski    }
4782f8369d7dSTobias Sarnowski    /**
4783f8369d7dSTobias Sarnowski     * Creates new document from markup.
4784f8369d7dSTobias Sarnowski     * Chainable.
4785f8369d7dSTobias Sarnowski     *
4786f8369d7dSTobias Sarnowski     * @param unknown_type $markup
4787f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
4788f8369d7dSTobias Sarnowski     */
4789f8369d7dSTobias Sarnowski    public static function newDocumentFileXML($file, $charset = null) {
4790f8369d7dSTobias Sarnowski        $contentType = $charset
4791f8369d7dSTobias Sarnowski            ? ";charset=$charset"
4792f8369d7dSTobias Sarnowski            : '';
4793f8369d7dSTobias Sarnowski        return self::newDocumentFile($file, "text/xml{$contentType}");
4794f8369d7dSTobias Sarnowski    }
4795f8369d7dSTobias Sarnowski    /**
4796f8369d7dSTobias Sarnowski     * Creates new document from markup.
4797f8369d7dSTobias Sarnowski     * Chainable.
4798f8369d7dSTobias Sarnowski     *
4799f8369d7dSTobias Sarnowski     * @param unknown_type $markup
4800f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
4801f8369d7dSTobias Sarnowski     */
4802f8369d7dSTobias Sarnowski    public static function newDocumentFileXHTML($file, $charset = null) {
4803f8369d7dSTobias Sarnowski        $contentType = $charset
4804f8369d7dSTobias Sarnowski            ? ";charset=$charset"
4805f8369d7dSTobias Sarnowski            : '';
4806f8369d7dSTobias Sarnowski        return self::newDocumentFile($file, "application/xhtml+xml{$contentType}");
4807f8369d7dSTobias Sarnowski    }
4808f8369d7dSTobias Sarnowski    /**
4809f8369d7dSTobias Sarnowski     * Creates new document from markup.
4810f8369d7dSTobias Sarnowski     * Chainable.
4811f8369d7dSTobias Sarnowski     *
4812f8369d7dSTobias Sarnowski     * @param unknown_type $markup
4813f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
4814f8369d7dSTobias Sarnowski     */
4815f8369d7dSTobias Sarnowski    public static function newDocumentFilePHP($file, $contentType = null) {
4816f8369d7dSTobias Sarnowski        return self::newDocumentPHP(file_get_contents($file), $contentType);
4817f8369d7dSTobias Sarnowski    }
4818f8369d7dSTobias Sarnowski    /**
4819f8369d7dSTobias Sarnowski     * Reuses existing DOMDocument object.
4820f8369d7dSTobias Sarnowski     * Chainable.
4821f8369d7dSTobias Sarnowski     *
4822f8369d7dSTobias Sarnowski     * @param $document DOMDocument
4823f8369d7dSTobias Sarnowski     * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
4824f8369d7dSTobias Sarnowski     * @TODO support DOMDocument
4825f8369d7dSTobias Sarnowski     */
4826f8369d7dSTobias Sarnowski    public static function loadDocument($document) {
4827f8369d7dSTobias Sarnowski        // TODO
4828f8369d7dSTobias Sarnowski        die('TODO loadDocument');
4829f8369d7dSTobias Sarnowski    }
4830f8369d7dSTobias Sarnowski    /**
4831f8369d7dSTobias Sarnowski     * Enter description here...
4832f8369d7dSTobias Sarnowski     *
4833f8369d7dSTobias Sarnowski     * @param unknown_type $html
4834f8369d7dSTobias Sarnowski     * @param unknown_type $domId
4835f8369d7dSTobias Sarnowski     * @return unknown New DOM ID
4836f8369d7dSTobias Sarnowski     * @todo support PHP tags in input
4837f8369d7dSTobias Sarnowski     * @todo support passing DOMDocument object from self::loadDocument
4838f8369d7dSTobias Sarnowski     */
4839f8369d7dSTobias Sarnowski    protected static function createDocumentWrapper($html, $contentType = null, $documentID = null) {
4840f8369d7dSTobias Sarnowski        if (function_exists('domxml_open_mem'))
4841f8369d7dSTobias Sarnowski            throw new Exception("Old PHP4 DOM XML extension detected. phpQuery won't work until this extension is enabled.");
4842f8369d7dSTobias Sarnowski//      $id = $documentID
4843f8369d7dSTobias Sarnowski//          ? $documentID
4844f8369d7dSTobias Sarnowski//          : md5(microtime());
4845f8369d7dSTobias Sarnowski        $document = null;
4846f8369d7dSTobias Sarnowski        if ($html instanceof DOMDOCUMENT) {
4847f8369d7dSTobias Sarnowski            if (self::getDocumentID($html)) {
4848f8369d7dSTobias Sarnowski                // document already exists in phpQuery::$documents, make a copy
4849f8369d7dSTobias Sarnowski                $document = clone $html;
4850f8369d7dSTobias Sarnowski            } else {
4851f8369d7dSTobias Sarnowski                // new document, add it to phpQuery::$documents
4852f8369d7dSTobias Sarnowski                $wrapper = new DOMDocumentWrapper($html, $contentType, $documentID);
4853f8369d7dSTobias Sarnowski            }
4854f8369d7dSTobias Sarnowski        } else {
4855f8369d7dSTobias Sarnowski            $wrapper = new DOMDocumentWrapper($html, $contentType, $documentID);
4856f8369d7dSTobias Sarnowski        }
4857f8369d7dSTobias Sarnowski//      $wrapper->id = $id;
4858f8369d7dSTobias Sarnowski        // bind document
4859f8369d7dSTobias Sarnowski        phpQuery::$documents[$wrapper->id] = $wrapper;
4860f8369d7dSTobias Sarnowski        // remember last loaded document
4861f8369d7dSTobias Sarnowski        phpQuery::selectDocument($wrapper->id);
4862f8369d7dSTobias Sarnowski        return $wrapper->id;
4863f8369d7dSTobias Sarnowski    }
4864f8369d7dSTobias Sarnowski    /**
4865f8369d7dSTobias Sarnowski     * Extend class namespace.
4866f8369d7dSTobias Sarnowski     *
4867f8369d7dSTobias Sarnowski     * @param string|array $target
4868f8369d7dSTobias Sarnowski     * @param array $source
4869f8369d7dSTobias Sarnowski     * @TODO support string $source
4870f8369d7dSTobias Sarnowski     * @return unknown_type
4871f8369d7dSTobias Sarnowski     */
4872f8369d7dSTobias Sarnowski    public static function extend($target, $source) {
4873f8369d7dSTobias Sarnowski        switch($target) {
4874f8369d7dSTobias Sarnowski            case 'phpQueryObject':
4875f8369d7dSTobias Sarnowski                $targetRef = &self::$extendMethods;
4876f8369d7dSTobias Sarnowski                $targetRef2 = &self::$pluginsMethods;
4877f8369d7dSTobias Sarnowski                break;
4878f8369d7dSTobias Sarnowski            case 'phpQuery':
4879f8369d7dSTobias Sarnowski                $targetRef = &self::$extendStaticMethods;
4880f8369d7dSTobias Sarnowski                $targetRef2 = &self::$pluginsStaticMethods;
4881f8369d7dSTobias Sarnowski                break;
4882f8369d7dSTobias Sarnowski            default:
4883f8369d7dSTobias Sarnowski                throw new Exception("Unsupported \$target type");
4884f8369d7dSTobias Sarnowski        }
4885f8369d7dSTobias Sarnowski        if (is_string($source))
4886f8369d7dSTobias Sarnowski            $source = array($source => $source);
4887f8369d7dSTobias Sarnowski        foreach($source as $method => $callback) {
4888f8369d7dSTobias Sarnowski            if (isset($targetRef[$method])) {
4889f8369d7dSTobias Sarnowski//              throw new Exception
4890f8369d7dSTobias Sarnowski                self::debug("Duplicate method '{$method}', can\'t extend '{$target}'");
4891f8369d7dSTobias Sarnowski                continue;
4892f8369d7dSTobias Sarnowski            }
4893f8369d7dSTobias Sarnowski            if (isset($targetRef2[$method])) {
4894f8369d7dSTobias Sarnowski//              throw new Exception
4895f8369d7dSTobias Sarnowski                self::debug("Duplicate method '{$method}' from plugin '{$targetRef2[$method]}',"
4896f8369d7dSTobias Sarnowski                    ." can\'t extend '{$target}'");
4897f8369d7dSTobias Sarnowski                continue;
4898f8369d7dSTobias Sarnowski            }
4899f8369d7dSTobias Sarnowski            $targetRef[$method] = $callback;
4900f8369d7dSTobias Sarnowski        }
4901f8369d7dSTobias Sarnowski        return true;
4902f8369d7dSTobias Sarnowski    }
4903f8369d7dSTobias Sarnowski    /**
4904f8369d7dSTobias Sarnowski     * Extend phpQuery with $class from $file.
4905f8369d7dSTobias Sarnowski     *
4906f8369d7dSTobias Sarnowski     * @param string $class Extending class name. Real class name can be prepended phpQuery_.
4907f8369d7dSTobias Sarnowski     * @param string $file Filename to include. Defaults to "{$class}.php".
4908f8369d7dSTobias Sarnowski     */
4909f8369d7dSTobias Sarnowski    public static function plugin($class, $file = null) {
4910f8369d7dSTobias Sarnowski        // TODO $class checked agains phpQuery_$class
4911f8369d7dSTobias Sarnowski//      if (strpos($class, 'phpQuery') === 0)
4912f8369d7dSTobias Sarnowski//          $class = substr($class, 8);
4913f8369d7dSTobias Sarnowski        if (in_array($class, self::$pluginsLoaded))
4914f8369d7dSTobias Sarnowski            return true;
4915f8369d7dSTobias Sarnowski        if (! $file)
4916f8369d7dSTobias Sarnowski            $file = $class.'.php';
4917f8369d7dSTobias Sarnowski        $objectClassExists = class_exists('phpQueryObjectPlugin_'.$class);
4918f8369d7dSTobias Sarnowski        $staticClassExists = class_exists('phpQueryPlugin_'.$class);
4919f8369d7dSTobias Sarnowski        if (! $objectClassExists && ! $staticClassExists)
4920f8369d7dSTobias Sarnowski            require_once($file);
4921f8369d7dSTobias Sarnowski        self::$pluginsLoaded[] = $class;
4922f8369d7dSTobias Sarnowski        // static methods
4923f8369d7dSTobias Sarnowski        if (class_exists('phpQueryPlugin_'.$class)) {
4924f8369d7dSTobias Sarnowski            $realClass = 'phpQueryPlugin_'.$class;
4925f8369d7dSTobias Sarnowski            $vars = get_class_vars($realClass);
4926f8369d7dSTobias Sarnowski            $loop = isset($vars['phpQueryMethods'])
4927f8369d7dSTobias Sarnowski                && ! is_null($vars['phpQueryMethods'])
4928f8369d7dSTobias Sarnowski                ? $vars['phpQueryMethods']
4929f8369d7dSTobias Sarnowski                : get_class_methods($realClass);
4930f8369d7dSTobias Sarnowski            foreach($loop as $method) {
4931f8369d7dSTobias Sarnowski                if ($method == '__initialize')
4932f8369d7dSTobias Sarnowski                    continue;
4933f8369d7dSTobias Sarnowski                if (! is_callable(array($realClass, $method)))
4934f8369d7dSTobias Sarnowski                    continue;
4935f8369d7dSTobias Sarnowski                if (isset(self::$pluginsStaticMethods[$method])) {
4936f8369d7dSTobias Sarnowski                    throw new Exception("Duplicate method '{$method}' from plugin '{$c}' conflicts with same method from plugin '".self::$pluginsStaticMethods[$method]."'");
4937f8369d7dSTobias Sarnowski                    return;
4938f8369d7dSTobias Sarnowski                }
4939f8369d7dSTobias Sarnowski                self::$pluginsStaticMethods[$method] = $class;
4940f8369d7dSTobias Sarnowski            }
4941f8369d7dSTobias Sarnowski            if (method_exists($realClass, '__initialize'))
4942f8369d7dSTobias Sarnowski                call_user_func_array(array($realClass, '__initialize'), array());
4943f8369d7dSTobias Sarnowski        }
4944f8369d7dSTobias Sarnowski        // object methods
4945f8369d7dSTobias Sarnowski        if (class_exists('phpQueryObjectPlugin_'.$class)) {
4946f8369d7dSTobias Sarnowski            $realClass = 'phpQueryObjectPlugin_'.$class;
4947f8369d7dSTobias Sarnowski            $vars = get_class_vars($realClass);
4948f8369d7dSTobias Sarnowski            $loop = isset($vars['phpQueryMethods'])
4949f8369d7dSTobias Sarnowski                && ! is_null($vars['phpQueryMethods'])
4950f8369d7dSTobias Sarnowski                ? $vars['phpQueryMethods']
4951f8369d7dSTobias Sarnowski                : get_class_methods($realClass);
4952f8369d7dSTobias Sarnowski            foreach($loop as $method) {
4953f8369d7dSTobias Sarnowski                if (! is_callable(array($realClass, $method)))
4954f8369d7dSTobias Sarnowski                    continue;
4955f8369d7dSTobias Sarnowski                if (isset(self::$pluginsMethods[$method])) {
4956f8369d7dSTobias Sarnowski                    throw new Exception("Duplicate method '{$method}' from plugin '{$c}' conflicts with same method from plugin '".self::$pluginsMethods[$method]."'");
4957f8369d7dSTobias Sarnowski                    continue;
4958f8369d7dSTobias Sarnowski                }
4959f8369d7dSTobias Sarnowski                self::$pluginsMethods[$method] = $class;
4960f8369d7dSTobias Sarnowski            }
4961f8369d7dSTobias Sarnowski        }
4962f8369d7dSTobias Sarnowski        return true;
4963f8369d7dSTobias Sarnowski    }
4964f8369d7dSTobias Sarnowski    /**
4965f8369d7dSTobias Sarnowski     * Unloades all or specified document from memory.
4966f8369d7dSTobias Sarnowski     *
4967f8369d7dSTobias Sarnowski     * @param mixed $documentID @see phpQuery::getDocumentID() for supported types.
4968f8369d7dSTobias Sarnowski     */
4969f8369d7dSTobias Sarnowski    public static function unloadDocuments($id = null) {
4970f8369d7dSTobias Sarnowski        if (isset($id)) {
4971f8369d7dSTobias Sarnowski            if ($id = self::getDocumentID($id))
4972f8369d7dSTobias Sarnowski                unset(phpQuery::$documents[$id]);
4973f8369d7dSTobias Sarnowski        } else {
4974f8369d7dSTobias Sarnowski            foreach(phpQuery::$documents as $k => $v) {
4975f8369d7dSTobias Sarnowski                unset(phpQuery::$documents[$k]);
4976f8369d7dSTobias Sarnowski            }
4977f8369d7dSTobias Sarnowski        }
4978f8369d7dSTobias Sarnowski    }
4979f8369d7dSTobias Sarnowski    /**
4980f8369d7dSTobias Sarnowski     * Parses phpQuery object or HTML result against PHP tags and makes them active.
4981f8369d7dSTobias Sarnowski     *
4982f8369d7dSTobias Sarnowski     * @param phpQuery|string $content
4983f8369d7dSTobias Sarnowski     * @deprecated
4984f8369d7dSTobias Sarnowski     * @return string
4985f8369d7dSTobias Sarnowski     */
4986f8369d7dSTobias Sarnowski    public static function unsafePHPTags($content) {
4987f8369d7dSTobias Sarnowski        return self::markupToPHP($content);
4988f8369d7dSTobias Sarnowski    }
4989f8369d7dSTobias Sarnowski    public static function DOMNodeListToArray($DOMNodeList) {
4990f8369d7dSTobias Sarnowski        $array = array();
4991f8369d7dSTobias Sarnowski        if (! $DOMNodeList)
4992f8369d7dSTobias Sarnowski            return $array;
4993f8369d7dSTobias Sarnowski        foreach($DOMNodeList as $node)
4994f8369d7dSTobias Sarnowski            $array[] = $node;
4995f8369d7dSTobias Sarnowski        return $array;
4996f8369d7dSTobias Sarnowski    }
4997f8369d7dSTobias Sarnowski    /**
4998f8369d7dSTobias Sarnowski     * Checks if $input is HTML string, which has to start with '<'.
4999f8369d7dSTobias Sarnowski     *
5000f8369d7dSTobias Sarnowski     * @deprecated
5001f8369d7dSTobias Sarnowski     * @param String $input
5002f8369d7dSTobias Sarnowski     * @return Bool
5003f8369d7dSTobias Sarnowski     * @todo still used ?
5004f8369d7dSTobias Sarnowski     */
5005f8369d7dSTobias Sarnowski    public static function isMarkup($input) {
5006f8369d7dSTobias Sarnowski        return ! is_array($input) && substr(trim($input), 0, 1) == '<';
5007f8369d7dSTobias Sarnowski    }
5008f8369d7dSTobias Sarnowski    public static function debug($text) {
5009f8369d7dSTobias Sarnowski        if (self::$debug)
5010f8369d7dSTobias Sarnowski            print var_dump($text);
5011f8369d7dSTobias Sarnowski    }
5012f8369d7dSTobias Sarnowski    /**
5013f8369d7dSTobias Sarnowski     * Make an AJAX request.
5014f8369d7dSTobias Sarnowski     *
5015f8369d7dSTobias Sarnowski     * @param array See $options http://docs.jquery.com/Ajax/jQuery.ajax#toptions
5016f8369d7dSTobias Sarnowski     * Additional options are:
5017f8369d7dSTobias Sarnowski     * 'document' - document for global events, @see phpQuery::getDocumentID()
5018f8369d7dSTobias Sarnowski     * 'referer' - implemented
5019f8369d7dSTobias Sarnowski     * 'requested_with' - TODO; not implemented (X-Requested-With)
5020f8369d7dSTobias Sarnowski     * @return Zend_Http_Client
5021f8369d7dSTobias Sarnowski     * @link http://docs.jquery.com/Ajax/jQuery.ajax
5022f8369d7dSTobias Sarnowski     *
5023f8369d7dSTobias Sarnowski     * @TODO $options['cache']
5024f8369d7dSTobias Sarnowski     * @TODO $options['processData']
5025f8369d7dSTobias Sarnowski     * @TODO $options['xhr']
5026f8369d7dSTobias Sarnowski     * @TODO $options['data'] as string
5027f8369d7dSTobias Sarnowski     * @TODO XHR interface
5028f8369d7dSTobias Sarnowski     */
5029f8369d7dSTobias Sarnowski    public static function ajax($options = array(), $xhr = null) {
5030f8369d7dSTobias Sarnowski        $options = array_merge(
5031f8369d7dSTobias Sarnowski            self::$ajaxSettings, $options
5032f8369d7dSTobias Sarnowski        );
5033f8369d7dSTobias Sarnowski        $documentID = isset($options['document'])
5034f8369d7dSTobias Sarnowski            ? self::getDocumentID($options['document'])
5035f8369d7dSTobias Sarnowski            : null;
5036f8369d7dSTobias Sarnowski        if ($xhr) {
5037f8369d7dSTobias Sarnowski            // reuse existing XHR object, but clean it up
5038f8369d7dSTobias Sarnowski            $client = $xhr;
5039f8369d7dSTobias Sarnowski//          $client->setParameterPost(null);
5040f8369d7dSTobias Sarnowski//          $client->setParameterGet(null);
5041f8369d7dSTobias Sarnowski            $client->setAuth(false);
5042f8369d7dSTobias Sarnowski            $client->setHeaders("If-Modified-Since", null);
5043f8369d7dSTobias Sarnowski            $client->setHeaders("Referer", null);
5044f8369d7dSTobias Sarnowski            $client->resetParameters();
5045f8369d7dSTobias Sarnowski        } else {
5046f8369d7dSTobias Sarnowski            // create new XHR object
5047f8369d7dSTobias Sarnowski            require_once('Zend/Http/Client.php');
5048f8369d7dSTobias Sarnowski            $client = new Zend_Http_Client();
5049f8369d7dSTobias Sarnowski            $client->setCookieJar();
5050f8369d7dSTobias Sarnowski        }
5051f8369d7dSTobias Sarnowski        if (isset($options['timeout']))
5052f8369d7dSTobias Sarnowski            $client->setConfig(array(
5053f8369d7dSTobias Sarnowski                'timeout'      => $options['timeout'],
5054f8369d7dSTobias Sarnowski            ));
5055f8369d7dSTobias Sarnowski//          'maxredirects' => 0,
5056f8369d7dSTobias Sarnowski        foreach(self::$ajaxAllowedHosts as $k => $host)
5057f8369d7dSTobias Sarnowski            if ($host == '.' && isset($_SERVER['HTTP_HOST']))
5058f8369d7dSTobias Sarnowski                self::$ajaxAllowedHosts[$k] = $_SERVER['HTTP_HOST'];
5059f8369d7dSTobias Sarnowski        $host = parse_url($options['url'], PHP_URL_HOST);
5060f8369d7dSTobias Sarnowski        if (! in_array($host, self::$ajaxAllowedHosts)) {
5061f8369d7dSTobias Sarnowski            throw new Exception("Request not permitted, host '$host' not present in "
5062f8369d7dSTobias Sarnowski                ."phpQuery::\$ajaxAllowedHosts");
5063f8369d7dSTobias Sarnowski        }
5064f8369d7dSTobias Sarnowski        // JSONP
5065f8369d7dSTobias Sarnowski        $jsre = "/=\\?(&|$)/";
5066f8369d7dSTobias Sarnowski        if (isset($options['dataType']) && $options['dataType'] == 'jsonp') {
5067f8369d7dSTobias Sarnowski            $jsonpCallbackParam = $options['jsonp']
5068f8369d7dSTobias Sarnowski                ? $options['jsonp'] : 'callback';
5069f8369d7dSTobias Sarnowski            if (strtolower($options['type']) == 'get') {
5070f8369d7dSTobias Sarnowski                if (! preg_match($jsre, $options['url'])) {
5071f8369d7dSTobias Sarnowski                    $sep = strpos($options['url'], '?')
5072f8369d7dSTobias Sarnowski                        ? '&' : '?';
5073f8369d7dSTobias Sarnowski                    $options['url'] .= "$sep$jsonpCallbackParam=?";
5074f8369d7dSTobias Sarnowski                }
5075f8369d7dSTobias Sarnowski            } else if ($options['data']) {
5076f8369d7dSTobias Sarnowski                $jsonp = false;
5077f8369d7dSTobias Sarnowski                foreach($options['data'] as $n => $v) {
5078f8369d7dSTobias Sarnowski                    if ($v == '?')
5079f8369d7dSTobias Sarnowski                        $jsonp = true;
5080f8369d7dSTobias Sarnowski                }
5081f8369d7dSTobias Sarnowski                if (! $jsonp) {
5082f8369d7dSTobias Sarnowski                    $options['data'][$jsonpCallbackParam] = '?';
5083f8369d7dSTobias Sarnowski                }
5084f8369d7dSTobias Sarnowski            }
5085f8369d7dSTobias Sarnowski            $options['dataType'] = 'json';
5086f8369d7dSTobias Sarnowski        }
5087f8369d7dSTobias Sarnowski        if (isset($options['dataType']) && $options['dataType'] == 'json') {
5088f8369d7dSTobias Sarnowski            $jsonpCallback = 'json_'.md5(microtime());
5089f8369d7dSTobias Sarnowski            $jsonpData = $jsonpUrl = false;
5090f8369d7dSTobias Sarnowski            if ($options['data']) {
5091f8369d7dSTobias Sarnowski                foreach($options['data'] as $n => $v) {
5092f8369d7dSTobias Sarnowski                    if ($v == '?')
5093f8369d7dSTobias Sarnowski                        $jsonpData = $n;
5094f8369d7dSTobias Sarnowski                }
5095f8369d7dSTobias Sarnowski            }
5096f8369d7dSTobias Sarnowski            if (preg_match($jsre, $options['url']))
5097f8369d7dSTobias Sarnowski                $jsonpUrl = true;
5098f8369d7dSTobias Sarnowski            if ($jsonpData !== false || $jsonpUrl) {
5099f8369d7dSTobias Sarnowski                // remember callback name for httpData()
5100f8369d7dSTobias Sarnowski                $options['_jsonp'] = $jsonpCallback;
5101f8369d7dSTobias Sarnowski                if ($jsonpData !== false)
5102f8369d7dSTobias Sarnowski                    $options['data'][$jsonpData] = $jsonpCallback;
5103f8369d7dSTobias Sarnowski                if ($jsonpUrl)
5104f8369d7dSTobias Sarnowski                    $options['url'] = preg_replace($jsre, "=$jsonpCallback\\1", $options['url']);
5105f8369d7dSTobias Sarnowski            }
5106f8369d7dSTobias Sarnowski        }
5107f8369d7dSTobias Sarnowski        $client->setUri($options['url']);
5108f8369d7dSTobias Sarnowski        $client->setMethod(strtoupper($options['type']));
5109f8369d7dSTobias Sarnowski        if (isset($options['referer']) && $options['referer'])
5110f8369d7dSTobias Sarnowski            $client->setHeaders('Referer', $options['referer']);
5111f8369d7dSTobias Sarnowski        $client->setHeaders(array(
5112f8369d7dSTobias Sarnowski//          'content-type' => $options['contentType'],
5113f8369d7dSTobias Sarnowski            'User-Agent' => 'Mozilla/5.0 (X11; U; Linux x86; en-US; rv:1.9.0.5) Gecko'
5114f8369d7dSTobias Sarnowski                 .'/2008122010 Firefox/3.0.5',
5115f8369d7dSTobias Sarnowski            // TODO custom charset
5116f8369d7dSTobias Sarnowski            'Accept-Charset' => 'ISO-8859-1,utf-8;q=0.7,*;q=0.7',
5117f8369d7dSTobias Sarnowski//          'Connection' => 'keep-alive',
5118f8369d7dSTobias Sarnowski//          'Accept' => 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
5119f8369d7dSTobias Sarnowski            'Accept-Language' => 'en-us,en;q=0.5',
5120f8369d7dSTobias Sarnowski        ));
5121f8369d7dSTobias Sarnowski        if ($options['username'])
5122f8369d7dSTobias Sarnowski            $client->setAuth($options['username'], $options['password']);
5123f8369d7dSTobias Sarnowski        if (isset($options['ifModified']) && $options['ifModified'])
5124f8369d7dSTobias Sarnowski            $client->setHeaders("If-Modified-Since",
5125f8369d7dSTobias Sarnowski                self::$lastModified
5126f8369d7dSTobias Sarnowski                    ? self::$lastModified
5127f8369d7dSTobias Sarnowski                    : "Thu, 01 Jan 1970 00:00:00 GMT"
5128f8369d7dSTobias Sarnowski            );
5129f8369d7dSTobias Sarnowski        $client->setHeaders("Accept",
5130f8369d7dSTobias Sarnowski            isset($options['dataType'])
5131f8369d7dSTobias Sarnowski            && isset(self::$ajaxSettings['accepts'][ $options['dataType'] ])
5132f8369d7dSTobias Sarnowski                ? self::$ajaxSettings['accepts'][ $options['dataType'] ].", */*"
5133f8369d7dSTobias Sarnowski                : self::$ajaxSettings['accepts']['_default']
5134f8369d7dSTobias Sarnowski        );
5135f8369d7dSTobias Sarnowski        // TODO $options['processData']
5136f8369d7dSTobias Sarnowski        if ($options['data'] instanceof phpQueryObject) {
5137f8369d7dSTobias Sarnowski            $serialized = $options['data']->serializeArray($options['data']);
5138f8369d7dSTobias Sarnowski            $options['data'] = array();
5139f8369d7dSTobias Sarnowski            foreach($serialized as $r)
5140f8369d7dSTobias Sarnowski                $options['data'][ $r['name'] ] = $r['value'];
5141f8369d7dSTobias Sarnowski        }
5142f8369d7dSTobias Sarnowski        if (strtolower($options['type']) == 'get') {
5143f8369d7dSTobias Sarnowski            $client->setParameterGet($options['data']);
5144f8369d7dSTobias Sarnowski        } else if (strtolower($options['type']) == 'post') {
5145f8369d7dSTobias Sarnowski            $client->setEncType($options['contentType']);
5146f8369d7dSTobias Sarnowski            $client->setParameterPost($options['data']);
5147f8369d7dSTobias Sarnowski        }
5148f8369d7dSTobias Sarnowski        if (self::$active == 0 && $options['global'])
5149f8369d7dSTobias Sarnowski            phpQueryEvents::trigger($documentID, 'ajaxStart');
5150f8369d7dSTobias Sarnowski        self::$active++;
5151f8369d7dSTobias Sarnowski        // beforeSend callback
5152f8369d7dSTobias Sarnowski        if (isset($options['beforeSend']) && $options['beforeSend'])
5153f8369d7dSTobias Sarnowski            phpQuery::callbackRun($options['beforeSend'], array($client));
5154f8369d7dSTobias Sarnowski        // ajaxSend event
5155f8369d7dSTobias Sarnowski        if ($options['global'])
5156f8369d7dSTobias Sarnowski            phpQueryEvents::trigger($documentID, 'ajaxSend', array($client, $options));
5157f8369d7dSTobias Sarnowski        if (phpQuery::$debug) {
5158f8369d7dSTobias Sarnowski            self::debug("{$options['type']}: {$options['url']}\n");
5159f8369d7dSTobias Sarnowski            self::debug("Options: <pre>".var_export($options, true)."</pre>\n");
5160f8369d7dSTobias Sarnowski//          if ($client->getCookieJar())
5161f8369d7dSTobias Sarnowski//              self::debug("Cookies: <pre>".var_export($client->getCookieJar()->getMatchingCookies($options['url']), true)."</pre>\n");
5162f8369d7dSTobias Sarnowski        }
5163f8369d7dSTobias Sarnowski        // request
5164f8369d7dSTobias Sarnowski        $response = $client->request();
5165f8369d7dSTobias Sarnowski        if (phpQuery::$debug) {
5166f8369d7dSTobias Sarnowski            self::debug('Status: '.$response->getStatus().' / '.$response->getMessage());
5167f8369d7dSTobias Sarnowski            self::debug($client->getLastRequest());
5168f8369d7dSTobias Sarnowski            self::debug($response->getHeaders());
5169f8369d7dSTobias Sarnowski        }
5170f8369d7dSTobias Sarnowski        if ($response->isSuccessful()) {
5171f8369d7dSTobias Sarnowski            // XXX tempolary
5172f8369d7dSTobias Sarnowski            self::$lastModified = $response->getHeader('Last-Modified');
5173f8369d7dSTobias Sarnowski            $data = self::httpData($response->getBody(), $options['dataType'], $options);
5174f8369d7dSTobias Sarnowski            if (isset($options['success']) && $options['success'])
5175f8369d7dSTobias Sarnowski                phpQuery::callbackRun($options['success'], array($data, $response->getStatus(), $options));
5176f8369d7dSTobias Sarnowski            if ($options['global'])
5177f8369d7dSTobias Sarnowski                phpQueryEvents::trigger($documentID, 'ajaxSuccess', array($client, $options));
5178f8369d7dSTobias Sarnowski        } else {
5179f8369d7dSTobias Sarnowski            if (isset($options['error']) && $options['error'])
5180f8369d7dSTobias Sarnowski                phpQuery::callbackRun($options['error'], array($client, $response->getStatus(), $response->getMessage()));
5181f8369d7dSTobias Sarnowski            if ($options['global'])
5182f8369d7dSTobias Sarnowski                phpQueryEvents::trigger($documentID, 'ajaxError', array($client, /*$response->getStatus(),*/$response->getMessage(), $options));
5183f8369d7dSTobias Sarnowski        }
5184f8369d7dSTobias Sarnowski        if (isset($options['complete']) && $options['complete'])
5185f8369d7dSTobias Sarnowski            phpQuery::callbackRun($options['complete'], array($client, $response->getStatus()));
5186f8369d7dSTobias Sarnowski        if ($options['global'])
5187f8369d7dSTobias Sarnowski            phpQueryEvents::trigger($documentID, 'ajaxComplete', array($client, $options));
5188f8369d7dSTobias Sarnowski        if ($options['global'] && ! --self::$active)
5189f8369d7dSTobias Sarnowski            phpQueryEvents::trigger($documentID, 'ajaxStop');
5190f8369d7dSTobias Sarnowski        return $client;
5191f8369d7dSTobias Sarnowski//      if (is_null($domId))
5192f8369d7dSTobias Sarnowski//          $domId = self::$defaultDocumentID ? self::$defaultDocumentID : false;
5193f8369d7dSTobias Sarnowski//      return new phpQueryAjaxResponse($response, $domId);
5194f8369d7dSTobias Sarnowski    }
5195f8369d7dSTobias Sarnowski    protected static function httpData($data, $type, $options) {
5196f8369d7dSTobias Sarnowski        if (isset($options['dataFilter']) && $options['dataFilter'])
5197f8369d7dSTobias Sarnowski            $data = self::callbackRun($options['dataFilter'], array($data, $type));
5198f8369d7dSTobias Sarnowski        if (is_string($data)) {
5199f8369d7dSTobias Sarnowski            if ($type == "json") {
5200f8369d7dSTobias Sarnowski                if (isset($options['_jsonp']) && $options['_jsonp']) {
5201f8369d7dSTobias Sarnowski                    $data = preg_replace('/^\s*\w+\((.*)\)\s*$/s', '$1', $data);
5202f8369d7dSTobias Sarnowski                }
5203f8369d7dSTobias Sarnowski                $data = self::parseJSON($data);
5204f8369d7dSTobias Sarnowski            }
5205f8369d7dSTobias Sarnowski        }
5206f8369d7dSTobias Sarnowski        return $data;
5207f8369d7dSTobias Sarnowski    }
5208f8369d7dSTobias Sarnowski    /**
5209f8369d7dSTobias Sarnowski     * Enter description here...
5210f8369d7dSTobias Sarnowski     *
5211f8369d7dSTobias Sarnowski     * @param array|phpQuery $data
5212f8369d7dSTobias Sarnowski     *
5213f8369d7dSTobias Sarnowski     */
5214f8369d7dSTobias Sarnowski    public static function param($data) {
5215f8369d7dSTobias Sarnowski        return http_build_query($data, null, '&');
5216f8369d7dSTobias Sarnowski    }
5217f8369d7dSTobias Sarnowski    public static function get($url, $data = null, $callback = null, $type = null) {
5218f8369d7dSTobias Sarnowski        if (!is_array($data)) {
5219f8369d7dSTobias Sarnowski            $callback = $data;
5220f8369d7dSTobias Sarnowski            $data = null;
5221f8369d7dSTobias Sarnowski        }
5222f8369d7dSTobias Sarnowski        // TODO some array_values on this shit
5223f8369d7dSTobias Sarnowski        return phpQuery::ajax(array(
5224f8369d7dSTobias Sarnowski            'type' => 'GET',
5225f8369d7dSTobias Sarnowski            'url' => $url,
5226f8369d7dSTobias Sarnowski            'data' => $data,
5227f8369d7dSTobias Sarnowski            'success' => $callback,
5228f8369d7dSTobias Sarnowski            'dataType' => $type,
5229f8369d7dSTobias Sarnowski        ));
5230f8369d7dSTobias Sarnowski    }
5231f8369d7dSTobias Sarnowski    public static function post($url, $data = null, $callback = null, $type = null) {
5232f8369d7dSTobias Sarnowski        if (!is_array($data)) {
5233f8369d7dSTobias Sarnowski            $callback = $data;
5234f8369d7dSTobias Sarnowski            $data = null;
5235f8369d7dSTobias Sarnowski        }
5236f8369d7dSTobias Sarnowski        return phpQuery::ajax(array(
5237f8369d7dSTobias Sarnowski            'type' => 'POST',
5238f8369d7dSTobias Sarnowski            'url' => $url,
5239f8369d7dSTobias Sarnowski            'data' => $data,
5240f8369d7dSTobias Sarnowski            'success' => $callback,
5241f8369d7dSTobias Sarnowski            'dataType' => $type,
5242f8369d7dSTobias Sarnowski        ));
5243f8369d7dSTobias Sarnowski    }
5244f8369d7dSTobias Sarnowski    public static function getJSON($url, $data = null, $callback = null) {
5245f8369d7dSTobias Sarnowski        if (!is_array($data)) {
5246f8369d7dSTobias Sarnowski            $callback = $data;
5247f8369d7dSTobias Sarnowski            $data = null;
5248f8369d7dSTobias Sarnowski        }
5249f8369d7dSTobias Sarnowski        // TODO some array_values on this shit
5250f8369d7dSTobias Sarnowski        return phpQuery::ajax(array(
5251f8369d7dSTobias Sarnowski            'type' => 'GET',
5252f8369d7dSTobias Sarnowski            'url' => $url,
5253f8369d7dSTobias Sarnowski            'data' => $data,
5254f8369d7dSTobias Sarnowski            'success' => $callback,
5255f8369d7dSTobias Sarnowski            'dataType' => 'json',
5256f8369d7dSTobias Sarnowski        ));
5257f8369d7dSTobias Sarnowski    }
5258f8369d7dSTobias Sarnowski    public static function ajaxSetup($options) {
5259f8369d7dSTobias Sarnowski        self::$ajaxSettings = array_merge(
5260f8369d7dSTobias Sarnowski            self::$ajaxSettings,
5261f8369d7dSTobias Sarnowski            $options
5262f8369d7dSTobias Sarnowski        );
5263f8369d7dSTobias Sarnowski    }
5264f8369d7dSTobias Sarnowski    public static function ajaxAllowHost($host1, $host2 = null, $host3 = null) {
5265f8369d7dSTobias Sarnowski        $loop = is_array($host1)
5266f8369d7dSTobias Sarnowski            ? $host1
5267f8369d7dSTobias Sarnowski            : func_get_args();
5268f8369d7dSTobias Sarnowski        foreach($loop as $host) {
5269f8369d7dSTobias Sarnowski            if ($host && ! in_array($host, phpQuery::$ajaxAllowedHosts)) {
5270f8369d7dSTobias Sarnowski                phpQuery::$ajaxAllowedHosts[] = $host;
5271f8369d7dSTobias Sarnowski            }
5272f8369d7dSTobias Sarnowski        }
5273f8369d7dSTobias Sarnowski    }
5274f8369d7dSTobias Sarnowski    public static function ajaxAllowURL($url1, $url2 = null, $url3 = null) {
5275f8369d7dSTobias Sarnowski        $loop = is_array($url1)
5276f8369d7dSTobias Sarnowski            ? $url1
5277f8369d7dSTobias Sarnowski            : func_get_args();
5278f8369d7dSTobias Sarnowski        foreach($loop as $url)
5279f8369d7dSTobias Sarnowski            phpQuery::ajaxAllowHost(parse_url($url, PHP_URL_HOST));
5280f8369d7dSTobias Sarnowski    }
5281f8369d7dSTobias Sarnowski    /**
5282f8369d7dSTobias Sarnowski     * Returns JSON representation of $data.
5283f8369d7dSTobias Sarnowski     *
5284f8369d7dSTobias Sarnowski     * @static
5285f8369d7dSTobias Sarnowski     * @param mixed $data
5286f8369d7dSTobias Sarnowski     * @return string
5287f8369d7dSTobias Sarnowski     */
5288f8369d7dSTobias Sarnowski    public static function toJSON($data) {
5289f8369d7dSTobias Sarnowski        if (function_exists('json_encode'))
5290f8369d7dSTobias Sarnowski            return json_encode($data);
5291f8369d7dSTobias Sarnowski        require_once('Zend/Json/Encoder.php');
5292f8369d7dSTobias Sarnowski        return Zend_Json_Encoder::encode($data);
5293f8369d7dSTobias Sarnowski    }
5294f8369d7dSTobias Sarnowski    /**
5295f8369d7dSTobias Sarnowski     * Parses JSON into proper PHP type.
5296f8369d7dSTobias Sarnowski     *
5297f8369d7dSTobias Sarnowski     * @static
5298f8369d7dSTobias Sarnowski     * @param string $json
5299f8369d7dSTobias Sarnowski     * @return mixed
5300f8369d7dSTobias Sarnowski     */
5301f8369d7dSTobias Sarnowski    public static function parseJSON($json) {
5302f8369d7dSTobias Sarnowski        if (function_exists('json_decode')) {
5303f8369d7dSTobias Sarnowski            $return = json_decode(trim($json), true);
5304f8369d7dSTobias Sarnowski            // json_decode and UTF8 issues
5305f8369d7dSTobias Sarnowski            if (isset($return))
5306f8369d7dSTobias Sarnowski                return $return;
5307f8369d7dSTobias Sarnowski        }
5308f8369d7dSTobias Sarnowski        require_once('Zend/Json/Decoder.php');
5309f8369d7dSTobias Sarnowski        return Zend_Json_Decoder::decode($json);
5310f8369d7dSTobias Sarnowski    }
5311f8369d7dSTobias Sarnowski    /**
5312f8369d7dSTobias Sarnowski     * Returns source's document ID.
5313f8369d7dSTobias Sarnowski     *
5314f8369d7dSTobias Sarnowski     * @param $source DOMNode|phpQueryObject
5315f8369d7dSTobias Sarnowski     * @return string
5316f8369d7dSTobias Sarnowski     */
5317f8369d7dSTobias Sarnowski    public static function getDocumentID($source) {
5318f8369d7dSTobias Sarnowski        if ($source instanceof DOMDOCUMENT) {
5319f8369d7dSTobias Sarnowski            foreach(phpQuery::$documents as $id => $document) {
5320f8369d7dSTobias Sarnowski                if ($source->isSameNode($document->document))
5321f8369d7dSTobias Sarnowski                    return $id;
5322f8369d7dSTobias Sarnowski            }
5323f8369d7dSTobias Sarnowski        } else if ($source instanceof DOMNODE) {
5324f8369d7dSTobias Sarnowski            foreach(phpQuery::$documents as $id => $document) {
5325f8369d7dSTobias Sarnowski                if ($source->ownerDocument->isSameNode($document->document))
5326f8369d7dSTobias Sarnowski                    return $id;
5327f8369d7dSTobias Sarnowski            }
5328f8369d7dSTobias Sarnowski        } else if ($source instanceof phpQueryObject)
5329f8369d7dSTobias Sarnowski            return $source->getDocumentID();
5330f8369d7dSTobias Sarnowski        else if (is_string($source) && isset(phpQuery::$documents[$source]))
5331f8369d7dSTobias Sarnowski            return $source;
5332f8369d7dSTobias Sarnowski    }
5333f8369d7dSTobias Sarnowski    /**
5334f8369d7dSTobias Sarnowski     * Get DOMDocument object related to $source.
5335f8369d7dSTobias Sarnowski     * Returns null if such document doesn't exist.
5336f8369d7dSTobias Sarnowski     *
5337f8369d7dSTobias Sarnowski     * @param $source DOMNode|phpQueryObject|string
5338f8369d7dSTobias Sarnowski     * @return string
5339f8369d7dSTobias Sarnowski     */
5340f8369d7dSTobias Sarnowski    public static function getDOMDocument($source) {
5341f8369d7dSTobias Sarnowski        if ($source instanceof DOMDOCUMENT)
5342f8369d7dSTobias Sarnowski            return $source;
5343f8369d7dSTobias Sarnowski        $source = self::getDocumentID($source);
5344f8369d7dSTobias Sarnowski        return $source
5345f8369d7dSTobias Sarnowski            ? self::$documents[$id]['document']
5346f8369d7dSTobias Sarnowski            : null;
5347f8369d7dSTobias Sarnowski    }
5348f8369d7dSTobias Sarnowski
5349f8369d7dSTobias Sarnowski    // UTILITIES
5350f8369d7dSTobias Sarnowski    // http://docs.jquery.com/Utilities
5351f8369d7dSTobias Sarnowski
5352f8369d7dSTobias Sarnowski    /**
5353f8369d7dSTobias Sarnowski     *
5354f8369d7dSTobias Sarnowski     * @return unknown_type
5355f8369d7dSTobias Sarnowski     * @link http://docs.jquery.com/Utilities/jQuery.makeArray
5356f8369d7dSTobias Sarnowski     */
5357f8369d7dSTobias Sarnowski    public static function makeArray($obj) {
5358f8369d7dSTobias Sarnowski        $array = array();
5359f8369d7dSTobias Sarnowski        if (is_object($object) && $object instanceof DOMNODELIST) {
5360f8369d7dSTobias Sarnowski            foreach($object as $value)
5361f8369d7dSTobias Sarnowski                $array[] = $value;
5362f8369d7dSTobias Sarnowski        } else if (is_object($object) && ! ($object instanceof Iterator)) {
5363f8369d7dSTobias Sarnowski            foreach(get_object_vars($object) as $name => $value)
5364f8369d7dSTobias Sarnowski                $array[0][$name] = $value;
5365f8369d7dSTobias Sarnowski        } else {
5366f8369d7dSTobias Sarnowski            foreach($object as $name => $value)
5367f8369d7dSTobias Sarnowski                $array[0][$name] = $value;
5368f8369d7dSTobias Sarnowski        }
5369f8369d7dSTobias Sarnowski        return $array;
5370f8369d7dSTobias Sarnowski    }
5371f8369d7dSTobias Sarnowski    public static function inArray($value, $array) {
5372f8369d7dSTobias Sarnowski        return in_array($value, $array);
5373f8369d7dSTobias Sarnowski    }
5374f8369d7dSTobias Sarnowski    /**
5375f8369d7dSTobias Sarnowski     *
5376f8369d7dSTobias Sarnowski     * @param $object
5377f8369d7dSTobias Sarnowski     * @param $callback
5378f8369d7dSTobias Sarnowski     * @return unknown_type
5379f8369d7dSTobias Sarnowski     * @link http://docs.jquery.com/Utilities/jQuery.each
5380f8369d7dSTobias Sarnowski     */
5381f8369d7dSTobias Sarnowski    public static function each($object, $callback, $param1 = null, $param2 = null, $param3 = null) {
5382f8369d7dSTobias Sarnowski        $paramStructure = null;
5383f8369d7dSTobias Sarnowski        if (func_num_args() > 2) {
5384f8369d7dSTobias Sarnowski            $paramStructure = func_get_args();
5385f8369d7dSTobias Sarnowski            $paramStructure = array_slice($paramStructure, 2);
5386f8369d7dSTobias Sarnowski        }
5387f8369d7dSTobias Sarnowski        if (is_object($object) && ! ($object instanceof Iterator)) {
5388f8369d7dSTobias Sarnowski            foreach(get_object_vars($object) as $name => $value)
5389f8369d7dSTobias Sarnowski                phpQuery::callbackRun($callback, array($name, $value), $paramStructure);
5390f8369d7dSTobias Sarnowski        } else {
5391f8369d7dSTobias Sarnowski            foreach($object as $name => $value)
5392f8369d7dSTobias Sarnowski                phpQuery::callbackRun($callback, array($name, $value), $paramStructure);
5393f8369d7dSTobias Sarnowski        }
5394f8369d7dSTobias Sarnowski    }
5395f8369d7dSTobias Sarnowski    /**
5396f8369d7dSTobias Sarnowski     *
5397f8369d7dSTobias Sarnowski     * @link http://docs.jquery.com/Utilities/jQuery.map
5398f8369d7dSTobias Sarnowski     */
5399f8369d7dSTobias Sarnowski    public static function map($array, $callback, $param1 = null, $param2 = null, $param3 = null) {
5400f8369d7dSTobias Sarnowski        $result = array();
5401f8369d7dSTobias Sarnowski        $paramStructure = null;
5402f8369d7dSTobias Sarnowski        if (func_num_args() > 2) {
5403f8369d7dSTobias Sarnowski            $paramStructure = func_get_args();
5404f8369d7dSTobias Sarnowski            $paramStructure = array_slice($paramStructure, 2);
5405f8369d7dSTobias Sarnowski        }
5406f8369d7dSTobias Sarnowski        foreach($array as $v) {
5407f8369d7dSTobias Sarnowski            $vv = phpQuery::callbackRun($callback, array($v), $paramStructure);
5408f8369d7dSTobias Sarnowski//          $callbackArgs = $args;
5409f8369d7dSTobias Sarnowski//          foreach($args as $i => $arg) {
5410f8369d7dSTobias Sarnowski//              $callbackArgs[$i] = $arg instanceof CallbackParam
5411f8369d7dSTobias Sarnowski//                  ? $v
5412f8369d7dSTobias Sarnowski//                  : $arg;
5413f8369d7dSTobias Sarnowski//          }
5414f8369d7dSTobias Sarnowski//          $vv = call_user_func_array($callback, $callbackArgs);
5415f8369d7dSTobias Sarnowski            if (is_array($vv))  {
5416f8369d7dSTobias Sarnowski                foreach($vv as $vvv)
5417f8369d7dSTobias Sarnowski                    $result[] = $vvv;
5418f8369d7dSTobias Sarnowski            } else if ($vv !== null) {
5419f8369d7dSTobias Sarnowski                $result[] = $vv;
5420f8369d7dSTobias Sarnowski            }
5421f8369d7dSTobias Sarnowski        }
5422f8369d7dSTobias Sarnowski        return $result;
5423f8369d7dSTobias Sarnowski    }
5424f8369d7dSTobias Sarnowski    /**
5425f8369d7dSTobias Sarnowski     *
5426f8369d7dSTobias Sarnowski     * @param $callback Callback
5427f8369d7dSTobias Sarnowski     * @param $params
5428f8369d7dSTobias Sarnowski     * @param $paramStructure
5429f8369d7dSTobias Sarnowski     * @return unknown_type
5430f8369d7dSTobias Sarnowski     */
5431f8369d7dSTobias Sarnowski    public static function callbackRun($callback, $params = array(), $paramStructure = null) {
5432f8369d7dSTobias Sarnowski        if (! $callback)
5433f8369d7dSTobias Sarnowski            return;
5434f8369d7dSTobias Sarnowski        if ($callback instanceof CallbackParameterToReference) {
5435f8369d7dSTobias Sarnowski            // TODO support ParamStructure to select which $param push to reference
5436f8369d7dSTobias Sarnowski            if (isset($params[0]))
5437f8369d7dSTobias Sarnowski                $callback->callback = $params[0];
5438f8369d7dSTobias Sarnowski            return true;
5439f8369d7dSTobias Sarnowski        }
5440f8369d7dSTobias Sarnowski        if ($callback instanceof Callback) {
5441f8369d7dSTobias Sarnowski            $paramStructure = $callback->params;
5442f8369d7dSTobias Sarnowski            $callback = $callback->callback;
5443f8369d7dSTobias Sarnowski        }
5444f8369d7dSTobias Sarnowski        if (! $paramStructure)
5445f8369d7dSTobias Sarnowski            return call_user_func_array($callback, $params);
5446f8369d7dSTobias Sarnowski        $p = 0;
5447f8369d7dSTobias Sarnowski        foreach($paramStructure as $i => $v) {
5448f8369d7dSTobias Sarnowski            $paramStructure[$i] = $v instanceof CallbackParam
5449f8369d7dSTobias Sarnowski                ? $params[$p++]
5450f8369d7dSTobias Sarnowski                : $v;
5451f8369d7dSTobias Sarnowski        }
5452f8369d7dSTobias Sarnowski        return call_user_func_array($callback, $paramStructure);
5453f8369d7dSTobias Sarnowski    }
5454f8369d7dSTobias Sarnowski    /**
5455f8369d7dSTobias Sarnowski     * Merge 2 phpQuery objects.
5456f8369d7dSTobias Sarnowski     * @param array $one
5457f8369d7dSTobias Sarnowski     * @param array $two
5458f8369d7dSTobias Sarnowski     * @protected
5459f8369d7dSTobias Sarnowski     * @todo node lists, phpQueryObject
5460f8369d7dSTobias Sarnowski     */
5461f8369d7dSTobias Sarnowski    public static function merge($one, $two) {
5462f8369d7dSTobias Sarnowski        $elements = $one->elements;
5463f8369d7dSTobias Sarnowski        foreach($two->elements as $node) {
5464f8369d7dSTobias Sarnowski            $exists = false;
5465f8369d7dSTobias Sarnowski            foreach($elements as $node2) {
5466f8369d7dSTobias Sarnowski                if ($node2->isSameNode($node))
5467f8369d7dSTobias Sarnowski                    $exists = true;
5468f8369d7dSTobias Sarnowski            }
5469f8369d7dSTobias Sarnowski            if (! $exists)
5470f8369d7dSTobias Sarnowski                $elements[] = $node;
5471f8369d7dSTobias Sarnowski        }
5472f8369d7dSTobias Sarnowski        return $elements;
5473f8369d7dSTobias Sarnowski//      $one = $one->newInstance();
5474f8369d7dSTobias Sarnowski//      $one->elements = $elements;
5475f8369d7dSTobias Sarnowski//      return $one;
5476f8369d7dSTobias Sarnowski    }
5477f8369d7dSTobias Sarnowski    /**
5478f8369d7dSTobias Sarnowski     *
5479f8369d7dSTobias Sarnowski     * @param $array
5480f8369d7dSTobias Sarnowski     * @param $callback
5481f8369d7dSTobias Sarnowski     * @param $invert
5482f8369d7dSTobias Sarnowski     * @return unknown_type
5483f8369d7dSTobias Sarnowski     * @link http://docs.jquery.com/Utilities/jQuery.grep
5484f8369d7dSTobias Sarnowski     */
5485f8369d7dSTobias Sarnowski    public static function grep($array, $callback, $invert = false) {
5486f8369d7dSTobias Sarnowski        $result = array();
5487f8369d7dSTobias Sarnowski        foreach($array as $k => $v) {
5488f8369d7dSTobias Sarnowski            $r = call_user_func_array($callback, array($v, $k));
5489f8369d7dSTobias Sarnowski            if ($r === !(bool)$invert)
5490f8369d7dSTobias Sarnowski                $result[] = $v;
5491f8369d7dSTobias Sarnowski        }
5492f8369d7dSTobias Sarnowski        return $result;
5493f8369d7dSTobias Sarnowski    }
5494f8369d7dSTobias Sarnowski    public static function unique($array) {
5495f8369d7dSTobias Sarnowski        return array_unique($array);
5496f8369d7dSTobias Sarnowski    }
5497f8369d7dSTobias Sarnowski    /**
5498f8369d7dSTobias Sarnowski     *
5499f8369d7dSTobias Sarnowski     * @param $function
5500f8369d7dSTobias Sarnowski     * @return unknown_type
5501f8369d7dSTobias Sarnowski     * @TODO there are problems with non-static methods, second parameter pass it
5502f8369d7dSTobias Sarnowski     *  but doesnt verify is method is really callable
5503f8369d7dSTobias Sarnowski     */
5504f8369d7dSTobias Sarnowski    public static function isFunction($function) {
5505f8369d7dSTobias Sarnowski        return is_callable($function);
5506f8369d7dSTobias Sarnowski    }
5507f8369d7dSTobias Sarnowski    public static function trim($str) {
5508f8369d7dSTobias Sarnowski        return trim($str);
5509f8369d7dSTobias Sarnowski    }
5510f8369d7dSTobias Sarnowski    /* PLUGINS NAMESPACE */
5511f8369d7dSTobias Sarnowski    /**
5512f8369d7dSTobias Sarnowski     *
5513f8369d7dSTobias Sarnowski     * @param $url
5514f8369d7dSTobias Sarnowski     * @param $callback
5515f8369d7dSTobias Sarnowski     * @param $param1
5516f8369d7dSTobias Sarnowski     * @param $param2
5517f8369d7dSTobias Sarnowski     * @param $param3
5518f8369d7dSTobias Sarnowski     * @return phpQueryObject
5519f8369d7dSTobias Sarnowski     */
5520f8369d7dSTobias Sarnowski    public static function browserGet($url, $callback, $param1 = null, $param2 = null, $param3 = null) {
5521f8369d7dSTobias Sarnowski        if (self::plugin('WebBrowser')) {
5522f8369d7dSTobias Sarnowski            $params = func_get_args();
5523f8369d7dSTobias Sarnowski            return self::callbackRun(array(self::$plugins, 'browserGet'), $params);
5524f8369d7dSTobias Sarnowski        } else {
5525f8369d7dSTobias Sarnowski            self::debug('WebBrowser plugin not available...');
5526f8369d7dSTobias Sarnowski        }
5527f8369d7dSTobias Sarnowski    }
5528f8369d7dSTobias Sarnowski    /**
5529f8369d7dSTobias Sarnowski     *
5530f8369d7dSTobias Sarnowski     * @param $url
5531f8369d7dSTobias Sarnowski     * @param $data
5532f8369d7dSTobias Sarnowski     * @param $callback
5533f8369d7dSTobias Sarnowski     * @param $param1
5534f8369d7dSTobias Sarnowski     * @param $param2
5535f8369d7dSTobias Sarnowski     * @param $param3
5536f8369d7dSTobias Sarnowski     * @return phpQueryObject
5537f8369d7dSTobias Sarnowski     */
5538f8369d7dSTobias Sarnowski    public static function browserPost($url, $data, $callback, $param1 = null, $param2 = null, $param3 = null) {
5539f8369d7dSTobias Sarnowski        if (self::plugin('WebBrowser')) {
5540f8369d7dSTobias Sarnowski            $params = func_get_args();
5541f8369d7dSTobias Sarnowski            return self::callbackRun(array(self::$plugins, 'browserPost'), $params);
5542f8369d7dSTobias Sarnowski        } else {
5543f8369d7dSTobias Sarnowski            self::debug('WebBrowser plugin not available...');
5544f8369d7dSTobias Sarnowski        }
5545f8369d7dSTobias Sarnowski    }
5546f8369d7dSTobias Sarnowski    /**
5547f8369d7dSTobias Sarnowski     *
5548f8369d7dSTobias Sarnowski     * @param $ajaxSettings
5549f8369d7dSTobias Sarnowski     * @param $callback
5550f8369d7dSTobias Sarnowski     * @param $param1
5551f8369d7dSTobias Sarnowski     * @param $param2
5552f8369d7dSTobias Sarnowski     * @param $param3
5553f8369d7dSTobias Sarnowski     * @return phpQueryObject
5554f8369d7dSTobias Sarnowski     */
5555f8369d7dSTobias Sarnowski    public static function browser($ajaxSettings, $callback, $param1 = null, $param2 = null, $param3 = null) {
5556f8369d7dSTobias Sarnowski        if (self::plugin('WebBrowser')) {
5557f8369d7dSTobias Sarnowski            $params = func_get_args();
5558f8369d7dSTobias Sarnowski            return self::callbackRun(array(self::$plugins, 'browser'), $params);
5559f8369d7dSTobias Sarnowski        } else {
5560f8369d7dSTobias Sarnowski            self::debug('WebBrowser plugin not available...');
5561f8369d7dSTobias Sarnowski        }
5562f8369d7dSTobias Sarnowski    }
5563f8369d7dSTobias Sarnowski    /**
5564f8369d7dSTobias Sarnowski     *
5565f8369d7dSTobias Sarnowski     * @param $code
5566f8369d7dSTobias Sarnowski     * @return string
5567f8369d7dSTobias Sarnowski     */
5568f8369d7dSTobias Sarnowski    public static function php($code) {
5569f8369d7dSTobias Sarnowski        return self::code('php', $code);
5570f8369d7dSTobias Sarnowski    }
5571f8369d7dSTobias Sarnowski    /**
5572f8369d7dSTobias Sarnowski     *
5573f8369d7dSTobias Sarnowski     * @param $type
5574f8369d7dSTobias Sarnowski     * @param $code
5575f8369d7dSTobias Sarnowski     * @return string
5576f8369d7dSTobias Sarnowski     */
5577f8369d7dSTobias Sarnowski    public static function code($type, $code) {
5578f8369d7dSTobias Sarnowski        return "<$type><!-- ".trim($code)." --></$type>";
5579f8369d7dSTobias Sarnowski    }
5580f8369d7dSTobias Sarnowski
5581f8369d7dSTobias Sarnowski    public static function __callStatic($method, $params) {
5582f8369d7dSTobias Sarnowski        return call_user_func_array(
5583f8369d7dSTobias Sarnowski            array(phpQuery::$plugins, $method),
5584f8369d7dSTobias Sarnowski            $params
5585f8369d7dSTobias Sarnowski        );
5586f8369d7dSTobias Sarnowski    }
5587f8369d7dSTobias Sarnowski    protected static function dataSetupNode($node, $documentID) {
5588f8369d7dSTobias Sarnowski        // search are return if alredy exists
5589f8369d7dSTobias Sarnowski        foreach(phpQuery::$documents[$documentID]->dataNodes as $dataNode) {
5590f8369d7dSTobias Sarnowski            if ($node->isSameNode($dataNode))
5591f8369d7dSTobias Sarnowski                return $dataNode;
5592f8369d7dSTobias Sarnowski        }
5593f8369d7dSTobias Sarnowski        // if doesn't, add it
5594f8369d7dSTobias Sarnowski        phpQuery::$documents[$documentID]->dataNodes[] = $node;
5595f8369d7dSTobias Sarnowski        return $node;
5596f8369d7dSTobias Sarnowski    }
5597f8369d7dSTobias Sarnowski    protected static function dataRemoveNode($node, $documentID) {
5598f8369d7dSTobias Sarnowski        // search are return if alredy exists
5599f8369d7dSTobias Sarnowski        foreach(phpQuery::$documents[$documentID]->dataNodes as $k => $dataNode) {
5600f8369d7dSTobias Sarnowski            if ($node->isSameNode($dataNode)) {
5601f8369d7dSTobias Sarnowski                unset(self::$documents[$documentID]->dataNodes[$k]);
5602f8369d7dSTobias Sarnowski                unset(self::$documents[$documentID]->data[ $dataNode->dataID ]);
5603f8369d7dSTobias Sarnowski            }
5604f8369d7dSTobias Sarnowski        }
5605f8369d7dSTobias Sarnowski    }
5606f8369d7dSTobias Sarnowski    public static function data($node, $name, $data, $documentID = null) {
5607f8369d7dSTobias Sarnowski        if (! $documentID)
5608f8369d7dSTobias Sarnowski            // TODO check if this works
5609f8369d7dSTobias Sarnowski            $documentID = self::getDocumentID($node);
5610f8369d7dSTobias Sarnowski        $document = phpQuery::$documents[$documentID];
5611f8369d7dSTobias Sarnowski        $node = self::dataSetupNode($node, $documentID);
5612f8369d7dSTobias Sarnowski        if (! isset($node->dataID))
5613f8369d7dSTobias Sarnowski            $node->dataID = ++phpQuery::$documents[$documentID]->uuid;
5614f8369d7dSTobias Sarnowski        $id = $node->dataID;
5615f8369d7dSTobias Sarnowski        if (! isset($document->data[$id]))
5616f8369d7dSTobias Sarnowski            $document->data[$id] = array();
5617f8369d7dSTobias Sarnowski        if (! is_null($data))
5618f8369d7dSTobias Sarnowski            $document->data[$id][$name] = $data;
5619f8369d7dSTobias Sarnowski        if ($name) {
5620f8369d7dSTobias Sarnowski            if (isset($document->data[$id][$name]))
5621f8369d7dSTobias Sarnowski                return $document->data[$id][$name];
5622f8369d7dSTobias Sarnowski        } else
5623f8369d7dSTobias Sarnowski            return $id;
5624f8369d7dSTobias Sarnowski    }
5625f8369d7dSTobias Sarnowski    public static function removeData($node, $name, $documentID) {
5626f8369d7dSTobias Sarnowski        if (! $documentID)
5627f8369d7dSTobias Sarnowski            // TODO check if this works
5628f8369d7dSTobias Sarnowski            $documentID = self::getDocumentID($node);
5629f8369d7dSTobias Sarnowski        $document = phpQuery::$documents[$documentID];
5630f8369d7dSTobias Sarnowski        $node = self::dataSetupNode($node, $documentID);
5631f8369d7dSTobias Sarnowski        $id = $node->dataID;
5632f8369d7dSTobias Sarnowski        if ($name) {
5633f8369d7dSTobias Sarnowski            if (isset($document->data[$id][$name]))
5634f8369d7dSTobias Sarnowski                unset($document->data[$id][$name]);
5635f8369d7dSTobias Sarnowski            $name = null;
5636f8369d7dSTobias Sarnowski            foreach($document->data[$id] as $name)
5637f8369d7dSTobias Sarnowski                break;
5638f8369d7dSTobias Sarnowski            if (! $name)
5639f8369d7dSTobias Sarnowski                self::removeData($node, $name, $documentID);
5640f8369d7dSTobias Sarnowski        } else {
5641f8369d7dSTobias Sarnowski            self::dataRemoveNode($node, $documentID);
5642f8369d7dSTobias Sarnowski        }
5643f8369d7dSTobias Sarnowski    }
5644f8369d7dSTobias Sarnowski}
5645f8369d7dSTobias Sarnowski/**
5646f8369d7dSTobias Sarnowski * Plugins static namespace class.
5647f8369d7dSTobias Sarnowski *
5648f8369d7dSTobias Sarnowski * @author Tobiasz Cudnik <tobiasz.cudnik/gmail.com>
5649f8369d7dSTobias Sarnowski * @package phpQuery
5650f8369d7dSTobias Sarnowski * @todo move plugin methods here (as statics)
5651f8369d7dSTobias Sarnowski */
5652f8369d7dSTobias Sarnowskiclass phpQueryPlugins {
5653f8369d7dSTobias Sarnowski    public function __call($method, $args) {
5654f8369d7dSTobias Sarnowski        if (isset(phpQuery::$extendStaticMethods[$method])) {
5655f8369d7dSTobias Sarnowski            $return = call_user_func_array(
5656f8369d7dSTobias Sarnowski                phpQuery::$extendStaticMethods[$method],
5657f8369d7dSTobias Sarnowski                $args
5658f8369d7dSTobias Sarnowski            );
5659f8369d7dSTobias Sarnowski        } else if (isset(phpQuery::$pluginsStaticMethods[$method])) {
5660f8369d7dSTobias Sarnowski            $class = phpQuery::$pluginsStaticMethods[$method];
5661f8369d7dSTobias Sarnowski            $realClass = "phpQueryPlugin_$class";
5662f8369d7dSTobias Sarnowski            $return = call_user_func_array(
5663f8369d7dSTobias Sarnowski                array($realClass, $method),
5664f8369d7dSTobias Sarnowski                $args
5665f8369d7dSTobias Sarnowski            );
5666f8369d7dSTobias Sarnowski            return isset($return)
5667f8369d7dSTobias Sarnowski                ? $return
5668f8369d7dSTobias Sarnowski                : $this;
5669f8369d7dSTobias Sarnowski        } else
5670f8369d7dSTobias Sarnowski            throw new Exception("Method '{$method}' doesnt exist");
5671f8369d7dSTobias Sarnowski    }
5672f8369d7dSTobias Sarnowski}
5673f8369d7dSTobias Sarnowski/**
5674f8369d7dSTobias Sarnowski * Shortcut to phpQuery::pq($arg1, $context)
5675f8369d7dSTobias Sarnowski * Chainable.
5676f8369d7dSTobias Sarnowski *
5677f8369d7dSTobias Sarnowski * @see phpQuery::pq()
5678f8369d7dSTobias Sarnowski * @return phpQueryObject|QueryTemplatesSource|QueryTemplatesParse|QueryTemplatesSourceQuery
5679f8369d7dSTobias Sarnowski * @author Tobiasz Cudnik <tobiasz.cudnik/gmail.com>
5680f8369d7dSTobias Sarnowski * @package phpQuery
5681f8369d7dSTobias Sarnowski */
5682f8369d7dSTobias Sarnowskifunction pq($arg1, $context = null) {
5683f8369d7dSTobias Sarnowski    $args = func_get_args();
5684f8369d7dSTobias Sarnowski    return call_user_func_array(
5685f8369d7dSTobias Sarnowski        array('phpQuery', 'pq'),
5686f8369d7dSTobias Sarnowski        $args
5687f8369d7dSTobias Sarnowski    );
5688f8369d7dSTobias Sarnowski}
5689f8369d7dSTobias Sarnowski// add plugins dir and Zend framework to include path
5690f8369d7dSTobias Sarnowskiset_include_path(
5691f8369d7dSTobias Sarnowski    get_include_path()
5692f8369d7dSTobias Sarnowski        .PATH_SEPARATOR.dirname(__FILE__).'/phpQuery/'
5693f8369d7dSTobias Sarnowski        .PATH_SEPARATOR.dirname(__FILE__).'/phpQuery/plugins/'
5694f8369d7dSTobias Sarnowski);
5695f8369d7dSTobias Sarnowski// why ? no __call nor __get for statics in php...
5696f8369d7dSTobias Sarnowski// XXX __callStatic will be available in PHP 5.3
5697f8369d7dSTobias SarnowskiphpQuery::$plugins = new phpQueryPlugins();
5698f8369d7dSTobias Sarnowski// include bootstrap file (personal library config)
5699f8369d7dSTobias Sarnowskiif (file_exists(dirname(__FILE__).'/phpQuery/bootstrap.php'))
5700f8369d7dSTobias Sarnowski    require_once dirname(__FILE__).'/phpQuery/bootstrap.php';
5701