latinexus / lx_bulmacss
Constructor de bloques HTML con estilos de Bulma CSS desde PHP
Requires
- php: >=8.0
- latinexus/lx_htmltag: ^1.0
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Constructor de bloques HTML con estilos de Bulma CSS generados desde PHP.
Instalación
composer require latinexus/lx_bulmacss
Uso
Los helpers solo generan el HTML con las clases de Bulma; para que se vean los estilos hay que cargar el CSS
en el <head>:
<link rel="stylesheet" href="public/css/bulma.min.css">
O hacerlo desde la clase con cssLinks(). Los assets son locales: no se usan CDNs externos.
Font Awesome es opcional y debe publicarse en public/css/font-awesome/all.min.css:
use Lib\Grids\BulmaCSS; $bul = new BulmaCSS(); echo $bul->cssLinks(); echo $bul->bul_input("Nombre", "nombre");
Para una página completa con estilos ya incluidos: echo $bul->page($contenido, "Título");.
Demos visuales: demo/index.php y tests/smoke.php (se abren directo en el navegador, p. ej.
http://localhost/cp_bulmacss/tests/smoke.php).
echo $bul->bul_input("Nombre", "nombre");
<div class="field"> <label class="label">Nombre</label> <div class="control"> <input class="input" type="text" name="nombre" /> </div> </div>
Los helpers generan su propio contenedor, así que no hace falta envolverlos en col().
El tercer parámetro $datos siempre es un array con dos elementos:
[0]— opciones del elemento (input, select, textarea...):value,id,class,placeholder,type,required,readonly,disabled,iconLeft,iconRight,color(is-success,is-danger...),help,helpColor,nowrap,min,max,minlength,maxlength, etc.[1]— opciones de la envoltura:class,style,idonowrap.
Si no se indica la envoltura, el contenedor es column y ocupa todo el ancho disponible;
si se indica, el contenedor pasa a ser field con los modificadores dados.
// column (todo el ancho) $g->bul_input("Nombre", "nombre", [["required" => true, "iconLeft" => "user", "placeholder" => "Tu nombre"]]); // field is-four-fifths (dentro de un row()) $g->bul_input("Nombre", "nombre", [["required" => true], ["class" => "is-four-fifths"]]); // sin contenedor $g->bul_input("Nombre", "nombre", [["nowrap" => true]]);
Genera:
<div class="column"> <label class="label">Nombre <span class="has-text-danger">*</span></label> <div class="control has-icons-left has-icons-right"> <input id="nombre" name="nombre" class="input" type="text" placeholder="Tu nombre" required /> <span class="icon is-small is-left"><i class="fas fa-user"></i></span> </div> </div>
También se acepta el formato con claves ["e" => [], "w" => []].
Assets locales
Este paquete no incluye el CSS de Bulma. Copia bulma.min.css (v1.0.4) en
public/css/bulma.min.css del proyecto donde lo uses, o pasa otra ruta a
cssLinks() / page(). Si usas los iconos (iconLeft, iconRight, icono),
publica también Font Awesome en public/css/font-awesome/all.min.css e indica
cssLinks(BulmaCSS::BULMA_CSS, true).
Componentes disponibles
| Método | Descripción |
|---|---|
row($contenido, $params, $tag) |
Contenedor columns |
col($contenido, $params, $tag) |
Columna column |
bul_input($label, $name, $datos) |
Input de texto, número, fecha, etc. |
bul_select($label, $name, $opciones, $datos) |
Select |
bul_textarea($label, $name, $datos) |
Textarea |
bul_check($label, $name, $datos) |
Checkbox |
bul_radio($label, $name, $datos) |
Radio |
bul_card($titulo, $contenido, $datos) |
Card (con imagen opcional) |
bul_button($texto, $datos) |
Botón o enlace con estilo de botón |
bul_notification($mensaje, $tipo, $dismissible) |
Notificación |
bul_box($contenido) |
Box |
bul_tag($texto, $tipo, $tamanio, $rounded, $delete) |
Tag |
bul_progress($valor, $tipo, $tamanio) |
Barra de progreso |
bul_table($filas, $encabezados, ...) |
Tabla |
cssLinks($bulmaUrl, $fontAwesome) |
<link> del CSS de Bulma (y Font Awesome) |
page($contenido, $titulo) |
Documento HTML completo |
Publicar una nueva versión
# subir cambios git add -A && git commit -m "..." && git push # crear y subir la etiqueta (Packagist la detecta automáticamente) git tag v1.0.1 git push origin v1.0.1
Packagist toma la versión del nombre del tag (v1.0.1 → 1.0.1).
Licencia
MIT