> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Schnellsuche

> Wie Sie in WEBSALE V8s das Standard-Sucheingabefeld in ein beliebiges Template einbauen, mit FORM-QuickSearch, WS-Search_Input und WS-Search.

Die Schnellsuche ist das einzeilige Sucheingabefeld, das auf jeder Shopseite stehen kann. Der Käufer tippt einen Begriff ein und landet auf der Suchergebnisseite.

Sie besteht aus einem gewöhnlichen HTML-Formular, dessen Ziel und Feldnamen Sie nicht selbst festlegen, sondern von WEBSALE V8s ausgeben lassen. So bleibt die Suche auch dann funktionsfähig, wenn sich an der Adressbildung des Shops etwas ändert.

## Schnellsuche einbauen

Das Formular lässt sich in jedes Template übernehmen.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<form action="~FORM-QuickSearch~" method="post">
   <input type="text" name="~WS-Search_Input~" value="~WS-Search~">
   <input type="submit" value="OK">
</form>
```

Drei Tags sind daran beteiligt.

| Tag | Gibt aus |
| - | - |
| [`~FORM-QuickSearch~`](https://dokumentation.websale.de/v8s/referenz/tags/form-formulare#katalog-suche-und-produkt) | Ziel des Formulars |
| [`~WS-Search_Input~`](https://dokumentation.websale.de/v8s/referenz/tags/ws/suche-listen-und-blaettern#die-tags-im-uberblick) | Name des Texteingabefelds |
| [`~WS-Search~`](https://dokumentation.websale.de/v8s/referenz/tags/ws/suche-listen-und-blaettern#die-tags-im-uberblick) | zuletzt eingegebener Suchbegriff |

### Warum das Ziel aus einem Tag kommt

`~FORM-QuickSearch~` liefert nicht nur die Zieladresse. Der Shop ergänzt zusätzlich ein verstecktes Feld mit dem Sitzungskontext, und zwar unmittelbar hinter der schließenden spitzen Klammer des `<form>`-Tags.

> [!WARNING]
>
> Setzen Sie `~FORM-QuickSearch~` deshalb ausschließlich in das `action`-Attribut eines echten `<form>`-Tags. In einem Link oder an anderer Stelle im Template landet das versteckte Feld an einer falschen Position, und die Suche verliert den Kontext.

### Warum der Suchbegriff wieder im Feld steht

`~WS-Search~` gibt den zuletzt eingegebenen Suchbegriff aus. Steht das Tag wie im Beispiel im `value`-Attribut, findet der Käufer seine Eingabe nach dem Absenden im Feld wieder und kann sie abwandeln, statt sie neu zu tippen.

Der Shop maskiert den Wert dabei HTML-gerecht. Anführungszeichen oder spitze Klammern im Suchbegriff zerstören das Formular also nicht.

### Warum der Feldname aus einem Tag kommt

`~WS-Search_Input~` gibt den Namen aus, unter dem der Shop den Suchbegriff erwartet. Es ist derselbe Name, den Sie auch an einen Such-Link anhängen würden. Über das Tag bleibt er an einer Stelle gepflegt, statt im Template verstreut zu sein.

Wegweiser: [Suchergebnisse](https://dokumentation.websale.de/v8s/suche/suchergebnisse.md)

## Übermittlungsmethode

Das Beispiel arbeitet mit `method="post"`. Das ist die passende Wahl, weil der Sitzungskontext im versteckten Feld mitgeht und in einer Adresszeile weder gut aufgehoben noch lesbar wäre.

## Verwandte Themen

* Wegweiser: [Suchergebnisse, für die Anzeige der Trefferliste und für Such-Links mit vorbelegten Kriterien](https://dokumentation.websale.de/v8s/suche/suchergebnisse.md)
* Wegweiser: [Blättern in Produktlisten](https://dokumentation.websale.de/v8s/anwendungsbeispiele/anwendungsbeispiele.md#blattern-in-produktlisten)


## Related topics

- [Suche mit Suggest-Funktion](https://dokumentation.websale.de/v8s/suche/suche-mit-suggest-funktion.md)
- [Erweiterte Suche](https://dokumentation.websale.de/v8s/suche/erweiterte-suche.md)
- [Webcodes für Produkte anbieten](https://dokumentation.websale.de/v8s/suche/webcodes-fuer-produkte-anbieten.md)
- [FORM- (Formulare)](https://dokumentation.websale.de/v8s/referenz/tags/form-formulare.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.