drewm/selecta

Selecta: super-light casual templating using CSS selectors

, _(*1)

Use a CSS selector to wrap your content with HTML tags., _(*2)

echo Selecta::wrap('h1.welcome', 'Hello, world');

will output:, _(*3)

<h1 class="welcome">Hello, world</h1>

Why?

Sometimes you need to output a quick bit of HTML at a point where it's really inconvenient to use a full template. Creating strings of HTML in your code is horrible, so this something a bit more humane., _(*4)

Usage

Currently supports IDs, classes and attribute selectors., _(*5)

Class names

echo Selecta::wrap('ul.list li', 'So listy');

will output:, _(*6)

<ul class="list"><li>So listy</li></ul>

IDs

echo Selecta::wrap('div#contact', 'Call me');

will output:, _(*7)

<div id="contact">Call me</div>

Attribute and Pseudo-class selectors

echo Selecta::build('input[type=radio][name=color][value=blue]:checked');

will output:, _(*8)

<input type="radio" name="color" value="blue" checked>

Currently supports :checked and :disabled pseudo-classes., _(*9)

Mix it up

All these can be combined and stacked:, _(*10)

echo Selecta::build('form#contact div.field input[type=text][required]');

will output (indented for clarity):, _(*11)

<form id="contact">
    <div class="field">
        <input type="text" required>
    </div>
</form>

Methods

The following methods are available:, _(*12)

Selecta::wrap(selector, contents) will wrap the contents with the tags created by the selector., _(*13)

Selecta::open(selector) will open the tags created by the selector., _(*14)

Selecta::close(selector) will close the tags created by the selector. Note that the order of tags is reversed - you can use the same selector string with open() and close() to get valid tag pairs., _(*15)

Selecta::build(selector, contents, open, close) will do everything - build the tags, optionally wrap the contents, optionally open and optionally close the tags., _(*16)

Opening and closing

Don't have a template to hand but need to output some structural markup?, _(*17)

echo Selecta::open('section.sidebar div');
echo $CMS->display_all_my_weird_sidebar_junk();
echo Selecta::close('section div');