Kode

Implementering af DKFDS

DKFDS kan installeres ved brug af npm pakken eller du kan download seneste version via Github.

Hent DKFDS (NPM)

Navigér til roden af dit projekt i en kommando prompt.

Installer DKFDS med følgende kommando:

npm install --save dkfds

Modulet ‘dkfds’ er nu installeret i ‘node_modules’ mappen.

Hent DKFDS (zip)

Hent nyeste version som zipfil på Github, og pak indholdet ud i dit projekt.

Inkludér CSS

Virk tema

<link type="text/css" rel="stylesheet" href="[sti til DKFDS mappen]/dist/css/dkfds-virkdk.css" />

Borger.dk tema

<link type="text/css" rel="stylesheet" href="[sti til DKFDS mappen]/dist/css/dkfds-borgerdk.css" />

Har du brug for dit eget tema? Så læs sektionen om, hvordan du tilpasser DKFDS til dit eget tema.

Inkludér JavaScript

JavaScript kan inkluderes med et script tag eller importeres ind i en eksisterende js fil.

`<script>` tag

Indsæt følgende script tag før</body>

<script src='[sti til DKFDS mappen]/dist/js/dkfds.js'></script>

Importer modulet i en .js fil

import * as DKFDS from "dkfds";

Init

Når DKFDS er inkluderet kan du køre funktionen DKFDS.init(); ved dom ready, eller hvornår det nu end passer i dit projekt.

DKFDS.init(); aktiverer javascript for alle komponenter, men man kan også tilføje javascript specifikt for hver komponent. Information omkring javascript for hver komponent finder du i kode sektionen for den specifikke komponent.

Eksempel på init:

document.addEventListener("DOMContentLoaded", function(){
  // Handler when the DOM is fully loaded
  DKFDS.init();
});

Temahåndtering

Designsystemet er udviklet med 2 forskellige temaer. Standard temaet er det neutrale tema, hvor primærfarven er grå. Denne grå farve skal overskrives, da det neutrale tema blot er ment som en skabelon til ens eget tilpassede tema. De to andre temaer er målrettet borger.dk og virk.dk.

Temaerne er simple, det eneste som er forskelligt mellem standard temaet og de to andre temaer er primærfarven og nogle få variationer i headeren (fx logo). Alt andet er ens på tværs af temaer.

Tema eksempel – borger.dk (scss):

// These variables overwrite the default values, giving the style the borger.dk theme
$color-primary:               #44831E;
$color-primary-medium:        #3C5C22;
$color-primary-dark:          #233614;

.header {
    .portal-header{
        background-color: #f1f1f1;
        .logo{
            background-image: url($image-path + '/logo-borgerdk.svg');
            height: 4.8rem;
        }
    }
}

$font-path:         '~dkfds/src/fonts/IBMPlexSans/';
$image-path:        '~dkfds/src/img';
$site-image-path:   '~dkfds/src/img';
$icons-folder-path: '~dkfds/src/img/svg-icons';
@import '~dkfds/src/stylesheets/dkfds';

Browserspecifik styling tilføjes i projektet

Webpack

Bemærk, at scss filen kun indeholder basic CSS. Den indeholder således ikke browser specifik CSS.

For at tilføje dette bør SCSS filen køres igennem autoprefixer, hvor den relevante styling vil blive tilføjet til output CSS filen.

Gulp