oziLoadData

Versión: 4.0.2 — Actualizado: 2026-05-27

Descripción

Motor de transporte e integración de la biblioteca ozi-ui. Realiza la recolección, envío y tratamiento de datos en diferentes modos de ejecución, con soporte para destino visual, integración con API y control de comportamiento.

oziLoadData nació como plugin, pero se está convirtiendo en el encanamiento inteligente entre interfaz, datos y backend — un verdadero engine, bridge y transport layer de la Ozi Library.

Ejemplos

[1] Formulario con validación

Validación automática — el botón permanece inactivo hasta que todos los campos obligatorios estén completos.

<button type="button"
    data-zld-url="/api/ejemplo/respuesta"
    data-zld-destiny-id="respuesta1"
    data-zld-catch-group-id="actionForm1"
    class="btn btn-primary">
    Enviar
</button>

[2] Dos formularios simultáneos

Recolecta datos de dos grupos diferentes en un único envío.

<button type="button"
    data-zld-url="/api/ejemplo/respuesta"
    data-zld-destiny-id="respuesta2"
    data-zld-catch-group-id="demoFormA, demoFormB"
    class="btn btn-primary">
    Enviar ambos formularios
</button>

[3] Recolección por nombre de elemento

Recolecta solo los campos con nombres específicos — ignora los demás.

<button type="button"
    data-zld-url="/api/ejemplo/respuesta"
    data-zld-destiny-id="respuesta3"
    data-zld-catch-group-id="demoFormC"
    data-zld-catch-item-name="auto,moto,avion:aeropuerto barajas"
    class="btn btn-primary">
    Enviar solo auto, moto y avion
</button>

avion:aeropuerto barajas — envía el campo con un valor fijo definido en el atributo.

[4] Vía JavaScript — actual

Llamada mediante oziLoadData({...}) directamente en JavaScript.

oziLoadData({
    zldUrl:           '/api/ejemplo/respuesta',
    zldDestinyId:     'respuesta4',
    zldCatchGroupId:  ['demoFormJS'],
    zldCatchItemName: ['auto','moto']
});

[5] Vía JavaScript — legado

Compatibilidad con la versión anterior usando el prefijo ld en lugar de zld.

// Prefijo ld — compatibilidad con versión anterior
oziLoadData({
    ldUrl:           '/api/ejemplo/respuesta',
    ldDestinyId:     'respuesta5',
    ldCatchGroupId:  'demoFormLegacy',
    ldCatchItemName: 'inputLegacy:star-trek'
});

[6] Retorno de la respuesta

Ejemplo del PHP de respuesta que el backend devuelve al frontend.

Backend PHP — ejemplo de respuesta:

<?php header('Content-Type: text/html; charset=utf-8'); ?>

<h6 class="fw-bold">Contenido recibido</h6>
<div class="m-3">
    <?php
    $data = $_POST ?: $_GET;
    foreach ($data as $key => $value) {
        echo "<div>
            <span class='text-primary'>{$key}:</span>
            <span class='text-muted'>{$value}</span>
        </div>";
    }
    ?>
</div>
<hr>
<div class="text-end text-muted" style="font-size:12px">
    Fecha/Hora: <?php echo date('Y-m-d H:i:s'); ?>
</div>

Retorno estructurado JSON:

{
    "perm":   1,
    "isJson": false,
    "ok":     true,
    "status": 200,
    "data":   null,
    "html":   "<h6>Contenido recibido</h6>...",
    "error":  null
}

Características

• Envío dinámico — soporta los modos fetch, window y page
• Recolección flexible — recolecta datos por grupo, elemento individual o JSON
• Respuesta visual — envía el retorno a un destino específico en el DOM
• Dos formularios simultáneos — catch-group-id acepta múltiples IDs
• Recolección por nombre — catch-item-name selecciona campos específicos
• Valor fijo — campo:valor envía el valor definido en el atributo
• Compatibilidad legado — acepta el prefijo ld de la versión anterior
• Integración con API — facilita llamadas orientadas a datos
• Limpieza de formulario — limpia campos tras el envío cuando está configurado
• Soporte de debug — muestra logs detallados mediante data-zld-log

Atributos HTML

[1] Envío

[2] Recolección de Datos

[3] Respuesta / Destino

[4] Comportamiento / UX

[5] Debug

[6] Compatibilidad

Adaptado para IIFE → Async/Await, evita conflictos, ejecución inmediata, ámbito privado y base preparada para SPA. Acepta el prefijo legado ld (ej: ldUrl, ldDestinyId) para compatibilidad con versiones anteriores.