Componente Ricerca rapida quick-search-component

Il componente Ricerca rapida fornisce funzionalità di ricerca in un sito web e visualizzazione dei risultati della ricerca, in modo che i visitatori possano facilmente effettuare ricerche nel contenuto del sito e visualizzare i risultati.

Utilizzo usage

Il componente Ricerca rapida offre ai visitatori del sito la possibilità di cercare contenuto, visualizzare direttamente i risultati e navigare facilmente nelle pagine trovate. I nuovi risultati vengono recuperati dinamicamente mentre l’utente scorre i risultati della ricerca.

La finestra di dialogo per modifica consente all’autore di contenuto di definire da dove deve iniziare la ricerca nella struttura del contenuto. La finestra di dialogo per progettazione consente all’autore del modello di impostare il valore predefinito per la posizione nella struttura del contenuto dalla quale deve iniziare la ricerca, nonché una dimensione massima del set di risultati e una lunghezza minima del termine di ricerca.

Versione e compatibilità version-and-compatibility

La versione corrente del componente Ricerca rapida è v2, introdotta con la versione 2.18.0 dei Componenti core a gennaio 2018, ed è quella descritta in questo documento.

La tabella che segue descrive tutte le versioni supportate del componente, le versioni di AEM con cui le versioni del componente sono compatibili e i collegamenti alla documentazione delle versioni precedenti.

Versione del componente
AEM 6.4
AEM 6.5
AEM as a Cloud Service
v2
-
Compatibile
Compatibile
v1
Compatibile con
versione 2.17.4 e precedenti
Compatibile
Compatibile

Per ulteriori informazioni sulle versioni e sugli aggiornamenti dei Componenti core, vedi il documento Versioni dei Componenti core.

Dettagli tecnici technical-details

NOTE
La protezione del componente Ricerca o di qualsiasi applicazione basata su AEM contro attacchi DOS deve essere implementata a un livello più alto, ad esempio utilizzando la proprietà mod_security su Dispatcher.

La documentazione tecnica più recente sul componente Ricerca rapida è disponibile su GitHub.

Per ulteriori informazioni sullo sviluppo di Componenti core, vedi la documentazione per gli sviluppatori di Componenti core.

Finestra di dialogo per modifica edit-dialog

La finestra di dialogo per modifica consente all’autore di contenuto di definire da dove deve iniziare la ricerca nella struttura del contenuto.

Finestra di dialogo per modifica del componente Ricerca rapida

Pagina iniziale ricerca: la pagina da cui avviare la ricerca. La pagina iniziale della ricerca può essere una pagina master blueprint, master lingua o normale.

  • ID: questa opzione consente di controllare l’identificatore univoco del componente nel codice HTML e nel Data Layer.

    • Se non specificato, viene generato automaticamente un ID univoco reperibile sulla pagina risultante.
    • Se l’ID viene specificato, è responsabilità dell’autore accertarsi che sia univoco.
    • La modifica dell’ID può avere un impatto sul tracciamento di CSS, JS e Data Layer.
NOTE
Se la Pagina iniziale ricerca non è configurata o non può essere risolta, per impostazione predefinita la ricerca rapida viene eseguita sotto la pagina corrente.

Finestra di dialogo per progettazione design-dialog

Tramite la finestra di dialogo per progettazione, l’autore del modello può impostare il valore predefinito per la posizione da cui iniziare la ricerca nella struttura del contenuto, nonché una dimensione massima del set di risultati e una lunghezza minima del termine di ricerca. La finestra di dialogo per progettazione consente all’autore del modello di definire quali opzioni di formattazione del testo sono disponibili per gli autori di contenuto.

Scheda Proprietà properties-tab

Finestra di dialogo per progettazione del componente Ricerca rapida

  • Pagina iniziale ricerca
    Il valore predefinito per la pagina iniziale della ricerca della ricerca quando un autore di contenuto inserisce il componente Ricerca rapida in una pagina
  • Dimensione risultati
    Il numero massimo di risultati recuperati da una richiesta di ricerca
  • Lunghezza minima termine di ricerca
    La lunghezza minima del termine di ricerca per l’avvio della ricerca
NOTE
Le opzioni Dimensione risultati e Lunghezza minima termine di ricerca possono essere impostate solo in modalità di progettazione e quindi solo a livello di modello, il che significa che gli autori di contenuto non possono modificare questi valori.
CAUTION
Le opzioni Dimensione risultati e Lunghezza minima termine di ricerca possono avere un impatto sulle prestazioni, se impostate rispettivamente su un valore troppo alto o troppo basso.

Scheda Stili styles-tab

Il componente Ricerca rapida supporta il sistema di stili di AEM.

recommendation-more-help
d2be9096-a81e-404b-9952-d8925af7219c