如何變更選取模式 (HTML)

[ 本文的目標對象是撰寫 Windows 執行階段 App 的 Windows 8.x 和 Windows Phone 8.x 開發人員。如果您正在開發適用於 Windows 10 的 App，請參閱 最新文件 ]

ListView 控制項的 selectionMode 屬性會指定清單項目的選取方式。

您必須知道的事

技術

• 使用 JavaScript 建立您的第一個 Windows 執行階段應用程式
• ListView

先決條件

• 我們假設您可以建立 ListView 控制項。如需詳細資訊，請參閱新增 ListView 快速入門。

指示

變更選取模式

selectionMode 屬性支援這些值，如 SelectionMode 列舉所定義：

詞彙	說明
none	無法選取項目。
single	只可以選取一個項目。按一下項目會變更為選取該項目。
multi	可以選取多個項目。按一下其他項目會將那些項目新增到選取範圍中。

 

若要在 HTML 中指定選取模式，請使用 data-win-options 屬性將 selectionMode 設為其中一個允許之列舉值的字串表示，例如 "none" 或 "single"。

在 HTML 中指定選取模式

• 這個範例將選取模式設定為只能夠選取一個項目。

  <div id="basicListView" 
      data-win-control="WinJS.UI.ListView"
      data-win-options="{ itemDataSource : DataExample.itemList.dataSource, itemTemplate: select('#mediumListIconTextTemplate'), selectionMode: 'single'}">
  </div> 
  

若要在 JavaScript 中指定選取模式，請抓取控制項並設定其 selectionMode 屬性。

在 JavaScript 中指定選取模式

• 下一個範例將選取模式設定為只能夠選取一個項目。

  var myListView = document.getElementById("basicListView1").winControl;
  myListView.selectionMode = WinJS.UI.SelectionMode.single;
  

相關主題

快速入門：新增 ListView