Languageの既知の問題APLコンポーネントその他のバージョン1.11.0APL変更ログ﻿APL基本コンポーネントのプロパティコンポーネントは、viewportに表示されるプリミティブな要素です。APLでは、コンポーネントとは、クライアントで表示されるプリミティブな視覚コンポーネントのことを指します。APLファイルを保存して別のAPLに読み込むことで新しいテンプレートの定義を追加することはできますが、新しく追加した下位レベルのコンポーネントを認識させてデバイス上のネイティブなユーザーインターフェースコントロールに変換するには、クライアントの更新が必要になります。プロパティaccessibilityLabelbindbindのプロパティbindの評価checkeddisableddisplayentityheightおよびwidthidinheritParentStateonMountonCursorEnteronCursorExitopacitypaddingBottom、paddingLeft、paddingRight、paddingTopshadowColorshadowHorizontalOffsetshadowRadiusshadowVerticalOffsetspeechstyletransformtypewhen影に関する注意事項プロパティすべてのコンポーネントは、次のプロパティをサポートしています。列の意味について詳しくは、表の下を参照してください。ユーザーがコンポーネントを選択したときに、この文字列が読み上げられます。データバインディングコンテキストに追加する式です。このコンポーネントの任意の説明です。trueの場合、このコンポーネントの状態はcheckedに設定されます。trueの場合、このコンポーネントはタッチまたはフォーカスに応答しません。コンポーネントが画面に表示されるかどうかを指定します。Alexaでリファレンスの明確化に使用されるOpaqueデータです。コンポーネントに指定する高さです。ナビゲーションおよびイベントに使用する、コンポーネントの参照名です。trueを指定した場合、親の状態が使用されます。このコンポーネントの高さの上限です。このコンポーネントの幅の上限です。このコンポーネントの高さの下限です。このコンポーネントの幅の下限です。コンポーネントが最初に表示されたときに実行されるコマンドです。カーソル(マウスポインター)がコンポーネントのアクティブな領域に入ったときに実行されるコマンドです。カーソル(マウスポインター)がコンポーネントのアクティブな領域から出たときに実行されるコマンドです。このコンポーネントと子の不透明度です。このコンポーネントの下側に追加するスペースです。このコンポーネントの左側に追加するスペースです。このコンポーネントの右側に追加するスペースです。このコンポーネントの上側に追加するスペースです。影の水平方向のオフセットです。影のぼかしの半径です。影の垂直方向のオフセットです。オーディオ再生に関する変換済みの音声の情報です。適用するスタイル(複数可)の名前です。コンポーネントの型です。評価結果がfalseの場合、このコンポーネントはインフレートされません。このコンポーネントに指定する幅です。1.0デフォルト列は、プロパティのデフォルト値を示します。すべての必須プロパティを設定する必要があります。設定しないと、コンポーネントはインフレートされません。<none>の値は、プロパティにデフォルト値がないことを意味します。<none>の解釈はプロパティに依存します。speechプロパティが設定されていないと、コンポーネントはSpeakItemコマンドを実行できません。maxHeightが設定されていないと、コンポーネントは任意の高さまで大きくなることができます。これは、maxHeightを非常に大きな数に設定することと同じです。スタイル設定列は、スタイルから設定できるプロパティかどうかを示します。コンポーネントのプロパティを直接指定すると、スタイル定義の値はすべて上書きされます。次の例では、myTextStyleの定義に関係なく、Textコンポーネントの不透明度は常に0.5に設定されます。}動的列は、SetValueコマンドを使用して動的に変更できるプロパティかどうかを示します。SetValueを使用して動的プロパティを設定すると、スタイル値はすべて上書きされます。動的プロパティの設定を解除するメカニズムはありません。コンポーネントがイベントのターゲットである場合、以下の値がevent.targetに報告されます。}}コンポーネント固有の値がevent.targetに追加されます。accessibilityLabelアクセシビリティモードでスクリーンリーダーが使用する文字列です。bindコンポーネントのbindプロパティは、コンポーネントおよびその子のデータバインディングコンテキストを展開するためのものです。bindプロパティは、現在のコンテキストを展開するデータバインディングを順序付きで指定します。バインディングには順序があり、以前のバインディングの定義を、それ以降のバインディングで使用できます。bindのプロパティバインディング配列の各バインディングオブジェクトには、次のプロパティを使用できます。このバインディングで使用する名前です。有効な名前を設定する必要があります。このバインディングに割り当てる値です。文字列の場合、データバインディングは文字列のコンテンツに対して行われます。bindの評価bindプロパティの評価は、whenプロパティとその他のプロパティとの間に行われます。バインディングは、配列の順序でデータバインディングコンテキストに追加されます。後続のバインディングでは先行するバインディングの結果を使用できます。どちらでお呼びしますか?"}この例では、FormalNameの内容は、それより前に定義されたTitleとLastNameの値によって決まります。最終的にこのテキストは、「ジャスミンさん、またはスミス博士のどちらでお呼びしますか?」となります。これは例として仮に作られたものであり、実際には、FirstName、LastName、Titleの値が生データ内の要素とバインドされます。バインドされる値は、set_value_commandを使用して動的に変更できます。set_value_commandは、コンポーネントのプロパティを変更する場合にも使用されるため、コンポーネント固有のプロパティと競合することがないよう、バインドされるプロパティの名前は大文字で始めることをお勧めします。「myCounter」ではなく、「MyCounter」や「"MY_COUNTER」のような名前にします。checkedcheckedプロパティは、コンポーネントがchecked状態かどうかを設定します。スタイルを定義する際にコンポーネントの状態として使用できます。コンポーネントのchecked状態を変更するには、SetStateコマンドを使用します。親のchecked状態を継承するには、子コンポーネントのinheritParentStateプロパティをtrueに設定します。disableddisabledプロパティは、コンポーネントがdisabled状態かどうかを設定します。スタイルを定義する際にコンポーネントの状態として使用できます。コンポーネントのdisabled状態を変更するには、SetStateコマンドを使用します。親のdisabled状態を継承するには、子コンポーネントのinheritParentStateプロパティをtrueに設定します。displayコンポーネントのdisplayプロパティは、画面に表示されるかどうかや、レイアウトの計算に与える影響を決定します。次のいずれかの値に設定します。コンポーネントは描画されませんが、スペースを占有します。タッチイベントには応答しません。コンポーネントを削除します。コンポーネントはレイアウトの一部ではなくなり、タッチに応答しません。通常どおりにコンポーネントを描画します。コンポーネントを作成する際に使用されるデータバインディングコンテキスト、序数、インデックスは、displayプロパティの影響を受けません。3つの子を持つContainerで、最初の子がdisplay=noneに設定されている場合でも、index=0でデータバインドされ、次の子にはindex=1が設定されます。◯(ただし、スペースを占有しません)「フォーカスの可否」列はキーボードフォーカスを許可するかどうかを示します。「タッチの可否」列はタッチイベントに応答するかどうかを示します。displayがinvisibleまたはnoneに設定されている場合、タッチイベントは存在しないものとしてコンポーネントを通過し、スタック順で次のコンポーネントによって処理されます。normalのdisplayコンポーネントはタッチイベントを通過させませんが、無効になっていない場合にのみタッチイベントに応答します。display==invisibleのコンポーネントの子要素は描画されません。invisibleのコンポーネントがvisibleの子要素を持つことはありません。同様に、コンポーネントにdisplay==noneが指定されている場合、該当するコンポーネントとそのすべての子要素は表示階層から削除され、画面上のスペースを占有しません。entityOpaque(不透明)のentityデータです。Alexaデバイスはentityデータをコンテキストとしてスキルに返します。heightおよびwidthwidth、height、minWidth、minHeight、maxWidth、maxHeightはすべてディメンション型のプロパティです。最小幅および最小高のデフォルト値は0であり、コンポーネントは表示されない場合があります。最大幅および最大高のプロパティのデフォルト値はnoneであり、コンポーネントは自由に拡大縮小できます。widthおよびheightの値を指定しない場合は、コンポーネントの元のサイズになります。idコンポーネントのこのインスタンスに対して定義できる識別子です。階層表示で特定のコンポーネントを見つけられるようにするために使用します。他のidと同じ値を使用してもかまいませんが、一意の値を割り当てることをお勧めします。inheritParentStateコンポーネントの状態を、コンポーネントの親の状態に置き換えます。コンポーネントの見た目を親の状態に合わせて変更する必要があるときに使用します。TouchWrapperが押されたときに、TouchWrapperの内側にあるTextコンポーネントの色を変更する場合を考えます。TextコンポーネントのinheritParentStateを設定することでTouchWrapperの状態が変わると、このコンポーネントの状態も変わるようになります。onMountコンポーネントが最初に表示されたときに実行されるコマンドです。マウントコマンドは、画面の切り替えを表示するために使用します。マウント時には、event.source.valueは設定されないままです。onMountコマンドは、ドキュメントの読み込み時にトリガーされます。コンポーネント自体が非表示である場合や画面に表示されていない場合でも、コンポーネントのonMountコマンドは常に実行されます。生成されるイベントの形式は次のようになります。}}イベントタイプのプロパティは、コンポーネントの名前に設定されます。"Frame"、"Container"、"TouchWrapper"などです。onCursorEnterカーソルがコンポーネントのアクティブな領域に入ったときに実行されるコマンドです。event.source.valueにコンポーネントの標準的なsource値が設定されます。イベントのsourceプロパティを参照してください。Disabled状態がtrueに設定されているコンポーネントは、カーソルイベントの変更に応答せず、onCursorEnterイベントハンドラーに割り当てられたコマンドは実行されません。無効なコンポーネントの上にカーソルがある状態で、そのコンポーネントが有効になった場合、そのコンポーネントに対してonCursorEnterイベントが生成されます。生成されるイベントの形式は次のようになります。}}イベントのsourceプロパティにはコンポーネントの名前(「Image」、「TouchWrapper」、「Sequence」など)が設定されます。onCursorExitカーソルがコンポーネントのアクティブな領域から出たときに実行されるコマンドです。event.source.valueにコンポーネントの標準的なsource値が設定されます。イベントのsourceプロパティを参照してください。Disabled状態がtrueに設定されているコンポーネントは、カーソルイベントの変更に応答せず、onCursorExitイベントハンドラーに割り当てられたコマンドは実行されません。有効なコンポーネントの上にカーソルがある状態で、そのコンポーネントが無効になった場合、そのコンポーネントに対してonCursorExitイベントが生成されます。生成されるイベントの形式は次のようになります。}}イベントのsourceプロパティにはコンポーネントの名前(「Image」、「TouchWrapper」、「Sequence」など)が設定されます。opacityこのコンポーネントと子コンポーネントの不透明度を一様に適用します。不透明度は0以上1以下の数値で指定します。この範囲を超える数値を指定した場合は、1に設定されます。実際に表示されるコンポーネントの不透明度は、この値に上位レベルの不透明度の値を掛けたものになります。現在のコンポーネントの不透明度が0.5、親の不透明度が0.8の場合、実際に表示されるコンポーネントの不透明度は0.4になります。コンポーネントの不透明度を0に設定すると表示されなくなりますが、コンポーネント階層からは削除されません。paddingBottom、paddingLeft、paddingRight、paddingToppaddingの値はディメンション型であり、コンポーネントの周りに追加するスペースを指定します。APLでは、パディングと境界線を含めて要素の全幅と全高を計算します。それぞれのデフォルトは0です。shadowColor影の色です。通常は、ある程度の透明度がある色が使用されます。影の色には、全体のopacity(不透明度)も適用されます。shadowHorizontalOffset影の描画の水平方向のオフセットです。正の数では影が右に、負の数では影が左に移動します。shadowRadius影のぼかしの半径です。shadowVerticalOffset影の描画の垂直方向のオフセットです。正の数では影が下に、負の数では影が上に移動します。ssmlToSpeechトランスフォーマーから取得するopaqueデータを指定します。これは、コンポーネントのコンテンツを読み上げるときに使用されるopaqueデータです。ssmlToSpeechトランスフォーマーおよびtextToSpeechトランスフォーマーの詳細については、データソースとトランスフォーマーを参照してください。styleコンポーネントのプロパティを設定するために使用する名前付きのスタイルです。transform変換配列は、コンポーネントに適用される変換値の配列です。}]transformは、単一のプロパティとそれに関連付けられた値を持つオブジェクトです。変換は右から左に(Web規格に従って)適用されます。dp移動され、50%拡大された後に、その中心を基準に30度回転されます。変換配列の各要素は、次のいずれかになります。回転角度(度単位)です。正の角度で時計回りに回転します。X方向とY方向に均等に拡大縮小されます。X方向の倍率です(同じグループの場合は「scale」を上書きします)。Y方向の倍率です(同じグループの場合は「scale」を上書きします)。X軸の傾斜角度(度単位)です。X軸は横線のままです。Y軸の傾斜角度(度単位)です。Y軸は縦線のままです。オブジェクトを右方向に平行移動する距離です。オブジェクトを下方向に平行移動する距離です。同じグループのtransformプロパティは、単一のオブジェクトにまとめられます。以下は同等となります。