【kintone】コピペでOK！Kintone Portal Designer のサンプルデザインの使い方

今回はKintone Portal Designer で**サンプルのHTMLの文言変更＆コピペするだけでOK!**なカスタマイズをしてみたいと思います。

# Kintone Portal Designer の準備

以下リンク先を上から順番にインストールして、「テンプレートを読み込む」のところで「**basic-1column**」を選択してください。

https://developer.cybozu.io/hc/ja/articles/360030856652-Kintone-Portal-Designer%E3%82%92%E4%BD%BF%E3%81%A3%E3%81%A6%E3%83%9D%E3%83%BC%E3%82%BF%E3%83%AB%E3%82%92%E3%83%87%E3%82%B6%E3%82%A4%E3%83%B3%E3%81%97%E3%82%88%E3%81%865

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/536148/7f9c5d53-3d6a-2c0f-04c6-d360dbb4ec75.png)

インポートするとこんなコードが表示されます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/536148/de6fc867-132e-7363-dd77-18b29153c3dd.png)

# HTMLの構成

HTMLのコードと、画面はこんなふうに対応しています。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/536148/e6390b6c-8c33-c3b7-7028-4dfb7d9e71cd.png)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/536148/ec46e420-2352-8108-e3ac-3f68fa27e040.png)

# セクション

3つのセクション（Apps、Spaces、Heading1 ）があります。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/536148/f0855706-7307-d062-7820-95db5cce77dc.png)

セクションは`section`タグで囲まれている部分です。

```html
<section class="basic-container">
～～セクションの中身～～
</section>
```

セクションのタイトルは`<h3 class="basic-heading1">Apps</h3>` のAppsの部分です

```html
<section class="basic-container">
  <h3 class="basic-heading1">Apps</h3>　← Appsを変更すればタイトルも変わる
  <ul class="basic-appSet">
  ～～～～～～
</section>
```

セクションのタイトルを変更するとこのようになります。

```html
<h3 class="basic-heading1">変更後のタイトル</h3>
```

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/536148/8d760676-772e-e72c-6ebd-ea1313d85aa2.png)

セクションを増やしたい場合は
`<section class="basic-container">～</section>` をコピーして
`<section>の上`か、`</section>の下`に貼り付けましょう。

「変更後のタイトル」のセクションの上にコピペしてみました。
※コードは折りたたんでいます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/536148/5e924598-d8a0-1d9d-892d-425d8df35d8b.png)

↓するとこのようになります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/536148/4dff45d7-d4ea-b6c7-246b-6574dc96fac0.png)

# アイコンの変更

## アイコン画像
アイコン画像は`svg`タグに囲まれている部分です。
使いたいアイコンに対応するsvgタグを↓のサイトからコピーして使います。

https://github.com/kintone/portal-design-templates/tree/master/images/icons

使いたいアイコンの隣のリンクをクリックすると、コードが表示されます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/536148/21446ad8-7b57-ecef-5178-61772d2e2b73.png)

コードをコピーして、
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/536148/7c67edb4-b850-df8f-d392-7dc77534e976.png)

もともとの`<svg>`タグの部分を消して、コピーしてきたコードを貼り付けます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/536148/695d8472-124f-d264-8a84-fa795ed85147.png)


↓コピーして貼り付けたばかりのコード

```html
<svg width="26" height="26" viewBox="0 0 26 26" fill="none" xmlns="http://www.w3.org/2000/svg">
<path d="M20.622 17.4C17.689 17.4 19.668 8.102 15.56 5.616C14.994 5.273 14.999 4.888 15 4.2C15 3.1 13.9 2 12.8 2C11.7 2 10.6 3.1 10.6 4.2C10.601 4.888 10.606 5.273 10.039 5.616C5.932 8.102 7.911 17.4 4.978 17.4C4.438 17.4 4 17.892 4 18.5C4 19.107 4.438 19.6 4.978 19.6H20.622C21.162 19.6 21.6 19.107 21.6 18.5C21.6 17.892 21.162 17.4 20.622 17.4ZM13.9 4.2C13.9 4.808 13.408 5.3 12.8 5.3C12.192 5.3 11.7 4.808 11.7 4.2C11.7 3.592 12.192 3.1 12.8 3.1C13.408 3.1 13.9 3.592 13.9 4.2ZM9.5 20.7C10.6 20.7 15 20.7 16.1 20.7C16.1 22.523 14.623 24 12.8 24C10.977 24 9.5 22.523 9.5 20.7Z" fill="black"/>
</svg>
```

次に
`class="basic-app-icon-img"を追加して`
`pathタグ内のfill="black" を消します`


↓`class="basic-app-icon-img"を追加し`て、`pathタグ内のfill="black" を消し`たコード

```html
<svg class="basic-app-icon-img" width="26" height="26" viewBox="0 0 26 26" fill="none" xmlns="http://www.w3.org/2000/svg">
<path d="M20.622 17.4C17.689 17.4 19.668 8.102 15.56 5.616C14.994 5.273 14.999 4.888 15 4.2C15 3.1 13.9 2 12.8 2C11.7 2 10.6 3.1 10.6 4.2C10.601 4.888 10.606 5.273 10.039 5.616C5.932 8.102 7.911 17.4 4.978 17.4C4.438 17.4 4 17.892 4 18.5C4 19.107 4.438 19.6 4.978 19.6H20.622C21.162 19.6 21.6 19.107 21.6 18.5C21.6 17.892 21.162 17.4 20.622 17.4ZM13.9 4.2C13.9 4.808 13.408 5.3 12.8 5.3C12.192 5.3 11.7 4.808 11.7 4.2C11.7 3.592 12.192 3.1 12.8 3.1C13.408 3.1 13.9 3.592 13.9 4.2ZM9.5 20.7C10.6 20.7 15 20.7 16.1 20.7C16.1 22.523 14.623 24 12.8 24C10.977 24 9.5 22.523 9.5 20.7Z"/>
</svg>
```



