Class: InputAutocomplete

geoBCN.Html.InputAutocomplete

new geoBCN.Html.InputAutocomplete(opcions){geoBCN.Html.InputAutocomplete}

Classe InputAutocomplete: Genera un input "autocomplete" fent servir les opcions passades per paràmetre.

Nom paràmetre Descripció
opcions

Opcions per generar el component

Nom paràmetre Tipus Descripció
inputId string

Id de l'element input creat a l'HTML
label string

Etiqueta de text que es mostrarà davant de l'input
origen string

Funció que cridarà el component per obtenir els resultats de la cerca
esborraTitle string opcional

Text tooltip que es mostrarà en el botó d'esborrar
desplegarTitle string opcional

Text tooltip que es mostrarà en el botó de desplegar
combobox boolean opcional

Indica si s'ha de mostrar un botó que executa la cerca sense paràmetres per aconseguir l'efecte "combo"
master geoBCN.Html.Autocomplete opcional

Lliga el control als esdeveniments (esborat/canvi) que produeix el control mestre.
masterRequired boolean opcional

Indica si el control lligat com a mestre, requereix estar informat a l'hora d'executar la cerca
seleccio geoBCN.Html~seleccioCallback

Funció que es cridarà quan es seleccioni un element del desplegable.
esborrat geoBCN.Html~esborratCallback

Funció que es cridarà quan es premi el botó d'esborrar el control.
Exemple

Exemple de contrucció d'un input Autocompletable que permet escriure i triar un carrer

cercadorCarrer = 
new geoBCN.Html.InputAutocomplete(
      {"inputId": "carrer",
       "label": "Carrer",
       "origen": function (request, response) {
           geoBCN.Cercadors.cercaCarrers(
               { "nom": cercadorCarrer.getText(),
                 "nomesCamps": ["Nom18", "Codi"],//Solament necessitem aquests camps de retorn
                 "resultat": function (data) {
                     response(jQuery.map(data.resultats, function (item) {
                         return { label: item["nom18"], value: item["codi"] };
                     }));
                 }
             });
            },
        "esborrat": function () {
            //Quan l'usuari esborri l'imput...
        },
        "seleccio": function () {
            //Quan l'usuari triï un element...
        }
});

Mètodes

addEsclau(esclau){void}

Permet afegir un control que es sotmetrà als canvis que es produeixin en el control mestre (canvi selecció/esborrat)

Nom paràmetre Tipus Descripció
esclau geoBCN.Html.Autocomplete

Control que es sotmetrà als esdeveniments d'aquest.

cerca(text){void}

Permet executar una cerca sobre el control. Aquest mètode desplegarà el control quan obtingui els resultats

Nom paràmetre Tipus Descripció
text string opcional

Text que es vol cercar

esborra(){void}

Permet esborrar l'entitat seleccionada i deixa el control preparat introduir una nova cerca

esborra(){void}

Permet esborrar l'entitat seleccionada i deixa el control preparat introduir una nova cerca

getCodi(){string}

Permet obtenir el codi/id de la opció triada al control

Returns:
Codi/id de la opció triada al control

getText(){string}

Permet obtenir el text del control

Returns:
Cadena de text que mostra el control

getValor(){object}

Permet obtenir el valor de la opció triada al control

Returns:
Objecte Javascript amb tots els camps de l'entitat que permet triar el control

setCodi(codi){void}

Permet establir el codi/id corresponent a l'entitat que es mostra al control

Nom paràmetre Tipus Descripció
codi string

Valor del codi/id

setError(propietats, error){void}

Permet establir el missatge d'error del component

Nom paràmetre Tipus Descripció
propietats object

Propietats a establir
error string

Text d'error que es mostra al control

setError(propietats, error){void}

Permet establir el missatge d'error del component

Nom paràmetre Tipus Descripció
propietats object

Propietats a establir
error string

Text d'error que es mostra al control

setPropietats(propietats){void}

Permet establir les propietats Text, Codi i Valor en una sola crida

Nom paràmetre Tipus Descripció
propietats

Propietats a establir

Nom paràmetre Tipus Descripció
text string opcional

Text que es mostra al control
codi string opcional

Codi associat a l'entitat
valor object opcional

Valor de l'entitat

setText(text){void}

Permet establir el text del control

Nom paràmetre Tipus Descripció
text string

Text que es vol mostrar al control

setValor(valor){void}

Permet establir el valor corresponent al l'entitat que es mostra al control

Nom paràmetre Tipus Descripció
valor object

Valor de l'entitat