From fca9162f02f997e327ca3a6cf6d9a17f9c903d6f Mon Sep 17 00:00:00 2001
From: Alicia Sykes <sykes.alicia@gmail.com>
Date: Wed, 2 Jun 2021 19:06:28 +0100
Subject: [PATCH] Adds option for a section to have an icon

---
 README.md                                |   1 +
 public/conf.yml                          |   1 +
 src/components/LinkItems/Collapsable.vue | 185 ++++++++++++-----------
 src/components/LinkItems/ItemGroup.vue   |   2 +
 src/styles/color-themes.scss             |   3 +-
 src/views/Home.vue                       |   1 +
 6 files changed, 102 insertions(+), 91 deletions(-)

diff --git a/README.md b/README.md
index 8fce76b0..6b1d17f9 100644
--- a/README.md
+++ b/README.md
@@ -105,6 +105,7 @@ All fields are optional, unless otherwise stated.
 **`section`**
 - `name` - String: (required) The title of that section
 - `items` - Item[]: (required) An array of items - _See **`item`** below_
+- `icon` - String: (optional) An single icon to be displayed next to the title _See **`icon`** below_
 - `displayData`: An object with the following fields (all optional)
   - `collapsed` - Boolean: If true, the section will  be collapsed initially (defaults to `false`) 
   - `color` - String: A custom accent color for the section, as a hex code or HTML color (e.g. `#fff`)
diff --git a/public/conf.yml b/public/conf.yml
index 99c1cd80..3f500182 100644
--- a/public/conf.yml
+++ b/public/conf.yml
@@ -13,6 +13,7 @@ appConfig:
   fontAwesomeKey: 0821c65656
 sections:
 - name: Getting Started
+  icon: fab fa-github
   items:
   - title: Source
     description: Source code and documentation on GitHub
diff --git a/src/components/LinkItems/Collapsable.vue b/src/components/LinkItems/Collapsable.vue
index 8878cbf0..e67b0042 100644
--- a/src/components/LinkItems/Collapsable.vue
+++ b/src/components/LinkItems/Collapsable.vue
@@ -11,6 +11,7 @@
         tabIndex="-1"
     >
     <label :for="`collapsible-${uniqueKey}`" class="lbl-toggle" tabindex="-1">
+      <Icon v-if="icon" :icon="icon" size="small" class="section-icon" />
       <h3>{{ title }}</h3>
     </label>
     <div class="collapsible-content">
@@ -24,18 +25,23 @@
 <script>
 
 import { localStorageKeys } from '@/utils/defaults';
