Merge abecbba into 7366953

docs/index.rst

@@ -72,6 +72,14 @@ The pre-defined html attributes is available too::
         {% endfor %}
     </ul>
 
+You can also have direct access to the current active item:
+
+
+.. code-block:: html+jinja
+
+    <h2>{{ nav.top.current_item.label }}</h2>
+
+
 API
 ---
 

flask_navigation/navbar.py

@@ -35,3 +35,11 @@ def alias_item(self, alias):
         """Gets an item by its alias."""
         ident = self.alias[alias]
         return self.items[ident]
+
+    @property
+    def current_item(self):
+        '''Get the current active navigation Item if any'''
+        for item in self:
+            if item.is_active:
+                return item
+        return None

tests/test_api.py

@@ -54,3 +54,28 @@ def biu():
     with app.test_client() as c:
         url = c.get('/')
         assert url.data == b'/biu/42'
+
+
+def test_current_item():
+    app = Flask(__name__)
+
+    nav = Navigation()
+    nav.init_app(app)
+    news_item = Item(u'News', 'news')
+    navbar = nav.Bar('test_current', [
+        Item(u'Home', 'home'),
+        news_item,
+    ])
+
+    @app.route('/')
+    def home():
+        pass
+
+    @app.route('/news')
+    def news():
+        pass
+
+    assert navbar.current_item is None
+
+    with app.test_request_context('/news'):
+        assert navbar.current_item == news_item