Bootstrap Resumen de complementos
Anteriormente,Componentes de diseñoLos componentes discutidos en el capítulo son solo el comienzo. Bootstrap incluye 12 complementos de jQuery, que amplían la funcionalidad y pueden agregar más interacción al sitio. Incluso si no es un desarrollador avanzado de JavaScript, puede comenzar a aprender los complementos de JavaScript de Bootstrap. Con la API de datos de Bootstrap (Bootstrap Data API), la mayoría de los complementos se pueden activar sin escribir ningún código.
Hay dos formas de referenciar los complementos de Bootstrap en un sitio:
- Referencia individual: utilice los archivos individuales de*.jsBootstrap. Algunos complementos y componentes CSS dependen de otros complementos. Si referencia complementos individualmente, asegúrese primero de entender las dependencias entre ellos.
- Referencia compilada (a la vez): utilicebootstrap.jso la versión comprimida debootstrap.min.js。
No intente hacer referencia a ambos archivos al mismo tiempo, porquebootstrap.jsybootstrap.min.jsambos contienen todos los complementos.
Atributos data
- Puede usar todos los complementos de Bootstrap simplemente a través de la API de atributos data, sin escribir una sola línea de código JavaScript. Esta es una API de primera clase en Bootstrap y debería ser su forma preferida.
- Por otro lado, en ciertos casos puede ser necesario desactivar esta función. Por lo tanto, también proporcionamos una forma de desactivar la API de atributos data, desvinculando los eventos con el espacio de nombresdata-apidata-api y vinculados al documento. De la siguiente manera:
$(document).off('.data-api') - Para desactivar un complemento específico, simplemente anteponga el nombre del complemento como espacio de nombres al espacio de nombres data-api, de la siguiente manera:
$(document).off('.alert.data-api')
API de programación
Proporcionamos una API de JavaScript puro para todos los complementos de Bootstrap. Todas las API públicas admiten llamadas individuales o encadenadas y devuelven la colección de elementos sobre la que operan (nota: igual que la forma de llamada de jQuery). Por ejemplo:
$(".btn.danger").button("toggle").addClass("fat")
Todos los métodos pueden aceptar un objeto de opciones opcional como parámetro, o una cadena que represente un método específico, o ningún parámetro (en este caso, el complemento se inicializará con el comportamiento predeterminado), como se muestra a continuación:
// 初始化为默认行为
$("#myModal").modal()
// 初始化为不支持键盘
$("#myModal").modal({ keyboard: false })
// 初始化并立即调用 show
$("#myModal").modal('show')
Cada complemento, en laConstructorpropiedad también expone su constructor original$.fn.popover.Constructor. Si desea obtener una instancia de un complemento específico, puede obtenerla directamente a través del elemento de la página:
$('[rel=popover]').data('popover').
Evitar conflictos de espacio de nombres
A veces, los complementos de Bootstrap pueden necesitar usarse junto con otros frameworks de UI. En este caso, pueden surgir conflictos de espacio de nombres. Si esto ocurre, puede, llamando al.noConflictmétodo del complemento, restaurar su valor original.
// 返回 $.fn.button 之前所赋的值 var bootstrapButton = $.fn.button.noConflict() // 为 $().bootstrapBtn 赋予 Bootstrap 功能 $.fn.bootstrapBtn = bootstrapButton
Eventos
Bootstrap proporciona eventos personalizados para el comportamiento único de la mayoría de los complementos. En general, estos eventos tienen dos formas:
- Infinitivo: se activa al inicio del evento. Por ejemploex: show. Los eventos en infinitivo proporcionan lapreventDefaultfuncionalidad. Esto permite detener la ejecución de la acción antes de que comience el evento.
$('#myModal').on('show.bs.modal', function (e) { // 阻止模态框的显示 if (!data) return e.preventDefault() }) - Participio pasado: se activa después de que la acción se haya completado. Por ejemploex: shown。