1. SPEAKの利用

攻略

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

ActionControlコンポーネントを使ってアクションリンク付きのパネルを作成します。これにより、ユーザーはその文脈で有用なアクションのセットに素早くアクセスできます。

このウォークスルーでは、以下の方法を説明します:

アクションコントロールを使います

SPEAKページでActionControlコンポーネントを使用するには:

  • ページに ActionControl コンポーネントを追加してください。通常は、 ActionControl が右揃えのときに最も効果的に動作するため、水平アラインメントを設定できるコンテナにコントロールを追加します。
  • 一部のコンポーネントは ActionControlのプレースホルダーを提供します。 ApplicationHeader ページのサブ構造にはActionsのプレースホルダーがあり、 AdvancedExpander コントロールにはActionBarのプレースホルダーがあります。これらのプレースホルダーを使用すると、SPEAKは ActionControl コンポーネントをSPEAKのビジュアルガイドラインに従ってスタイル化し位置を調整します。
  1. PageSettings項目の子として設定項目用のフォルダを作成します。
  2. ActionControlコンポーネントのDataSourceプロパティを、PageSettingsのconfig itemsフォルダで作成したActionControlアイテムにバインドします。
  3. このフォルダに ActionControl のアイテムを追加してください。このアイテムはメニューを構成する構造の始まりです。このアイテムで値を設定する必要はありません。
  4. ActionControl項目の子としてActionColumn項目を追加してください。メニュー内の各列ごとにActionColumn項目を1つ追加します。この項目で値を設定する必要はありません。
  5. 必要なグループ見出しごとに、ActionColumnアイテムの子としてActionGroupアイテムを追加してください。アイテムのTextフィールドで見出しテキストを指定します。
  6. アクショングループ(ActionGroups)の子項目としてアクションアイテムを追加してください。メニューに追加したいアクションごとに1つのアクションアイテムを追加します。各アイテムはユーザーがクリックできるメニュー項目を表示します。タイトルフィールドに表示する名前とクリックフィールドでアクションを設定すること。
  • アクションは他のコンポーネントの相互作用を指定するのと同じ方法で指定できます。

アクションの有効化と無効化

ActionControlコンポーネントは、その中に含まれるすべてのアクションをデフォルトで有効にします。個別のアクションは、いくつかの方法で無効化・有効化できます:

  • アクションを無効にするには、アクション 項目の「無効化」チェックボックスを選択し、有効化するにはチェックボックスをクリアしてください。

  • ActionControlコンポーネントが提供するactionsActionControl配列をJavaScriptで使うことができます。例えば:

    this.ActionControl1.viewModel.actions()0.disable()配列の最初のアクションを無効にするために。 enable関数を使ってアクションを有効にします。

  • ViewモデルのgetActionメソッドを使うことができます。例えば:

    this. ActionControl1.viewModel.getAction(‘data-sc-actionId=\”Sitecore ID of Action item\”\’).disable()指定されたSitecore IDを持つアクションアイテムのアクションを無効にします。代わりにenable関数を使って有効にしてください。

Dataプロパティを活用してください

ActionControlのDataプロパティでデータを指定でき、例えばActionControl内のActionアイテムのClickイベントからこのデータにアクセスできます。

以下の例では、Dataプロパティの使い方を示しています。この例データはActionControlコンポーネントをListControlにバインドします。ActionControlにはShow Itemというアクションアイテムがあります。ActionControlコンポーネントは最初無効化され、ListControl内でアイテムを選択するとActionControlが有効になりますSPEAK。ユーザーがShow Itemアクションをクリックすると、SPEAK選択されたアイテム名($displayNameの値)を含むアラートが表示されます。

この機能を実装するために:

  • ActionControlのDataプロパティを、次のようなものに設定します:{Binding ListControl1.SelectedItem}。これは、ActionControlのDataプロパティに常にListControlの現在選択されているアイテムへのポインタ(もしあれば)を含むことを意味します。

  • ActionControlのIsEnabledプロパティを、この: {Binding ListControl1.HasSelectedItem}に似た設定に設定してください。つまりSPEAK、ActionControl(およびその中に含まれるアクション)は、ListControlが選択されたアイテムを持っている場合にのみ有効になることを意味します。

  • Show Itemアクションのクリックプロパティを次のように設定します:javascript

    .viewModel.app.showItem(this.get("data"))。つまり、ユーザーが「アイテムを表示」アクションをクリックした際にSPEAKはPageCodeスクリプトファイル内のshowItemというメソッドを呼び出し、Dataプロパティの内容を引数として渡します。このプロパティの内容が現在選択されているアイテムです。

  • PageCodeスクリプトファイルでshowItem関数を次のように定義します:

    showItem: function(item) { alert(item.get("$displayName")); }

この記事を改善するための提案がある場合は、 お知らせください!