Termwind
Termwind le permite crear aplicaciones de línea de comandos PHP únicas y hermosas, utilizando la API CSS de Tailwind . En resumen, es como Tailwind CSS, pero para aplicaciones de línea de comandos PHP.
Requiere PHP 8.0+
Requerir Termwind usando 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()
La función style()
se puede utilizar para agregar estilos personalizados propios y también actualizar colores.
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()
La función ask()
se puede utilizar para hacer una pregunta al usuario.
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 );
La return
proporcionada por el método de pregunta será la respuesta proporcionada por el usuario.
terminal()
La función terminal()
devuelve una instancia de la clase Terminal, con los siguientes métodos:
->width()
: Devuelve el ancho completo del terminal.->height()
: Devuelve la altura completa del terminal.->clear()
: Borra la pantalla del terminal. Todas las clases admitidas utilizan exactamente la misma lógica que está disponible en 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-['.']
. Al igual que TailwindCSS, también admitimos consultas de medios de diseño responsivo y estos son los puntos de interrupción admitidos:
sm
: 64 espacios (640px)md
: 76 espacios (768px)lg
: 102 espacios (1024px)xl
: 128 espacios (1280px)2xl
: 153 espacios (1536px) render (<<<'HTML'
<div class="bg-blue-500 sm:bg-red-600">
If bg is blue is sm, if red > than sm breakpoint.
</div>
HTML);
Todos los tamaños de la CLI se basan en el tamaño de fuente 15.
Todos los elementos tienen la capacidad de utilizar el atributo class
.
<div>
El elemento <div>
se puede utilizar como elemento de tipo bloque.
Estilos predeterminados : block
render (<<<'HTML'
<div>This is a div element.</div>
HTML);
<p>
El elemento <p>
se puede utilizar como párrafo.
Estilos predeterminados : block
render (<<<'HTML'
<p>This is a paragraph.</p>
HTML);
<span>
El elemento <span>
se puede utilizar como contenedor de texto en línea.
render (<<<'HTML'
<p>
This is a CLI app built with <span class="text-green-300">Termwind</span>.
</p>
HTML);
<a>
El elemento <a>
se puede utilizar como hipervínculo. Permite utilizar el atributo href
para abrir el enlace cuando se hace clic.
render (<<<'HTML'
<p>
This is a CLI app built with Termwind. <a href="/">Click here to open</a>
</p>
HTML);
<b>
y <strong>
Los elementos <b>
y <strong>
se pueden utilizar para marcar el texto como negrita .
Estilos predeterminados : font-bold
render (<<<'HTML'
<p>
This is a CLI app built with <b>Termwind</b>.
</p>
HTML);
<i>
y <em>
Los elementos <i>
y <em>
se pueden utilizar para marcar el texto como cursiva .
Estilos predeterminados : italic
render (<<<'HTML'
<p>
This is a CLI app built with <i>Termwind</i>.
</p>
HTML);
<s>
El elemento <s>
se puede utilizar para agregar un línea a través el texto.
Estilos predeterminados : line-through
render (<<<'HTML'
<p>
This is a CLI app built with <s>Termwind</s>.
</p>
HTML);
<br>
El elemento <br>
se puede utilizar para hacer un salto de línea.
render (<<<'HTML'
<p>
This is a CLI <br>
app built with Termwind.
</p>
HTML);
<ul>
El elemento <ul>
se puede utilizar para una lista desordenada. Solo puede aceptar elementos <li>
como hijos; si se proporciona otro elemento, generará una excepción InvalidChild
.
Estilos predeterminados : block
, list-disc
render (<<<'HTML'
<ul>
<li>Item 1</li>
<li>Item 2</li>
</ul>
HTML);
<ol>
El elemento <ol>
se puede utilizar para una lista ordenada. Solo puede aceptar elementos <li>
como hijos; si se proporciona otro elemento, generará una excepción InvalidChild
.
Estilos predeterminados : block
, list-decimal
render (<<<'HTML'
<ol>
<li>Item 1</li>
<li>Item 2</li>
</ol>
HTML);
<li>
El elemento <li>
se puede utilizar como elemento de lista. Sólo debe usarse como hijo de los elementos <ul>
y <ol>
.
Estilos predeterminados : block
, list-decimal
render (<<<'HTML'
<ul>
<li>Item 1</li>
</ul>
HTML);
<dl>
El elemento <dl>
se puede utilizar para una lista de descripción. Solo puede aceptar elementos <dt>
o <dd>
como elementos secundarios; si se proporciona otro elemento, generará una excepción InvalidChild
.
Estilos predeterminados : block
render (<<<'HTML'
<dl>
<dt> Termwind</dt>
<dd>Give your CLI apps a unique look</dd>
</dl>
HTML);
<dt>
El elemento <dt>
se puede utilizar como título de descripción. Sólo debe usarse como hijo de elementos <dl>
.
Estilos predeterminados : block
, font-bold
render (<<<'HTML'
<dl>
<dt> Termwind</dt>
</dl>
HTML);
<dd>
El elemento <dd>
se puede utilizar como título de descripción. Sólo debe usarse como hijo de elementos <dl>
.
Estilos predeterminados : block
, ml-4
render (<<<'HTML'
<dl>
<dd>Give your CLI apps a unique look</dd>
</dl>
HTML);
<hr>
El elemento <hr>
se puede utilizar como una línea horizontal.
render (<<<'HTML'
<div>
<div> Termwind</div>
<hr>
<p>Give your CLI apps a unique look</p>
</div>
HTML);
<table>
El elemento <table>
puede tener columnas y filas.
render (<<<'HTML'
<table>
<thead>
<tr>
<th>Task</th>
<th>Status</th>
</tr>
</thead>
<tr>
<th>Termwind</th>
<td> Done</td>
</tr>
</table>
HTML);
<pre>
El elemento <pre>
se puede utilizar como texto preformateado.
render (<<<'HTML'
<pre>
Text in a pre element
it preserves
both spaces and
line breaks
</pre>
HTML);
<code>
El elemento <code>
se puede utilizar como resaltador de código. Acepta atributos line
y 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 es un software de código abierto con licencia MIT .