如何放置次要磚飛出視窗的位置 (使用 JavaScript 和 HTML 的 Metro 樣式應用程式)

[本文件尚屬初始版本,後續有可能變更。]

這個主題說明如何放置對話方塊,要求使用者確認是否要將項目釘選至 [開始] 畫面。 最佳做法是在按一下或觸碰即可釘選項目的元素附近顯示對話方塊。

您必須知道的事

技術

  • Windows Runtime

先決條件

  • 磚與通知詞彙及概念的使用知識。如需詳細資訊,請參閱磚、徽章及通知
  • 文件物件模型 (DOM) 的使用經驗。
  • 能夠使用 Windows 執行階段 API 透過 JavaScript 建立基本 Metro 樣式應用程式的能力。

指示

步驟 1: 在將會引發釘選飛出視窗的頁面上包含元素

按一下或觸碰 [釘選到 [開始] 畫面] 按鈕時,會顯示確認對話方塊。將內容釘選到 [開始] 畫面的決定永遠取決於使用者。

<button class="action" id="pinTileButton">

步驟 2: 決定該元素的週框用戶端座標

因為飛出視窗應該在叫用它的項目附近,所以您必須知道該項目的位置。

var element = document.getElementById("pinTileButton"),
var selectionRect = element.getBoundingClientRect();

步驟 3: 釘選次要磚,傳遞叫用它的項目的位置。

呼叫 SecondaryTile.requestCreateAsync 方法會顯示確認對話方塊,使用提供的座標在叫用點附近顯示該對話方塊。當使用者確認時,方法會傳回結果讓您繼續。此步驟假設您已經建立一個名為 "tile" 的SecondaryTile 物件。如需詳細資訊,請參閱快速入門:釘選次要磚

tile.requestCreateAsync({ x: selectionRect.left, y: selectionRect.top }).then(function (isPinned) {{
    if (isPinned) {
        // Proceed.
    } else {
        // The user canceled the operation or an error occurred.
    }
});

相關主題

次要磚的指導方針和檢查清單

次要磚概觀