Mobile Lookup Module for Xataface

Widget mobile-friendly per lookup record con ricerca AJAX e interfaccia touch-optimized per Xataface standard (nessuna dipendenza da tabelle o moduli dell'istanza host).

Caratteristiche

• Touch-optimized: target 44px (standard iOS)
• Ricerca AJAX multi-parola (AND tra token)
• Focus automatico sulla casella ricerca all'apertura
• Font 16px (evita zoom iOS)
• Select2 4.1.0-rc.0 da CDN
• Compatibile con grid Xataface e RecordDialog nativo
• Portabile: solo API Xataface + modulo autonomo

Installazione

[_modules]
    modules_mobile_lookup=modules/mobile_lookup/mobile_lookup.php

Poi svuota cache templates_c/. Dettaglio: INSTALL.md.

Portabilità

Il modulo è autonomo: copia modules/mobile_lookup/, attivalo in conf.ini, configura i fields.ini della tua applicazione.

• Nessuna tabella o delegate obbligatorio
• URL asset risolti via Dataface_ModuleTool::getModuleURL()
• Tema host opzionale (docs/THEMING.md)
• Checklist trasferimento: docs/PORTABILITY.md

Utilizzo

[fk_customer]
    widget:type=mobile_lookup
    widget:table=Customers
    widget:keycol=id
    widget:labelcol=company_name
    widget:searchFields=company_name,code,email
    widget:placeholder="Seleziona cliente..."

Filtri dinamici e pulsante +

[fk_site]
    widget:type=mobile_lookup
    widget:table=Sites
    widget:keycol=id
    widget:labelcol=code
    widget:filters:customer_id="$fk_customer"
    widget:searchFields=code,address

Il pulsante + apre RecordDialog con i filtri come parametri del form nuovo (≥ v1.1.7).

Grid relationship

In widget:type=grid, il modulo gestisce l'interazione con addRowOnChange di Xataface (≥ v1.1.44): una riga nuova solo alla selezione reale, non su ogni evento change di Select2.

Handler legacy onchange

widget:atts:onchange = "myFieldChangeHandler(this.value, this.id);"

Parametri principali

Parametro	Default	Descrizione
widget:table	—	Tabella lookup (obbligatorio)
widget:keycol	id	Colonna chiave
widget:labelcol	nome	Etichetta visualizzata
widget:searchFields	labelcol	Campi ricerca AJAX
widget:preloadOptions	selected	selected | first100 | none
widget:allscreen	0	Overlay fullscreen su mobile
widget:canEdit / widget:canNew	auto	Pulsanti matita / +

Non usare vocabulary= sullo stesso campo: in grid può far perdere il valore FK salvato.

Documentazione

File	Contenuto
INSTALL.md	Installazione e configurazione
docs/PORTABILITY.md	Compatibilità Xataface standard, checklist
docs/THEMING.md	Variabili CSS tema
docs/EXAMPLES.md	Esempi avanzati
CHANGELOG.md	Storico versioni

Autore

plcats

Licenza

GNU GPL v2 — compatibile con Xataface.

Repository

https://github.com/plcats/module-mobile_lookup

Contributi

Vedi CONTRIBUTING.md.