Warning

注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

Handlebars で値にアクセスする

Slate では、クエリ、関数、ウィジェットのテンプレートに Handlebars ↗ を使用しています。Handlebars のテンプレートは {{}} で囲まれ、ウィジェット、変数、クエリ/関数の結果などの Slate オブジェクトにアクセスできます。例えば、ドロップダウンウィジェット w1 がある場合、テンプレート {{w1.selectedValue}} を使用して選択された値にアクセスできます。Slate は自動的にテンプレートを評価し、評価された値に置き換えます。

Handlebars のテンプレートでは、ヘルパー関数を呼び出すこともできます。詳細は、Helpers を参照してください。

どの Slate オブジェクトを参照できますか?

変数

Variables エディターで定義された 変数 には {{variableName}} でアクセスできます。例えば、変数 var1{"a": [1,2,3]} の場合、テンプレート {{var1.a.[0]}}1 に評価されます。 また、現在のアプリケーションユーザーやユーザー専用ストレージに関する情報を含む Slate の 環境変数 にもアクセスできます。例えば、テンプレート {{$global.user.firstName}} を使用すると、ユーザーの名前が表示されます。

クエリ

クエリの結果 にアクセスできます。例えば、{{myQuery}} は SQL または HttpJson クエリからの結果を含みます。また、一部のメタデータを含む隠し _response フィールドもあります。

