Formularios de envío automático
Keep on Learning!
If you liked what you've learned so far, dive in! Subscribe to get access to this tutorial plus video, code and script downloads.
With a Subscription, click any sentence in the script to jump to that part of the video!
Login Subscribe¿Ya es el día 12? Durante los próximos 3 días, vamos a trabajar en un gran objetivo: transformar esta tabla en una rica configuración de tabla de datos, con búsqueda, filtrado de columnas, paginación, todo ello con un bonito AJAX. Esta es una de las partes en las que estoy más emocionado por sumergirme.
Nuestra página de inicio tiene una búsqueda. Y no tiene nada de especial. Pulso intro para enviar el formulario, el parámetro de consulta está en la URL y filtra los resultados. Naturalmente, gracias a Turbo Drive, todo ocurre vía AJAX.
Para nuestro primer truco, mira cómo hacemos que la búsqueda se actualice automáticamente a medida que escribimos. Así que escribimos y, sin pulsar intro, la lista debería actualizarse.
Para hacer esto, vamos a tomar prestado un controlador de un repositorio de 30 Días de Hotwire. Esto viene de un fantástico reto de 30 Días de Hotwire que hizo alguien de la comunidad Rails. Me encanta esta serie y tiene un montón de cosas buenas. Te recomiendo que le eches un vistazo.
El controlador de Stimulus de envío automático
De todos modos, voy a tomar prestado este estupendo controlador "auto-submit". Es sencillísimo: nos da una forma de enviar un formulario... con desbordamiento opcional. Si escribo muy rápido, no quiero enviar el formulario cuatro veces. Quiero que espere una ligera pausa... y luego lo envíe. A eso se le llama desbordamiento. Esto espera una pausa de 300 milisegundos.
Así que vamos a ponernos manos a la obra e introducir esto en nuestra aplicación. Crea un nuevo archivo llamado autosubmit_controller.js... y pégalo:
| import { Controller } from "@hotwired/stimulus" | |
| import debounce from 'debounce' | |
| // Connects to data-controller="autosubmit" | |
| export default class extends Controller { | |
| initialize() { | |
| this.debouncedSubmit = debounce(this.debouncedSubmit.bind(this), 300) | |
| } | |
| submit(e) { | |
| this.element.requestSubmit() | |
| } | |
| debouncedSubmit() { | |
| this.submit() | |
| } | |
| } |
Luego dirígete a la página de inicio para utilizarlo. Cerca de la parte superior... aquí está nuestro formulario de búsqueda. En el formulario, añade data-controller"autosubmit":
| // ... lines 1 - 4 | |
| {% block body %} | |
| <div class="flex"> | |
| // ... lines 7 - 13 | |
| <section class="flex-1 ml-10"> | |
| <form | |
| // ... lines 16 - 18 | |
| data-controller="autosubmit" | |
| > | |
| // ... lines 21 - 30 | |
| </form> | |
| // ... lines 32 - 85 | |
| </section> | |
| </div> | |
| {% endblock %} |
Observa que se autocompleta. Eso es gracias a un plugin Stimulus que tengo para PhpStorm.
A continuación, abajo en la entrada, di data-action igual a autosubmit#debouncedSubmit:
| // ... lines 1 - 4 | |
| {% block body %} | |
| <div class="flex"> | |
| // ... lines 7 - 13 | |
| <section class="flex-1 ml-10"> | |
| <form | |
| // ... lines 16 - 18 | |
| data-controller="autosubmit" | |
| > | |
| <input | |
| // ... lines 22 - 27 | |
| data-action="autosubmit#debouncedSubmit" | |
| > | |
| // ... line 30 | |
| </form> | |
| // ... lines 32 - 85 | |
| </section> | |
| </div> | |
| {% endblock %} |
En el controlador, puedes llamar a submit para enviar el formulario inmediatamente o adebouncedSubmit() para esperar a la pausa. Y esta vez no necesitamos incluir el nombre del evento, como input-> para escuchar el evento input. Cuando aplicas un data-action a un input, un button o un link, Stimulus averigua qué evento quieres escuchar. La mayoría de las veces, la vida será así de sencilla.
Instalar el paquete que falta
¿Funciona? ¡No! Porque tenemos un error... ¡un error que espero que te resulte familiar!
Error al resolver el especificador de módulo
debounce.
¡Esto proviene de nuestro código! Nuestro código copiado utiliza un paquete debounce... ¡y no lo tenemos instalado! ¡Genial! Copia debounce, gíralo y ejecútalo:
php bin/console importmap:require debounce
Ahora está en nuestro proyecto... y ahora el error ha desaparecido. ¿Listo para la magia? Eh, ¡funciona! ¡Sólo una petición después de terminar de escribir gracias a debounce!
Lo único malo es que perdemos el foco cuando se recarga toda la página. Como solución provisional -no va a ser nuestra solución definitiva- podemos probar a ponerautofocus:
| // ... lines 1 - 4 | |
| {% block body %} | |
| <div class="flex"> | |
| // ... lines 7 - 13 | |
| <section class="flex-1 ml-10"> | |
| <form | |
| // ... lines 16 - 18 | |
| data-controller="autosubmit" | |
| > | |
| <input | |
| // ... lines 22 - 28 | |
| autofocus | |
| > | |
| // ... line 31 | |
| </form> | |
| // ... lines 33 - 86 | |
| </section> | |
| </div> | |
| {% endblock %} |
Esto... casi funciona... excepto que perdemos la posición del cursor: nos devuelve al principio. No pasa nada: pronto resolveremos esto de una forma mucho mejor. Y cuando lo hagamos, ni siquiera necesitaremos el autoenfoque.
Mañana vamos a enriquecerlo añadiendo paginación y ordenación por columnas.
