@kb-dk/kb-footer
v2.12.0
Published
A footer with kb design and links.
Downloads
5
Readme
kb-footer
kb-footer is a web component which shows KB design footer. Moreover, column items come from kb.dk footer API. In kb design manual, every application has to use exactly the same footer at in kb.dk, except for the first column which can be application specific.
Properties
| Property | Attribute | Description | Type | Default | |:--------:|:---------:|:--------------------------:|:-------------:|:---------:| | language | language | The language of the page. | "da" / "en" | "da" | | cookieId | cookieId | The id for the cookie. | string | "" |
Additional considerations
KB design allows the first column to be overwritten by the application but the other three must be the same as in kb.dk.
- You can provide a
ul
element within the kb-footer which will be used as the first column. ul
element must have the following line inside<style>kb-footer > ul {display: none;}</style>
.ul
element must have its id sat toappFooterColumnDA
for Danish orappFooterColumnEN
for English.- If an
ul
element has its id sat toappFooterColumn
, it will be used as the replacement for the missing language.
Local configuratin needed
You need two configuration files in the root folder of this web component. One called .env.dev
and one called .env.prod
. In those files you need to specify the variables BASEURL
and JSONAPIURL
taylored to your local and production environment. The variables are needed to fetch non default footer data. Both filenames/locations are already added to .gitignore
Cookie script
To add Cookie script, you need to pass the id of your site from https://cookie-script.com/ as a property to the footer.
for example:
<kb-footer cookieId="903181bb69e77c4a5adfc4ea71d034xx"></kb-footer>
It will insert the cookie script to the page.
if you want to add the option of opening the cookie banner by clicking on Cookie Settings
in the footer, then you need to add the following div to the kb-footer:
<kb-footer cookieId="903181bb69e77c4a5adfc4ea71d034xx">
<div id="csconsentlink" style="display: none;"></div>
</kb-footer>
Examples
- Exactly as in kb.dk
<kb-footer></kb-footer>
- Footer with Application specific column
<kb-footer>
<ul id="appFooterColumn">
<style>kb-footer > ul {display: none;}</style>
<li><a href="#">Om KBs Digitale samlinger</a></li>
<li><a href="#">Mediestream</a></li>
<li><a href="#">Danmark Set Fra Lunften</a></li>
</ul>
</kb-footer>
- English footer
<kb-footer language="en"></kb-footer>
- Footer with application specific footer for each language (English and Danish)
<kb-footer> <ul id="appFooterColumnDA" > <style>kb-footer > ul {display: none;}</style> <li><a href="#">Om KBs Digitale samlinger</a></li> <li><a href="#">Mediestream</a></li> <li><a href="#">Danmark Set Fra Lunften</a></li> </ul> <ul id="appFooterColumnEN"> <style>kb-footer > ul {display: none;}</style> <li><a href="#">About Digital collections</a></li> <li><a href="#">Danmark from above</a></li> </ul> </kb-footer>
- Change the language dynamically from within your application
- HTML
<label for="language">Language:</label> <select id="language"> <option value="da" selected>Dansk</option> <option value="en">English</option> </select> <kb-footer> <ul id="appFooterColumnDA" > <style>kb-footer > ul {display: none;}</style> <li><a href="#">Om KBs Digitale samlinger</a></li> <li><a href="#">Mediestream</a></li> <li><a href="#">Danmark Set Fra Lunften</a></li> </ul> <ul id="appFooterColumnEN"> <style>kb-footer > ul {display: none;}</style> <li><a href="#">About Digital collections</a></li> <li><a href="#">Danmark from above</a></li> </ul> </kb-footer>
- Javascript
<script> document.getElementById('language').addEventListener('change', function() { let footer = document.querySelector("kb-footer"); footer.language = this.value; }); </script>
- HTML