Saltar la navegación

3.2.- JQuery4PHP.

Logotipo de la librería jQuery4PHP.
Omar Yepez (GNU/GPL)

La otra librería con la que vas a trabajar se llama jQuery4PHP. Su objetivo es proporcionar un interface de programación en PHP que aproveche las capacidades de la librería de JavaScript jQuery. Es de código abierto, disponible bajo licencias MIT y GPLv2, y funciona únicamente con las últimas versiones de PHP (a partir de la versión 5).

jQuery4PHP

Para poder utilizarla en tus páginas puedes descargarte la última versión o bien instalarla con Composer (recomendado):

En las páginas PHP en que quieras utilizar jQuery4PHP, deberás incluir la librería escribiendo el siguiente código:

Si has hecho la instalación normal:

<?php
    require_once("YepSua/Labs/RIA/jQuery4PHP/YsJQueryAutoloader.php");
    YsJQueryAutoloader::register();

Con Composer y autoload:

<?php
require '../vendor/autoload.php';
YsJQueryAutoloader::register();

Asegúrate de que la ruta a la librería y del autoload sea la correcta a tú configuración.

El código anterior ejecuta un método estático de la clase YsJQueryAutoloader que se encarga de incluir todos los ficheros necesarios para la librería en el código de tu página.

Para acceder a las capacidades de jQuery4PHP, deberás utilizar en tu código PHP la clase YsJQuery.

La librería jQuery4PHP se apoya completamente en el código JavaScript de la librería jQuery. Por tanto, al escribir el código HTML de la página deberás asegurarte de que se incluye dicha librería, poniendo una línea como la siguiente:

<head>
// Utilizamos la versión de jQuery disponible en las CDN de jQuery
<script src="https://code.jquery.com/jquery-3.5.0.min.js"
    integrity="sha256xNzN2a4ltkB44Mc/Jz3pT4iU1cmeR0FkXs4pru/JxaQ="
    crossorigin="anonymous">
</script>
. . .
</head>

Asegurate de trabajar con la versión adecuada. Las puedes conultar en el enlace siguiente: jQuery

En la documentación de la librería, y en los ejemplos que vas a programar a continuación, se utiliza una sintaxis peculiar de programación propia de PHP. Por ejemplo, comprueba el siguiente código:

<?php
    $jq = YsJQuery::newInstance();
    $jq->onClick();
    $jq->in('#enviar');
    $jq->execute('alert("Has pulsado el botón.")');
    $jq->write();
?>

Como ves, se crea un nuevo objeto a partir del método estático newInstance, y a continuación se ejecutan ciertos métodos implementados en la clase YsJQuery. Estos métodos definen código JavaScript asociado al evento onClick del botón con id='enviar'. El código que se ejecutará cuando se pulse el botón se incluye dentro del método execute, y muestra un mensaje en pantalla. El último método (write) es el encargado de generar el código JavaScript en la página.

Ese mismo código se puede escribir de la forma siguiente, que es la que utilizaremos a continuación.

<?php
echo 
    YsJQuery::newInstance()
      ->onClick()
      ->in('#enviar')
      ->execute('alert("Has pulsado el botón.")')
?>

Fíjate que no se asigna nombre al objeto que se crea, pues no es necesario nombrarlo si los métodos se ejecutan justo a continuación de su instanciación. Además, se ha sustituido la llamada al método write por un comando echo al comienzo.