binding (タイル スキーマ)

  • [アーティクル]

タイル テンプレートを指定します。 すべての通知には、サポートされているタイル サイズごとに 1 つのバインド要素が含まれている必要があります。

要素の階層

<tile>
<visual>
<binding>

構文

<binding template       = tileTemplateNameV2
         fallback?      = tileTemplateNameV1
         lang?          = string
         baseUri?       = anyURI
         branding?      = "none" | "logo" | "name"
         addImageQuery? = boolean
         contentId?     = string >

  <!-- Child elements -->
  ( image
  | text
  )*

</binding>

キー

? 省略可能 (0 または 1) * 省略可能 (0 個以上)

属性および要素

属性

属性 説明 データ型 必須 既定値
addImageQuery

タイル通知で指定されたイメージ URI にクエリ文字列を追加できるようにするには、 true に設定します。 この属性は、サーバーが画像をホストしていてクエリ文字列を処理できる場合に使用します。サーバーがこのために、クエリ文字列に基づいて画像の変化形を取得しているか、またはクエリ文字列を無視して使わずに指定の画像を返しているかどうかは問いません。 このクエリ文字列は、スケール、コントラスト設定、言語を指定します。たとえば、 の値

"www.website.com/images/hello.png"

通知に含まれる

"www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

 boolean いいえ false
Baseuri

イメージ ソース属性の相対 URI と組み合わせた既定のベース URI。

 anyURI いいえ ms-appx:///
ブランド

アプリのブランドを表示するためにタイルで使用されるフォームです。

この属性は、次のいずれかの値になります。

  • なし
  • ロゴ
  • name
 いいえ ロゴ
contentId

通知の内容を一意に識別する送信者定義の文字列に設定します。 これにより、大きなタイル テンプレートで最後の 3 つのワイド タイル通知が表示される状況での重複が回避されます。

 string いいえ
fallback

プライマリ テンプレート名が受信者によって認識されない場合に使用するテンプレート。互換性Windows 8使用します。 この値は、テンプレート属性の値のWindows 8名です。 Windows 8後に導入された新しいテンプレートにはフォールバックがありません。

 tileTemplateNameV1 (「解説」を参照) いいえ なし
ラング

"en-US" や "fr-FR" などの BCP-47 言語タグとして指定された XML ペイロードのターゲット ロケール。 ここで指定したロケールは 、ビジュアルではオーバーライドされますが、 テキストではオーバーライドできます。 この値がリテラル文字列の場合、この属性の既定値はユーザーの UI 言語になります。 この値が文字列リファレンスの場合、この属性の既定値は、文字列を解決する際に Windows ランタイムで選択されたロケールになります。 この値が指定されていない場合の備考を参照してください。

 string いいえ なし
template

タイルの基となるテンプレートの 1 つ。 通常、開発者は正方形とワイド形式の両方を個別の バインド 要素として指定する必要があります。 有効なエントリは、 tileTemplateType 列挙のメンバーです。

 tileTemplateNameV2 (「解説」を参照) はい なし

 

子要素

子要素 説明
image

タイル テンプレートで使用されるイメージを指定します。 指定されたイメージは、そのテンプレート内の特定のテンプレートまたはイメージのサイズと形状の要件と一致している必要があります。
text

タイル テンプレートで使用されるテキストを指定します。

 

親要素

Parent 要素 説明
Visual

複数の バインド 子要素が含まれており、それぞれがタイルを定義します。

 

注釈

template 属性で使用される tileTemplateNameV2 値には、次のいずれかの文字列値を指定できます。 各テンプレートの詳細については、「 タイル テンプレート カタログ」を参照してください。

  • TileSquare150x150Block
  • TileSquare150x150Image
  • TileSquare150x150PeekImageAndText01
  • TileSquare150x150PeekImageAndText02
  • TileSquare150x150PeekImageAndText03
  • TileSquare150x150PeekImageAndText04
  • TileSquare150x150Text01
  • TileSquare150x150Text02
  • TileSquare150x150Text03
  • TileSquare150x150Text04
  • TileSquare310x310BlockAndText01
  • TileSquare310x310BlockAndText02
  • TileSquare310x310Image
  • TileSquare310x310ImageAndText01
  • TileSquare310x310ImageAndText02
  • TileSquare310x310ImageAndTextOverlay01
  • TileSquare310x310ImageAndTextOverlay02
  • TileSquare310x310ImageAndTextOverlay03
  • TileSquare310x310ImageCollection
  • TileSquare310x310ImageCollectionAndText01
  • TileSquare310x310ImageCollectionAndText02
  • TileSquare310x310SmallImagesAndTextList01
  • TileSquare310x310SmallImagesAndTextList02
  • TileSquare310x310SmallImagesAndTextList03
  • TileSquare310x310SmallImagesAndTextList04
  • TileSquare310x310Text01
  • TileSquare310x310Text02
  • TileSquare310x310Text03
  • TileSquare310x310Text04
  • TileSquare310x310Text05
  • TileSquare310x310Text06
  • TileSquare310x310Text07
  • TileSquare310x310Text08
  • TileSquare310x310TextList01
  • TileSquare310x310TextList02
  • TileSquare310x310TextList03
  • TileWide310x150BlockAndText01
  • TileWide310x150BlockAndText02
  • TileWide310x150Image
  • TileWide310x150ImageAndText01
  • TileWide310x150ImageAndText02
  • TileWide310x150ImageCollection
  • TileWide310x150PeekImage01
  • TileWide310x150PeekImage02
  • TileWide310x150PeekImage03
  • TileWide310x150PeekImage04
  • TileWide310x150PeekImage05
  • TileWide310x150PeekImage06
  • TileWide310x150PeekImageAndText01
  • TileWide310x150PeekImageAndText02
  • TileWide310x150PeekImageCollection01
  • TileWide310x150PeekImageCollection02
  • TileWide310x150PeekImageCollection03
  • TileWide310x150PeekImageCollection04
  • TileWide310x150PeekImageCollection05
  • TileWide310x150PeekImageCollection06
  • TileWide310x150SmallImageAndText01
  • TileWide310x150SmallImageAndText02
  • TileWide310x150SmallImageAndText03
  • TileWide310x150SmallImageAndText04
  • TileWide310x150SmallImageAndText05
  • TileWide310x150Text01
  • TileWide310x150Text02
  • TileWide310x150Text03
  • TileWide310x150Text04
  • TileWide310x150Text05
  • TileWide310x150Text06
  • TileWide310x150Text07
  • TileWide310x150Text08
  • TileWide310x150Text09
  • TileWide310x150Text10
  • TileWide310x150Text11