↓アイコンの設置操作
![svg2.gif](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/536148/4341b696-69df-99a6-8702-ef46e8c8bc34.gif)

## アイコンの背景色の変更

アイコンの背景色は`<div class="basic-app-icon basic-app-icon--blue"> `のクラス名、`basic-app-icon--blue`を変更したらOK

```html
<!-- FAQ icon -->
<li class="basic-app">
  <a class="basic-app-link" href="#">
    <div class="basic-app-icon basic-app-icon--blue"> ←ここ
      ~~~~
    </div>
    <p class="basic-app-name">変更後の名前</p>
  </a>
</li>
```

| クラス名| 色 |
|:-:|:-:|
|  basic-app-icon--blue | 青  |
|basic-app-icon--pink   | ピンク  |
|basic-app-icon--green   |  緑 |
| basic-app-icon--purple  |  紫 |
| basic-app-icon--orange  | オレンジ  |

## アイコンのタイトル

アイコンのタイトルは`<p class="basic-app-name"></p>`で囲まれたの部分を変更します。

```html
<p class="basic-app-name">FAQ</p> ←FAQの部分を変更する
```

変更後

```html
<p class="basic-app-name">変更後の名前</p>
```

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/536148/f8b9aece-c3d9-6c5e-f484-e0dcc7cfa839.png)

## アイコンクリック時のリンク先

アイコンクリック時のリンク先は、`<a class="basic-app-link" href="#">` の`#`をURLに変更します。

変更前

```html
<a class="basic-app-link" href="#">
```

変更後(例：アプリIDが319のアプリに飛びたい場合)

```html
<a class="basic-app-link" href="/k/319/">
```

## アイコンを増やしたい場合

アイコンを増やしたい場合は、`<li class="basic-app">～</li>`の部分をコピーして、追加したい部分(`<li>`タグの前か、`</li>`のすぐ後がよいです)に貼り付けます。`<!-- FAQ icon -->`の等のコメントタグも一緒にコピーして貼り付けておくと便利かも

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/536148/651ff062-c67c-367a-0b13-88441333e9d7.png)
]

コピーペーストで増えた様子

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/536148/a88a04d7-abe5-c6e5-5e64-05f2402ef34c.png)

アイコンを増やしたら、タイトルや画像、リンク先を変更すればバッチリですね！

# アイコンをアプリアイコンにしたい
最後にちょっと重めのコピペカスタマイズです。
ポータルに表示するアイコン、アプリアイコンにしたいですよね。

まずCSSをちょっといじる必要があります。

## CSSの追加
CSSの255行目に

```css
.designportal .basic-app-icon-img-app {
  display: block;
  width: 100px;
  height: 100px;
  fill: #FFFFFF;
}
```

と追加します。

## アプリアイコンのURLをゲットする

使いたいアイコンの画像を右クリックして、
「検証」をクリックします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/536148/804b4ee8-d9ce-ba17-a2f4-c05efc8e4899.png)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/536148/92b12ae7-70bc-5395-e0ee-37ea77623f42.png)

するとこんな感じにspanタグ部分が選ばれた状態になります。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/536148/b1e238b1-a8ad-4ef0-3855-fe351a972d92.png)

コレを右クリックでCopy → Copy element と選択し、コピーしてメモ帳に貼り付けます。
`/k/～～～～～;.png` までコピーします。コレがアイコン画像のURLになります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/536148/6dddf3b0-d1df-c746-6b99-ab195733e530.png)

## HTMLを書く

コチラをコピペして、
アプリID、コピーしたアイコン画像のURL、アプリの名前などを書き換えればOKです。

```html
<!-- ○○アプリ icon -->
<li class="basic-app">
  <a class="basic-app-link" href="/k/アプリID">
    <div class="basic-app-icon ">
      <img class="basic-app-icon-img-app" src="コピーしたアイコン画像のURL">
    </div>
    <p class="basic-app-name">アプリの名前</p>
  </a>
</li>
```

実際に入力したらこんな感じになります。

```html
<!-- 素敵アプリ icon -->
<li class="basic-app">
  <a class="basic-app-link" href="/k/320/">
    <div class="basic-app-icon ">
      <img class="basic-app-icon-img-app" src="/k/api/app/icon.do/-/app.png?app=320&size=NORMAL&hash=45902608266627f4d3c4d27aa7318556a13bd220&.png">
    </div>
    <p class="basic-app-name">素敵アプリ</p>
  </a>
</li>
```

わぁい！きとみちゃんアイコン！

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/536148/f19d2a0a-5751-01ca-b3c6-d4f1204f0967.png)

# まとめ

コピペでもある程度のポータルのカスタマイズができそうです。

HTMLやCSSが読めたり書けたりすると、もっと自由にカスタマイズすることもできるので、
入門サイトなどで挑戦してみるのもいいかもしれません✨レッツチャレンジ！