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

カラムのピン留め

📌 の画びょうアイコンが各カラムヘッダーの左側に表示されます。これをクリックするとカラムがピン留めされ、もう一度クリックすると解除されます。このアイコンは実際のボタンなので、キーボード利用者は Tab キーで移動してキーボードでトグルできます。また、ピン留め状態は支援技術にも伝えられます。 ホバー可能なポインター (マウス) を備えたデバイスでは、アイコンはヘッダーにホバーしている間、またはトグルにフォーカスがある間だけ表示されるため、それ以外のときは邪魔になりません。一方、ホバーのないタッチ端末やその他の粗いポインターデバイスでは、直接タップできるようアイコンは常に表示されます。ピン留めされたカラムでは、その状態を示すため、アイコンがはっきり表示されたままになります。

ピン留めを利用できる場合

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

スクロール時のピン留めされたカラムの動作

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

結果間で共有

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

永続性

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

制限事項

  • 縦方向 (転置) の単一行表示には横スクロールするカラムがないため、ピン留めはできません。
最終更新日 2026年7月23日