# 一覧の列を固定 詳細マニュアル | 設定リファレンス・トラブルシューティング - KINTAUROS

> kintoneプラグイン「一覧の列を固定」の詳細マニュアル。全設定項目のリファレンス(意味・制約値)、動作条件・制限事項、エラーコード別のトラブルシューティングを掲載。対象バージョン: v1.0.0。

元ページ: https://kintauros.com/plugins/column-freeze/manual/

一覧の列を固定は、レコード一覧(表形式の一覧)の左側の列を固定し、横にスクロールしても見えるようにするプラグインです。Excel の「ウィンドウ枠の固定」と同じ感覚で、取引先名や案件名を左に残したまま右側の項目を確認できます。一覧は作り直さず kintone 標準の一覧のまま固定するため、インライン編集・並べ替え・列幅の変更はそのまま使えます。固定する列の数は、設定画面ですべての一覧の既定と一覧ごとの列数を決め、利用者は一覧の上部の「列の固定」ボタンから自分の列数に変えられます(そのブラウザにだけ保存)。このマニュアルでは、設定項目のリファレンスと、動作仕様・制限事項・トラブルシューティングを説明します。

機能紹介・画面イメージ・導入手順は[プラグイン紹介ページ](https://kintauros.com/plugins/column-freeze/)を、ダウンロードは[ダウンロードページ](https://kintauros.com/download/)をご覧ください。このマニュアルは[Markdown版](index.md)でも提供しており、全プラグインのメタ情報と設定スキーマは機械可読な[catalog.json](https://kintauros.com/catalog.json)から取得できます。

## 基本情報

- **プラグインID**: column-freeze

- **対象バージョン**: v1.0.0(配布中の最新版)

- **カテゴリ**: 一覧画面カスタマイズ

- **説明**: レコード一覧の左側の列を固定し、横にスクロールしても見えるようにします。

## 動作条件

- **対応環境**: kintone スタンダードコース(デスクトップ版UI)。最新版の Google Chrome で動作を確認しています(Edge・Safari・Firefox は順次確認します)。モバイルアプリ・モバイル版の画面では動作しません。

- **動作画面**: レコード一覧画面の表形式の一覧(「（すべて）」を含む)。カレンダー形式・カスタマイズ形式の一覧、レコード詳細・追加・編集画面では何もしません。

- **必要な準備**: 特にありません。フィールドやスペースの追加は不要で、プラグインを追加して列数を選ぶだけで使えます。

- **必要な権限**: 利用者: レコードの閲覧権限。プラグインの設定: アプリの管理権限。

## 設定項目リファレンス

プラグイン設定の全項目です。「項目」は設定データ(エクスポートファイルの config)のキーを表し、[] は配列の要素を意味します。設定画面での入力項目と1対1に対応します。この構造の正式な定義はJSON Schema([catalog.json](https://kintauros.com/catalog.json) の configSchema)として公開しています。

- **項目**: 型 / 必須 / 説明・制約

- **defaultCount**: 整数 / 必須 / すべての一覧の既定の列数 / 左から数えたフィールドの列の数。0 は固定しない。一覧ごとの指定が無い一覧(「（すべて）」を含む)に使う。 / 0以上 / 10以下

- **views**: 配列 / 任意 / 一覧ごとの列数 / 既定と違う列数にする一覧だけを持つ。一覧は ID で照合し、見つからなければ一覧名で照合する(アプリの再利用・設定のインポートで ID が変わる場合のため)。

- **views[].id**: 文字列 / 必須 / 一覧の ID / 形式: ^[0-9]+$

- **views[].name**: 文字列 / 任意 / 一覧名(ID で見つからないときの照合と表示用)

- **views[].count**: 整数 / 必須 / 列数(0 は固定しない) / 0以上 / 10以下

- **allowUserChange**: 真偽値 / 任意 / 一覧画面のボタンで利用者が列数を変えられるようにする / true のとき、一覧の上部に「列の固定」ボタンを表示する。利用者が選んだ列数はそのブラウザにだけ保存され、ほかの利用者には影響しない。

## 設定のポイント

- defaultCount(すべての一覧の既定の列数)は 0〜10 です。左から数えたフィールドの列の数で、0 は固定しません。一覧ごとの指定が無い一覧(一覧を作っていないアプリの「（すべて）」を含む)に使います。

- 左端の「レコードの詳細を表示する」アイコンの列は列数に数えません。1 列以上固定するときは、このアイコンの列も一緒に固定します。

- views(一覧ごとの列数)は、既定と違う列数にする一覧だけを持ちます。設定画面にはアプリの表形式の一覧が並び、一覧ごとに列数を選べます(「既定に従う」のままの一覧は保存しません)。

- views[] の一覧は ID で照合し、見つからなければ一覧名で照合します。アプリを再利用して作ったアプリや、設定をインポートしたアプリで一覧の ID が変わっても、一覧名が同じなら引き継がれます。

- allowUserChange(利用者による変更)を有効にすると、一覧の上部に「列の固定」ボタンを表示し、利用者が自分の列数に変えられます(既定は有効)。無効にするとボタンを表示せず、利用者がこれまでに選んだ列数も使いません(全員が設定画面の列数になります)。

## 動作仕様

- レコード一覧(表形式)を表示すると、左から設定した数の列を固定します。横にスクロールすると、固定した列は左端に残り、ほかの列がその下をくぐるように動きます。固定した列の右端には影を付けて境目を示します。

- 一覧は作り直さず、kintone の一覧の表のセルに固定の指定を加えるだけです。インライン編集(鉛筆アイコン)・列見出しのクリックによる並べ替え・列幅の変更・レコードの詳細を開くアイコン・編集/削除のボタンは、kintone 標準のまま使えます。インライン編集で保存して行が描き直されても固定は保たれます。

- 縦にスクロールしたときに kintone が上部に表示する列見出しも、同じ列が固定されます。

- 列幅をドラッグで変えたとき・ブラウザのウィンドウの幅が変わったときは、固定する位置を自動で計算し直します。

- 列数の決め方: (1) 利用者がボタンで選んだ列数(利用者による変更が有効なときだけ)、(2) 一覧ごとの列数、(3) すべての一覧の既定、の順に使います。

- 「列の固定」ボタン: 一覧の上部(レコード作成ボタンの右)に表示し、いまの列数をバッジで示します(固定しないときは「なし」)。押すと「左から固定する列」の選択肢が開き、「1 列(〜レコード番号)」のように、どの列まで固定されるかを列見出しの名前で選べます。選ぶとすぐに反映されます。

- 利用者が選んだ列数は、アプリ・一覧ごとにそのブラウザ(localStorage)にだけ保存されます。kintone のサーバーにも KINTAUROS のサーバーにも送られず、ほかの利用者やプラグインの設定には影響しません。別のパソコンやブラウザでは設定画面の列数に戻ります。ポップアップの「既定に戻す」で、設定画面の列数に戻せます。

- ブラウザの設定などでブラウザに保存できない場合も、選んだ列数はその画面には反映されます(ページを開き直すと設定画面の列数に戻ります)。

- レコードが 0 件の一覧では表が表示されないため、何もしません。カレンダー形式・カスタマイズ形式の一覧に切り替えたときは、固定を外して何もしません。

- 外部通信: レコードのデータが KINTAUROS のサーバーに送られることはありません。KINTAUROS への通信はライセンス確認(kintone ドメイン名・プラグインID・バージョンのみ)です。

## 制限事項・既知の仕様

- 対象は PC のレコード一覧(表形式の一覧)のみです。カレンダー形式・カスタマイズ形式の一覧、モバイルアプリ・モバイル版の画面、レコード詳細画面のテーブル(サブテーブル)では動作しません。

- 固定できるのは左から最大 10 列までです。右側の列や、左から飛び飛びの列だけを固定することはできません。固定する列は、一覧の設定での列の並び順に従います。

- 固定した列の幅の合計が画面の幅に近いと、ほかの列を見る余地が少なくなります。列数は少なめにしてください。

- 行にマウスを重ねたときに kintone が表示する枠線は、固定した列の上には表示されません(見た目のみで、操作には影響しません)。

- 利用者が選んだ列数はブラウザごとに保存されるため、別のパソコン・ブラウザには引き継がれません。ブラウザのサイトデータを削除すると設定画面の列数に戻ります。

- 動作確認は最新版の Google Chrome で行っています。Edge・Safari・Firefox は順次確認します。

## 設定のインポート / エクスポート

プラグイン設定画面の上部にある「設定のインポート / エクスポート」から、現在の設定をJSONファイルとして書き出し(エクスポート)、別のアプリで読み込み(インポート)できます。検証用アプリから本番アプリへの設定コピーや、バックアップ・復元にご利用ください。

- インポートは取り込む内容の差分を確認してから「設定画面に反映」し、最後に「保存」を押して確定します(反映しただけでは保存されません)。

- 読み込んだファイルはブラウザ内で処理され、KINTAUROSのサーバーには送信されません。

- 別のアプリの設定を取り込んだ場合、このアプリに存在しないフィールドは警告として一覧表示されるので、反映後に該当箇所を選び直してください。

エクスポートファイルは次の形式(封筒形式)です。config の中身が設定本体で、その構造は上の設定項目リファレンスのとおりです。

```
{
  "kintauros": "config/v1",
  "plugin": "<プラグインID>",
  "pluginName": "<プラグイン名>",
  "pluginVersion": "<バージョン>",
  "exportedAt": "<書き出し日時(ISO 8601)>",
  "sourceApp": "<書き出し元アプリID>",
  "config": { ... 設定本体 ... }
}
```

### AIエージェント向け: ブラウザコンソールAPI

各プラグインは共通ランタイム window.KINTAUROS を搭載しており、ブラウザの開発者コンソールから設定の読み取り・検証・保存ができます。設定の保存(save: true)はkintoneの制約上、プラグイン設定画面でのみ成功します。

```
KINTAUROS.config.plugins()                   // このページのKINTAUROSプラグインID一覧
KINTAUROS.config.describeAll()               // 同居プラグインすべての設定サマリ
KINTAUROS.config.of('<プラグインID>').schema()    // 設定のJSON Schema
KINTAUROS.config.of('<プラグインID>').export()    // 現在の設定(封筒つき)
KINTAUROS.config.of('<プラグインID>').validate(x) // 保存せず検証
KINTAUROS.config.of('<プラグインID>').diff(x)     // 現在の設定との差分
await KINTAUROS.config.of('<プラグインID>').import(x, { save: true }) // 検証して保存(設定画面のみ)
```

登録が1件だけのページでは of(...) を省略できます(例: KINTAUROS.config.export())。

## トラブルシューティング

**列が固定されない**

(1) 表形式の一覧か確認してください(カレンダー形式・カスタマイズ形式の一覧では動作しません)。(2) 「列の固定」ボタンのバッジが「なし」なら、ボタンから列数を選んでください。(3) 設定画面で、その一覧の列数または既定が「固定しない」になっていないか確認してください。(4) 一覧の幅が画面に収まっていて横にスクロールできない場合は、見た目は変わりません(横にスクロールすると固定が効きます)。

**設定画面で列数を変えたのに、自分の一覧だけ変わらない**

以前に「列の固定」ボタンで自分の列数を選んでいると、そのブラウザではその列数が優先されます。ボタンを押してポップアップの「既定に戻す」を押すと、設定画面の列数になります。

**「列の固定」ボタンが表示されない**

設定画面の「利用者による変更」が無効になっているか、表形式以外の一覧を表示しています。ボタンが不要な場合は無効のままで、全員が設定画面の列数で固定されます。

**固定した列が画面の大部分を占めて、ほかの列が見づらい**

固定する列数を減らすか、固定する列の列幅を狭めてください。利用者は「列の固定」ボタンから自分の列数を減らせます。

**アプリを再利用(コピー)したら、一覧ごとの列数が効かない**

一覧ごとの列数は一覧の ID で照合し、見つからなければ一覧名で照合します。コピー先で一覧名を変えている場合は照合できないため、コピー先のアプリでプラグインの設定画面を開き、一覧ごとの列数を選び直して保存してください。

## エラーコードと診断情報

一覧の列を固定を含むKINTAUROSプラグインは、エラー発生時にブラウザのコンソールへ統一形式のログを出力します。人間向けの1行に続けて、機械可読なJSON(code / plugin / version / appId / message / doc)を出力し、doc には該当エラーの解説ページのURLが入ります。

```
[KINTAUROS <プラグインID>@<バージョン>] E001: 設定されたフィールドが見つかりません: ...
{"kintauros":{"code":"E001","plugin":"...","version":"...","appId":"...","message":"...","doc":"https://kintauros.com/docs/errors/E001"}}
```

各エラーコードの意味と対処は[エラーコード一覧](https://kintauros.com/docs/errors/)を参照してください。また、プラグイン設定画面の「サポート用情報をコピー」から、環境・バージョン・ライセンス状態・直近のエラーを含む診断情報をコピーできます(レコードの内容や個人情報は含まれません)。お問い合わせの際はこの情報を添えてください。

## ライセンスについて

- 初回利用時は、プラグイン設定画面の「利用開始」ボタンから60日間の無料トライアルを開始できます(カード登録不要)。

- トライアル・契約の期限が切れるとプラグインの動作は停止し、画面に案内が表示されます。[料金プラン](https://kintauros.com/#pricing)から契約すると同じ設定のまま再開できます。

- ライセンス確認のための外部通信で送信されるのは、kintoneドメイン名・プラグインID・バージョンのみです。レコードの内容や個人情報が外部に送信されることはありません。

- ライセンスサーバーに一時的に接続できない場合も、プラグインは一定期間動作を継続する設計です。

## サポート

解決しない場合は[お問い合わせ](https://kintauros.com/contact/)からご連絡ください。その際、プラグイン設定画面の「サポート用情報をコピー」でコピーした診断情報を添えていただくと、調査がスムーズです。

最終更新: 2026-10-23 / 対象バージョン: v1.0.0