Mattilsynets designsystem - for Clojure!

Dette er en bitteliten repakettering av Mattilsynets designsystem som lar deg konsummere det som en pakke fra Clojars. I tillegg tilbyr den noen bekvemmelighets-API-er for å bruke CSS-moduler og laste SVG-er fra Clojure og ClojureScript.

Klasser

For å bruke klasser fra designsystemet:

(require '[mattilsynet.design :as mtds])

[:a {:class (mtds/classes :logo)}
  "Klikk her, a!"]

mattilsynet.design/classes kan kalles med en regle med klasser, både i og utenfor designsystemet. De som er i designsystemet blir bytta ut med riktige klasser, mens de øvrige forblir urørt:

(require '[mattilsynet.design :as mtds])

(mtds/classes :mt-4 :button :yolo)

;;=>
;; (:mt-4 "_button_1tlt5_12" "_ds-button_141tn_1" :yolo)

CSS-fil

CSS-fila er tilgjengelig som:

(require '[clojure.java.io :as io])

(io/resource "public/mtds/styles.css")

Ikoner og illustrasjoner

Ikoner og illustrasjoner kan rendres som hiccup. Fra Clojure er det bare å bruke mattilsynet.design/render-icon:

(require '[mattilsynet.design :as mtds])

(mtds/render-svg :icon/cow)
;;=>
;; [:svg ,,, ]

(mtds/render-svg :illustration/animals.bird)
;;=>
;; [:svg ,,, ]

Fra ClojureScript må du sørge for å laste SVG-en inn i bygget ditt først med mattilsynet.design/svg:

(require '[mattilsynet.design :as mtds])

(mtds/render-svg (mtds/svg :icon/cow))
;;=>
;; [:svg ,,, ]

For en liste med tilgjengelige ikoner og/eller illustrasjoner:

(require '[mattilsynet.design :as mtds])

(mtds/get-icon-ids)
[:icon/cow :icon/fish ,,,]

(mtds/get-illustration-ids)
[:illustration/animals.bird :illustration/animals.pig ,,,]

Slippe ny release

Når det er endringer i npm-pakken til designsystemet, eller i koden i dette repoet bør det lages en ny versjon av Clojars-pakken. Det gjør du på følgende vis:

./release.sh

Dette scriptet sørger for å oppdatere designsystemet, bygge resources på nytt, bumpe versjonsnummeret (som er designsystemets versjonsummer, pluss et løpetall), committe og tagge, bygge jar-fil og publisere den på Clojars. Du må ha tilgang til io.mattilsynet-gruppen på Clojars, det får du av noen på Team Mat.