# bx:containersearch

Das Tag `containersearch` gibt eine Liste von Containerdatensätzen aus, die einem Suchergebnis in diesem Container entspricht. In der Liste sind nur aktive Datensätze enthalten.

```xml
<!-- Listenseite -->
<bx:containersearch pool="{id}" fields="{felder}" [indexparam="{param}"] [searchparam="{param}"] max="{n}" [listall]  [orderby="{feld}"] [desc]>
  Inhalt
</bx:containersearch>
 
<!-- Detailseite -->
<bx:containersearch pool="{id}" fields="{felder}" [searchparam="{param}"] max="{n}" [listall] [singleidname="{param}"] [orderby="{feld}"] [desc]>
  Inhalt
</bx:containersearch>
```
Erklärungstext.

### pool
ID des Containers

### fields
die zu durchsuchenden Felder (durch Komma getrennt)

### indexparam
Parameter, der den aktuellen Index hält (Standard: `searchidx`)

### searchparam
gesuchter String (Standard: `search`)

### max
maximale Anzahl an angezeigten Elementen

### listall
Falls kein Suchbegriff angegeben wurde, wird nichts angezeigt, außer `listall` ist gesetzt

### singleidname
Detailseite: Parameter, in dem die DS-ID steht

### orderby
Feld, nach dem die Liste sortiert wird (Standard: nach Relevanz)

### desc
kehrt Sortierung um

### Beispiele

Beispiel für eine Listen-/Detailseite mit einer Suche im Container

**Listenseite**

```xml
<form action="index.htm" method="post">
  <input type="text" name="suchbegriff" value="<bx:pagedata.request name="suchbegriff"/>">
  <input type="submit" value="suchen">
</form>

<bx:containersearch.News pool="139439682C3" fields="Titel,Anmoderation,Text" indexparam="seite" searchparam="suchbegriff" max="2" listall  orderby="Titel">
  <a href="detail.htm?detail=<bx:recorddata.id/>"><bx:recordfield.Titel/></a> - Ranking: <bx:containersearch.rank/><br>
</bx:containersearch.News>

<bx:recorddata.nav object="News">
  <bx:recorddata.previouslist/> | <bx:recorddata.nextlist/>
</bx:recorddata.nav>
```
Der Container wird komplett gelistet, wenn kein Suchbegriff angegeben wurde. Wenn doch, dann wird in den Feldern Titel, Anmoderation und Text nach diesem Wort gesucht.

**Detailseite**

```xml
<bx:containersearch.News pool="139439682C3" fields="Titel,Anmoderation,Text" singleidname="detail" searchparam="suchbegriff" max="2" listall  orderby="Titel">
  <h1><bx:recordfield.Titel/></h1>
  <em><bx:recordfield.Anmoderation/></em><br>
  <bx:recordfield.Text/>
</bx:containersearch.News>

<a href="index.htm?seite=<bx:pagedata.request name="seite"/>">zurück</a>
```
Angabe von `singleidname`, damit der richtige Datensatz angezeigt wird. Der Zurück-Knopf enthält die Seite, die auf der Listenseite wiederum durch den Parameter `indexparam` gefunden wird.

## containersearch.rank

```xml
<bx:containersearch.rank/>
```
Innerhalb der obigen Schleife gibt dieses Tag den Rang des aktuellen Suchergebnisses zurück.

## containersearch.relevanz

```xml
<bx:containersearch.relevanz/>
```
Dieses Tag gibt innerhalb der Suchschleife die Relevanz des aktuellen Ergebnisses aus.