Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/decodelabs/tagged
PHP markup generation without the fuss
https://github.com/decodelabs/tagged
html markup php tags
Last synced: about 2 months ago
JSON representation
PHP markup generation without the fuss
- Host: GitHub
- URL: https://github.com/decodelabs/tagged
- Owner: decodelabs
- License: mit
- Created: 2019-09-09T20:50:42.000Z (about 5 years ago)
- Default Branch: develop
- Last Pushed: 2023-12-06T22:54:00.000Z (10 months ago)
- Last Synced: 2024-04-17T07:48:27.383Z (5 months ago)
- Topics: html, markup, php, tags
- Language: PHP
- Homepage:
- Size: 329 KB
- Stars: 6
- Watchers: 3
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Tagged
[](https://packagist.org/packages/decodelabs/tagged)
[](https://packagist.org/packages/decodelabs/tagged)
[](https://packagist.org/packages/decodelabs/tagged)
[](https://github.com/decodelabs/tagged/actions/workflows/integrate.yml)
[](https://github.com/phpstan/phpstan)
[](https://packagist.org/packages/decodelabs/tagged)
### PHP markup generation without the fuss.
Tagged provides a simple, powerful and beautiful way to create HTML markup without the spaghetti.
_Get news and updates on the [DecodeLabs blog](https://blog.decodelabs.com)._
---
## Installation
```bash
composer require decodelabs/tagged
```
## Usage
Tagged uses [Veneer](https://github.com/decodelabs/veneer) to provide a unified frontage under DecodeLabs\Tagged.
You can access all the primary HTML functionality via this static frontage without compromising testing and dependency injection.
## HTML markup
Generate markup using a simple, flexible interface.
```php
use DecodeLabs\Tagged as Html;
echo Html::{'div.my-class#my-id'}('This is element content', [
'title' => 'This is a title'
]);
```
...creates:
```html
This is element content
```
Create individual tags without content:
```php
use DecodeLabs\Tagged as Html;
$tag = Html::tag('div.my-class');
echo $tag->open();
echo 'Content';
echo $tag->close();
```
Wrap HTML strings to be used where an instance of Markup is needed:
```php
use DecodeLabs\Tagged as Html;
$buffer = Html::raw('My span');
```
Dump script data to Html:
```php
yield Html::script(Html::raw(json_encode( $some_data )), [
'type' => 'application/json'
]);
```
Prepare arbitrary input for Markup output:
```php
use DecodeLabs\Tagged as Html;
$markup = Html::wrap(
function() {
yield Html::h1('My title');
},
[Html::p(['This is ', Html::strong('mixed'), ' content'])]
);
```
### Nesting
You can nest elements in multiple ways:
```php
use DecodeLabs\Tagged as Html;
// Pass in nested elements via array
echo Html::div([
Html::{'span.inner1'}('Inner 1'),
' ',
Html::{'span.inner2'}('Inner 2')
]);
// Return anything and everything via a generator
echo Html::div(function($el) {
// $el is the root element
$el->addClass('container');
// Nest elements with a single call
yield Html::{'header > h1'}('This is a header');
yield Html::p('This is a paragraph');
// Set attributes inline
yield Html::{'p[data-target=open]'}('Target paragraph');
// Generator return values are rendered too
return Html::{'div.awesome'}('This is awesome!');
});
```
### Time and date
Format and wrap dates and intervals
```php
use DecodeLabs\Tagged as Html;
// Custom format
Html::$time->format('now', 'd/m/Y', 'Europe/London');
// Locale format
// When timezone is true it is fetched from Cosmos::$timezone
Html::$time->locale('now', 'long', 'long', true);
// Locale shortcuts
Html::$time->dateTime('tomorrow'); // medium
Html::$time->longTime('yesterday');
Html::$time->shortDate('yesterday');
// ...etc
// Intervals
Html::$time->since('yesterday'); // 1 day ago
Html::$time->until('tomorrow'); // 1 day from now
Html::$time->sinceAbs('yesterday'); // 1 day
Html::$time->untilAbs('yesterday'); // -1 day
Html::$time->between('yesterday', 'tomorrow'); // 1 day
```
### Icons
Create the markup needed for font or SVG icons:
```php
use DecodeLabs\Tagged as Html;
Html::$icon->setFormat('font');
echo Html::$icon->aubergine; //
Html::$icon->setFormat('svg');
echo Html::$icon->aubergine; //
Html::$icon->setSvgReference('path/to/my/file.svg');
echo Html::$icon->aubergine; //
```
### Media embeds
Normalize embed codes shared from media sites:
```php
use DecodeLabs\Tagged as Html;
echo Html::$embed->video('https://www.youtube.com/watch?v=RG9TMn1FJzc');
```
## Deprecated functionality
Looking for the functionality that was here before? It's likely been moved to a dedicated library:
### XML handling
The XML manipulation functionality of Tagged has been moved to its own project, [Exemplar](https://github.com/decodelabs/exemplar/).
### Content parsing (Tagged::$parse and ::$toText plugins)
Content transformations are now handled by the [Metamorph](https://github.com/decodelabs/metamorph/) library.
## Licensing
Tagged is licensed under the MIT License. See [LICENSE](./LICENSE) for the full license text.