GeoComponents Bcn - documentació - Class: InputAutocomplete

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

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

Cal tenir en compte que la Cerca Unificada adopta un funcionament per defecte i origen ha passat a ser opcional

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	opcional 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. Sense especificar el paràmetre `origen`, aquest no aplica
`combobox`	boolean	opcional Indica si s'ha de mostrar un botó que executa la cerca sense paràmetres per aconseguir l'efecte "combo". Sense especificar el paràmetre `origen`, aquest no aplica
`master`	geoBCN.Html.Autocomplete	opcional Lliga el control als esdeveniments (esborat/canvi) que produeix el control mestre. Sense especificar el paràmetre `origen`, aquest no aplica
`masterRequired`	boolean	opcional Indica si el control lligat com a mestre, requereix estar informat a l'hora d'executar la cerca. Sense especificar el paràmetre `origen`, aquest no aplica
`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