UIkitのバージョン3.0(beta)のカスタムテーマを作成してみます。
おなじみUIkitのバージョン3.0のドキュメント を参考にカスタムテーマを作成してみたいと思います。
バージョン2ではビルドツールとしてgulpが採用されていました。
バージョン3ではnpmでビルドを行うようですね。
環境面の前提としてはNode.jsがインストールされていてnpmコマンドが利用できることを条件とさせていただきます。
では、インストールから始めます。
UIkitのインストール
インストールはいくつかの方法があり、ドキュメントでも紹介されていますが今回はUIkitのGitHubリポジトリをforkしているため、 forkしたリポジトリをcloneする方法を採用します。
treeコマンドで確認してみると、次のような構成になっています。
この中にpackage.jsonファイルがあり、ライブラリの依存関係が定義も含まれています。
手順に従い、依存関係のあるライブラリをインストールしましょう。尚、この作業は一度のみ実施します。
プロジェクト直下にnode_modulesというディレクトリが生成され、ライブラリがインストールされます。
UIkitのビルド
続けてビルドを行います。
ビルドはnpmコマンドで実行します。
ビルドは成功したようですね。
dist ディレクトリとその中にJavaScriptファイルが生成されました。
カスタムテーマの作成の準備
ようやくカスタムテーマを作成する準備が整いました。
カスタムテーマを作成するには、まず/custom
ディレクトリをプロジェクトのルートディレクトリに作成します。
ディレクトリ名はcustomとした方が良さそうです。.gitignoreにも記載されていますし。(管理の対象外として)
では、テーマの名称を tb-theme として必要なファイルを作成します。
- custom/tb-theme.less
// Core
// uikit.lessをインポートしても良かったのですが、下記の通りuikit.theme.lessの方に
// 設定されているスタイルの方が好みだったので・・・
@import "../../src/less/uikit.theme.less";
// Theme
@import "tb-theme/_import.less";
このファイルが Less compiler のエントリーファイルになるようです。
- custom/tb-theme/_import..less
@import "variables.less";
上記に記載のあるtb-theme/_import.less
を作成します。
後述しますが、variables.lessファイルをインポートする定義を追加しておきます。
尚、ファイルは定義するテーマをコンポーネント単位で作成するよう記載があります。(私の英語の解釈が正しければ)
コンポーネント単位で記述するのは必須ではないと思いますが、管理面を考慮しているのでしょう。
今回のカスタムテーマは簡単箇所から試してみます。
font-familyの設定
font-familyを変更してみます。
UIkitのカスタマイズは以下の方法が紹介されています。
- Use variables (変数を使う)
- Use hooks (フックを使う)
- Miscellaneous hooks (いろいろなフックを使う?直訳)
これらのうち、font-familyの変更は「変数を使う」変更となります。
UIkitのソースコードを単にfont-family
で検索してみると、いろいろいくつか利用しているファイルが出てきますが、
おそらく@global-font-family
のみ対応しておけば良さそうです。
この変数は/src/less/components/variables.less
に定義されています。
オリジナルは次のように定義されています。
@global-font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
/custom/tb-theme/variables.less
を作成し、次の変数を定義します。
オリジナルの定義に”Hiragino Kaku Gothic ProN”, Meiryo, “MS Pゴシック”を追加したいと思います。
@global-font-family: "Hiragino Kaku Gothic ProN", Meiryo, "MS Pゴシック", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
カスタムテーマのビルド
ファイルを作成したら、先ほどと同じ手順でビルドを行います。npm run compile
でもいいですし、npm run watch
でも可です。
後者はファイルの変更があればリビルドしてくれます。
次のように出力されればカスタムテーマが作成成功でしょう。おめでとうございます!!
[compile-less] dist/css/uikit.css 321.98kb
[compile-less] dist/css/uikit-core.css 303.82kb
[compile-less] dist/css/uikit.min.css 228.64kb
[compile-less] dist/css/uikit-core.min.css 212.82kb
[compile-less] dist/css/uikit.tb-theme.css 304.01kb
[compile-less] dist/css/uikit.tb-theme.min.css 213.00kb
では、ビルドしたものの確認はどうするのか・・・。
少し調べたところ/tests/index.html
をブラウザで表示すれば確認ができそうでした。
この画面上部でテーマを選択することができるようです。
自動的に作成したテーマが追加されているかも・・・という淡い期待もありましたがプルダウンには追加されていませんでした。
ビルド後、プロジェクトのルートディレクトリに themes.json というファイルが生成されます。 webpack-dev-server を起動すると、test/test.jsがビルドされて、カスタムテーマが追加されます。
ページをリロードして、テーマが増えているか確認します。
コンテンツが英語なのでわかりにくいですが、テーマを切り替えるとフォントも変更されていました。
以上で今回のミッションは完了です!!!
今回一通りの手順が確認できましたので、あとはひたすらカスタムテーマを作り込むだけですね。