はじめに
「グループフィールド開閉API」を使ったJavaScriptカスタマイズを紹介します。
このAPIを使うことでたとえば、回答の条件によって、グループフィールドを開いたり閉じたりしたい!という要望にお応えできます。
分岐のある入力項目がある場合に便利ですね。
今回ここで紹介するのは、製品の要望を集めるアプリのラジオボタンの選択肢によってグループフィールドを制御できるカスタマイズです。
デモ環境
cybozu developer network DemoSite
のデモ環境で実際に動作を確認できます。
ログイン情報は
cybozu developer networkデモ環境
で確認してください。
完成イメージ
設問「種類」のラジオボタンの選択肢によって開いておくグループフィールドを設定できます。
実際には下のように動きます。
サンプルアプリの準備
まずはアプリの準備をします。
今回は
kintoneアプリストア
にある「
製品評価箱アプリ
」を使います。
ダウンロードした「製品評価箱アプリ」に必要なフィールドを追加して、フィールドコードを新たに設定します。
フィールドの設定
サンプルアプリのフィールドは以下です。
製品評価箱アプリに、次のフィールドを付け足してください。
フィールド名 | フィールドコード | フィールドタイプ |
---|---|---|
不具合を選択された方 | group_failure | グループフィールド |
要望を選択された方 | group_demand | グループフィールド |
質問を選択された方 | group_question | グループフィールド |
その他を選択された方 | group_other | グループフィールド |
各グループフィールドの中には上の完成イメージ図や下図を参考に任意のフィールドを入れてみてください。
サンプルプログラム
|
|
プログラム(JavaScript)
「グループフィールド開閉API(kintone.app.record.setGroupFieldOpen)」を使って、まずアプリ内のすべてのグループフィールドを閉じる処理をします。
そのあと、ラジオボタンの値によって開くグループフィールドを切り替えています。
使用したAPI
- イベントハンドラーを登録する
- レコード詳細画面を表示した後のイベント
- レコード追加画面を表示した後のイベント
- レコード編集画面を表示した後のイベント
- レコード追加画面でフィールドの値を変更したときのイベント
- レコード編集画面でフィールドの値を変更したときのイベント
- グループフィールドを開閉する
最後に
他にもアレンジして便利にお使いいただけそうでしょうか?
今回はラジオボタンの選択肢によってグループフィールド開閉を切り替えるというものでした。
他にもプロセス管理のステータスによって切り替えるという利用シーンもありますね。
何かご不明な点などありましたらお気軽にコメントください。
デモ環境についての説明は cybozu developer networkデモ環境 を確認してください。