Copied!
1{ 2 "name": ["Ceres","Pallas"], // 天体の名前 3 "earthmoid": [1.59376,1.23071], // 地球からの最小距離(天文単位) 4 "pha": [false,false], // 潜在的に危険な天体かどうか 5 "datefirstobs": ["1830-04-18","1825-03-23"], // 初めて観測された日付 6 "_response": { 7 "hasRun": true, // 実行されたかどうか 8 "message": "Unable to parse query.", // クエリを解析できなかったというメッセージ 9 "success": false // 成功したかどうか 10 } 11}

関数

ハンドルバーで関数名を囲むことで、関数の戻り値にアクセスできます。例えば、{{myFunction}}とします。

ウィジェットのプロパティ

特定のウィジェットプロパティにアクセスできます。具体的には、テンプレートはリーフプロパティ(配列とそのサブプロパティを含む)にアクセスできます。例えば、チャートウィジェットがあると仮定します。

これらはウィジェットの raw JSON タブにリストされているプロパティです:

Copied!
1{ 2 "allowSelection": true, // 選択を許可 3 "animate": true, // アニメーションを有効に 4 "datasets": [ // データセット 5 { 6 "name": "dataset1", // データセットの名前 7 "renderer": "bar", // レンダリングタイプ 8 "xValues": "{{yearToObsNum.name}}", // x軸の値 9 "yValues": "{{yearToObsNum.numofobs}}" // y軸の値 10 } 11 ], 12 "labelsEnabled": false, // ラベルを非表示 13 "panZoomEnabled": false, // パンズームを無効に 14 "selection": { // 選択範囲 15 "indices": [], 16 "xMax": null, 17 "xMin": null, 18 "xValues": [], 19 "yMax": null, 20 "yMin": null, 21 "yValues": [] 22 }, 23 "tooltipsEnabled": false, // ツールチップを無効に 24 "xAxes": [ // x軸の設定 25 { 26 "gridlinesEnabled": false, // グリッドラインを無効に 27 "label": "first observed {{w9.selectedValue}}", // ラベルのテキスト 28 "name": "x1", // 軸の名前 29 "position": "bottom", // 軸の位置 30 "scale": "category" // スケールのタイプ 31 } 32 ], 33 "yAxes": [ // y軸の設定 34 { 35 "gridlinesEnabled": false, // グリッドラインを無効に 36 "label": "Number of Observations", // ラベルのテキスト 37 "name": "y1", // 軸の名前 38 "position": "left", // 軸の位置 39 "scale": "linear" // スケールのタイプ 40 } 41 ] 42}

これらはユーザーがアクセスできる、またはアクセスできないプロパティです:

{{w1.allowSelection}}             (リーフプロパティ)  // 選択を許可する
{{w1.animate}}                    (リーフプロパティ)  // アニメーションを行う
{{w1.datasets}}                   (配列)  // データセットの配列
{{w1.datasets.[0]}}               (配列内のサブプロパティ)  // データセット配列の最初の要素
{{w1.datasets.[0].xValues}}       (配列内のサブプロパティ)  // 最初のデータセットのx値の配列
{{w1.datasets.[0].xValues.[0]}}   (配列内のサブプロパティ)  // 最初のデータセットのx値配列の最初の要素
{{w1.labelsEnabled}}              (リーフプロパティ)  // ラベルの表示を許可する
{{w1.panZoomEnabled}}             (リーフプロパティ)  // パン・ズームを許可する
{{w1.selection.indices}}          (配列)  // 選択されたインデックスの配列
{{w1.selection.xMax}}             (リーフプロパティ)  // 選択範囲のxの最大値
{{w1.selection.xMin}}             (リーフプロパティ)  // 選択範囲のxの最小値
{{w1.selection.xValues}}          (配列)  // 選択範囲のx値の配列
{{w1.selection.yMax}}             (リーフプロパティ)  // 選択範囲のyの最大値
{{w1.selection.yMin}}             (リーフプロパティ)  // 選択範囲のyの最小値
{{w1.selection.yValues}}          (配列)  // 選択範囲のy値の配列
{{w1.tooltipsEnabled}}            (リーフプロパティ)  // ツールチップの表示を許可する
{{w1.xAxes}}                      (配列)  // x軸の配列
{{w1.yAxes}}                      (配列)  // y軸の配列
{{w1.yAxes.[0]}}                  (配列内のサブプロパティ)  // y軸配列の最初の要素


{{w1}}                            (アクセス不可、リーフでない)
{{w1.selection}}                  (アクセス不可、リーフでない)

Handlebarsはどこで使用できますか?

クエリエディター

クエリエディターのHandlebarsテンプレートは常に文字列値に置き換えられます。テンプレートが文字列に評価されない場合、その値は最初に文字列に変換されます。これは、クエリ自体が常に文字列であるためです。例えば:

Copied!
1-- {{column w8.selectedValues}}カラムを選択します 2SELECT {{column w8.selectedValues}} 3-- allNamedテーブルから 4FROM allNamed 5-- nameが{{param w12.selection.xValues}}と等しい行を探します 6WHERE name = {{param w12.selection.xValues}};

非文字列の値は toString メソッドで変換されます。これは整数やブーリアンに対しては一般的に問題ありませんが、より複雑なオブジェクトに対しては予期しない出力を生成する可能性があります。例えば、オブジェクトに対して toString を実行すると、その結果は [object Object] となり、これはおそらくユーザーが望むものではありません。この問題を回避するために、 {{jsonStringify myObject}} のようなヘルパーを使用することができます。

関数エディター

クエリとは異なり、関数エディターのHandlebarsテンプレートは常に評価された値に置き換えられます。例えば:

Copied!
1var a = {{query1}}; // query1はオブジェクトです。 2var b = a.results[0]; // そのプロパティにアクセスすることができます。

ヘルパー関数はFunctionsエディタでは使用できません、Slateのオブジェクトを直接リファレンスする必要があります。また、関数の外部にある状態を変更することはできないため、変数やプロパティ値を設定することはできません。例えば:

Copied!
1var c = {{jsonStringify query1}}; //無効 - ヘルパーを使用することはできません 2{{var1}} = [1,2,3]; // 無効 - グローバル変数を設定することはできません

ウィジェットのプロパティエディター

アプリケーションが 編集 モードの場合、ウィジェットのプロパティエディターでハンドルバーを使用できます。ウィジェットでは、ハンドルバーのテンプレートは常に二重引用符 "" で囲む必要があります。なぜなら、中括弧は正しい JSON の構文ではないからです。

Copied!
1{ 2 "property1": "{{variable1}}", // "property1"というプロパティは"{{variable1}}"という値を持っています 3 "property2": "Hello, my name is {{var1}}", // "property2"というプロパティは"Hello, my name is {{var1}}"という値を持っています 4 "property3": [1, 2, "{{var3}}"], // "property3"というプロパティは[1, 2, "{{var3}}"]という配列を持っています 5 "property4": {{variable1}} //無効:JSON解析エラー 6}

一般的に、ウィジェットのテンプレートは文字列に置き換えられます。評価された値が文字列でない場合、Slateはその値に対して toString を実行します。ただし、このルールにはいくつかの例外があります。以下の条件が真の場合、Slateはテンプレートを評価された値で直接置き換えます:

  1. 波括弧 {{}} のセットが一つだけ存在する そして
  2. 波括弧の外側に他の文字(空白を含む)が存在しない。

いくつかの例を見てみましょう:

Copied!
1{ 2 // 値の置換えの例 3 "property1": "{{var1}}", // "property1"は"var1"の値に置換されます。 4 "property2": "{{ var1 }}", // 中括弧の内側に空白があります。 5 "property3": "{{ add 2 (add 1 var1) }}", // ヘルパーを使用して、ネスト可能です。 6 "property4": ["{{var1}}", "{{w1.property.[0]}"], // リスト内の要素も置換可能です。 7 8 // 文字列の置換えの例 9 "property5": "Hello {{var1}}!", // "var1"の値が挿入されます。 10 "property6": " {{var1}} ", // 中括弧の外側に空白があります。 11 "property7": "{{#if 0}}3{{else}}4{{/if}}" // 中括弧が複数組ある場合も対応可能です。 12}

Handlebarsはどこで使えないのか?

  • 変数エディタではHandlebarsを使用することはできません。
  • スタイルエディタではHandlebarsを使用することはできません。
  • アプリケーションのビューモードではHandlebarsを使用することはできません。ウィジェットやテキストフィールドにhandlebarsを入力しても、その表現は評価も置換もされません。

チュートリアル:ウィジェットのリンク

以下のチュートリアルでは、ユーザーが特定のフライトの航空機についてさらに詳しく知るためのボタンを作成する方法を学びます。これには、2つのウィジェット間にリンクを作成する必要があります。

ウィジェットをリンクするには、リンクしたいウィジェットの名前とプロパティを知っている必要があります。今回のケースでは、元のテーブルで選択された行の tail_num 値を取得したいと思っていますが、テーブルの選択を flight_id をプライマリキーとして設定しています。

このような場合、別のヘルパー関数を使用するのが理想的です。選択したテーブル行の列値を取得するというのは一般的なパターンなので、これを実装するための関数を使用できます:

Copied!
1function getRowData(s){ 2 var returnObj = {}; 3 var index = data[selectionColumn].indexOf(s); 4 5 // この関数はオブジェクトdata内の各配列を反復処理します 6 // valueは実際の配列であり、keyはその配列のキーです 7 _.forOwn(data, function(value, key){ 8 returnObj[key] = value[index]; 9 }); 10 11 return returnObj; 12} 13 14// テーブルに供給されるのと同じデータ 15var data = {{f_data}}; 16 17// テーブルでの現在の選択 18var selection = {{w_mainTable.selectedRowKeys}}; 19 20// テーブル主キーとして設定された列 21var selectionColumn = {{w_mainTable.selectionIdentityColumnId}} 22 23var rowData = _.map(selection, getRowData); 24 25return rowData;

上記のコードに新しい関数 f_selectedRowValues を追加します。var data のHandlebar テンプレートの値を {{q_allFlights}} に、selectionColumnselection 変数を w_flightTable に指すように変更します。

selectedRowKeys が何であるかを理解するために、テーブルウィジェットのコードを振り返ってみてください。我々は "selectionIdentityColumnId""flight_id" に設定しました。これは、列 flight_id が特定の行のユニークキーとして使用されることを意味します。ユーザーがテーブル内の行をフィルター処理すると、そのユニークキー(フライトID番号)が selectedRowKeys に追加されます。

selectedRowKeys は、ユーザーのインタラクションによってのみ変更できるテーブルウィジェットのプロパティです。ウィジェットを編集する際には、JSONエディターの下にユーザーのインタラクションプロパティの読み取り専用の値を確認することができます。

これで、テーブルでTest を選択して関数の振る舞いを確認する選択を行うことができます。

選択関数を設定したので、テキストウィジェットを追加し、それを w_linkingButton と名付けてテーブルの上に移動することができます。ウィジェットのプロパティエディタで、Content の下の HTML タブに切り替えて、次の内容を入力します:

Copied!
1<a 2 class = 'pt-button pt-intent-primary pt-icon-document-open' <!-- ボタンのスタイルとアイコンを設定するクラス --> 3 target = '_blank' <!-- リンクを新しいタブで開くための属性 --> 4 href = 'https://registry.faa.gov/AircraftInquiry/Search/NNumberResult?nNumberTxt={{f_selectedRowValues.[0].tail_num}}' <!-- クリックすると航空機の詳細情報を表示するページにリダイレクトするリンク --> 5 role='button'> <!-- この要素がボタンとして機能することを示す属性 --> 6 航空機 {{f_selectedRowValues.[0].tail_num}} の詳細を学ぶ <!-- ボタン上のテキスト --> 7</a>