Functionalitati

Tot ce ai nevoie pentru adrese

Un singur script care se ocupa de tot - de la cautare pana la popularea campurilor din formular.

⚡

Autocompletare rapida

Rezultate instant pe masura ce utilizatorul tasteaza. Suport pentru diacritice si cautare fara ele.

📍

Date complete

Strada, numar, sector, oras, judet si cod postal. Toate datele necesare pentru o adresa completa.

🏛

Suport Bucuresti

Sectoarele 1-6 sunt tratate corect, cu populare automata in campurile de oras/sector.

⌨

Navigare tastatura

Sus/Jos pentru navigare, Enter pentru selectie, Escape pentru inchidere. UX complet.

🔧

Zero dependinte

Vanilla JavaScript, sub 10KB. Nu necesita jQuery, React sau alte librarii.

🎨

Detectare automata

Gaseste automat campurile de adresa, oras, judet si cod postal din formular.

Demo

Incearca widget-ul

Scrie in campul de adresa pentru a vedea autocompletarea in actiune.

Dropdown default

Dropdown compact data-adresa-style="compact"

Readonly fields data-adresa-readonlyfields="true"

Country filter name="country"

Widget-ul detecteaza campul country si se dezactiveaza automat pentru tarile non-Romania. Schimba tara pentru a vedea efectul.

Integrare

3 pasi simpli

Adauga scriptul

Include scriptul in pagina ta, inainte de </body>.

Numeste campurile

Foloseste nume standard si widget-ul le detecteaza automat.

<input name="address" placeholder="Strada...">
<input name="city"    placeholder="Oras...">
<input name="county"  placeholder="Judet...">
<input name="postcode" placeholder="Cod postal...">

Gata!

Widget-ul se initializeaza automat. Optional, poti configura comportamentul:

<script>
window.ADRESA_CONFIG = {
    style: 'compact',      // 'default' sau 'compact'
    minChars: 3,           // caractere minime
    debounceMs: 200,       // delay intre taste
    maxResults: 10         // rezultate maxime
};
</script>
<script src="https://adresa.apidata.ro/js/adresa.js"></script>

Configurare

Optiuni disponibile

Widget-ul functioneaza fara configurare, dar poate fi personalizat complet.

Detectare automata campuri

Widget-ul cauta campuri cu aceste nume (id sau name):

Adresa address, address1, adresa, adresa1, strada, street

Oras city, oras, localitate, locality

Judet county, judet, region, state, provincie, judetul

Cod postal postcode, postal, zip, cod_postal, postal_code, zipcode

Tara country, tara

Configurare globala

Seteaza inainte de includerea scriptului:

<script>
window.ADRESA_CONFIG = {
    // Comportament (valori = default)
    style: 'default',      // sau 'compact'
    minChars: 3,            // caractere minime
    debounceMs: 200,        // ms intre taste
    maxResults: 20,         // rezultate max
    appendToBody: false,   // true pt modale
    readOnlyFields: false, // campuri readonly

    // Campuri custom (exemple, nu default)
    addressFields:  ['my_address'],
    cityFields:     ['my_city'],
    countyFields:   ['my_county'],
    postcodeFields: ['my_postcode'],
    countryFields:  ['my_country']
};
</script>
<script src="https://adresa.apidata.ro/js/adresa.js"></script>

Atribute per camp

Configureaza individual fiecare input:

<!-- Stil compact doar pentru acest camp -->
<input name="address"
       data-adresa-style="compact">

<!-- Portal mode - dropdown in body (pentru modale) -->
<input name="address"
       data-adresa-portal="true">

<!-- Readonly fields - city/county/postcode readonly -->
<input name="address"
       data-adresa-readonlyfields="true">

API JavaScript

Metode expuse pentru integrari avansate:

// Re-initializeaza (dupa AJAX/SPA navigation)
Adresa.init();

// Cauta adrese programatic
const results = await Adresa.searchAddresses('victoriei');

// Obtine judete
const counties = await Adresa.fetchCounties();

// Obtine orase pentru un judet
const cities = await Adresa.fetchCities('Cluj');

// Acces la configuratie
console.log(Adresa.CONFIG);

Widget autocompletare adrese