Files
pages/docs/design/ja/navigation-search.md
T
Anya Tokugawa b90aef79d0
Build and publish container images / images (push) Successful in 11m37s
Release container images / release (push) Successful in 22s
feat: add browser upload queue and trusted sessions with bounded projections
2026-11-08 20:27:04 +09:00

3.8 KiB

8. 検索・ツリー・ホーム・設定画面

状態:検索・children・Tree・ホーム・ブックマーク・設定整理の初期機能は実装済み。大規模索引と共通サイドバーは継続課題。

閲覧の入口

トップバーの検索はhome PathではなくDomain全体の / を基準にします。指定フォルダ内の検索とはモードを分けます。結果は全文だけでなくタイトル・Path・City要素のどこに一致したかを示し、Quartier/Street/Spotを上位にまとめます。

ファイル種別、拡張子、作成・更新日を候補取得の前に適用します。snippet生成失敗で結果全体を消さず、HTMLをそのまま検索結果へ注入しません。日本語の部分一致・現在Revisionだけの索引は残課題です。

childrenとTree

childrenは現在Pathを既定にし、表示形式は本文macroの view 引数ではなくナビゲーションのアイコン操作で切り替えます。仮想フォルダでは設定により配下を表示します。サムネイルは描画を妨げず非同期取得します。

/v/tree/{path} は範囲を限定します。展開・全展開・全折りたたみ状態の保持、複数選択、rename・移動・削除はPath操作と一致させます。一般の子一覧から予約ユーザー領域を混入させません。再帰操作は事前の全対象確認と競合検出が必要です。

Browserのアップロード

/v/browser/{path} の一覧へファイルをドロップすると、現在のPath配下へアップロードします。フォルダ行へのドロップではそのフォルダが宛先になります。既存の内部Path移動・選択操作とは区別します。

右下のフローティングカードに待機・送信中・完了・失敗・取消と進捗を表示します。追加ドロップは同じキューへ積み、送信は1件ずつ、最大100件・各256 MiBまで。待機中の取消、折りたたみ、終了分のクリアに対応します。終了後は一覧だけを再取得し、キューは残します。

既存の認可付き /v/upload を使用し、If-None-Match: * で同名Pathの上書きを防ぎます。通信断は保存結果不明として扱い、自動再送しません。キューはページ内のみで、ページ離脱・再起動後の再開やフォルダの再帰アップロードには未対応です。新規オブジェクト・Path・初回Revisionの一体的なトランザクション化は残課題です。

ホームとブックマーク

通常トップバー型、中央検索型、検索+セクションカード型を選びます。セクションは手動URL/Path、または指定親の子リンクを表示します。設定は歯車のポップアップで、閲覧画面を編集フォームで埋めません。カード列はviewportに適応します。

外部ブックマーク連携は、手動登録と同期由来を区別し、同期時にローカル項目を削除しません。

設定画面

基本・認証・ドキュメント・拡張・運用等のグループとサブパネルを使います。選択したパネルだけ非同期で読み込みます。フォームの入力をpollingで上書きしません。トグルの装飾には実際のlabel・フォーカス・キーボード操作を残します。

テーブルは一行中心、詳細は展開またはポップアップへ。非JSONの403等をJSON parse errorに置き換えず、元の原因を表示します。

TODO

directory索引と不透明cursor、権限付き検索の十分なrecall、共通サイドバー、個人ブックマーク、関連するテーブルのアクセシビリティ試験。キャッシュは認可結果の長期保存にせず、現在の権限を再評価します。