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 e, facoltativamente, di nascondere l’interruttore Ricerca semantica. Utilizzando la finestra di dialogo per progettazione, l’autore del modello può impostare il valore predefinito per la posizione nella struttura del contenuto da cui deve iniziare la ricerca, la dimensione massima del set di risultati, la lunghezza minima del termine di ricerca e se l’opzione Ricerca semantica viene visualizzata ai visitatori per impostazione predefinita.
Versione e compatibilità version-and-compatibility
La versione corrente del componente Ricerca rapida è la v3, introdotta con la versione 2.32.0 dei Componenti core con l’aggiunta di un interruttore di ricerca semantica opzionale, 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.
*L’interruttore di ricerca semantica è disponibile solo con AEM as a Cloud Service.
Per ulteriori informazioni sulle versioni e sugli aggiornamenti dei Componenti core, vedi il documento Versioni dei Componenti core.
Esempio di output del componente sample-component-output
Per avere un’idea del componente Ricerca rapida e vedere esempi delle opzioni di configurazione e dell’output HTML e JSON, visita la libreria dei componenti.
Dettagli tecnici technical-details
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 e di nascondere facoltativamente l’opzione Ricerca semantica.
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 livello dati.
- 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 livello dati.
-
Nascondi/Nascondi ricerca semantica in questa istanza - Se questa opzione è selezionata, l’opzione Ricerca semantica è nascosta, indipendentemente dalla finestra di dialogo per progettazione configurata per la visualizzazione.
- Lascia deselezionata questa opzione per utilizzare l’impostazione predefinita del modello.
- Questa opzione non può forzare la visualizzazione dell’interruttore su un posizionamento in cui la finestra di dialogo per progettazione la nasconde.
Finestra di dialogo per progettazione design-dialog
Utilizzando la finestra di dialogo per progettazione, l’autore del modello può impostare il valore predefinito per la posizione nella struttura del contenuto da cui deve iniziare la ricerca, nonché una dimensione massima del set di risultati, una lunghezza minima del termine di ricerca e se l’opzione Ricerca semantica è visualizzata o meno per impostazione predefinita dai visitatori.
Scheda Proprietà properties-tab
-
Pagina iniziale ricerca - Valore predefinito per la pagina iniziale della ricerca quando un autore di contenuti inserisce il componente Ricerca rapida in una pagina
-
Dimensione risultati - Numero massimo di risultati recuperati da una richiesta di ricerca
-
Lunghezza minima termine di ricerca - Lunghezza minima del termine di ricerca per avviare la ricerca
-
Nascondi attivazione/disattivazione ricerca semantica - Se questa opzione è selezionata, l’opzione Ricerca semantica descritta in Utilizzo non viene visualizzata ai visitatori del sito per impostazione predefinita e il componente si comporta come il componente v2 (solo ricerca full-text).
- Deselezionato per impostazione predefinita.
- Gli autori dei contenuti possono inoltre ignorare questa impostazione per un singolo componente Ricerca rapida nella finestra di dialogo per modifica.
Scheda Stili styles-tab
Il componente Ricerca rapida supporta il sistema di stili di AEM.