Skip to content
Thin ClojureScript wrapper around Ant Design React components with Reagent
Clojure
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
resources/images Add Ant-Man image Feb 17, 2019
src Fix message docstrings for Ant Design Message Sep 18, 2019
test
.gitignore Ignore `.nrepl-port` Feb 18, 2019
.travis.yml
LICENSE.txt Create LICENSE.txt Feb 18, 2019
README.md 1.7.7 Sep 18, 2019
project.clj Generate API docs for Ant Design items Sep 18, 2019

README.md

Ant-Man

Clojars Project Dependencies Status Build Status Clojars GitHub last commit

One question, is it too late to change the name?

-Scott Lang

Overview

Thin ClojureScript wrapper for Ant Design React components with Reagent

Quick link to Ant Design introduction: https://ant.design/docs/react/introduce

Documentation

Usage with Yarn + Webpack + DoubleBundle

TODO: Showcase how to package dependencies using Yarn + Webpack + DoubleBundle

Reference: https://github.com/pesterhazy/cljs-spa-example

Usage with packaged CLJSJS version of Ant Design

Include Ant-Man and Reagent in your project.clj

[com.hypaer/ant-man "1.7.7"]
[reagent "0.8.1"] ;; Ant-Man requires Reagent 0.8.0+

Include Ant Design CSS and JavaScript CDNs

https://cdnjs.cloudflare.com/ajax/libs/antd/3.14.1/antd.min.css
https://cdnjs.cloudflare.com/ajax/libs/antd/3.14.1/antd.min.js

Require and use in your project

(require '[ant-man.core :as ant-man])

;; Input field
[ant-man/input {:value @your-reagent-atom
                :id "your-id"
                :placeholder "your-placeholder"}]


;; Select input field
(def t (reagent.core/atom nil)
(def col [{:id 1 :label "uno"}
          {:id 2 :label "dos"}]

[ant-man/select {:on-change (fn [val] (reset! t val))
                 :value @t}
  (for [{:keys [label id]} col]
    [ant-man/select-option {:value id} label])]

Helper functions

Keyify-ing lists

Given a function and collection will add unique :key value to metadata information

A customizable :key-fn functionality for specifying list item :key value

Use example:

(require '[ant-man.core :as ant-man]
         '[ant-man.helpers :as ant-man-helpers]
         '[reagent.core :as r])

(def selection (r/atom nil))
(def example-collection [{:label "foo" :id 1} {:label "bar" :id 2}])

;; Default
[ant-man/select {:on-change (fn [val] (reset! selection val))
                 :value @selection}
  (ant-man-helpers/keyify
    (fn [{:keys [label id]}]
      [ant-man/select-option {:value id} label])
    example-collection)]

;; Custom `:key-fn`
[ant-man/select {:on-change (fn [val] (reset! selection val))
                 :value @selection}
  (ant-man-helpers/keyify
    (fn [{:keys [label id]}]
      [ant-man/select-option {:value id} label] :key-fn (fn [x] [(inc x)]))
    example-collection)]

Development

To use in your project and develop this library simultaneously use Leiningen Checkouts along with specifying a src path inside your :cljsbuild configuration. If you are using Figwheel and it is configured correctly changes made in Ant-Man will auto re-load.

Example:

;; Specify path in your `project.clj`

:cljsbuild {:builds
            [{:id "dev"
              :source-paths ["src/cljs" "src/cljc" "checkouts/ant-man/src/cljs"]}]}

License

Copyright © 2019 HYPÆR

The use and distribution terms for this software are covered by the Eclipse Public License 2.0. By using this software in any fashion, you are agreeing to be bound by the terms of this license. You must not remove this notice, or any other, from this software.

You can’t perform that action at this time.