Bootstrap Popover
Descripción
El Popover de Bootstrap se crea utilizando un complemento personalizado de jQuery. Se puede usar para mostrar información de cualquier elemento.
En este tutorial, verá cómo usar el Popover de Bootstrap y cómo personalizarlo con algunas de las opciones disponibles.
Lo que se requiere
Debe hacer referencia a jQuery, al CSS de Bootstrap y a dos archivos JavaScript: uno para el Tooltip de Bootstrap y otro para el Popover de Bootstrap.
El archivo JS para el Tooltip se encuentra en la carpeta js dentro de su carpeta de Bootstrap, y se llama bootstrap-tooltip.js. El archivo JS para el Popover se encuentra en la carpeta js dentro de la carpeta principal de Bootstrap, y se llama bootstrap-popover.js. jQuery se encuentra en docs > assets > js dentro de la carpeta principal de Bootstrap, y se llama jquery.js. O puede descargar jQuery accediendo directamente a https://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js
Asegúrese de descargar bootstrap-tooltip.js antes de bootstrap-popover.js. El popover depende del complemento de tooltip, por lo que el complemento de tooltip debe cargarse primero.
Usar el Popover de Bootstrap en su sitio web
Ejemplo
<h2>Crear un popover con Bootstrap</h2>
<div class="well">
<a href="../index.html" id="example" class="btn btn-danger" rel="popover" data-content="It's so simple to create a tooltop for my website!" data-original-title="Twitter Bootstrap Popover">hover for popover</a>
</div>
</div>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js"></script>
<script src="../twitter-bootstrap/twitter-bootstrap-v2/js/bootstrap-tooltip.js.html"></script>
<script src="../twitter-bootstrap/twitter-bootstrap-v2/js/bootstrap-popover.js.html"></script>
<script>
$(function ()
{ $("#example").popover();
});
</script>
Ver ejemplo en línea
Explicación
La siguiente tabla explica el código anterior. Le ayudará a entender cómo usar el Popover de Bootstrap.
| Código | Explicación |
|---|---|
| id="example" | Asigna un id al ancla correspondiente; el valor del id apunta al JavaScript que luego implementará el popover. |
| class="btn btn-danger" | Crea un botón. btn btn-danger es la clase utilizada en el ejemplo. Puede usar cualquier otra clase del CSS de Bootstrap o usar su propia clase definida. |
| data-content="It's so simple to create a tooltip for my website!" | El valor de data-content se muestra en el cuerpo del popover. |
| data-original-title="Bootstrap Popover" | El valor de data-original-title se muestra como el título del popover. |
| hover for popover | Texto del ancla. |
| Referencia a jQuery. | |
| Referencia al archivo JS del complemento Tooltip de Bootstrap. | |
| Referencia al archivo JS del complemento Popover de Bootstrap. | |
| $(function () | Prepara el documento. Comando de jQuery. |
| $("#example").popover(); | Accede al id example y aplica popover() sobre él. |
Aquí no hemos creado el popover fuera de la caja, sin personalización, es decir, no hemos usado ninguna opción con popover().
Uso
Por lo tanto, podemos resumir el uso del Popover de Bootstrap de la siguiente manera:
$(function ()
{ $("identifier").popover(options);
});
Dondeidentifieres un selector de jQuery que se utiliza para identificar el elemento contenedor correspondiente. A continuación, veamosoptionscuáles son.
Opciones
A continuación se muestran algunas de las opciones que puede utilizar al personalizar el aspecto y la sensación del Popover con popover().
animation
animation: el tipo de valor es boolean, el valor predeterminado es true. Se utiliza para dar al tooltip un efecto de transición de desvanecimiento CSS.
placement
placement: el tipo de valor puede ser string o function, el valor predeterminado es 'right'; top, bottom y left son otros valores que se pueden usar. Esta opción se utiliza para decidir la posición del Popover alrededor del texto del ancla. A continuación se muestra un ejemplo con la opción placement.
Ejemplo
<html lang="en">
<head>
<meta charset="utf-8">
<title>Ejemplo de selección de posición del popover de Bootstrap</title>
<meta name="description" content="Creating Modal Window with Twitter Bootstrap">
<link href="../twitter-bootstrap/twitter-bootstrap-v2/docs/assets/css/bootstrap.css.html" rel="stylesheet">
<style>
a {
margin-left : 400px;
}
</style>
</head>
<body>
<div class="container">
<h2>Crear un popover usando las opciones de plcement de Bootstrap</h2>
<div class="well">
<a href="../index.html" id="example" class="btn btn-success" rel="popover" data-content="¡Crear un popover para mi sitio web es así de simple!" data-original-title="Twitter Bootstrap popover">Popover al pasar</a>
</div>
<div class="well">
<a href="../index.html" id="example_left" class="btn btn-success" rel="popover" data-content="¡Crear un popover para mi sitio web es así de simple!" data-original-title="Twitter Bootstrap popover">Popover al pasar</a>
</div>
<div class="well">
<a href="../index.html" id="example_top" class="btn btn-success" rel="popover" data-content="¡Crear un popover para mi sitio web es tan fácil!" data-original-title="Twitter Bootstrap popover">Popover al pasar el cursor</a>
</div>
<div class="well">
<a href="../index.html" id="example_bottom" class="btn btn-success" rel="popover" data-content="¡Crear un popover para mi sitio web es tan fácil!" data-original-title="Twitter Bootstrap popover">Popover al pasar el cursor</a>
</div>
</div>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js"></script>
<script src="../twitter-bootstrap/twitter-bootstrap-v2/js/bootstrap-tooltip.js.html"></script>
<script src="../twitter-bootstrap/twitter-bootstrap-v2/js/bootstrap-popover.js.html"></script>
<script>
$(function ()
{ $("#example").popover();
$("#example_left").popover({placement:'left'});
$("#example_top").popover({placement:'top'});
$("#example_bottom").popover({placement:'bottom'});
});
</script>
</body>
</html>
Ver ejemplo en línea
selector
selector: el tipo de valor es string, el valor predeterminado es false. Al usar esta opción, puede delegar el objeto Tooltip al destino dado.
trigger
trigger: el tipo de valor puede ser string, el valor predeterminado es 'hover'; focus y manual son otros valores que se pueden usar. Esta opción se utiliza para decidir cómo se inicia el tooltip. El siguiente ejemplo demuestra cómo activar el Popover usando la opción focus.
Ejemplo
<h2>Crear popovers con la opción trigger de Bootstrap</h2>
<div class="well">
<a href="../index.html" id="example" class="btn btn-success" rel="popover" data-content="¡Crear un popover para mi sitio web es así de simple!" data-original-title="Twitter Bootstrap popover">Popover al pasar</a>
</div>
</div>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js"></script>
<script src="../twitter-bootstrap/twitter-bootstrap-v2/js/bootstrap-tooltip.js.html"></script>
<script src="../twitter-bootstrap/twitter-bootstrap-v2/js/bootstrap-popover.js.html"></script>
<script>
$(function ()
{ $("#example").popover({trigger: 'focus'});
});
</script>
Ver ejemplo en línea
title
title: el tipo de valor puede ser string o function, el valor predeterminado es ''. Es decir, por defecto no se muestra el valor del atributo title.
content
content: el tipo de valor puede ser string o function, el valor predeterminado es ''. Es decir, por defecto no se muestra el valor del atributo data-content. A continuación se muestra un ejemplo que utiliza las opciones title y data-content. Este ejemplo también demuestra cómo usar varias opciones juntas.
Ejemplo
<h2>Bootstrap popover usando las opciones title y content</h2>
<div class="well">
<a href="../index.html" id="example" class="btn btn-success" rel="popover">Popover al pasar el mouse</a>
</div>
</div>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js"></script>
<script src="../twitter-bootstrap/twitter-bootstrap-v2/js/bootstrap-tooltip.js.html"></script>
<script src="../twitter-bootstrap/twitter-bootstrap-v2/js/bootstrap-popover.js.html"></script>
<script>
$(function ()
{ $("#example").popover({title: 'Twitter Bootstrap Popover', content: "¡Crear un popover para mi sitio web es tan fácil!"});
});
</script>
Ver ejemplo en línea
delay
El tipo del valor `delay` puede ser `number` u `object`, el valor predeterminado es `0`. Esto determina el tiempo de espera para mostrar y ocultar el popover, en milisegundos. Si el valor se establece como un número, el tiempo de espera se aplica tanto para mostrar como para ocultar. Si el valor se establece como un objeto, la estructura es `delay: { show: 500, hide: 100 }`, donde 500 y 100 están en milisegundos.
Cambiar el marcado y estilo predeterminados del popover
El marcado predeterminado de la ventana emergente Popover se encuentra en la línea 92 del archivo `bootstrap-popover.js`. Como se muestra a continuación:
template: '<div class="popover"><div class="arrow"></div><div class="popover-inner"><h3 class="popover-title"></h3><div class="popover-content"><p></p></div></div></div>'
Puede cambiarlo y poner su propio marcado.
El estilo predeterminado de la ventana emergente Popover se encuentra en las líneas 3027 a 3118. Puede modificarlo y poner su propio estilo.
Haga clic aquí para descargar todos los archivos HTML, CSS, JS e imágenes utilizados en este tutorial.
Otras extensiones