rex0220 タブ表示プラグイン

kintone アプリで、ヘッダ固定行、タブ切替、フッター固定行を設定表示するプラグインです。

- PC表示時のタブカスタマイズ機能
    - タブ間のマージン、最小幅、背景色、文字色、ボーダー表示
- PC表示時のタブ固定位置表示<br>
　ただし、「タブ固定位置表示」については、IE11 は、動作対象外
- PC、モバイル対応

※ Ver.28
・プラグイン設定画面のデザイン変更対応
・プラグイン設定に、「説明」設定機能を追加

[rex0220 stores](https://rex0220.stores.jp)で、販売中です。

<img width="907" alt="2019-07-10_22h20_54.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/100572/ba083f2b-cffb-eeac-ccd2-6fe8eb81d986.png">


# 新テーマ対応

新テーマ（RED, GREEN, BLUE, YELLOW, BLACK）に合わせてタブ表示します。

- 新テーマ RED の表示例

![2017-02-12_09h44_28.png](https://qiita-image-store.s3.amazonaws.com/0/100572/1c10b6d2-36b0-a201-e2a8-6dd75cba7005.png)

- 各テーマの表示例

![KTAB-THEME.png](https://qiita-image-store.s3.amazonaws.com/0/100572/42d48ed0-c5ea-dec6-1a65-22fe9704c121.png)



# 詳細画面

![ktab02.png](https://qiita-image-store.s3.amazonaws.com/0/100572/997ae859-4e49-8caf-6fa4-c8357669a078.png)

# 編集画面

![ktab03.png](https://qiita-image-store.s3.amazonaws.com/0/100572/64d89608-0c26-46f7-cbf6-0f41a39385c9.png)

# 画面切り替えのタブ表示

詳細画面から編集画面に切り替えても、タブ位置は変わりません。

![ktab04.png](https://qiita-image-store.s3.amazonaws.com/0/100572/f198075d-c591-63cb-bbed-46bd72323c6d.png)

# モバイル表示

新モバイルUIのみタブ表示可能です。

<img width="715" alt="2019-09-22_15h11_45.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/100572/09b53ce1-c975-92bc-d666-adfbe727a285.png">


# タブの表示幅の指定例

フォームの横幅が長い場合、タブの表示幅も対応して長くなります。
タブ表示を途中で折り返ししたい場合は、表示幅を指定してください。

![2021-09-25_10h27_42.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/100572/c689a1b1-55e8-d17f-352d-73e773060560.png)

# タブカスタマイズ機能

タブ間のマージン、最小幅、背景色、文字色、ボーダー表示を指定して、タブ表示をカスタマイズできます。

![2021-06-13_18h28_15.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/100572/04c36c89-3582-1374-dd05-8f10a5b390de.png)


# プラグインの読み込み

- kintoneシステム管理 > プラグイン　の画面で、プラグインを読み込みます。
- アプリの設定 >  プラグイン　で、プラグインを追加します。

![2017-05-31_12h51_44.png](https://qiita-image-store.s3.amazonaws.com/0/100572/6015c094-c9c7-d833-5f4f-471bcc49fe32.png)


# プラグイン設定方法

タブ表示プラグインは、フォームの項目を行単位に、上から順番に、
ヘッダ固定部、タブ１、タブ２...　、フッター固定部に割り付けていくイメージです。


- 最初に標準のフォーム設定でレイアウトを、行単位でタブ表示順位に変更
- 以下、プラグイン設定画面
- ヘッダ部固定表示行数を設定
- タブ１：タブ名と表示行数を設定
- ...
- タブN：タブ名と表示行数を設定
- タブに割り当てられなかった行が、フッター固定部になります。


**グループは、まとめて１行でカウント
サブテーブルは、１行でカウント**

タブ表示設定を変更すると、レイアウト表示のタブ名欄に反映されます。

![t9a.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/100572/49b47590-324c-f1dd-811f-55a5961207f0.png)

- タブ設定とタブ表示例

<img width="1029" alt="2020-01-16_12h12_37.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/100572/9c8363c7-2344-e503-add9-9deea3891e63.png">


# 全タブの項目表示

プラグイン設定画面で、「全表示タイトル」を指定すると全タブの項目表示が行えます。

<img width="1092" alt="2019-07-11_09h21_55.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/100572/426816c5-6f61-edc1-4946-d539b557c9e0.png">



# プラグイン設定画面

各項目を指定して、「保存する」をクリックします。
下記の入力エリアでタブ名と表示行数欄を入力していただくとレイアウト欄に自動反映されます。
タブ名または表示行数欄の入力エリアをクリックすると、入力可能となります。

![2023-05-26_09h58_40.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/100572/73314ff4-1588-266d-c464-2693b5b0042d.png)

## タブ設定

![2024-06-20_09h02_09.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/100572/626ba2d2-0387-3e82-d4af-a8d588716f39.png)

- プラグインの有効／無効
- タブ表示エリアの表示幅
- ヘッダ部固定表示行数
- 全表示タイトル※1
    - 指定すると、全項目を表示するタブを表示
- モバイルヘッダー※1
- モバイルフッター※1
- タブマージン※2：　タブ間のサイズを[px] 単位で指定。規定値は 1[px]
- タブ最小幅※2：　タブの最小幅を[px] 単位で指定。規定値は 84[px]
- タブ背景色※2
- タブ文字色※2
- ボーダー色※2：　指定するとタブの枠を表示
- 縦位置固定
    - PC のタブ表示について、縦位置固定を　"Y","N" で指定
- タブ切替時、先頭表示
    - PC のタブ切り替え時に、タブ先頭項目を表示する。"N": 無効(既定値), "Y": 有効 
- PC:レコード表示時のタブ位置を指定
    - 未設定の場合、タブ位置を維持
    - 1-20: タブ位置
    - A: 全表示
- MOBILE:レコード表示時のタブ位置を指定
    - 未設定の場合、タブ位置を維持
    - 1-20: タブ位置
    - A: 全表示
    - H: ヘッダー
    - T: テール

## タブ名・表示行数

- 各タブと表示行数を設定※1
    - グループ・サブテーブル・関連テーブルは、１行で計算します

## APP レイアウト
- NOTE
    - プラグイン設定のメモ等を指定できます
- 運用環境に反映
    - プラグイン設定画面で「保存」時に、直接運用環境に反映します

※1 英日中を設定すると、ユーザ別に設定された各言語対応のタイトルを表示
※2 項目をダブルクリックすると、設定値をクリア



# タブカスタマイズ機能の操作例

- タブカスタマイズ項目を指定すると、タブ背景色の「英日中」の表示に反映されます。
![2021-06-13_18h44_02.gif](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/100572/e818f134-e0fc-3d29-85cc-a1a2cbb868e9.gif)

- タブカスタマイズ結果
![2021-06-13_18h46_53.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/100572/d21e5f3e-ae20-17fd-b064-5cc47a3c6bfe.png)



## プラグイン設定でのコピー＆ペースト機能

プラグイン設定で、セルのコピー「CTL+C」＆ペースト「CTL+P」が使用できます。

![タブ表示V6-3.png](https://qiita-image-store.s3.amazonaws.com/0/100572/2f920f67-240a-cf81-8d4d-2828abc0b058.png)


# プラグイン設定のダウンロード

- プラグイン設定をダウンロードできます。
- 計算式を変更している場合は、変更後の設定が対象です。
- ブラウザ IE については、プラグイン設定のダウンロードの動作対象外です。

<img width="928" alt="2019-07-11_09h16_47.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/100572/97f3b2b8-db01-8463-1eed-f96ecee30d1d.png">


# プラグイン設定のアップロード

- プラグイン設定をアップロードできます。
- フィールドコードをキーにして、設定ファイルから計算式を設定します。
- ブラウザ IE については、プラグイン設定のアップロードの動作対象外です。

<img width="935" alt="2019-07-11_09h18_57.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/100572/213b962c-bafd-eef3-bed6-08372a5a399b.png">

- プラグイン設定ファイル情報を確認して、設定します。

<img width="939" alt="2019-07-11_09h19_13.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/100572/a8287590-cbf9-f395-42ec-4f699eef329d.png">



#注意事項

- 既に、JavaScript によるカスタマイズを行っているアプリの場合、処理が競合して、エラーになる場合があります。その場合は、該当するアプリでプラグインの使用を中止してください。
- アプリ設定を変更した場合は、プラグインを再設定してください。
- Internet Explorer の場合、追加・編集画面においてリッチエディター項目の値が表示されず編集が出来ません。

# 参考

- [kintone 従業員名簿アプリのタブ表示例](https://qiita.com/rex0220/items/d4d0f2fd86875ac11f91)