Search by

latinexus / lx_bulmacss

latinexus

Constructor de bloques HTML con estilos de Bulma CSS desde PHP

Package info

github.com/latinexus/lx_bulmacss

Homepage

pkg:composer/latinexus/lx_bulmacss

Statistics

Installs: 5

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

v1.1.0 2026-11-20 17:21 UTC

This package is auto-updated.

Last update: 2026-11-20 17:21:54 UTC


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, id o nowrap.

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