+import Icon from '@/components/LinkItems/ItemIcon.vue';
 
 export default {
   name: 'CollapsableContainer',
   props: {
     uniqueKey: String,
     title: String,
+    icon: String,
     collapsed: Boolean,
     cols: Number,
     rows: Number,
     color: String,
     customStyles: String,
   },
+  components: {
+    Icon,
+  },
   data() {
     return {
       isOpen: !this.collapsed,
@@ -96,105 +102,104 @@ export default {
 @import '@/styles/media-queries.scss';
 
 .collapsable {
-    padding: var(--item-group-padding);
-    margin: 10px;
+  padding: var(--item-group-padding);
+  margin: 10px;
+  border-radius: var(--curve-factor);
+  background: var(--item-group-outer-background);
+  box-shadow: var(--item-group-shadow);
+  height: fit-content;
+  width: 100%;
+  width: stretch;
+
+  grid-row-start: span 1;
+  &.row-2 { grid-row-start: span 2; }
+  &.row-3 { grid-row-start: span 3; }
+  &.row-4 { grid-row-start: span 4; }
+
+  grid-column-start: span 1;
+  @include tablet-up {
+    &.col-2 { grid-column-start: span 2; }
+    &.col-3 { grid-column-start: span 2; }
+    &.col-4 { grid-column-start: span 2; }
+  }
+  @include laptop-up {
+    &.col-2 { grid-column-start: span 2; }
+    &.col-3 { grid-column-start: span 3; }
+    &.col-4 { grid-column-start: span 3; }
+  }
+  @include monitor-up {
+    &.col-2 { grid-column-start: span 2; }
+    &.col-3 { grid-column-start: span 3; }
+    &.col-4 { grid-column-start: span 4; }
+  }
+
+  .wrap-collabsible {
+    margin-bottom: 1.2rem 0;
+  }
+
+  input[type='checkbox'] {
+    display: none;
+  }
+
+  label.lbl-toggle {
+    outline: none;
+    display: block;
+    padding: 0.25rem;
+    cursor: pointer;
     border-radius: var(--curve-factor);
-    background: var(--item-group-outer-background);
-    box-shadow: var(--item-group-shadow);
-    height: fit-content;
-    width: 100%;
-    width: stretch;
-
-    grid-row-start: span 1;
-    &.row-2 { grid-row-start: span 2; }
-    &.row-3 { grid-row-start: span 3; }
-    &.row-4 { grid-row-start: span 4; }
-
-    grid-column-start: span 1;
-    @include tablet-up {
-      &.col-2 { grid-column-start: span 2; }
-      &.col-3 { grid-column-start: span 2; }
-      &.col-4 { grid-column-start: span 2; }
+    transition: all 0.25s ease-out;
+    text-align: left;
+    color: var(--item-group-heading-text-color); //var(--item-group-background);
+    h3 {
+      margin: 0;
+      padding: 0;
+      display: inline;
     }
-    @include laptop-up {
-      &.col-2 { grid-column-start: span 2; }
-      &.col-3 { grid-column-start: span 3; }
-      &.col-4 { grid-column-start: span 3; }
-    }
-    @include monitor-up {
-      &.col-2 { grid-column-start: span 2; }
-      &.col-3 { grid-column-start: span 3; }
-      &.col-4 { grid-column-start: span 4; }
+    .section-icon {
+      display: inline;
+      margin-right: 0.5rem;
     }
+  }
 
-    .wrap-collabsible {
-        margin-bottom: 1.2rem 0;
-    }
+  .lbl-toggle:hover {
+    color: var(--item-group-heading-text-color-hover);
+  }
 
-    input[type='checkbox'] {
-        display: none;
-    }
+  .lbl-toggle::before {
+    content: ' ';
+    display: inline-block;
+    border-top: 5px solid transparent;
+    border-bottom: 5px solid transparent;
+    border-left: 5px solid currentColor;
+    vertical-align: middle;
+    margin-right: .7rem;
+    transform: translateY(-2px);
+    transition: transform .2s ease-out;
+  }
 
-    label {
-        outline: none;
-    }
+  .toggle:checked + .lbl-toggle::before {
+    transform: rotate(90deg) translateX(-3px);
+  }
 
-    .lbl-toggle {
-        display: block;
-        padding: 0.25rem;
-        cursor: pointer;
-        border-radius: var(--curve-factor);
-        transition: all 0.25s ease-out;
-        text-align: left;
-        color: var(--item-group-heading-text-color); //var(--item-group-background);
+  .collapsible-content {
+    max-height: 0px;
+    overflow: hidden;
+    transition: max-height .25s ease-in-out;
+    background: var(--item-group-background);
+    border-radius: 0 0 var(--curve-factor) var(--curve-factor);
+  }
 
-        h3 {
-            margin: 0;
-            padding: 0;
-            display: inline;
-        }
-    }
+  .toggle:checked + .lbl-toggle + .collapsible-content {
+    max-height: 3000px;
+  }
 
-    .lbl-toggle:hover {
-        color: var(--item-group-heading-text-color-hover);
-    }
+  .toggle:checked + .lbl-toggle {
+    border-bottom-right-radius: 0;
+    border-bottom-left-radius: 0;
+  }
 
-    .lbl-toggle::before {
-        content: ' ';
-        display: inline-block;
-        border-top: 5px solid transparent;
-        border-bottom: 5px solid transparent;
-        border-left: 5px solid currentColor;
-        vertical-align: middle;
-        margin-right: .7rem;
-        transform: translateY(-2px);
-
-        transition: transform .2s ease-out;
-    }
-
-    .toggle:checked + .lbl-toggle::before {
-        transform: rotate(90deg) translateX(-3px);
-    }
-
-    .collapsible-content {
-        max-height: 0px;
-        overflow: hidden;
-        transition: max-height .25s ease-in-out;
-        background: var(--item-group-background);
-        border-radius: 0 0 var(--curve-factor) var(--curve-factor);
-    }
-
-    .toggle:checked + .lbl-toggle + .collapsible-content {
-        max-height: 3000px;
-    }
-
-    .toggle:checked + .lbl-toggle {
-        border-bottom-right-radius: 0;
-        border-bottom-left-radius: 0;
-    }
-
-    .collapsible-content .content-inner {
-        padding: 0.5rem;
-    }
+  .collapsible-content .content-inner {
+    padding: 0.5rem;
+  }
 }
 </style>
diff --git a/src/components/LinkItems/ItemGroup.vue b/src/components/LinkItems/ItemGroup.vue
index 45f1044b..ef3dba8c 100644
--- a/src/components/LinkItems/ItemGroup.vue
+++ b/src/components/LinkItems/ItemGroup.vue
@@ -1,6 +1,7 @@
 <template>
    <Collapsable
     :title="title"
+    :icon="icon"
     :uniqueKey="groupId"
     :collapsed="displayData.collapsed"
     :cols="displayData.cols"
@@ -51,6 +52,7 @@ export default {
   props: {
     groupId: String,
     title: String,
+    icon: String,
     displayData: Object,
     items: Array,
     itemSize: String,
diff --git a/src/styles/color-themes.scss b/src/styles/color-themes.scss
index 2f326aed..6b43e8da 100644
--- a/src/styles/color-themes.scss
+++ b/src/styles/color-themes.scss
@@ -551,10 +551,11 @@ html[data-theme='minimal-dark'] {
   --search-container-background: #14171e;
   --curve-factor: 4px;
   --curve-factor-navbar: 8px;
+  --item-group-heading-text-color: #fff;
+  --item-group-heading-text-color-hover: #ffffffbf;
 
   label.lbl-toggle h3 {
     font-size: 1.8rem;
-    color: #fff;
   }
 
   section.filter-container {
diff --git a/src/views/Home.vue b/src/views/Home.vue
index be17bc8a..dc4160ea 100644
--- a/src/views/Home.vue
+++ b/src/views/Home.vue
@@ -22,6 +22,7 @@
         v-for="(section, index) in getSections(sections)"
         :key="index"
         :title="section.name"
+        :icon="section.icon || undefined"
         :displayData="getDisplayData(section)"
         :groupId="`section-${index}`"
         :items="filterTiles(section.items)"