# Webflow exports & changelog




## 2021-24-06 - App preview removal

{% file src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-McwYRcLaJjenAxsmVVc%2F-McwYcnaMRZLY6lYGv3E%2Fcitizen-engagement-app.webflow%20(remove-app-preview-in-header%20-%2006242021).zip?alt=media&token=a2eb52f2-e733-4637-ab00-1f0cc5909f42" %}
Webflow export
{% endfile %}

#### Changed:

* Removed the app preview subtitle from the header nav.

<div align="left"><img src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-McwYRcLaJjenAxsmVVc%2F-McwYmcPufI09eoBV2yI%2Fimage.png?alt=media&#x26;token=5be87583-ae3d-4828-8974-bc3879ea2e59" alt=""></div>

## 2021-24-05 - richtext-image update

{% file src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MaS3mlw0oiZrMidyZXz%2F-MaS4I-OOZWRZBNsxPw1%2Fcitizen-engagement-app.webflow%20(richtext-image%20-%2005242021).zip?alt=media&token=4b215371-53c1-4efd-b3b4-05c5450ac3f5" %}

#### Changed:

* Added `.richtext-image` to the export
* Removed the reliance on a combo class for `.richtext-image`.
* Updated documentation to reflect this change

<div align="left"><img src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MaS3mlw0oiZrMidyZXz%2F-MaS4a0u7PR6oWE6BS4S%2Fimage.png?alt=media&#x26;token=cca35a59-24b3-495d-8945-57e96924f370" alt=""></div>

## 2021-19-05 - image--richtext addition

{% file src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-Ma2GfalwbVnEH6ozbVu%2F-Ma2GxZ8sxMUlvwma6BW%2Fcitizen-engagement-app.webflow%20(image--richtext%20-%2005192021).zip?alt=media&token=68d6b683-9dbe-4465-942b-f39a7551c2c6" %}
Webflow export
{% endfile %}

#### Added:

* Added .image--richtext to the documentation and component library.&#x20;
  * This class adds "height: auto;" to the .image class

{% hint style="info" %}
This may not be the best way to implement this feature. Based on dev feedback, we may be able to add "height: auto;" to the base .image class to make this class unnecessary. Please advise on this.&#x20;
{% endhint %}



## 2021-07-05 - Logo loading and button wrapping

{% file src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-M_53X9VPgl3v5vN6tMC%2F-M_53gKGtDtqyAPGxMqp%2Fcitizen-engagement-app.webflow%20(button-wrapping-logo-load%20-%2005072021).zip?alt=media&token=bd218381-0e34-431c-b924-8a3eb5e26c00" %}
Webflow export
{% endfile %}

#### Changed:

* Set the loading behavior on `.nav-menu__logo` to "eager" so that it loads with the page rather than when it becomes visible.
* Removed max-height on `.card.action-block` so that the label does not extend outside the button.

{% hint style="warning" %}
Please note that the changing of this max height will mean that we need to be careful about the length of button labels. They will grow to be as long as the label is and might cause UI/UX issues if not vetted. **Err on the side of short descriptive labels.**&#x20;
{% endhint %}

<div align="left"><img src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-M_53X9VPgl3v5vN6tMC%2F-M_53whVU3zcL18vIPzP%2Fimage.png?alt=media&#x26;token=479117a6-38ba-414c-8dd4-b7db96f8ccb0" alt=""></div>

## 2021-04-21 - Form items and fontawesome removal

{% file src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MYnBaj863YoSeGB8HbE%2F-MYoA8xqAx2gLDXw0CWl%2Fcitizen-engagement-app.webflow%20(04212021-form-items-fontawesome-removal).zip?alt=media&token=cab5fb31-4231-4e9f-b6e4-ac5f9b20c5f3" %}
Webflow export
{% endfile %}

{% hint style="info" %}
Feature preview: [https://citizen-engagement-app.webflow.io/feature-previews/feature-preview-service-requests](https://citizen-engagement-app.webflow.io/feature-previews/feature-preview-service-requests)
{% endhint %}

#### Changed:

* Removed label from `.form___input-block--large-field` (these labels must now be added manually above this component)
* Removed font awesome fonts from the site. Now only icons created using the class approach will work. If you run into any issues with old styling that relied on the fonts, please let me know.

#### Added:

* Added .upload-images component to the component library as well as the documentation (see images)

<div align="left"><img src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MYnBaj863YoSeGB8HbE%2F-MYnPXcmTgHlIznV-Q8R%2Fimage.png?alt=media&#x26;token=d06801ac-6a4d-4ee5-beb9-5ea0d153ca50" alt="Preview of the .upload-images component"></div>

<div align="left"><img src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MYnBaj863YoSeGB8HbE%2F-MYnF21s358xUX2YgKh4%2Fimage.png?alt=media&#x26;token=f2dc177a-f61c-4219-96de-c8362970868e" alt="upload-images component structure"></div>

* Added `.form__field-label` to the documentation and component library. This `.form__field-label` (if duplicated from the component library) will have the `<label>` tag.&#x20;
* Added `.form__location-picker_expand` to the component library and documentation. This allows for the map location picker to be hidden by default and then expanded on request from the user. See the documentation for more information.

<div align="left"><img src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MYnBaj863YoSeGB8HbE%2F-MYnLOTHznvIEqmUs_c2%2Fimage.png?alt=media&#x26;token=1af0586e-b712-4a5b-8394-ccb05868c755" alt="Documentation of the .form__field-label"></div>

{% hint style="warning" %}
Please stop using the `.label` component that is currently in the component library. Use the `.form__field-label` instead
{% endhint %}

## 2021-04-08 - Remove location and pre-wrap paragraph

{% file src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MXfdYOvFqM-xAWtaJqZ%2F-MXk6kPe5MiP4PkU81Dg%2Fcitizen-engagement-app.webflow%20(pre-wrap-remove-location%20-%2004082021).zip?alt=media&token=c3cf129f-b0c8-4dc0-bc78-0e6c59609149" %}
Pre-wrap and remove location
{% endfile %}

### Fixed:

* Removed the dummy map from `.map-container`

### Added:

* Added `.paragraph--prewrap` to the component library based on this user story [https://trello.com/c/Oyubdn55](https://trello.com/c/Oyubdn55)
* Added `.map-remove-location` to the `.location-picker` component and documented it in the documentation here: [https://citizen-engagement-app.webflow.io/documentation#maps](https://citizen-engagement-app.webflow.io/documentation#maps)
* Added a `.map-loading` item to the `.map-container` which should be hidden once the map is loaded.

<div align="left"><img src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MXfdYOvFqM-xAWtaJqZ%2F-MXk7RHSgPUbxlxoYMS9%2Fimage.png?alt=media&#x26;token=4612b8b1-1e35-4d4e-a175-abf83f41e5cf" alt=""></div>



## 2021-04-06 - Tab Content Fix

{% file src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MXaP_mT25teh0dxcbaY%2F-MXeje9_fy_iPkTPP0m2%2Fcitizen-engagement-app.webflow%20(tab-content-fix%20-%2004072021).zip?alt=media&token=4db05223-5bfd-4d8e-b1c6-e9437ab29ee4" %}
Tab content fix
{% endfile %}

### Fixed:

* Added elements to ensure the export html represents the structure outlined by Jaron

```
<div class="tab-contents__wrap">
  <div class="tab-content scroll">
    <div class="grid--default"></div>
  </div>
</div>
```

<div align="left"><img src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MXaP_mT25teh0dxcbaY%2F-MXejvIB18gvE0PjX5Ht%2Fimage.png?alt=media&#x26;token=4064a519-d317-42ac-b4eb-4ac713218a0d" alt="Tabs structure"></div>

## 2021-04-06 - Location picker

{% file src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MXaHi3HnG4HfKWUxobi%2F-MXaOjWRMevBgwaAh9JT%2Fcitizen-engagement-app.webflow%20(location-picker%20-%2004062021).zip?alt=media&token=67787f24-08d2-42b4-b05d-a8c3feb895bb" %}
Location picker
{% endfile %}

{% hint style="info" %}
Documentation link: [https://citizen-engagement-app.webflow.io/documentation#maps](https://citizen-engagement-app.webflow.io/documentation#maps)

Trello card: [https://trello.com/c/GF14y9FH](https://trello.com/c/GF14y9FH)
{% endhint %}

### Added:

* Added `.location-picker` item to the component library and documented it on the documentation page.

<div align="left"><img src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MXaHi3HnG4HfKWUxobi%2F-MXaLdYdHnLG2NeZmHq1%2Fimage.png?alt=media&#x26;token=a3918737-1fdb-4d40-ada6-ffb3f0c1d268" alt=".location-picker preview"></div>

<div align="left"><img src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MXaHi3HnG4HfKWUxobi%2F-MXaLYmae4BpZ508py27%2Fimage.png?alt=media&#x26;token=0922f759-5c16-411e-8882-9e95e66a3a6c" alt=".location-picker structure"></div>

{% hint style="info" %}
Please note that the location picker does not have a heading or a prompt to drag the map to a specific location. This should be added based on the needs of the map. If this should be incorporated into the component, please let me know.
{% endhint %}

#### Location picker dev:

* `.map-container` is where the leaflet map should be inserted.
* Added the following css to the site in order to prevent users from being able to highlight and select the map pin element when swiping on the map:

```
/*Make map pin non-interactive*/  
.map-pin {
  pointer-events: none;
  -webkit-user-select: none;  /* Chrome all / Safari all */
  -moz-user-select: none;     /* Firefox all */
  -ms-user-select: none;      /* IE 10+ */
  user-select: none;          /* Likely future */   
}
```

#### Location picker notes:

* The location picker is for users to identify a location that might not be an address eg. the user wants to highlight a dam or a tree next to a road.
* A user journey could be as follows:
  * User wants to locate a broken street lamp near them
  * The user knows the lamp is down the road from their house
  * They click "use my location" to center the map on their current GPS location
  * The user is prompted to allow the website to use their location (if they haven't already)
  * The map centers on their location
  * The then drags the map to position the map pin on the location of the lamp

## 2021-04-02 - Share button

{% file src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MXGU4x1HJEGDhg16QxA%2F-MXGZhTG2vUoVxgZnaI1%2Fcitizen-engagement-app.webflow%20(sharing-menu%20-%2004022021).zip?alt=media&token=4ce0f446-71b9-4dd9-b5ec-143c95eadb46" %}
Sharing menu
{% endfile %}

### Fixed:

* Adjusted the way that `.tab-links` display. They were filling the screen height before, which meant that when you tapped one, the entire height of the screen below the tab would be highlighted with the tap interaction. I have fixed this so now the tab is only highlighted at the top of the screen where it is visible.
* Added `padding-bottom: 6px` to the bottom of `.tab-link` to make this fix work

### Changes:

* Added sharing menu

<div align="left"><img src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MXGU4x1HJEGDhg16QxA%2F-MXGU8aOANbD3Oe9MPjX%2Fimage.png?alt=media&#x26;token=94548ce1-931d-451a-afc3-36211f844589" alt="Preview of the share menu"></div>

<div align="left"><img src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MXGU4x1HJEGDhg16QxA%2F-MXGZ8_S1aXR2QtgKJZj%2Fimage.png?alt=media&#x26;token=c5af83ef-dc17-445e-ae80-67f01018fbfa" alt="Share component structure"></div>

{% hint style="warning" %}
.share is hidden by default using a .hidden class and will not show up by default
{% endhint %}

#### Share menu interaction:

* Tap on `.share__button` opens the menu and shows `.share__close` which is a fixed div that fills the entire screen so any tap outside the menu will close it.
* Tapping a `.share__link` will also close the menu (and any functionality should be added on this click eg. linking to facebook sharing or opening the email client)
* `.share-link`s have a class to describe their function (eg. facebook, email, copy-link etc.)
* The `.share__link.copy-link` is the only link that doesn't close the menu, instead it plays a blinking animation saying "Link copied!" to let people know it has been copied to clipboard. The user will need to then click outside the menu to close it.

<div align="left"><img src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MXGU4x1HJEGDhg16QxA%2F-MXGZMqHVad3EhECx1L-%2Fimage.png?alt=media&#x26;token=eeae3544-37e5-4c77-96c7-66d05c3916da" alt=".share__link function class"></div>

#### Share menu notes:

* `.share__link_icon` is an SVG embed on the Webflow side so that the colour of the icon can be dynamically controlled. You can adjust this icon by changing the svg code.
* `.share__link_alt` is only used on the `.copy-link` it is the alternate text that flashes when the link is clicked

## 2021-02-25 - Description truncation

{% file src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MV0oJ8mmken6jkKXf6J%2F-MV0sgcskNBw5cKFzBb1%2Fcitizen-engagement-app.webflow%20(03052021%20-%20status%20description%20truncation).zip?alt=media&token=4ca64b2a-7b66-4913-80ba-2c2b2fd1d204" %}
Description truncation
{% endfile %}

### Changed:

* Added `.truncate` class to `.h3-block-title` within  `.link-block--subtitle-status` in order to prevent it from running onto multiple lines within the block
* Added `overflow: hidden` to `.link-block__inner` to ensure truncation behaves correctly

<div align="left"><img src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MV0oJ8mmken6jkKXf6J%2F-MV0s6zgpup2NbUKodBh%2Fimage.png?alt=media&#x26;token=0b997826-9576-4712-8bef-bb0798c0cc94" alt="Example of truncation"></div>

<div align="left"><img src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MV0oJ8mmken6jkKXf6J%2F-MV0q4983fO2hJbDqqgd%2Fimage.png?alt=media&#x26;token=19b876df-4574-4901-ae58-2a67d78755dd" alt="truncate added to .h3-block-title within .link-block--subtitle-status"></div>

## 2021-02-25 - Form item changes

{% file src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MUN2d7rwOrBDGYOhSUp%2F-MUNXMpPdYC-TFT5aXEF%2Fcitizen-engagement-app.webflow%20(02252020%20-%20Form%20item%20changes).zip?alt=media&token=19492cdf-71f8-45ef-8faf-d348e7427c89" %}
Form item changes
{% endfile %}

### Rationale:

These changes were implemented to make form more accessible and&#x20;

### Changed:

{% hint style="warning" %}
Please note that there are spacing issues with the current form because form items are not being placed within `.form__inner`
{% endhint %}

{% hint style="info" %}
Please note that **placeholder text in form items should now be example text** as apposed to a label. eg. John Smith, johnsmith@email.com
{% endhint %}

* `.input-field` changed to `.form__input-field` and is now housed within`.form__input-block` to accommodate the default `.form__field-label` that will accompany each `.form__input-field`
* `.field-label` changed to `.form__field-description` to avoid confusion now that there is an explicit field label that appears above the input field&#x20;
* `.form__input-field--label` changed to `.form__input-block--description` to avoid confusion and keep the concept of the "input-block" consistent.
* `.form__input-field--large` is now housed within `.form__input-block--large-field` to accommodate the default `.form__field-label` that will accompany each input field

<div align="left"><img src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MUN2d7rwOrBDGYOhSUp%2F-MUNBFZEgx2w8Txw7uw1%2Fimage.png?alt=media&#x26;token=3ba86f8b-5c4a-44d3-ba1b-f08cf6360404" alt="Structure of form__input-block--large-field"></div>

* Added `.form__legend-block` to be used as "headings" for form input groupings
* Added `.form__legend-block--label` to be used when heading description labels are required eg. \*Required

<div align="left"><img src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MUN2d7rwOrBDGYOhSUp%2F-MUNXo6TGRbaeQ1Q6DHg%2Fimage.png?alt=media&#x26;token=2ac53351-cf52-40ca-a114-b36e7d84470e" alt="Screenshot from documentation"></div>

## 2021-02-17 - Added grid--default to component library

{% file src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MTiZNN7Zyi3t7AI1skl%2F-MTiZR5oY1XWMHI_v3NH%2Fcitizen-engagement-app.webflow%20(grid--deafult%20fix%20-%2001172021).zip?alt=media&token=5cda010a-46c9-48a7-b101-a62bdc62f093" %}
Added grid--default to component library
{% endfile %}

### Changed:

#### Added grid--default to component library:

* Removed grid--fullwidth from component library
* Added grid--default to component library

## 2021-02-12 - Status alerts and placeholder messages

{% file src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MTKZ-l0NrFGUYIHCusb%2F-MTK_9yw_biU7NN3Z3An%2Fcitizen-engagement-app.webflow%20(status-alert-placeholder-message%20-%2002122021).zip?alt=media&token=27ed1f2e-4298-476a-a74e-6545607a6bc8" %}
Status alerts and placeholder message
{% endfile %}

### **Associated designs:**

{% embed url="https://www.figma.com/file/GREhUOy6VpwAku9O7yb2Lu/Citizen-Engagement-App?node-id=708%3A0" %}

{% hint style="info" %}
Documentation: [https://citizen-engagement-app.webflow.io/documentation](https://citizen-engagement-app.webflow.io/documentation)
{% endhint %}

### Changelog:

* Created component `.basic-block--placeholder` for lists that do not have any items
* Created component `.basic-block--status` for success/warning/failure messages&#x20;

<div align="left"><img src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MTKZ-l0NrFGUYIHCusb%2F-MTKaBAJ02BBFhbVtL9X%2Fimage.png?alt=media&#x26;token=b190748e-b498-45e8-96e3-dd7c9feeeba8" alt="Status alerts"></div>

<div align="left"><img src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MTKZ-l0NrFGUYIHCusb%2F-MTKaIa5eXwlMMOZlZVs%2Fimage.png?alt=media&#x26;token=4781eb2d-3007-4d41-8439-5b1cc2839996" alt="Placeholder block"></div>

## 2021-02-10 - Service requests

{% file src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MTAJcmVAvHOK8XpGTR0%2F-MTANkDq5R9KFlo2xST_%2Fcitizen-engagement-app.webflow%20(service-requests%20-%2002102021).zip?alt=media&token=550ce3aa-3258-4df7-b55c-4fe66e676804" %}
citizen-engagement-app.webflow (service-requests - 02102021)
{% endfile %}

### **Associated designs:**

[https://www.figma.com/file/GREhUOy6VpwAku9O7yb2Lu/Citizen-Engagement-App?node-id=708%3A0](https://www.figma.com/file/GREhUOy6VpwAku9O7yb2Lu/Citizen-Engagement-App?node-id=708%3A0)

### Changelog:

* Created component ".form\_\_input-field--large" for "Service request description"
* Created component ".link-block--subtitle-status" for "My service requests"
* Created component ".dropdown" for "Ward" and "Service area of request"
* Created component ".label"

### Documentation:

{% embed url="https://citizen-engagement-app.webflow.io/documentation" %}

{% file src="https://3781560293-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MJMOjRvhmSwc5da9Djd%2F-MSlDJlwwjcVsvVOe2ov%2F-MSlDylmtwbh06EmblBa%2Fcitizen-engagement-app.webflow%20(12092020%20-%20logo-link-form-labels-favicon-webclip).zip?alt=media&token=c84e90b4-ce56-4ba6-8fe8-1adc4c73f505" %}
