README

A helper function that adds classes to elements in html strings. Useful for Tailwind projects. Designed for Laravel.

Installation

composer require stuartcusackie/cdom

Publish

php artisan vendor:publish

Tailwind Purge

Tailwind will need to know about this cdom config file so that classes are maintained in the purge.

content: [
  ...
  './config/cdom.php'
],

Config

You can set up multiple styles for your application.

Example style config

'style1' => [
	'a' => 'underline text-blue-500 hover:text-blue-900 visited:text-blue-900',
	'h1' => 'text-5xl 2xl:text-6xl font-display font-bold mb-12 text-highlight-primary',
	'h2' => 'text-4xl 2xl:text-5xl font-display font-semibold mb-8 mt-12 first:mt-0',
	'h3' => 'text-3xl 2xl:text-4xl font-display font-semibold mb-6 mt-12 first:mt-0',
	'h4' => 'text-2xl 2xl:text-3xl mb-6',
	'h5' => 'text-xl 2xl:text-2xl font-semibold mb-4',
	'ul' => 'pl-5 list-disc',
	'ol' => 'pl-5 list-decimal',
	'li' => 'mb-2 last:mb-0',
	'p, ul, ol, table' => 'mb-4 last:mb-0',
	'blockquote' => 'border-l-8 p-3 mb-5 text-xl border-gray-200',
	'table' => 'w-full border-r text-left border-gray-200',
	'table tbody' => 'border-t border-gray-200',
	'table tr' => 'border-b border-gray-200 odd:bg-gray-100',
	'table td, table th' => 'border-l px-3 py-1 border-gray-200',
	'table th' => 'odd:bg-gray-200'
]

Usage

To transform markup use the cdom helper. You can optionally pass a style name from your config or let it fall back to the default. You can also pass an array of overrides.

{!! cdom($content) !!}
{!! cdom($content, 'yourconfigstylename') !!}

To get the classes for a single HTML element from your style config you can use the cdomel helper. You can optionally pass a style name from your config or let it fall back to the default:

<h1 class="{{ cdomel('h1') }}">Heading</h1>
<a href="/" class="{{ cdomel('a', 'style1') }}">Link</a>