ViewHelper Documentation
v:page.menu.browse
Page: Browse Menu ViewHelper
ViewHelper for rendering TYPO3 browse menus in Fluid
Renders links to browse inside a menu branch including
first, previous, next, last and up to the parent page.
Supports both automatic, tag-based rendering (which
defaults to ul > li
with options to set both the
parent and child tag names. When using manual rendering
a range of support CSS classes are available along
with each page record.
DEPRECATED: use v:menu.browse instead
Arguments
- class
- dir
- id
- lang
- style
- title
- accesskey
- tabindex
- onclick
- forceClosingTag
- hideIfEmpty
- contenteditable
- contextmenu
- draggable
- dropzone
- translate
- spellcheck
- hidden
- showAccessProtected
- classAccessProtected
- classAccessGranted
- useShortcutUid
- useShortcutTarget
- useShortcutData
- tagName
- tagNameChildren
- entryLevel
- levels
- expandAll
- classFirst
- classLast
- classActive
- classCurrent
- classHasSubpages
- substElementUid
- showHiddenInMenu
- showCurrent
- linkCurrent
- linkActive
- titleFields
- includeAnchorTitle
- includeSpacers
- deferred
- as
- rootLineAs
- excludePages
- forceAbsoluteUrl
- doktypes
- divider
- labelFirst
- labelLast
- labelPrevious
- labelNext
- labelUp
- renderFirst
- renderLast
- renderUp
- usePageTitles
- pageUid
- currentPageUid
class string
CSS class(es) for this element
dir string
Text direction for this HTML element. Allowed strings: "ltr" (left to right), "rtl" (right to left)
id string
Unique (in this file) identifier for this HTML element.
lang string
Language for this element. Use short names specified in RFC 1766
style string
Individual CSS styles for this element
title string
Tooltip text of element
accesskey string
Keyboard shortcut to access this element
tabindex integer
Specifies the tab order of this element
onclick string
JavaScript evaluated for the onclick event
forceClosingTag boolean
If TRUE, forces the created tag to use a closing tag. If FALSE, allows self-closing tags.
hideIfEmpty boolean
Hide the tag completely if there is no tag content
contenteditable string
Specifies whether the contents of the element are editable.
contextmenu string
The value of the id attribute on the menu with which to associate the element as a context menu.
draggable string
Specifies whether the element is draggable.
dropzone string
Specifies what types of content can be dropped on the element, and instructs the UA about which actions to take with content when it is dropped on the element.
translate string
Specifies whether an elements attribute values and contents of its children are to be translated when the page is localized, or whether to leave them unchanged.
spellcheck string
Specifies whether the element represents an element whose contents are subject to spell checking and grammar checking.
hidden string
Specifies that the element represents an element that is not yet, or is no longer, relevant.
showAccessProtected boolean
If TRUE links to access protected pages are always rendered regardless of user login status
classAccessProtected string
Optional class name to add to links which are access protected
classAccessGranted string
Optional class name to add to links which are access protected but access is actually granted
useShortcutUid boolean
If TRUE, substitutes the link UID of a shortcut with the target page UID (and thus avoiding redirects) but does not change other data - which is done by using useShortcutData.
useShortcutTarget boolean
Optional param for using shortcut target instead of shortcut itself for current link
useShortcutData boolean
Shortcut to set useShortcutTarget and useShortcutData simultaneously
tagName string
Tag name to use for enclosing container
tagNameChildren string
Tag name to use for child nodes surrounding links. If set to "a" enables non-wrapping mode.
entryLevel integer
Optional entryLevel TS equivalent of the menu
levels integer
Number of levels to render - setting this to a number higher than 1 (one) will expand menu items that are active, to a depth of $levels starting from $entryLevel
expandAll boolean
If TRUE and $levels > 1 then expands all (not just the active) menu items which have submenus
classFirst string
Optional class name for the first menu elment
classLast string
Optional class name for the last menu elment
classActive string
Optional class name to add to active links
classCurrent string
Optional class name to add to current link
classHasSubpages string
Optional class name to add to links which have subpages
substElementUid boolean
Optional parameter for wrapping the link with the uid of the page
showHiddenInMenu boolean
Include pages that are set to be hidden in menus
showCurrent boolean
If FALSE, does not display the current page
linkCurrent boolean
If FALSE, does not wrap the current page in a link
linkActive boolean
If FALSE, does not wrap with links the titles of pages that are active in the rootline
titleFields string
CSV list of fields to use as link label - default is "nav_title,title", change to for example "tx_myext_somefield,subtitle,nav_title,title". The first field that contains text will be used. Field value resolved AFTER page field overlays.
includeAnchorTitle boolean
If TRUE, includes the page title as title attribute on the anchor.
includeSpacers boolean
Wether or not to include menu spacers in the page select query
deferred boolean
If TRUE, does not output the tag content UNLESS a v:page.menu.deferred child ViewHelper is both used and triggered. This allows you to create advanced conditions while still using automatic rendering
as string
If used, stores the menu pages as an array in a variable named after this value and renders the tag content. If the tag content is empty automatic rendering is triggered.
rootLineAs string
If used, stores the menu root line as an array in a variable named according to this value and renders the tag content - which means automatic rendering is disabled if this attribute is used
excludePages anySimpleType
Page UIDs to exclude from the menu. Can be CSV, array or an object implementing Traversable.
forceAbsoluteUrl boolean
If TRUE, the menu will be rendered with absolute URLs
doktypes anySimpleType
DEPRECATED: Please use typical doktypes for starting points like shortcuts.
divider string
Optional divider to insert between each menu item. Note that this does not mix well with automatic rendering due to the use of an ul > li structure
labelFirst string
Label for the "first" link
labelLast string
Label for the "last" link
labelPrevious string
Label for the "previous" link
labelNext string
Label for the "next" link
labelUp string
Label for the "up" link
renderFirst boolean
If set to FALSE the "first" link will not be rendered
renderLast boolean
If set to FALSE the "last" link will not be rendered
renderUp boolean
If set to FALSE the "up" link will not be rendered
usePageTitles boolean
If set to TRUE, uses target page titles instead of "next", "previous" etc. labels
pageUid integer
Optional parent page UID to use as top level of menu. If unspecified, current page UID is used
currentPageUid integer
Optional page UID to use as current page. If unspecified, current page UID from globals is used