en:public:developer:template_system:tags:navigation:tbreadcrumbs
Differences
This shows you the differences between two versions of the page.
|
en:public:developer:template_system:tags:navigation:tbreadcrumbs [2013/04/25 00:15] svanderclock removed |
— (current) | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ===== <#TBreadcrumbs> ===== | ||
| - | This tag permit to construct a Breadcrumbs. It is a navigation aid used in user interfaces, it allows users to keep track of their locations within programs or documents. The term comes from the trail of breadcrumbs left by Hansel and Gretel in the popular fairytale. | ||
| - | |||
| - | {{:horizontalmenu.jpg|}} | ||
| - | |||
| - | ==== Parameters ==== | ||
| - | |||
| - | * **template_container** - The main template that will contain all the items. default value is | ||
| - | |||
| - | <code> | ||
| - | <#breadcrumbs_items.text> | ||
| - | </code> | ||
| - | |||
| - | * **template_item** - the template of one item. Default value is | ||
| - | |||
| - | <code> | ||
| - | |||
| - | <#if condition="(<#breadcrumbs_current_item.index> >= 1)">> <#endif> | ||
| - | <#if condition="(<#breadcrumbs_current_item.index> < <#breadcrumbs_items.count> - 1)"><a href="<#breadcrumbs_current_item.url>"><#endif> | ||
| - | <#breadcrumbs_current_item.title> | ||
| - | <#if condition="(<#breadcrumbs_current_item.index> < <#breadcrumbs_items.count> - 1)"></a> <#endif> | ||
| - | |||
| - | </code> | ||
| - | |||
| - | |||
| - | ==== cfgpages configuration ==== | ||
| - | |||
| - | The breadcrumps is build like an hierarchical site structures (the parent pages of the current one). this hierarchical site structures is taken from the [[en:public:developer:template_system:cfgpages]]. if for exemple the [[en:public:developer:template_system:cfgpages]] contain the nodes | ||
| - | |||
| - | <code xml> | ||
| - | <page name='/'> | ||
| - | <page name='real-estate'> | ||
| - | <page name='residential'> | ||
| - | <page name='holiday-rentals' /> | ||
| - | </page> | ||
| - | </page> | ||
| - | </page> | ||
| - | </code> | ||
| - | |||
| - | then the breadcrumps on the page /real-estate/residential/holiday-rentals/ will be "Home > Real Estate > Residential > Holiday rentals" | ||
| - | |||
| - | Each <page> nodes in the [[en:public:developer:template_system:cfgpages]] xml file must also contains in their <cfg> child node one <breadcrumbs> node that contain the neccessary params to build the breadcrumps | ||
| - | |||
| - | <code xml> | ||
| - | <page name="..."> | ||
| - | <cfg> | ||
| - | ... | ||
| - | <breadcrumbs> | ||
| - | <visible>1</visible> | ||
| - | <expend_after_geoplace>1</expend_after_geoplace> | ||
| - | <title>REAL ESTATE</title> | ||
| - | </breadcrumbs> | ||
| - | <title>Real Estate</title> | ||
| - | ... | ||
| - | </cfg> | ||
| - | </page> | ||
| - | </code> | ||
| - | |||
| - | * **<visible>** - 1 or 0 (default): used to say if the current node must be show in the Breadcrumps | ||
| - | * **<expend_after_geoplace>** - 1 or 0 (default): Insert after the current node the geo place items (ie: > United States > Illinois > Cook > Chicago > Near North Side in our exemple) | ||
| - | * **<title>** - Used for the title of the current node. by default it's taken from cfg.breadcrumbs.title and if empty them from cfg.title | ||
| - | ==== Example ==== | ||
| - | |||
| - | <code html> | ||
| - | |||
| - | <#{breadcrumbs> | ||
| - | <#{template> | ||
| - | <#{htmlbox template="box_14_2.html"> | ||
| - | |||
| - | <#{box_title><#page_title xmlencode=1><#}box_title> | ||
| - | |||
| - | <#{box_content> | ||
| - | <#for var="i" from="0" to="<#breadcrumbs.count> - 1"> | ||
| - | <#if condition="(<#i> >= 1)">><#endif> | ||
| - | <#if condition="(<#i> < <#breadcrumbs.count> - 1)"><a href="<#breadcrumbs[<#i>].url xmlencode=1>"><#endif> | ||
| - | <#breadcrumbs[<#i>].title xmlencode=1> | ||
| - | <#if condition="(<#i> < <#breadcrumbs.count> - 1)"></a><#endif> | ||
| - | <#Endfor> | ||
| - | <#}box_content> | ||
| - | |||
| - | <#}htmlbox> | ||
| - | |||
| - | <#}template> | ||
| - | |||
| - | <#}breadcrumbs> | ||
| - | |||
| - | </code> | ||
en/public/developer/template_system/tags/navigation/tbreadcrumbs.1366834554.txt.gz ยท Last modified: 2013/04/25 00:15 by svanderclock
Page Tools
Except where otherwise noted, content on this wiki is licensed under the following license: GNU Free Documentation License 1.3
