Schnellsuch-Komponente quick-search-component

Die Schnellsuch-Komponente bietet Suchfunktionen für eine Website und zeigt Suchergebnisse an, damit Besucher mühelos übereinstimmende Inhalte finden und Ergebnisse anzeigen können.

TIP
Haben Sie schon Edge Delivery Services für AEM in Betracht gezogen?
Sie können die in diesem Dokument beschriebenen Methoden für bestehende Projekte weiter verwenden. Für neue Projekte empfiehlt Adobe jedoch die Verwendung von Edge Delivery Services.

Nutzung usage

Die Schnellsuch-Komponente bietet Site-Besuchern die Möglichkeit, nach Inhalten zu suchen, die Ergebnisse unmittelbar anzuzeigen und leicht zu den passenden Seiten zu navigieren. Neue Ergebnisse werden dynamisch abgerufen, wenn der Benutzer die Suchergebnisse durchblättert.

Im Dialogfeld „Bearbeiten“ kann der Verfasser des Inhalts festlegen, wo die Suche in der Inhaltsstruktur beginnen soll. Im Dialogfeld „Design“ kann der Vorlagenautor den Standardwert festlegen, an dem die Suche in der Inhaltsstruktur beginnen soll, sowie eine maximale Ergebnissatzgröße und minimale Suchbegriffslänge festlegen.

Version und Kompatibilität version-and-compatibility

Die aktuelle Version der Schnellsuch-Komponente ist v2, die mit Version 2.18.0 der Kernkomponenten im Januar 2018 eingeführt wurde und in diesem Dokument beschrieben wird.

Die folgende Tabelle enthält alle unterstützten Versionen der Komponente, die AEM-Versionen, mit denen die Versionen der Komponente kompatibel sind, sowie Links zur Dokumentation für frühere Versionen.

Komponentenversion
AEM 6.4
AEM 6.5
AEM 6.5 LTS
AEM as a Cloud Service
v2
Kompatibel
Kompatibel
Kompatibel
v1
Kompatibel mit
Version 2.17.4 und vorherigen
Kompatibel
Kompatibel

Weitere Informationen zu Kernkomponentenversionen und -freigaben finden Sie im Dokument Kernkomponentenversionen.

Technische Details technical-details

NOTE
Der Schutz der Suchkomponente oder einer beliebigen AEM-basierten Anwendung gegen DOS-Angriffe sollte auf höherer Ebene implementiert werden, z. B. durch Verwendung von mod_security auf dem Dispatcher.

Die neueste technische Dokumentation zur Schnellsuch-Komponente finden Sie auf GitHub.

Weitere Informationen zur Entwicklung von Kernkomponenten finden Sie in der Dokumentation zu Kernkomponenten für Entwickler.

Dialogfeld „Bearbeiten“ edit-dialog

Im Dialogfeld „Bearbeiten“ kann der Verfasser des Inhalts festlegen, wo die Suche in der Inhaltsstruktur beginnen soll.

Dialogfeld „Bearbeiten“ der Schnellsuch-Komponente

Suchstamm - Die Stammseite, von der aus die Suche gestartet werden soll. Der Suchstamm kann ein Blueprint-Master, ein Sprachen-Master oder eine normale Seite sein.

  • ID – Diese Option dient zur Kontrolle der eindeutigen Kennung der Komponente in der HTML-Datei und in der Datenschicht.

    • Wenn Sie das Feld leer lassen, wird automatisch eine eindeutige ID generiert, die Sie über die resultierende Seite finden.
    • Sofern eine ID angegeben wird, ist vom Autor bzw. der Autorin sicherzustellen, dass diese eindeutig ist.
    • Änderungen der ID können sich auf das CSS-, JS- und Datenschicht-Tracking auswirken.
NOTE
Wenn der Suchstamm nicht konfiguriert ist oder nicht aufgelöst werden kann, sucht die Schnellsuche standardmäßig unterhalb der aktuellen Seite.

Dialogfeld „Design“ design-dialog

Im Dialogfeld „Design“ kann die Autorin bzw. der Autor der Vorlage den Standardwert, an dem die Suche in der Inhaltsstruktur beginnen soll, sowie eine maximale Ergebnissatzgröße und minimale Suchbegriffslänge festlegen.Im Dialogfeld „Design“ kann die Autorin bzw. der Autor der Vorlage festlegen, welche Textformatierungsoptionen den Erstellenden von Inhalten zur Verfügung stehen.

Registerkarte „Eigenschaften“ properties-tab

Design-Dialog der Schnellsuch-Komponente

  • Suchstamm
    Der Standardwert des Suchstamms, wenn eine Autorin bzw. ein Autor von Inhalten die Komponente „Schnellsuche“ auf einer Inhaltsseite platziert
  • Ergebnisgröße
    Die maximale Anzahl von Ergebnissen, die durch eine Suchanfrage abgerufen werden
  • Minimale Länge für Suchbegriff
    Mindestlänge des Suchbegriffs, damit die Suche gestartet werden kann
NOTE
Ergebnisgröße und Minimale Länge für Suchbegriff können nur im Design-Modus festgelegt werden und daher nur auf Vorlagenebene, d. h. bei der Inhaltserstellung können diese Werte nicht geändert werden.
CAUTION
Die Größe der Ergebnisse und die Minimale Länge für Suchbegriff können Auswirkungen auf die Leistung haben, wenn sie zu hoch oder zu niedrig eingestellt sind.

Registerkarte „Arten“ styles-tab

Die Komponente „Schnellsuche“ unterstützt das AEM-Stilsystem.

recommendation-more-help
experience-manager-core-components-help-main-toc