フォールバック属性で使用される tileTemplateNameV1 値には、次のいずれかの文字列値を指定できます。 これらはWindows 8テンプレート名です。 各テンプレートの詳細については、「 タイル テンプレート カタログ」を参照してください。

  • TileSquareBlock
  • TileSquareImage
  • TileSquarePeekImageAndText01
  • TileSquarePeekImageAndText02
  • TileSquarePeekImageAndText03
  • TileSquarePeekImageAndText04
  • TileSquareText01
  • TileSquareText02
  • TileSquareText03
  • TileSquareText04
  • TileWideBlockAndText01
  • TileWideBlockAndText02
  • TileWideImage
  • TileWideImageAndText01
  • TileWideImageAndText02
  • TileWideImageCollection
  • TileWidePeekImage01
  • TileWidePeekImage02
  • TileWidePeekImage03
  • TileWidePeekImage04
  • TileWidePeekImage05
  • TileWidePeekImage06
  • TileWidePeekImageAndText01
  • TileWidePeekImageAndText02
  • TileWidePeekImageCollection01
  • TileWidePeekImageCollection02
  • TileWidePeekImageCollection03
  • TileWidePeekImageCollection04
  • TileWidePeekImageCollection05
  • TileWidePeekImageCollection06
  • TileWideSmallImageAndText01
  • TileWideSmallImageAndText02
  • TileWideSmallImageAndText03
  • TileWideSmallImageAndText04
  • TileWideSmallImageAndText05
  • TileWideText01
  • TileWideText02
  • TileWideText03
  • TileWideText04
  • TileWideText05
  • TileWideText06
  • TileWideText07
  • TileWideText08
  • TileWideText09
  • TileWideText10
  • TileWideText11

次の表では、lang が指定されていない場合のシステムの応答について説明します。

For... システム応答
通知の言語
  • 明示的に設定する場合は、visual.lang または binding.lang を使用します
  • それ以外の場合は、アプリ固有の言語設定 ([リソース管理システム](/previous-versions/windows/apps/jj552947(v=win.10)) によって現在の言語プロファイルが指定された場合にアプリが実行されると判断される言語)
  • それ以外の場合は、タイルの表示名の言語がWindows ランタイムによって解決されます
  • それ以外の場合は、シェルの UI 言語 (MUI 言語)

この言語は主に、列を特徴とするテンプレート内の列のレイアウトに影響します。
リテラル テキストを含むテキスト要素
  • 明示的に設定する場合は、visual.lang または binding.lang を使用します
  • それ以外の場合は、アプリ固有の言語設定 ([リソース管理システム](/previous-versions/windows/apps/jj552947(v=win.10)) によって現在の言語プロファイルが指定された場合にアプリが実行されると判断される言語)
  • それ以外の場合は、タイルの表示名の言語がWindows ランタイムによって解決されます
  • それ以外の場合は、シェルの UI 言語 (MUI 言語)
ms-resource コンテンツを含むテキスト要素
  • 明示的に設定する場合は、visual.lang または binding.lang を使用します。明示的な言語は、文字列の解決に使用される Resource Management System の [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) の言語リストの前に追加されます
  • それ以外の場合は、[ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) がユーザーの言語プロファイルで初期化済みとして使用されます

文字列が解決されると、解決された文字列の言語が text 要素に割り当てられます。 この言語は、UI のテキストの配置 (LTR と RTL) とフォントの選択を調整します。
ms-appx:/// image
  • 明示的に設定する場合は、visual.lang または binding.lang を使用します。明示的な言語は、文字列の解決に使用されるリソース管理システムの [ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) の言語リストの前に追加されます
  • それ以外の場合は、[ResourceContext](/previous-versions/windows/apps/jj552947(v=win.10)#resourcecontext) ユーザーの言語プロファイルで初期化として使用されます
クラウド イメージ
  • 明示的に設定する場合は、visual.lang または binding.lang を使用します
  • それ以外の場合は、アプリ固有の言語設定 ([リソース管理システム](/previous-versions/windows/apps/jj552947(v=win.10)) が現在の言語プロファイルでアプリを実行することを決定する言語 (存在する場合)
  • それ以外の場合は、Windows ランタイムによって解決されたタイルの表示名の言語 (名前が言語に依存しない場合は設定されない可能性があります)
  • それ以外の場合は、シェルの UI 言語 (MUI 言語)

addImageQuery が true の場合、この言語はクエリ文字列に含まれます。

 

要件

値
Namespace http://schemas.microsoft.com/notifications/2012/tile.xsd