termwind
v2.3.0
TermwindTermwind позволяет создавать уникальные и красивые PHP-приложения командной строки, используя Tailwind CSS API. Короче говоря, это похоже на Tailwind CSS, но для приложений командной строки PHP.
Требуется PHP 8.0+.
Требуйте Termwind с помощью Composer:
composer require nunomaduro/termwind use function Termwind { render };
// single line html...
render ( ' <div class="px-1 bg-green-300">Termwind</div> ' );
// multi-line html...
render (<<<'HTML'
<div>
<div class="px-1 bg-green-600">Termwind</div>
<em class="ml-1">
Give your CLI apps a unique look
</em>
</div>
HTML);
// Laravel or Symfony console commands...
class UsersCommand extends Command
{
public function handle ()
{
render (
view ( ' users.index ' , [
' users ' => User:: all ()
])
);
}
}style() Функцию style() можно использовать для добавления собственных стилей, а также для обновления цветов.
use function Termwind { style };
style ( ' green-300 ' )-> color ( ' #bada55 ' );
style ( ' btn ' )-> apply ( ' p-4 bg-green-300 text-white ' );
render ( ' <div class="btn">Click me</div> ' );ask() Функция ask() может использоваться для того, чтобы задать пользователю вопрос.
use function Termwind { ask };
$ answer = ask ( <<<HTML
<span class="mt-1 ml-2 mr-1 bg-green px-1 text-black">
What is your name?
</span>
HTML ); return полученный от метода Ask, будет ответом, полученным от пользователя.
terminal() Функция terminal() возвращает экземпляр класса Терминал со следующими методами:
->width() : возвращает полную ширину терминала.->height() : возвращает полную высоту терминала.->clear() : очищает экран терминала. Все поддерживаемые классы используют ту же логику, которая доступна на сайте Tailwindcss.com/docs.
bg-{color}-{variant} .text-{color}-{variant} .font-bold , font-normal .italic .underline , line-through .uppercase , lowercase , capitalize , snakecase .truncate .text-left , text-center , text-right .m-{margin} , ml-{leftMargin} , mr-{rightMargin} , mt-{topMargin} , mb-{bottomMargin} , mx-{horizontalMargin} , my-{verticalMargin} .p-{padding} , pl-{leftPadding} , pr-{rightPadding} , pt-{topPadding} , pb-{bottomPadding} , px-{horizontalPadding} , py-{verticalPadding} .space-y-{space} , space-x-{space} .w-{width} , w-full , w-auto .min-w-{width} .max-w-{width} .justify-between , justify-around , justify-evenly , justify-center .invisible .block , flex , hidden .flex-1 .list-disc , list-decimal , list-square , list-none .content-repeat-['.'] . Как и TailwindCSS, мы также поддерживаем медиа-запросы адаптивного дизайна, и поддерживаются следующие точки останова:
sm : 64 пробела (640 пикселей)md : 76 пробелов (768 пикселей)lg : 102 пробела (1024 пикселя).xl : 128 пробелов (1280 пикселей).2xl : 153 места (1536 пикселей) render (<<<'HTML'
<div class="bg-blue-500 sm:bg-red-600">
If bg is blue is sm, if red > than sm breakpoint.
</div>
HTML);Все размеры CLI основаны на размере шрифта 15.
Все элементы имеют возможность использовать атрибут class .
<div> Элемент <div> можно использовать как элемент блочного типа.
Стили по умолчанию : block
render (<<<'HTML'
<div>This is a div element.</div>
HTML);<p> Элемент <p> можно использовать как абзац.
Стили по умолчанию : block
render (<<<'HTML'
<p>This is a paragraph.</p>
HTML);<span> Элемент <span> можно использовать как встроенный текстовый контейнер.
render (<<<'HTML'
<p>
This is a CLI app built with <span class="text-green-300">Termwind</span>.
</p>
HTML);<a> Элемент <a> можно использовать в качестве гиперссылки. Это позволяет использовать атрибут href для открытия ссылки при нажатии.
render (<<<'HTML'
<p>
This is a CLI app built with Termwind. <a href="/">Click here to open</a>
</p>
HTML);<b> и <strong> Элементы <b> и <strong> можно использовать для выделения текста жирным шрифтом .
Стили по умолчанию : font-bold
render (<<<'HTML'
<p>
This is a CLI app built with <b>Termwind</b>.
</p>
HTML);<i> и <em> Элементы <i> и <em> можно использовать для выделения текста курсивом .
Стили по умолчанию : italic
render (<<<'HTML'
<p>
This is a CLI app built with <i>Termwind</i>.
</p>
HTML);<s> Элемент <s> можно использовать для добавления линия через текст.
Стили по умолчанию : line-through
render (<<<'HTML'
<p>
This is a CLI app built with <s>Termwind</s>.
</p>
HTML);<br> Элемент <br> можно использовать для разрыва строки.
render (<<<'HTML'
<p>
This is a CLI <br>
app built with Termwind.
</p>
HTML);<ul> Элемент <ul> можно использовать для неупорядоченного списка. Он может принимать только элементы <li> в качестве дочерних элементов. Если есть другой элемент, он выдаст исключение InvalidChild .
Стили по умолчанию : block , list-disc
render (<<<'HTML'
<ul>
<li>Item 1</li>
<li>Item 2</li>
</ul>
HTML);<ol> Элемент <ol> можно использовать для упорядоченного списка. Он может принимать только элементы <li> в качестве дочерних элементов. Если есть другой элемент, он выдаст исключение InvalidChild .
Стили по умолчанию : block , list-decimal
render (<<<'HTML'
<ol>
<li>Item 1</li>
<li>Item 2</li>
</ol>
HTML);<li> Элемент <li> можно использовать как элемент списка. Его следует использовать только как дочерний элемент элементов <ul> и <ol> .
Стили по умолчанию : block , list-decimal
render (<<<'HTML'
<ul>
<li>Item 1</li>
</ul>
HTML);<dl> Элемент <dl> можно использовать для списка описаний. Он может принимать только элементы <dt> или <dd> в качестве дочерних элементов. Если есть другой элемент, он выдаст исключение InvalidChild .
Стили по умолчанию : block
render (<<<'HTML'
<dl>
<dt> Termwind</dt>
<dd>Give your CLI apps a unique look</dd>
</dl>
HTML);<dt> Элемент <dt> можно использовать в качестве заголовка описания. Его следует использовать только как дочерний элемент <dl> .
Стили по умолчанию : block , font-bold
render (<<<'HTML'
<dl>
<dt> Termwind</dt>
</dl>
HTML);<dd> Элемент <dd> можно использовать в качестве заголовка описания. Его следует использовать только как дочерний элемент <dl> .
Стили по умолчанию : block , ml-4
render (<<<'HTML'
<dl>
<dd>Give your CLI apps a unique look</dd>
</dl>
HTML);<hr> Элемент <hr> можно использовать в качестве горизонтальной линии.
render (<<<'HTML'
<div>
<div> Termwind</div>
<hr>
<p>Give your CLI apps a unique look</p>
</div>
HTML);<table> Элемент <table> может иметь столбцы и строки.
render (<<<'HTML'
<table>
<thead>
<tr>
<th>Task</th>
<th>Status</th>
</tr>
</thead>
<tr>
<th>Termwind</th>
<td> Done</td>
</tr>
</table>
HTML);<pre> Элемент <pre> можно использовать как предварительно отформатированный текст.
render (<<<'HTML'
<pre>
Text in a pre element
it preserves
both spaces and
line breaks
</pre>
HTML);<code> Элемент <code> можно использовать в качестве подсветки кода. Он принимает атрибуты line и start-line .
render (<<<'HTML'
<code line="22" start-line="20">
try {
throw new Exception('Something went wrong');
} catch (Throwable $e) {
report($e);
}
</code>
HTML);Termwind — это программное обеспечение с открытым исходным кодом, лицензированное по лицензии MIT .
