diff --git a/developer_manual/design/index.rst b/developer_manual/design/index.rst index 800af24fa..dc48991e7 100644 --- a/developer_manual/design/index.rst +++ b/developer_manual/design/index.rst @@ -6,3 +6,4 @@ Design Guidelines :maxdepth: 2 navigation + popovermenu diff --git a/developer_manual/design/popovermenu.rst b/developer_manual/design/popovermenu.rst new file mode 100644 index 000000000..da886e5a7 --- /dev/null +++ b/developer_manual/design/popovermenu.rst @@ -0,0 +1,66 @@ +.. sectionauthor:: John Molakvoæ +.. codeauthor:: John Molakvoæ + +=============== +Popover Menu +=============== + +What is a popover menu +======================= + +This is a quick menu that open on click. We're usually using the three dots icons on nextcloud. +This menu currently differs from the navigation menu on the app-navigation section on the left. We should definitely merge those two and make one single way to create a popover menu on nextcloud (see app-navigation-entry-menu class on css files) + +.. image:: ../images/popovermenu.png + +Basic layout +============= + +.. code-block:: html + +
+
+ +Technical details +================== + +* The only allowed menu items elements are **a** and **button**. +* You can mix between a and button on the same menu (in case of form or direct link) like the example above +* You need to put the entire menu just after the three dot icon ``
...
`` +* You do not need js, css only is ok for positioning. Js is **still** required to handle the hide/show. +* Only **one** ul is allowed. +* Only **one level** of menu is allowed. +* Every entry **needs** to have its own icon. This greatly improves the UX. +* The required **right** distance to the border (or padding, whatever you want to use) of the three-dot icon should be 14px (5 for menu margin and 6 for arrow position) + +.. image:: ../images/popover-position.png + +Alignment +========== +If you want to align your menu, you can add the class to the main popovermenu div. + +* Center: ``menu-center`` +* Left: ``menu-left`` +* Right is by default diff --git a/developer_manual/images/popover-position.png b/developer_manual/images/popover-position.png new file mode 100644 index 000000000..2002ccaea Binary files /dev/null and b/developer_manual/images/popover-position.png differ diff --git a/developer_manual/images/popovermenu.png b/developer_manual/images/popovermenu.png new file mode 100644 index 000000000..bc5cc61de Binary files /dev/null and b/developer_manual/images/popovermenu.png differ