Plugin autocomplete para jQuery

25 de agosto de 20105 min de lectura
El plugin para jQuery que forma parte de la libería jQuery UI y su funcionalidad es la que todo el mundo conoce, autocompletar texto de forma rápida para el usuario. Nos va mostrando una serie de sugerencias mientras que el usuario va tecleando la palabra.

El uso es bastante sencillo, sólo debemos de incluir el código de jQuery y Autocomplete en nuestro archivo HTML. Luego seleccionamos el elemento al que se le aplicará el autocomplete por medio de un selector de jQuery y se le indicará que ejecute el método autocomplete para que nos de las opciones según vayamos escribiendo.

<html>
<head>
<link rel="stylesheet" href="jquery-ui-1.8.2.custom.css" type="text/css" media="all"/>

<script type="text/javascript" src="jquery-1.4.2.min.js"></script>
<script type="text/javascript" src="jquery-ui-1.8.2.custom.min.js"></script>
<script type="text/javascript">
$(function() {
	var animales = ["Ardilla roja", "Gato", "Gorila occidental",
	  "León", "Oso pardo", "Perro", "Tigre de Bengala"];

	$("#animal").autocomplete({
	  source: animales
	});
});
</script>
</head>

<body>
<input type="text" id="animal"/>
</body>
</html>

En este caso, la fuente de datos ha sido un array, pero además de esto, puede ser otro tipos de datos.

Un array de objetos con las propiedades label, que será el texto que se mostrará como sugerencia, y value, el texto que se introducirá en la caja de texto.

<html>
<head>
<link rel="stylesheet" href="jquery-ui-1.8.2.custom.css" type="text/css" media="all"/>

<script type="text/javascript" src="jquery-1.4.2.min.js"></script>
<script type="text/javascript" src="jquery-ui-1.8.2.custom.min.js"></script>
<script type="text/javascript">
$(function() {
	var animales = [
	  {label: "Ardilla roja", value: "Sciurus vulgaris"},
	  {label: "Gato", value: "Felis silvestris catus"},
	  {label: "Gorila occidental", value: "Gorilla gorilla"},
	  {label: "León", value: "Panthera leo"},
	  {label: "Oso pardo", value: "Ursus arctos"},
	  {label: "Perro", value: "Canis lupus familiaris"},
	  {label: "Tigre de Bengala", value: "Panthera tigris tigris"}];

	$("#animal").autocomplete({
	  source: animales
	});
});
</script>
</head>

<body>
<input type="text" id="animal"/>
</body>
</html>

Una cadena con una URL, que deberá devolver un array de strings u objetos en formato JSON

<?php
if(isset($_GET['getAnimales'])) {
  $bd = new mysqli("localhost", "root", "", "animales");
  if(mysqli_connect_errno()) return;

  $animales = array();
  if($res = $bd->query("SELECT * FROM animales"))
    while($animal = $res->fetch_assoc())
      $animales[] = array(
        'label' => $animal['nombreComun'],
        'value' => $animal['nombreCientifico'],
        'estado' => $animal['conservacion'],
      );
  $bd->close();
  echo json_encode($animales);
  return;
}
?>

<html>
<head>
<link rel="stylesheet" href="jquery-ui-1.8.2.custom.css" type="text/css" media="all"/>

<script type="text/javascript" src="jquery-1.4.2.min.js"></script>
<script type="text/javascript" src="jquery-ui-1.8.2.custom.min.js"></script>
<script type="text/javascript">
$(function() {
	$("#animal").autocomplete({
	  source: "animales.php?getAnimales=1"
	});
});
</script>
</head>

<body>
<input type="text" id="animal"/>
</body>
</html>

Una función de callback, a la que se le pasa un objeto request (la petición) y un objeto response (la respuesta).

<?php
if(isset($_GET['getAnimales'])) {
  $bd = new mysqli("localhost", "root", "", "animales");
  if(mysqli_connect_errno()) return;

  $animales = array();
  if($res = $bd->query("SELECT * FROM animales"))
    while($animal = $res->fetch_assoc())
      $animales[] = array(
        'label' => $animal['nombreComun'],
        'value' => $animal['nombreCientifico'],
        'estado' => $animal['conservacion'],
      );
  $bd->close();
  echo json_encode($animales);
  return;
}
?>

<html>
<head>
<link rel="stylesheet" href="jquery-ui-1.8.2.custom.css" type="text/css" media="all"/>

<script type="text/javascript" src="jquery-1.4.2.min.js"></script>
<script type="text/javascript" src="jquery-ui-1.8.2.custom.min.js"></script>
<script type="text/javascript">
$(function() {
    $("#animal").autocomplete({
        source: "animales.php?getAnimales=1",
        select: function(event, ui) {
            $('#conservacion').html(ui.item.label + " (" + ui.item.value + ") " +
                "tiene un estado de conservación de: " + ui.item.estado);
        }
    });
});
</script>
</head>

<body>
<input type="text" id="animal"/>
<p id="conservacion"></p>
</body>
</html>

Vía: mundogeek.net

Sigue leyendo