Power Apps 中的組合方塊控制項

允許使用者從其提供的選擇中選取項目的控制項。 支援搜尋和多重選取。

描述

組合方塊控制項可讓您搜尋您將選取的項目。 該搜尋是在伺服器端上的 SearchField 屬性執行,因此效能不會受到大型的資料來源影響。

單一或多重選取模式是透過 SelectMultiple 屬性設定。

搜尋要選取的項目時,您可以就個別項目在資料窗格中修改版面配置設定,以選擇要顯示單一資料值、兩個值,還是或一張圖片和兩個值 (人員)。

在小畫面上查看時,項目清單彈出式視窗將成為全畫面控制項,以提高可用性。

注意

如果您想要搜尋含有 數字 的項目,請將數字轉換成含有 text() 函數的文字。 例如, Text(12345)

人員選擇器

若要使用組合方塊作為人員選擇器,請從資料窗格中的版面配置設定選擇 人員 範本,並設定要為下方人員顯示的相關資料屬性。

主要屬性

Items – 可從中建立選取的資料來源。

DefaultSelectedItems – 在使用者與控制項互動之前的初始選取項目。

注意

Default 屬性已被取代,請改用 DefaultSelectedItems

SelectedItems – 因使用者互動選取的項目清單。

SelectMultiple – 使用者是否可以選取單一項目或多個項目。

IsSearchable – 使用者是否可以先搜尋項目再選取。

注意

IsSearchable 只能在包含至少一個文字欄位的資料來源上啟用。 Items 運算式必須是可委派的,以便將查詢與搜尋一起委派。 也就是說,不支援 Items 運算式內的 If 陳述式。

SearchFields - 使用者輸入文字時,搜尋資料來源的資料欄位。

注意

若要搜尋多個欄位,請將 SearchFields 屬性設定為此格式:["MyFirstColumn"、"MySecondColumn"]。 僅支援文字欄位。

其他屬性

AccessibleLabel – 螢幕報讀軟體的標籤。

BorderColor – 控制項框線的色彩。

BorderStyle – 決定控制項的框線為實線虛線點線

BorderThickness – 控制項框線的粗細。

DisplayFields – 針對搜尋傳回的每個項目顯示的欄位清單。 透過屬性選項索引標籤中的資料窗格最容易進行組態。

注意

若要更新特定範本中的多個顯示欄位,請以下列格式設定 DisplayFields 屬性:["MyFirstColumn", "MySecondColumn"]

DisplayMode – 控制項是否允許使用者輸入 (Edit)、只顯示資料 (View) 或者已停用 (Disabled)。

FocusedBorderColor – 當控制項為焦點時的控制項框線色彩。

FocusedBorderThickness – 當控制項為焦點時的控制項框線粗細。

Height – 控制項的頂端和底部邊緣之間的距離。

InputTextPlaceholder – 未選取任何項目時,向使用者顯示的說明文字。

OnChange – 當使用者變更選項時,要執行的動作。

OnNavigate – 使用者選取項目時要執行的動作。

OnSelect – 在使用者選擇或按一下控制項時,要執行的動作。

TabIndex – 相對於其他控制項的鍵盤導覽順序。

Visible – 控制項顯示或隱藏。

Width – 控制項左邊緣與右邊緣之間的距離。

X – 控制項左邊緣與其父容器 (沒有父容器時則為螢幕) 左邊緣之間的距離。

Y – 控制項頂部邊緣與其父容器 (沒有父容器時則為螢幕) 頂部邊緣之間的距離。

注意

彈出式視窗邊框屬性是由 Border 屬性所控制。

範例

基本組合方塊

此範例中的步驟適用於任何提供資料表的資料來源,但是若要完全遵循這些步驟,請使用具有 Microsoft Dataverse 範例資料之資料庫的環境。

  1. 選取插入 > 輸入 > 組合方塊,並將其命名為「Combobox1」。

  2. 在畫面右側的屬性窗格中,打開選取資料來源清單 (Items旁邊),然後新增或選取資料來源 (例如帳戶資料表)。

  3. 在相同的窗格中,選取編輯 (欄位旁邊)。

  4. Data窗格中,打開主要文字清單,然後選取將顯示在組合方塊控制項中的主要名稱欄。

  5. 按住 Alt 鍵的同時,選取下箭頭開啟組合方塊控制項。

    控制項會顯示您在指定資料來源中指定之主要名稱的資料。

(選用) 預設顯示第一則記錄

  1. DefaultSelectedItems 屬性設定為此運算式,並將 DataSource 替換為您資料來源的名稱:

    First(DataSource)
    

(選用) 在標籤中顯示選取的帳戶名稱

  1. 選取插入 > 文字標籤,然後選取標籤

  2. Text 屬性設定為此運算式,以 Text 取代下列公式:

    If(CountRows(ComboBox1.SelectedItems)>0, Concat(ComboBox1.SelectedItems,'Account Name',", "), "NO SELECTED ITEM")
    

    注意

    If 陳述式將檢查以瞭解所選取的項目存在方式,並以逗號分隔標籤或在空白時顯示「未選取的項目」訊息。

模擬簡單下拉式行為

透過設定 IsSearchable 為 false 並設定 SelectMultiple 為 false,您就可以達到與下拉式清單的相同功能。

  1. 選取插入 > 輸入,然後選取組合方塊

  2. 在畫面右側的屬性窗格中,打開選取資料來源清單 (Items旁邊),然後新增或選取資料來源。

  3. 在相同的窗格中,選取編輯 (欄位旁邊)。

  4. Data 窗格中,開啟 Primary text 清單,然後選取您要在組合方塊控制項中顯示的欄位。

  5. IsSearchable 屬性設為 false。

  6. SelectMultiple 屬性設為 false。

  7. 按住 Alt 鍵的同時,選取下箭頭開啟組合方塊控制項。

    控制項顯示您在指定資料來源中指定欄位的資料。

    注意

    「尋找項目」文字消失,而且您只能選取單一項目。

協助工具指南

色彩對比

以下項目之間必須有足夠的色彩對比:

  • ChevronFillChevronBackground
  • ChevronHoverFillChevronHoverBackground
  • SelectionColorSelectionFill
  • SelectionFillFill
  • SelectionTagColorSelectionTagFill

這是 標準色彩對比要求 之外的要求。

螢幕助讀程式支援

  • AccessibleLabel 必須存在。

    注意

    在觸控螢幕控制項上,螢幕助讀程式使用者可依序導覽組合方塊的內容。 選取時,組合方塊可作為顯示或隱藏其內容的按鈕。

鍵盤支援

  • TabIndex 必須是零或大於零,鍵盤使用者才能導覽到該處。

  • 焦點指標必須清楚可見。 使用 FocusedBorderColorFocusedBorderThickness 達成此目的。

    注意

    索引標籤鍵可導覽到或離開組合方塊。 方向鍵可導覽組合方塊的內容。 開啟時,Esc 鍵可關閉下拉式清單。

注意

是否能請您告知您偏好的慣用文件語言? 請填寫問卷。 (請注意,本問卷為英文版)

完成問卷大約需要七分鐘。 本問卷將不會收集個人資料 (隱私權聲明)。