> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> 組み込みの Web SQL UI（`/play`）のピン留めされたカラム（sticky）に関するドキュメント

# Web UI のピン留めされたカラム

組み込みの Web SQL UI (`play.html`。任意の ClickHouse HTTP ポートの [`/play`](/docs/ja/concepts/features/interfaces/http) パスで提供) では、結果内で選択したカラムを表示したまま、テーブルの残りを横方向にスクロールできます。ピン留めされたカラムはスクロールして見えなくならず、結果領域の手前側の端に留まるため、識別子、名前、日付といったキーになるカラムを、確認中の右端のカラムの横に常に表示しておけます。

<div id="pinning-a-column">
  ## カラムのピン留め
</div>

📌 の画びょうアイコンが各カラムヘッダーの左側に表示されます。これをクリックするとカラムがピン留めされ、もう一度クリックすると解除されます。このアイコンは実際のボタンなので、キーボード利用者は `Tab` キーで移動してキーボードでトグルできます。また、ピン留め状態は支援技術にも伝えられます。

ホバー可能なポインター (マウス) を備えたデバイスでは、アイコンはヘッダーにホバーしている間、またはトグルにフォーカスがある間だけ表示されるため、それ以外のときは邪魔になりません。一方、ホバーのないタッチ端末やその他の粗いポインターデバイスでは、直接タップできるようアイコンは常に表示されます。ピン留めされたカラムでは、その状態を示すため、アイコンがはっきり表示されたままになります。

<div id="when-pinning-is-available">
  ## ピン留めを利用できる場合
</div>

ピン留めを利用できるのは、テーブルの幅が横スクロールを必要とする場合だけです。テーブル全体がビューポート内に収まっている場合は、スクロールして見えなくなる部分がないため、ピン留めのトグルは無効になり、キーボードのタブ移動順からも除外されます。結果が横方向にスクロール可能になると、つまり、結果が横に広い場合、ウィンドウ幅が狭い場合、またはストリーミングされた結果が横方向に広がっていく場合には、トグルが有効になります。

<div id="how-a-pinned-column-behaves-when-scrolling">
  ## スクロール時のピン留めされたカラムの動作
</div>

ピン留めされたカラムは、水平スクロール中はコンテンツと一緒に移動し、ビューポートから外れそうになると手前側の端に固定されます。左側のカラムは左端に、右側のカラムは右端に固定され、そのまま表示され続けます。複数のピン留めされたカラムがある場合は、元の順序のまま端に沿って重なり、それぞれが境界線によってスクロール中のコンテンツと区切られます。固定セルは、その下をスクロールする通常のセル (選択中のセルを含む) の上に描画されるため、常に読みやすい状態が保たれます。

<div id="shared-across-results">
  ## 結果間で共有
</div>

ピン留めはカラム名ごとに管理され、列ごとの[色分けモード](/docs/ja/concepts/features/interfaces/web-ui-color-coding)と同様に、ページ上のすべての結果テーブル間で共有されます。ある結果で `id` という名前のカラムをピン留めすると、他の結果や、同じカラムを返す後続のクエリでも、その `id` カラムはピン留めされたままになります。

<div id="persistence">
  ## 永続性
</div>

固定したセットは、ページのURL、ブラウザーの履歴、タブごとの結果スナップショットに保存されるため、ページを再読み込みしたり、リンクを共有したり、前後に移動したりしても維持されます。コンパクトに保つため、保存されるのは固定したカラムだけで、空のセットはURLや履歴状態に何も追加しません。

<div id="limitations">
  ## 制限事項
</div>

* 縦方向 (転置) の単一行表示には横スクロールするカラムがないため、ピン留めはできません。