===== rootLine =====

Die **rootLine** ist der Weg von der aktuellen Unterseite zur //root//-Seite. Das Prinzip der rootLine wird an verschiedenen Stellen angewendet: [[typo3:about:menu#rootline|Menüs]], [[typo3:about:datentypen#gettext-typen|getText]], [[typo3:about:conditions#conditionsbeispiele|Conditions]]. Positive Werte zählen dabei die Ebenen unterhalb von root. Negative Werte zählen rückwärts von der aktuell gewählten Ebene, wobei -1 die aktuelle Ebene selbst ist. 0 ist //root//.

  * -1 -> die aktuell gewählte Ebene
  * -2 -> eine Ebene über der gewählten
  * -3 -> zwei Ebenen über der gewählten
  * etc.
  * 0 -> root-Ebene
  * 1 -> erste Ebene unterhalb von root
  * 2 -> zweite ebene unterhalb von root
  * etc.

<code>
// Beispiel einer Breadcrumb-Navigation:
// Die Seite auf Ebene 6 ist gewählt.

  -6    -5  -4  -3  -2  -1           negative Werte
  |     |   |   |   |   |
root (Ebene 1)  |   |   |
  |     |   |   |   |   |
  |---- Ebene 2 |   |   |
  |-----|-- Ebene 3 |   |
  |-----|---|-- Ebene 4 |
  |-----|---|---|-- Ebene 5
  |-----|---|---|---|-- Ebene 6      <- aktuell gewählte Seite
  |-----|---|---|---|---|-- Ebene 7
  0     1   2   3   4   5   6        positive Werte
</code>

Teilweise können mithilfe der //range//-Eigenschaft zwei Werte angegeben werden. Hiermit kann ein Start- und Endpunkt definiert werden, um z.B. eine Brotkrumen-Navigation zu beschränken. ''1|-1'' würde mit der ersten Ebene unterhalb von //root// beginnen und mit der aktuell gewählten Ebene enden.

==== addRootLineFields ====

Mit [[typo3:about:datentypen#gettext-typen|levelfield]] können beliebige Felder der Datenbanktabelle //pages// entlang der rootLine ausgelesen werden. In der Grundkonfiguration sind nicht alle Felder im entsprechenden Array //%%$GLOBALS['TSFE']->rootLine%%// hinterlegt. Um weitere hinzuzufügen, müssen diese im //Install Tool// unter ''[addRootLineFields]'' eingetragen werden. Die aktuell verfügbaren Felder können mit ''data = debug:rootLine'' ausgegeben werden.