As explained, UssElement simplifies working with HTML documents in PHP by providing a lightweight, intuitive API. Below, we’ll go through several examples to demonstrate how to use UssElement for common tasks such as creating, querying, and modifying elements, as well as serializing and deserializing node data.
1. Using HtmlLoader to Load and Query an HTML Document
HtmlLoader allows you to load an HTML document and query it easily using CSS selectors. Here’s an example of how to use it:
use Ucscode\UssElement\Parser\HtmlLoader;
// Load HTML content using HtmlLoader
$html = <<<HTML
<div class="container">
<p>Hello World!</p>
<a href="https://example.com">Click Here</a>
</div>
HTML;
$div = (new HtmlLoader($html))->getNodeList()->first();
echo $div->getInnerHtml(); // Output: <p>Hello World!</p><a href="https://example.com">Click Here</a>2. Using JsonNodeEncoder to Serialize a Node to JSON
The JsonNodeEncoder class allows you to convert a node into a JSON representation. Below is an example:
use Ucscode\UssElement\Node\ElementNode;
use Ucscode\UssElement\Serializer\JsonNodeEncoder;
// Create a new div element
$div = new ElementNode('div');
$div->setAttribute('class', 'container');
// Create a new p element
$p = new ElementNode('p');
$p->appendChild(new TextNode('Hello World'));
// append it to the div
$div->appendChild($p);
// Encode the div node to a JSON string
$encoder = new JsonNodeEncoder($div);
echo $encoder->encode(true); // Pretty print JSONSee NodeJsonEncoder for json output example
3. Using JsonNodeDecoder to Deserialize a JSON String Back into a Node
The JsonNodeDecoder class is the counterpart to JsonNodeEncoder and allows you to deserialize a JSON string back into a node object.
use Ucscode\UssElement\Serializer\JsonNodeDecoder;
use Ucscode\UssElement\Node\ElementNode;
// A JSON representation of a node
$json = '{"nodeId":1,"nodeType":1,"nodeName":"DIV","parentId":null,"attributes":{"class":"container"},"void":false,"visible":true,"meta":[],"childNodes":[{"nodeId":2,"nodeType":3,"nodeName":"#TEXT","parentId":1,"attributes":{},"void":false,"visible":true,"meta":{"data":"Hello World"},"childNodes":[]}]}';
// Decode the JSON string back into a node object
$decoder = new JsonNodeDecoder($json);
$node = $decoder->decode();
// Output the outer HTML of the node
echo $node->render(); // Output: <div class="container"><p>Hello World</p></div>Learn more about NodeJsonDecoder
4. Creating an Element and Setting Attributes via Constructor
UssElement allows for a more concise way to create elements with attributes by passing the attributes as an array in the constructor.
use Ucscode\UssElement\Node\ElementNode;
// Create an element (input) with attributes passed as the second parameter
$input = new ElementNode('input', [
'type' => 'text',
'class' => 'form-control',
'placeholder' => 'Enter your name'
]);
// Output the element with attributes
echo $input->render(); // Output: <input type="text" class="form-control" placeholder="Enter your name" />