Skip to content
master
Switch branches/tags
Code
This branch is up to date with master.
Contribute

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
lib
 
 
 
 
 
 
 
 
 
 
 
 

Navigation Tags

Provides hierarchical tree navigation based on Radiant's site structure. Outputs navigation in the form of a -very flexible and CSS'able- unordered list. Also provides r:if_self and r:if_ancestor_or_self

Usage

<r:nav [root=“/”] [include_root=“true”] [depth=“2”] [expand_all=“true”] [ids_for_lis=“true”] />

Given this directory tree:

  • Home

    • About

      • Contact us

    • Blog

      • First Article

      • Second Article

    • Catalog

<r:nav depth=“2” /> would output a navigation list like:

<ul>

<li class="parent_of_current has_children"><a href="/about/">About</a>
  <ul>
    <li class="current"><a href="/about/contact">Contact Us</a></li>
  </ul>
</li>
<li class="has_children"><a href="/blog/">Blog</a></li>
<li class="has_children"><a href="/catalogue">Catalogue</a></li>

</ul>

Use only and except to filter which pages are included. The following would output a navigation list only containing only the pages articles, or notices, or their descendants, and which aren't css, javascript, or xml pages:

<r:nav only=“^/(articles|notices)/” except=“.(css|js|xml)/*$” />

Available tag attributes:

  • root defaults: to “/”, where to start building the navigation from, you can i.e. use “/products” to build a subnav

  • include_root: defaults to false, set to true to include the root page (i.e. Home)

  • ids_for_lis: defaults to false, enable this to give each li an id (it's slug prefixed with nav_)

  • ids_for_links: defaults to false, enable this to give each link an id (it's slug prefixed with nav_)

  • depth: defaults to 1, which means no sub-ul's, set to 2 or more for a nested list

  • expand_all: defaults to false, enable this to have all li's create sub-ul's of their children, i.o. only the currently active li

  • only: a string or regular expresssion. only pages whose urls match this are included

  • except: a string or regular expresssion. pages whose urls match this are not shown. except will override only. use to eliminate non-content file-types

  • id, class, monkeyballs, … will be used as html attributes for the ul

CREDITS

  • Ryan Heneise

  • Marty Haught

  • Benny Degezelle

  • Arthur Gunn

About

Radiant Extension - navigation_tags

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages