テーブル
データ・バインディング
「一般」プロパティー・タブでビューのデータ・バインディングの設定や変更を行います。 テーブル・ビューはオブジェクトのリストにバインドされ、このリストによって行にデータが取り込まれます。
構成プロパティー
「構成」で、ビューの構成プロパティーを設定または変更します。
- 画面サイズ
- プロパティー名の横に画面サイズ・アイコン がある構成プロパティーは、画面サイズごとに異なる値を持つことができます。 値を設定しない場合、画面サイズはそのデフォルト値として次に大きい画面サイズの値を継承します。
- テーマ定義
- テーマ定義は、ビューの色およびスタイルを指定し、その外観を決定します。 ビューのルック・アンド・フィールをテーマ・エディターでプレビューできます。 テーマを参照してください。
外観構成プロパティー | 説明 | データ・タイプ |
---|---|---|
表スタイル | 表のスタイル。 次のオプションの中から選択できます。
|
TableStyle |
色のスタイル | 表の色のスタイル。 色は、指定したテーマの変数に対応します。 次のオプションの中から選択できます。
|
TableColorStyle |
選択を強調表示 | 選択された行に陰影を付けます。 このオプションが機能するのは、色スタイルが指定されている場合です。 | Boolean |
幅 | テーブルの幅を指定します。 幅の単位は px (ピクセル)、% (パーセント)、または em で指定できます。 例えば、 50px、 20%、または 0.4emです。 単位タイプが指定されていない場合は、px とみなされます。 | String |
高さ | ビューの高さを指定します (px (ピクセル) または em 単位)。 単位タイプが指定されていない場合は、px とみなされます。 高さには、ヘッダーまたはフッターは含まれません。 高さを指定した場合、行が表の本文の使用可能な垂直方向のスペースを超えると、本文が垂直方向にスクロール可能になります。 | String |
列見出しを折り返す | テーブル内の使用可能なスペースに応じて、列見出しを折り返します。 | Boolean |
ポップアップの表示 | 高さが指定されない場合に、テーブルの上にポップアップ・メニューやビューを表示します。 例えば、このオプションが選択されている場合は、日時ピッカー・ビューがテーブルの上に表示されます。 このオプションが選択されていない場合は、日時ピッカーはテーブル・セルに埋め込まれます。 | Boolean |
ヘッダーとフッターのスタイル設定 | 別のヘッダー/フッター・スタイルを適用できます。 例えば、 Modern スタイルは、ヘッダーとフッターのページ編集を簡素化します。 | TableHFStyle |
動作構成プロパティー | 説明 | データ・タイプ |
---|---|---|
選択モード | ユーザーが選択可能な行数を指定します。
|
TableSelectionMode |
削除ボタンを表示 | 行を削除するボタンの表示/非表示を切り替えます。 | Boolean |
フッターの表示 | フッターの表示/非表示を切り替えます。 フッターは、「追加ボタンの表示」などのフッター・ビューのいずれかが有効になっている場合にも表示されます。 | Boolean |
追加ボタンの表示 | 行を追加するボタンの表示/非表示を切り替えます。 表のソートまたはフィルタリングを行っている場合、ソートまたはフィルタリングをクリアするまで、新規に追加した行が表の最後の行として表示されない場合やまったく表示されない場合があります。 「最新」 のヘッダーとフッターのスタイルを選択し、 「追加」 ボタンを表示する場合は、 「フッターの表示」 オプションも選択する必要があります。 |
Boolean |
テーブル統計の表示 | フッターの表の統計の表示を使用可能にします。 例えば、Showing
1 to 5 of 59 entries などです。「フッターの表示」オプションも選択する必要があることに注意してください。 |
Boolean |
ページャーの表示 | ページ番号の表示/非表示を切り替えます。 ページャーに表示されるのは 5 ページのみです。したがって、最初のページ・サイズとレコード数によっては、ページが連続 (1、2、3...) しない場合があります。 例: 表の項目数が合計 50 で、初期ページ・サイズが 5 に設定されています。 表示されるページ番号は、1、3、5、7、10 です。 「次へ」ボタンをクリックすると、ページを順番に移動できます。ページ番号ボタンを使用すると、素早くページを移動できます。 「フッターの表示」オプションも選択する必要があることに注意してください。 |
Boolean |
ページ・サイザーの表示 | ページの行数を表示するページ・サイザーの表示/非表示を切り替えます。 | Boolean |
初期ページ・サイズ | ページに表示される行数。 | Integer |
列のサイズ変更 | ユーザーが列の区切りをドラッグして列をサイズ変更できるようにします。 | Boolean |
すべてのタイプ | ビューが ANY タイプ・リストにバインドされている場合のビジネス・オブジェクト定義タイプの指定。 | TableANYType |
列構成プロパティー | 説明 | データ・タイプ |
---|---|---|
レンダリング方法 | セル内容のレンダリング方法。
通常、表のセルにネストされるビュー (整数や日付ピッカー (非推奨) など) にはボーダーが表示されます。 表にも独自のボーダーがあります。 ネストされたビューのボーダーを削除するには、シームレス・ビューを使用します。 Coach ビューまたはシームレス Coach ビューを使用している場合に、ネストされたビューのラベルを表示するには、「showLabel」を選択します。 詳しくは、 レンダリング・タイプを参照してください。 |
String |
可視性 | 列の可視性。 | String |
ソート可能 | この列のデータのソートを許可します。 デフォルトでは、単純型にバインドされている列のみをソートできます。 複合型をソートするには、「レンダリング方法 (Render as)」を「カスタム」に設定して、「カスタム・セル時」イベントを使用する必要があります。 例:
|
Boolean |
オプション | データ型に応じて列のデータをフォーマットするオプション。
|
String |
CSS | 列に適用される CSS スタイル。 CSS スタイル (例: color:#00ff00 ) を使用することも、CSS クラスを使用することもできます。 このフィールドにコロンがある場合、テーブル・ビューは、CSS スタイルが指定されているものと想定します。 それ以外の場合は、1 つ以上の CSS クラス名が指定されているものと想定します。 |
String |
幅 | 列の幅は、px、em、または % 単位です。 単位が指定されていない場合は、px と見なされます。 注意: 1 つの列の幅を未定義のままにすることを検討してください。そうすれば、ブラウザーが残りのスペースを計算し、幅が未指定の列に割り当てることができます。 | String |
ラベル | 列のラべル。 | String |
showLabel | セルが Coach ビューまたはシームレス Coach ビューとしてレンダリングされている場合、ビュー・ラベルを表示または非表示にします。 | Boolean |
パフォーマンス構成プロパティー | 説明 | データ・タイプ |
---|---|---|
非同期ロード | 大規模なデータ・セットの場合の UI エクスペリエンスを向上させます (その代わり、セクションがロードを開始すると、全体的な行のロード時間は低速になります)。 | Boolean |
非同期バッチ・サイズ | 非同期バッチで同期的にロードされる行数を定義します。 非同期ロードのパフォーマンスに対して、同期を調整/最適化するのに役立ちます。 | Integer |
例
- String 型の name パラメーター。
- String 型の favoriteSport パラメーター。
- String 型の favoritePlayer パラメーター。
var autoObject = [];
autoObject[0] = {};
autoObject[0].name = "Dylan";
autoObject[0].favoriteSport = "Tennis";
autoObject[0].favoritePlayer = "Federer";
autoObject[1] = {};
autoObject[1].name = "Max";
autoObject[1].favoriteSport = "Soccer";
autoObject[1].favoritePlayer = "Messi";
autoObject
クライアント・サイド・ヒューマン・サービスには、Profiles[] 型のプライベート変数 profiles があります。
- 「一般」>「ラベル」は「プロファイル - Coach One (Profiles - Coach One)」です。
- 「一般」>「バインディング」は profiles[] です。
- バインディング profiles.currentItem.name を持つ「名前」列
- バインディング profiles.currentItem.favoriteSport を持つ「お気に入りのスポーツ (Favorite Sport)」列
- バインディング profiles.currentItem.favoritePlayer を持つ「お気に入りのプレイヤー (Favorite Player)」列
- 「構成」>「動作」
- 「選択モード」は「単一」です
- 「削除ボタンの表示」が選択されています
- 「フッターの表示」が選択されています
- 「追加ボタンの表示」が選択されています
- 「表の統計の表示」が選択されています
- 「構成」>「列」には 3 つの項目があり、以下のように設定されています。
- 「レンダリング方法 (RenderAs)」は「Coach ビュー」に設定されています
- 「可視性」は「表示」に設定されています
- 「ソート可能 (Sortable)」が選択されています
クライアント・サイド・ヒューマン・サービスで、ページのコピーを作成して、最初のページにワイヤリングします。 2 番目のページで「表 (Table)」のラベルを「プロファイル - Coach 2 (Profiles - Coach Two)」に変更します。
レンダリング・タイプ
- Coach ビュー
- このレンダリング・タイプ (デフォルト・タイプ) は、JavaScript ロジックを実行するビューとしてテーブル列のコンテンツをレンダリングする場合に使用します。 このレンダリング・タイプは、データ集中型であり、列レンダリングのパフォーマンスに影響を与える可能性があります。 例えば、ボタンをクリックするとテーブルに含まれるモーダル・セクションが表示されるようにするには、ボタンのイベントで以下の JavaScript のような Coach ビュー・レンダリング・タイプとロジックを使用できます。
- シームレス Coach ビュー
- このレンダリング・タイプは、レンダリング時にテーブルに含まれているビューのボーダーを削除する場合に使用します。 このレンダリング・タイプを使用して、整数や 10 進数などの標準的なフォーム入力ビューのレンダリングの外観を変更できます。 外観の違い以外では、このレンダリング・タイプはビューと同じように扱われます。
- シンプル HTML
- このレンダリング・タイプは、テーブル・フィールドが JavaScript ロジックを実行しない場合にのみ、純粋な HTML を使用してテーブル・コンテンツをレンダリングするために使用します。 (例えば、ビュー・イベントで) JavaScript を実行するフィールドとともに使用すると、ビューはページにレンダリングされません。 このレンダリング・タイプは、説明しているタイプの中で最もデータ集中型でありません。
- カスタム
- このレンダリング・タイプは、カスタム・テーブル列にレンダリング・オプションを指定したり、フィールドの外観を指定したりする場合に使用します。 テーブル列の構成データを編集する際に、「オプション」編集ボックスを使用して、既に作成されているオブジェクトに適用するオプションの書式設定を指定できます。 例: 。
イベント
「イベント」プロパティーでビューのイベント・ハンドラーの設定や変更を行います。 イベントをプログラムでトリガーするかユーザーがビューと対話したときにトリガーするように設定できます。 イベントを定義およびコーディングする方法については、 ユーザー定義イベントを参照してください。
テーブルには、以下のタイプのイベント・ハンドラーがあります。
- : テーブルのロード時に活動化されます。 例:
me.setPageIndex(0);
- : (列構成で設定された) カスタム・レンダリング・オプションを持つセルがロードされたときにアクティブ化されます。 このイベントを使用するには、「列」構成で「レンダリング」を構成値として設定する必要があります。 このイベントを使用して、複合タイプを設定することもできます。 例:
var div = document.createElement("div"); div.innerHTML = cell.row.data[cell.varName]; return div;
- : 行が表示されたときにアクティブ化されます。 このイベントは、ページ・テーブルに対してのみ適用できます。 例:
alert("All rows have " + (all ? "" : "NOT") + " been loaded");
- : このイベントは、拡張可能な行がロードされたときに起動します。 このイベントを使用するには、「拡張可能な行の許可」構成オプションを有効にする必要があります。 例えば、行が以下のようにレンダリングされるとします。
行が以下のようにレンダリングされる場合の例:row.views.forEach(function(view) { switch(view.context.viewid) { case "Text1": view.setData(row.data[varName]); break; case "Text2": view.setData(row.data[varName]); break; } });
var div = document.createElement("div"); div.innerHTML = row.data[varName] + " " + row.data[varName]; return div;
- : 行が展開されるとトリガーされます。 例:
${Service_Call1}.execute();
- : 行が省略されたときにトリガーされます。 例:
alert("Collapsed row has index " + row.recordIndex);
- : ユーザーが行を選択したときにアクティブ化されます。 例:
alert("Selected row has index " + row.recordIndex);
- : ユーザーが 「すべて選択」 を使用して、 「複数」 選択モードのテーブル内のすべての行を選択するか、すべてのテーブル行の選択をクリアしたときにアクティブ化されます。 これは、すべてという名前のコンテキスト変数を提供し、すべての行が選択されているか、どの行も選択されていないかを示します。 例:
alert("All rows selected: " + all);
- : このイベントは、ユーザーがボタンを使用して行を追加するときに呼び出されます。 JavaScript オブジェクトを返す場合は、オブジェクトが追加されます。それ以外の場合は、空のオブジェクトが追加されます。 例:
alert("New row will be added");
- : ユーザーがレコードの削除を要求したときにアクティブ化されます。 イベントが返された場合、レコードは削除されません。 このイベントを使用すると、レコードを正式に削除する前にユーザーに確認を求めることができます。 例:
return confirm("Are you sure you want to delete item " + item.str1);
- : ユーザーがテーブル列ヘッダーのソート・アイコンをクリックするとアクティブ化されます。 カスタム・ソートを使用するように戻り、デフォルトのテーブル・ソートをスキップします。 このイベントを使用して、カスタム・ソート・リストに設定できます。 例:
alert("Sorting " + col + " column in " + order + " order"); me.context.binding.set("value", myCustomSortedList); return false;
- : ユーザーがページごとの入力フィールドの値を変更したときにアクティブ化されます。 例:
me.showPager(true);
- 21.0.2 : ユーザーが列のサイズを変更したときにアクティブ化されます。 例:
alert("Column resized");
- : ユーザーが列をドラッグ・アンド・ドロップしたときにアクティブ化されます。
alert("Column dropped");
メソッド
テーブルに使用できるメソッドの詳細情報については、 テーブル JavaScript API を参照してください。
追加リソース
Coach またはページの作成方法については、 Coach の作成を参照してください。
標準プロパティー (「一般」、 「構成」、 「位置決め」、 「可視性」、および 「HTML 属性」) について詳しくは、 「プロパティーの表示」を参照してください。