NAME

XML::LibXML::jQuery - Fast, jQuery-like DOM manipulation over XML::LibXML

SYNOPSIS

    use XML::LibXML::jQuery;

    my $div = j(<<HTML);
        <div>
            <h1>Hello World</h1>
            <p> ... </p>
            <p> ... </p>
        </div>
    HTML

    $div->find('h1')->text; # Hello World

    $div->find('p')->size; # 2

DESCRIPTION

XML::LibXML::jQuery is a jQuery-like DOM manipulation module build on top of XML::LibXML for speed. The goal is to be as fast as possible, and as compatible as possible with the javascript version of jQuery. Unlike similar modules, web fetching functionality like -append($url)> was intentionally not implemented.

SIMILAR MODULES

Following is a list of similar CPAN modules.

Web::Query::LibXML

Web::Query::LibXML is my previous attempt to create a fast, jQuery-like module. But since it uses HTML::TreeBuilder::LibXML (for compatibility with Web::Query) for the underlying DOM system, its not as fast as if it used XML::LibXML directly. Also, maintaining it was a bit of a pain because of the API contracts to Web::Query and HTML::TreeBuilder.

jQuery

jQuery seemed to be the perfect candidade for me to use/contribute since its a jQuery port implemented directly over XML::LibXML, but discarded the idea after finding some issues. It was slower than Web::Query::LibXML for some methods, it has its own css selector engine (whose code was a bit scary, I'd rather just use HTML::Selector::XPath), invalid html output (spits xml) and even some broken methods. Which obviously could be fixed, but honestly I didn't find its codebase fun to work on.

Web::Query

Web::Query uses the pure perl DOM implementation HTML::TreeBuilder, so its slow.

pQuery

pQuery is also built on top of HTML::TreeBuilder, so..

CONSTRUCTOR

new

Parses a HTML source and returns a new XML::LibXML::jQuery instance.

EXPORTED FUNCTION

j

A shortcut to new.

METHODS

Unless otherwise noted, all methods behave exactly like the javascript version.

add

Implemented signatures:

add(selector)

add(selector, context)

add(html)

add(elements)

add(selection)

Documentation and examples at http://api.jquery.com/add/.

add_class

Implemented signatures:

add_class(className)

add_class(function)

Documentation and examples at http://api.jquery.com/addClass/.

after

Implemented signatures:

after(content[, content])

after(function)

Documentation and examples at http://api.jquery.com/after/.

append

append_to

as_html

attr

before

children

clone

contents

data

Implemented signatures:

data(key, value)

data(key)

data(obj)

Documentation and examples at http://api.jquery.com/data/.

detach

document

each

eq

end

find

get

html

insert_after

Implemented signatures:

insert_after(target)

All targets supported: selector, element, array of elements, HTML string, or jQuery object.

Documentation and examples at http://api.jquery.com/insertAfter/.

insert_before

filter

first

last

parent

prepend

prepend_to

remove

remove_attr

remove_class

replace_with

serialize

size

tagname

text

xfind

Like "find", but uses a xpath expression instead of css selector.

xfilter

Like "filter", but uses a xpath expression instead of css selector.

LICENSE

Copyright (C) Carlos Fernando Avila Gratz.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

AUTHOR

Carlos Fernando Avila Gratz <cafe@kreato.com.br>

cpanm XML::LibXML::jQuery

perl -MCPAN -e shell
install XML::LibXML::jQuery