jQuery UI Cómo funciona

jQuery UI contiene muchos widgets que mantienen estado; por lo tanto, su patrón de uso es ligeramente diferente al de los plugins típicos de jQuery. Su método de instalación es similar al de la mayoría de los plugins de jQuery. Los widgets de jQuery UI se basan enla fábrica de widgets (Widget Factory)que proporciona una API común. Por lo tanto, una vez que aprenda a usar uno de ellos, sabrá cómo usar los demás widgets. Este tutorial utilizarála barra de progreso (progressbar)ejemplos de código del widget para presentar las funciones comunes.

Instalación

Para rastrear el estado del widget, primero presentaremos el ciclo de vida completo del widget. El ciclo de vida comienza cuando se instala el widget. Solo necesitamos llamar al plugin en uno o más elementos para instalar el widget.

$( "#elem" ).progressbar();

Esto inicializará cada elemento dentro del objeto jQuery; en este ejemplo, el elemento tiene el id 'elem'. Como llamamos sin parámetros al.progressbar()método, el widget se inicializará con sus opciones predeterminadas. Podemos pasar un conjunto de opciones durante la instalación para sobrescribir las opciones predeterminadas.

$( "#elem" ).progressbar({ value: 20 });

La cantidad de opciones que pasamos durante la instalación puede determinarse según nuestras necesidades. Cualquier opción que no pasemos usará su valor predeterminado.

Las opciones son parte del estado del widget, por lo que también podemos configurar opciones después de la instalación. Esto lo presentaremos en losoptionmétodos posteriores.

Métodos

Dado que el widget ya está inicializado, podemos consultar su estado o ejecutar acciones sobre él. Todas las acciones posteriores a la inicialización se realizan mediante llamadas a métodos. Para llamar a un método en un widget, podemos pasar el nombre del método al plugin de jQuery. Por ejemplo, para llamar alvaluemétodo en el widget de la barra de progreso (progressbar), deberíamos usar:

$( "#elem" ).progressbar( "value" );

Si el método acepta parámetros, podemos pasarlos después del nombre del método. Por ejemplo, para pasar el parámetro al40Paravaluemétodo, podemos usar:

$( "#elem" ).progressbar( "value", 40 );

Al igual que otros métodos en jQuery, la mayoría de los métodos de widgets devuelven objetos jQuery para encadenar.

$( "#elem" )
    .progressbar( "value", 90 )
    .addClass( "almost-done" );

Métodos comunes

Cada widget tiene su propio conjunto de métodos basados en la funcionalidad que proporciona el widget. Sin embargo, hay algunos métodos que son comunes a todos los widgets.

option

Como mencionamos anteriormente, podemos cambiar las opciones después de la inicialización mediante eloptionmétodo. Por ejemplo, podemos llamar aloptionmétodo para cambiar el valor de la barra de progreso (progressbar) a 30.

$( "#elem" ).progressbar( "option", "value", 30 );

Tenga en cuenta que esto es diferente delvaluemétodo que llamamos anteriormente. En este ejemplo, llamamos aloptionmétodo, cambiando la opción value a 30.

También podemos obtener el valor actual de una opción.

$( "#elem" ).progressbar( "option", "value" );

Además, podemos pasarle aloptionmétodo un objeto para actualizar múltiples opciones a la vez.

$( "#elem" ).progressbar( "option", {
    value: 100,
    disabled: true
});

Quizás haya notado que eloptionmétodo tiene la misma firma que los getters y setters en el código jQuery, como.css()y.attr(). La única diferencia es que debe pasar la cadena "option" como primer parámetro.

disable

disableEl método deshabilita el widget. En el caso de la barra de progreso (progressbar), esto cambia el estilo para que la barra de progreso se muestre como deshabilitada.

$( "#elem" ).progressbar( "disable" );

Llamar aldisablemétodo equivale a establecer ladisabledopción comotrue。

enable

enableEl método esdisablelo opuesto al método.

$( "#elem" ).progressbar( "enable" );

Llamar alenablemétodo equivale a establecer ladisabledopción comofalse。

destroy

Si ya no necesita el widget, puede destruirlo y volver al marcado original. Esto significa el fin del ciclo de vida del widget.

$( "#elem" ).progressbar( "destroy" );

Una vez que haya destruido un widget, no puede llamar a ningún método en él, a menos que vuelva a inicializar el widget. Si desea eliminar el elemento, puede hacerlo directamente mediante.remove(), o mediante.html()o.empty()y el widget se destruirá automáticamente.

widget

Algunos widgets generan elementos envoltorio o elementos desconectados del elemento original. En el siguiente ejemplo,widgetdevolverá el elemento generado. En el caso de la barra de progreso (progressbar), no hay envoltorio generado, elwidgetmétodo devuelve el elemento original.

$( "#elem" ).progressbar( "widget" );

Eventos

Todos los widgets tienen eventos relacionados con sus diversos comportamientos, que le notifican cuando el estado cambia. Para la mayoría de los widgets, cuando un evento se activa, el nombre tiene como prefijo el nombre del widget. Por ejemplo, podemos vincular el evento change de la barra de progreso (progressbar), que se activa cuando el valor cambia.

$( "#elem" ).bind( "progressbarchange", function() {
    alert( "The value has changed!" );
});

Cada evento tiene una devolución de llamada correspondiente que se presenta como una opción. Podemos usar lachangedevolución de llamada de la barra de progreso (progressbar), que equivale a vincular elprogressbarchangeevento.

$( "#elem" ).progressbar({
    change: function() {
        alert( "The value has changed!" );
    }
});

Eventos comunes

La mayoría de los eventos son específicos de un widget en particular; todos los widgets tienen un evento comúncreateevento. Este evento se activa cuando se crea el widget.

Otras extensiones