Menu
====

Base class: `MenuBase`

Class that describes menus.

Example:

.. code-block:: python

    menu = Menu(
        sub_menu=dict(
            root=MenuItem(url='/'),

            albums=MenuItem(url='/albums/'),

            # url defaults to /<name>/ so we
            # don't need to write /musicians/ here
            musicians=MenuItem(),
        ),
    )

Refinable members
-----------------


* `after`       (:ref:`evaluated <evaluate>`)
    Type: `Union[int, str]`


* `assets`
    Type: `Namespace`


* `attrs`       (:ref:`evaluated <evaluate>`)
    Type: :doc:`Attrs`


* `endpoints`
    Type: `Namespace`


* `extra`
    Type: `Dict[str, Any]`


* `extra_evaluated`
    Type: `Dict[str, Any]`


* `extra_params`

* `include`       (:ref:`evaluated <evaluate>`)
    Type: `bool`


* `iommi_style`
    Type: `str`


* `items_container`

* `sort`       (:ref:`evaluated <evaluate>`)
    Type: `bool`

    Default: `False`

* `sub_menu`
    Type: `Dict`


* `tag`       (:ref:`evaluated <evaluate>`)
    Type: `str`


* `template`       (:ref:`evaluated <evaluate>`)
    Type: `Union[str, iommi._web_compat.Template]`


Methods
-------

`on_bind`
^^^^^^^^^

`own_evaluate_parameters`
^^^^^^^^^^^^^^^^^^^^^^^^^

`set_active`
^^^^^^^^^^^^

`validate`
^^^^^^^^^^