https://github.com/drewm/selecta

Write HTML strings using CSS selectors
https://github.com/drewm/selecta

Last synced: about 2 months ago
JSON representation

Write HTML strings using CSS selectors

• Host: GitHub
• URL: https://github.com/drewm/selecta
• Owner: drewm
• License: mit
• Created: 2015-06-17T15:19:19.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2016-11-06T17:28:57.000Z (about 8 years ago)
• Last Synced: 2024-08-05T22:39:47.961Z (5 months ago)
• Language: PHP
• Homepage:
• Size: 32.2 KB
• Stars: 17
• Watchers: 4
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Selecta: super-light casual templating using CSS selectors

[![Build Status](https://travis-ci.org/drewm/selecta.svg)](https://travis-ci.org/drewm/selecta)

[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/drewm/selecta/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/drewm/selecta/?branch=master)

Use a CSS selector to wrap your content with HTML tags.

```php

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

```

will output:

```html

Hello, world

```


## 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. 

## Usage

Currently supports IDs, classes and attribute selectors.

### Class names

```php

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

```

will output:

```html

So listy

```


### IDs

```php

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

```

will output:

```html

Call me

```


### Attribute and Pseudo-class selectors

```php

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

```

will output:

```html

```

Currently supports `:checked` and `:disabled` pseudo-classes.

### Mix it up

All these can be combined and stacked:

```php

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

```

will output (indented for clarity):

```html

	


		

	


```

## Methods

The following methods are available:

`Selecta::wrap(selector, contents)` will wrap the contents with the tags created by the selector.

`Selecta::open(selector)` will open the tags created by the selector.

`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.

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

### Opening and closing

Don't have a template to hand but need to output some structural markup?

```php

echo Selecta::open('section.sidebar div');

echo $CMS->display_all_my_weird_sidebar_junk();

echo Selecta::close('section div');

```