Frameworks Javascript
From Joomla! Documentation
El CMS de Joomla! incluye una serie de Frameworks JavaScript. En lugar de incluir su propio código JavaScript, puede utilizar estas bibliotecas de funciones JavaScript pre-existentes. Los frameworks se cargan mediante llamadas a métodos estáticos con la clase JHtml
.
Framework JavaScript Twitter Bootstrap
Para habilitar el framework Bootstrap, utiliza JHtml::_('bootstrap.framework')
. Esto habilitará automáticamente el framework jQuery en modo noConflict (es decir, acceder a través de jQuery
en lugar de $
).
La biblioteca Bootstrap incluida es la versión 2.1.0 y se encuentra en media/jui/bootstrap.js
.
Incluye métodos para inicializar los plugins de Bootstrap: affix, alert, button, carousel, collapse, dropdown, modal, tooltip, popover, scrollspy, tab y typeahead.
NOTA: Existe una incompatibilidad entre bootstrap-button
y jquery-ui-botón
. El uso de ambos en la misma página, puede dar lugar a conflictos. Ver [1] para una posible solución.
Framework jQuery JavaScript
Con el fin de cargar jQuery, usa JHtml::_('jquery.framework');
Esto cargará la biblioteca jQuery versión 1.12.4 en modo noConflict. Esto significa que se puede acceder mediante el espacio de nombres jQuery
, no a través de $
.
Para cargarlo en modo normal, utiliza JHtml::_('jquery.framework', false);
FrameworkjQuery UI
Las bibliotecas JUX incluyen el código núcleo jQuery UI más Widget, Mouse, Position y Sortable (versión 1.8.23 a partir de Joomla 3.0.2). Por favor, revisa la documentación de jQuery-UI para más detalles sobre su uso.
Para cargar el núcleo utiliza: JHtml::_('jquery.ui');
Esto cargará el adecuado jquery-ui.core.js
desde el directorio media/jui
. La habilitación de jQuery UI, habilita automáticamente jQuery en modo noConflict si ya no se ha hecho.
Para agregar la biblioteca Sortable, usa JHtml::_('jquery.ui', array('sortable'));
Esto incluirá automáticamente la bibliotecas core de jQuery UI y jQuery.
Para mayor claridad, es mejor habilitar de forma explícita tanto el núcleo y la biblioteca Sortable a partir de una sola llamada con JHtml::_('jquery.ui', array('core', 'sortable'));
.
A partir de Joomla! 3.0.2, sólo jQuery UI Core y Sortable están instalados/disponibles. El uso de otros plugins de jQuery, incluyendo plugins de jQuery UI, tendrás que asegurarte que están instalados con la aplicación y llamar a JHtml::_('script')
junto con los parámetros adecuados para la carga. Alternativamente, puedes crear e instalar tus propias extensiones JHtml y crear tus propias llamadas JHtml - como en JHtml::_('mibiblioteca.micargador')
Framework Mootools JavaScript
Este framework está en desuso y será eliminado en Joomla 4.
Carga de las bibliotecas Mootools desde system/js
. JHtml::_('behavior.framework', $tipo)
donde $tipo
define la biblioteca.
Núcleo: mootools-core.js
, versión 1.4.5
Más: mootools-more.js
, versión 1.4.0.1, permitiendo de forma más automática habilitar el núcleo
Framework Joomla! JavaScript
Muchas de las bibliotecas de Joomla! requieren el framework Mootools. Se supone que estas serán migradas al framework Bootstrap en alguna versión futura.
Estas bibliotecas de JavaScript pueden ser ubicadas dentro de la carpeta media/system/js
. Esta lista es incompleta, por favor revisa la carpeta por las bibliotecas disponibles. Las bibliotecas son:
caption.js :: JHtml::_('behavior.caption', $selector)
Esto aplicará las funciones de subtítulos para todos los elementos del DOM que tienen la clase CSS $selector
. La clase selector predeterminada es img.caption
.
Para aplicar la función de subtítulos a múltiples clases, sólo tienes que hacer varias llamadas a JHTML::_('behavior.caption', $selector)
. La biblioteca sólo se carga una vez, pero se aplicará a todas las clases.
tooltip.js :: JHtml::_('behavior.tooltip', $selector, $params)
Para todos los objetos DOM con clase $selector
, un onhover de la descripción emergente va a ser creado en base a $params
. El valor predeterminado del selector es la clase hasTip
. La carga de este framework también carga el framework Mootools.
combobox.js :: JHtml::_('behavior.combobox')
Crea un efecto combobox. La carga de este framework también cargar el framework Mootools.
validate.js :: JHtml::_('behavior.formvalidation')
Permite la validación del formulario basado en reglas definidas para los campos de formulario. La carga de este framework también cargar el framework Mootools.
switcher.js :: JHtml::_('behavior.switcher')
Esta biblioteca se utiliza internamente y no es útil para otros componentes. Cuando está habilitada, también habilita el framework Mootools.
multiselect.js :: JHtml::_('behavior.multiselect')
JavaScript se comporta para permitir el cambio seleccionar cuadrículas. La carga de este framework también cargar el framework Mootools.
swf.js :: JHtml::_('behavior.uploader')
progressbar.js :: JHtml::_('behavior.uploader')
uploader.js :: JHtml::_('behavior.uploader')
Agregar un soporte no obstructivo a JavaScript para la carga avanzada.
mootree.js :: JHtml::_('behavior.tree')
Agregar un soporte no obstructivo a JavaScript para un árbol que puede contraerse.
No hay ningún archivo JHtml::_('behavior.keepalive')
- Mantiene la sesión activa, por ejemplo, al editar o crear un artículo.
No hay ningún archivo JHtml::_('behavior.noframes')</code - Permite salir de cualquier contenedor iframes.