AutoComplete //Repositório JavaScript

Descrição

Auto-complete para inputs utilizando um combo.
Criado: 2005.11.21 - Modificado 2013.09.17

Código (Download)

//+ Carlos R. L. Rodrigues
//@ http://jsfromhell.com/dhtml/auto-complete [rev. #4]

AutoComplete = function(form){
    var o = this;
    o.form = document.forms[form], o.fields = {};
    o.hide = function(f){
        var s = f.box.style;
        s.display != "none" && f.box && (s.display = "none", o.onHide && o.onHide(f));
    }
    o.show = function(f){
        var b = f.box, s = b.style;
        s.display != "block" && b && b.options.length && (b.selectedIndex = 0,
        b.style.display = "block", o.onShow && o.onShow(f));
    }
    o.filter = function(h){
        var a, b = h.box, s = b.style, v, l = (v = (o.ignoreAccents ? o.rem(h.value) : h.value).toLowerCase()).length;
        for(var p = 0, t = h.list, i = t.length; i--;)
            (a = (o.ignoreAccents ? o.rem(t[i]) : t[i]).toLowerCase().indexOf(v), o.matchExact ? !a : a > -1) &&
            t[i].length != l && (b.options[p++] = new Option(t[i], t[i]));
        return b.size = (b.options.length = p) < o.size ? p : o.size, p;
    }
    o.rem = function(s){
        var a = {a: "??????", e: "????", i: "????", o: "???", u: "????", c: "?", n: "?"};
        for(var i in a) s = s.replace(new RegExp("[" + a[i] + "]", "gi"), i);
        return s;
    }
}
AutoComplete.prototype.size = 5;
AutoComplete.prototype.matchExact = true;
AutoComplete.prototype.ignoreAccents = true;
AutoComplete.prototype.addControls = function(field){
    var o = this.form[field], b = o.box, h = this;
    addEvent(o, "keydown", function(e){
        e.keyValue == 40 && b.style.display == "block" && b.focus();
    });
    addEvent(o, "keypress", function(e){
        e.keyValue == 13 && b.style.display == "block" && (h.hide(o), b.ondblclick(), e.preventDefault());
    });
    addEvent(o, "keyup", function(e){
        if(!o.value) return;
        if(e.keyValue == 13 && b.style.display == "block") return b.ondblclick();
        (e = h.filter(o)) && h.show(o), !e && (b.fo && !b.blur() || (h.hide(o), o.focus()));
    });
    addEvent(o, "blur", function(){
        setTimeout(function(){return !b.fo && h.hide(o);}, 10);
    });
    b.onblur = function(){h.hide(o), b.f = b.fo = false;}
    b.onfocus = function(){b.fo = true;}
    b.onclick = function(){this.options.length == 1 && this.ondblclick()}
    b.ondblclick = function(){
        h.onSelect && h.onSelect.call(this, b.selectedIndex);
        o.value = b.options[b.selectedIndex].value;
        b.fo && b.blur(), o.focus();
    }
    addEvent(b, "keypress", function(e){e.keyValue == 8 && o.focus()});
    addEvent(b, "keyup", function(e){
        if(e.keyValue == 13) b.ondblclick();
        else if(e.keyValue == 38)
            !b.selectedIndex && b.f && (b.blur(), o.focus()), b.f = true;
        else b.f = false;
    });
}
AutoComplete.prototype.addField = function(field, list, cssClass){
    if(this.fields[field]) return;
    var f, v, a, x = ((f = this.form[(this.fields[field] = 1, field)]).list = list, v = f).offsetLeft, y = f.offsetTop, st;
    while(v = v.offsetParent) (y += v.offsetTop, x += v.offsetLeft);
    f.box = document.createElement("select"), cssClass && (f.box.className = cssClass);
    for(var s in st = f.box.style, a = {display: "none", position: "absolute", width: f.offsetWidth + "px",
        top: y + f.offsetHeight + "px", left: x + "px"}) st[s] = a[s];
    return this.addControls((document.body.appendChild(f.box), field));
}

