Tailwind
For projects with a Tailwind config, this module lets you access those tokens in your PHP and Twig. This is especially useful for accessing your system colors.
Setup
Your Tailwind config must be parsed and written to a JSON file, typically via Webpack (FedPack example link coming soon). The only configuration available is the absolute path (use an alias!) to that JSON file. You can override that value via the same config file used for all base module features: /config/viget.php
. These settings should be nested under a tailwind
key.
Key | Default | Description |
---|---|---|
configPath | Craft::getAlias('@config/tailwind/tailwind.json') | Path to your Tailwind JSON file |
Here’s a full sample configuration:
// /config/viget.php
<?php
return [
'tailwind' => [
'configPath' => Craft::getAlias('@config/somewhere-else/tailwind.json'),
],
// other base module settings
'partsKit' => [
//...
],
];
Components exposed to Twig craft.viget.tailwind
sub-object
getFullConfig()
This method returns the entire config as an object.
Returns: Array|null
Example:
{% set config = craft.viget.tailwind.getFullConfig() %}
{% set font = tw.theme.fontFamily.sans[0] ?? null %}
getColors()
This method returns an array of all the colors, with formatted names (respecting nested objects) as the keys.
Returns: Array
Example:
{% set colors = craft.viget.tailwind.getColors() %}
{% for name, hex in colors %}
{{ name }}: {{ hex }}<br>
{% endfor %}