データエントリは Alius プラットフォームにおける重要なインタラクションパターンです。ユーザーはロボットの設定、パラメータの調整、設定ファイルの編集、技術データの入力を行います。データエントリシステムは、エラーを最小限に抑え、明確なガイダンスを提供し、コンテンツの技術的性質を尊重する必要があります。

フォームコントロール

Input（テキストフィールド）

  • 短い値（名前、識別子、URL、数値）用の単一行テキスト入力
  • 入力の上または左に配置された明確なラベルを含める
  • フィールドが空の場合、例値のプレースホルダーテキストを表示
  • 具体的なエラーメッセージ付きのインラインバリデーションを提供
  • 追加コンテキストのためのオプショナルなヘルパーテキストを入力下にサポート
  • 定義済みリストから選択するための単一選択ドロップダウン
  • 閉じた状態で現在選択されている値を表示
  • 長いリストのドロップダウン内での検索/フィルタリングをサポート
  • リストが多い場合、カテゴリー別にオプションをグループ化

マルチセレクト

  • リストから複数項目の選択を許可
  • 選択された項目を入力内のタグまたはチップとして表示
  • 全クリアオプションを提供
  • 大きなリスト内の項目検索のための検索/フィルタリングをサポート

Radio

  • 少数の相互排他的オプション（2〜5）からの単一選択
  • すべてのオプションが同時に可視であるべき
  • 選択前にオプションを比較する必要があるユーザー向け
  • 各オプションに明確なラベルを含める

Switch（トグル）

  • 設定と環境設定のバイナリオン/オフコントロール
  • 現在の状態（オンとオフ）を明確に示す
  • オプションが単に有効/無効である設定に使用
  • 説明的なラベルと組み合わせる

Slider

  • 定義された範囲内での連続値選択
  • スライダーの横に現在の値を数値で表示
  • min、max、step 値を明確に定義
  • おおよその値が許容されるパラメータに使用（例：明るさ、速度）

ファイルアップロード

  • ドラッグ＆ドロップとクリックして参照をサポート
  • 選択後にファイル名、サイズ、タイプを表示
  • アップロード前にファイルタイプとサイズをバリデーション
  • 大きなファイルのアップロード進行状況を表示
  • 該当する場合、複数ファイルアップロードをサポート

設定編集

コンフィグフォーム

  • 設定パラメータ編集用の構造化フォーム
  • 関連する設定を明確なセクションヘッダーでグループ化
  • 各パラメータの現在値、デフォルト値、有効範囲を表示
  • 「デフォルトにリセット」オプションを提供

YAML / JSON エディタ

  • 高度な設定編集用のコードスタイルエディタ
  • ターゲットフォーマットのシンタックスハイライト
  • 問題のある行にエラーインジケーター付きのリアルタイムバリデーション
  • 既知のキーと値のオートコンプリート
  • 現在の設定をデフォルトまたは以前のバージョンと比較する際の差分ビューを表示

データエントリの原則

  • 技術設定にはデフォルト値が必要 — 設定に空のフォームを提示してはならない。適切なデフォルト値を事前入力する
  • リスクのある設定には説明が必要 — 安全性、パフォーマンス、ハードウェア動作に影響するパラメータには警告と結果の説明を含める
  • エラー位置は明確に — バリデーション失敗時、ユーザーはどのフィールドにエラーがあるかとその理由を正確に知る必要がある
  • 入力例は完全に — プレースホルダーとヘルパーテキストには「テキストを入力」ではなく現実的で完全な例を表示
  • バッチ編集 — 可能な場合、1つずつではなく関連する複数の値をまとめて編集をサポート
  • 未保存変更の警告 — 未保存の変更があるフォームから移動しようとした場合、ユーザーに警告