Exemplo (Exemplo)

<style type="text/css">
.box{
    font: 10px verdana;
    background: #fef2c5;
    border: 1px solid #999;
}
</style>

<form action="" id="formulario">
    <fieldset>
        <legend>Preenchimento din?mico</legend>
        <label for="nome">Nome</label>
        <input autocomplete="0" type="text" name="nome" id="nome" />
        <input type="button" name="nome_complete" value="AutoComplete.Show()" />
        <br />
        <label for="tel">Telefone</label>
        <input autocomplete="0" type="text" name="tel" id="tel" />
    </fieldset>
</form>
<br style="clear:both;" />
<span id="label"></span>

<script type="text/javascript">
//<![CDATA[

var nomes = ["Armindo", "Arminda", "Armando", "Arlindo", "Benedito", "Diana", "Ti?o", "Vanessa"];
var telefones = ["4221 0339", "4548 0813", "4548 1225", "4665 0056", "4665 0636", "4665 0037", "2236 0106", "2236 0533"];

var code = new AutoComplete("formulario");
//code.ignoreAccents = false;
//code.matchExact = false;
code.addField("nome", nomes, "box");
code.addField("tel", telefones);
code.onSelect = function(i){
    //alert(this.options[i].text);
}
code.onShow = function(f){
    document.getElementById("label").innerHTML += "SHOW = " + f.name + "<br />";
}
code.onHide = function(f){
    document.getElementById("label").innerHTML += "HIDE = " + f.name + "<br />";
}
document.forms.formulario.nome_complete.onclick = function(){
    code.filter(this.form.nome), code.show(this.form.nome);
}
document.getElementById("label").innerHTML = "<b>Nomes:</b><br />" + nomes.join("<br />") + "<br /><br />" + "<b>Telefones:</b><br />" + telefones.join("<br />");

//]]>
</script>

Ajuda

Construtor

AutoComplete(formName: String)
Gera uma instância de AutoComplete.
formName
name ou id do formulário onde se encontra os campos para aplicar o auto-complete

Propriedades

AutoComplete.size: Integer
Indica o quantidade máxima de elementos que serão exibidos no combo (propriedade size do select). Seu valor padrão é 5.
AutoComplete.matchExact: Boolean
Se true, apenas strings idênticas serão listadas, caso contrário a classe procura por qualquer ocorrência. Seu valor padrão é true
AutoComplete.ignoreAccents: Boolean
Indica se a busca irá ignorar os acentos. Seu valor padrão é true

Métodos

AutoComplete.addField(fieldName: String, list: Array, [className: String]): void
Insere o autocomplete no campo.
fieldName
nome do elemento input que será inserido o auto-complete
list
lista onde será feita a busca por ocorrências
className
nome da classe CSS que será usada pelo auto-complete
AutoComplete.show(field: HTMLInputElement): void
Exibe a listagem associada a um determinado campo.
field
campo
AutoComplete.hide(field: HTMLInputElement): void
Esconde a listagem associada a um determinado campo.
field
campo
AutoComplete.show(field: HTMLInputElement): void
Filtra a listagem associada a um determinado campo.
field
campo

Eventos

AutoComplete.onSelect: function(index: Integer): void
Este evento é chamado quando um item da listagem é selecionado com um double-click ou com o enter.
A palavra "this" dentro do callback desse evento, está apontada para o objeto select do auto-complete.
index
index do option que foi selecionado dentro do select utilizado no auto-complete
AutoComplete.onShow: function(field: HTMLField): void
Este evento é chamado quando a lista para o auto-complete é mostrada.
field
input html a qual a lista do auto-complete está relacionada
AutoComplete.onHide: function(field: HTMLField): void
Este evento é chamado quando a lista para o auto-complete é escondida.
field
input html a qual a lista do auto-complete está relacionada

Para manusear o auto-complete você pode utilizar o mouse ou então seta para baixo (próximo item), seta para cima (item anterior), enter ou double-click (confirma valor).

Ranque (Votos: 96)

4.26