kintone API ドキュメント

フィールド要素を取得する

目次

フィールド要素を取得する

フィールドコードを指定して、現在開いているレコード内のフィールド要素を取得します。

フィールド要素の取得、および取得した DOM の style（装飾するためのタグの属性）の変更のみをサポートしています。

関数

PC

kintone.app.record.getFieldElement(fieldCode)

モバイル

kintone.mobile.app.record.getFieldElement(fieldCode)

引数

パラメーター名 型 必須 説明
fieldCode 文字列 必須 取得するフィールドのフィールドコード

戻り値

型 説明
Element オブジェクト 指定したフィールドの要素
null になる条件
  • 利用できない画面
  • 次のフィールドのフィールドコードを指定したとき
    • ステータス
    • 作業者
    • テーブルに含まれるフィールド
    • 関連レコード一覧に含まれるフィールド
    • 閲覧権限のないフィールド
    • （モバイルのみ）グループ

利用できる画面

PC
  • レコード詳細画面
  • レコード印刷画面
モバイル
  • レコード詳細画面

サンプルコード

1
2
3
4
5

// フィールドコードが「文字列_0」のフィールド要素を取得
const element = kintone.app.record.getFieldElement('文字列_0');

// 要素の文字色を赤に設定する
element.style.color = 'red';

制限事項

  • 取得した DOM の内部構造を変更するような処理を行うと、kintone のバージョンアップ後に動作しなくなる可能性があります。