Fix #2482: partially collapse packages with too many members

Author: felixmulder

doc-tool/resources/_includes/sidebar.html

@@ -20,7 +20,16 @@ <h1><a class="entity-name" href="{{ site.baseurl }}/api/{{ pkg.path | join: "/"
             {% for member in pkg.children %}
                 {% if member.kind == "object" and member.hasCompanion %}
                 {% elsif member.kind != "package" %}
+
+                {% if forloop.index == 6 and forloop.length > 7 %}
+                <li id="show-hidden-by-default" onclick="toggleHiddenByDefault(this);">+ expand rest</li>
+                <li class="hidden-by-default {% if member.hasCompanion %} with-companion {% endif %}">
+                {% elsif forloop.index > 6 and forloop.length > 7 %}
+                <li class="hidden-by-default {% if member.hasCompanion %} with-companion {% endif %}">
+                {% else %}
                 <li class="{% if member.hasCompanion %} with-companion {% endif %}">
+                {% endif %}<!-- end li setter -->
+
                     <div class="entity-kinds">
                         {% if member.hasCompanion %}
                         <a class="letter-anchor object" href="{{ site.baseurl }}/api/{{ member.companionPath | join: "/" }}.html">O</a>
@@ -29,10 +38,28 @@ <h1><a class="entity-name" href="{{ site.baseurl }}/api/{{ pkg.path | join: "/"
                     </div>
                     <a class="entity-name" href="{{ site.baseurl }}/api/{{ member.path | join: "/" }}.html">{{ member.name }}</a>
                 </li>
+
+                {% if forloop.last and forloop.index > 6 %}
+                <li id="hide-hidden-by-default" onclick="toggleHiddenByDefault(this);">- collapse members</li>
                 {% endif %}
+
+                {% endif %} <!-- end != "package" -->
+
             {% endfor %}
             </ul>
         </li>
     {% endfor %}
     </ul>
 </div>
+<script>
+    function toggleHiddenByDefault(li) {
+        var ul = li.parentElement;
+
+        for (var i = 0; i < ul.children.length; i++) {
+            var childLi = ul.children[i];
+            if (childLi.classList.contains('hidden-by-default') || childLi.id == "hide-hidden-by-default" || childLi.id == "show-hidden-by-default") {
+                childLi.classList.toggle('toggled');
+            }
+        }
+    }
+</script>

doc-tool/resources/css/sidebar.css

@@ -10,6 +10,7 @@ div#content-wrapper div.index-wrapper {
     font-family: "Titillium Web", sans-serif;
     font-weight: 200;
     padding-left: 14px;
+    padding-bottom: 75px;
 }
 
 /** Mobile (x < 576px) sidebar: Defaults closed with 60% wide sidebar */
@@ -133,6 +134,30 @@ li.entity-package > ul.package-entities > li {
     transition: all 0.2s ease;
 }
 
+li.entity-package > ul.package-entities > li#hide-hidden-by-default,
+li.entity-package > ul.package-entities > li#show-hidden-by-default {
+  margin-left: 0;
+  color: #ff4081;
+  font-size: 13px;
+}
+
+li.entity-package > ul.package-entities > li#hide-hidden-by-default:hover,
+li.entity-package > ul.package-entities > li#show-hidden-by-default:hover {
+  cursor: pointer;
+}
+
+li.entity-package > ul.package-entities > li#show-hidden-by-default,
+li.entity-package > ul.package-entities > li#hide-hidden-by-default.toggled,
+li.entity-package > ul.package-entities > li.hidden-by-default.toggled {
+  display: block;
+}
+
+li.entity-package > ul.package-entities > li.hidden-by-default,
+li.entity-package > ul.package-entities > li#show-hidden-by-default.toggled,
+li.entity-package > ul.package-entities > li#hide-hidden-by-default {
+  display: none;
+}
+
 li.entity-package > ul.package-entities > li.with-companion {
   margin-left: -92px;
 }