Power Apps 中的資源庫控制項

包含其他控制項並顯示一組資料的控制項。

描述

資源庫控制項可以顯示來自資料來源的多筆記錄,每筆記錄可以包含多種類型的資料。 例如使用資源庫控制項顯示多名連絡人,每一項顯示包括每位連絡人的名稱、地址和電話號碼的連絡資訊。

每個資料欄位都會出現在資源庫控制項的不同控制項中。 而您可以在它的範本中組態這些控制項。 範本會顯示為資源庫中的第一個項目:

  • 資源庫控制項左邊緣上朝水平/橫向方向。
  • 以及在資源庫控制項頂端朝垂直/縱向方向。

您在範本中進行的任何變更都會反映在整個資源庫控制項中。

目前資源庫開放預先定義的範本顯示圖像、文字,及具有變動高度項目的資源庫。

限制

資源庫控制項具有下列限制:

  1. 如果使用者在載入所有專案之前捲動 Flexible height 資源庫控制項,則在完成資料載入時,可能會將目前在視圖中的項目推外和縮小。 若要避免這個問題,請使用資源庫控制項取代 Flexible height 變數。
  2. 資源庫中不支援下列控制項:
  3. 您只能在其他資源庫中新增一個資源庫。
  4. 最小的 TemplateSize 為 1。 當您不考慮範本大小時,可能會讓資源庫中的控制項失去預期的 XY 值。
  5. 如果您從資料自動產生應用程式,請儲存應用程式,並重新開啟,瀏覽資源庫可能不會立即顯示任何資料。 若要解決此問題,請在搜尋方塊中輸入至少一個字元,然後刪除鍵入的文字。 資源庫就會如預期顯示資料。
  6. 如果庫包含 ComboBox、DatePicker、Slider 或 Toggle 控件, OnChange 其規則修補與庫相同的 資料來源 或集合,則可能會導致意外或性能降低。 這是因為 OnChange 修補庫 資料來源 的規則可能會創建一個永無止境的修補和重新載入迴圈。 為避免此問題,建議在將這些控件放置在庫中時不要使用 OnChange 規則。

索引鍵屬性

Default – 當應用程式啟動時,預計在資源庫選取資料來源中的項目或記錄。

Items – 出現在資源庫控制項、清單或圖表中的資料來源。

Selected – 選取的項目。

其他屬性

AccessibleLabel – 畫面控制項讀取器的資源庫標籤 (不是它包含的項目)。 應描述項目的清單。

AllItems – 載入資料庫中的項目。 這可能小於資料來源中的實際項目數 。 滾動資料庫轉軸時,可能會載入更多項目。 AllItems 也包含用於每個資料庫項目中的控制項。

AllItemsCount – 資源庫中已載入項目的計數。 這可能小於資料來源中的實際項目數 。 滾動資料庫轉軸時,可能會載入更多項目。

BorderColor – 控制項框線的色彩。

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

BorderThickness – 控制項框線的粗細。

DelayItemLoading - 在畫面控制項首次載入之前,先延遲載入項目 (行)。

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

Fill – 控制項背景的色彩。

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

ItemAccessibleLabel – 每個畫面控制項讀取器的資源庫項目標籤。 應該描述每個項目的定義。

LoadingSpinner (NoneControlsData) - 當無時,將不會顯示微調框。 當 Controls | Data,當轉譯器發生略過導致看見空白行的情況時,將顯示微調器。

LoadingSpinnerColor - 載入微調框的填充色彩。 預設會設定為 BorderColor。

NavigationStep – 如果資源庫的 ShowNavigation 屬性設定為 true,而使用者選取該資源庫任一端的瀏覽箭頭,則資源庫會捲動多遠。

Selectable – 是否可以選取資源庫項目。 當設定為 true 時,畫面控制項讀取器會將資源庫識別為可選取清單。 而您可以選取它來選取項目。 當設定為 false 時,畫面控制項讀取器會將資源庫識別為常規清單,而選取項目不會連帶選取它。

ShowNavigation – 箭號是否出現在資源庫的每一端,讓使用者可以選取箭號來捲動資源庫中的項目。

ShowScrollbar – 使用者將滑鼠游標停留在資源庫上方時是否顯示捲軸。

TemplateFill – 資源庫的背景色彩。

TemplatePadding – 資源庫中項目之間的距離。

TemplateSize – 垂直/縱向方向的資源庫範本高度。 或依橫向/縱向方式排列資源庫範本的寬度。 最小大小為 1。

Transition – 使用者將滑鼠游標停留在資源庫中的項目上方時的視覺效果 ()。

Visible – 控制項顯示或隱藏。

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

WrapCount – 根據水平或垂直配置的每個資料列或欄位顯示的項目數。

X – 控制項左邊緣與其父容器或畫面左邊緣之間的距離。

Y – 控制項上邊緣與父容器或畫面上邊緣之間的距離。

Filter( DataSource, Formula )

Reset( Control ) - 將您的資源庫重新設定為初始狀態。 初始狀態包括捲動到第一個項目,並選取第一個項目或預設值 (如果有的話)。

注意

重設控制項不會遞迴重設資源庫的所有子系。

範例

顯示和篩選資料

取得使用者的資料

協助工具指南

色彩對比

如果點擊資源庫項目中的任意位置就代表選取它,以下項目之間必須有足夠的色彩對比:

  • BorderColor 與資源庫之外的色彩 (如果有框線)。
  • Fill 與資源庫之外的色彩 (如果沒有框線)。

螢幕助讀程式支援

  • AccessibleLabel 必須存在。

    注意

    螢幕助讀程式將在資源庫中的項目變更時宣告。 也會提及 AccessibleLabel。 這可提供宣告的內容,若同一個畫面控制項上有多個資源庫時則更重要。

  • 當資源庫項目包含多個控制項時,請使用 ItemAccessibleLabel 顯示資源庫項目的內容。

  • 如果您希望使用者選取庫項目,請將 Selectable 設定為 true。 否則,請將該值設定為 false

  • 當資源庫項目包含多個控制項時,請使用 ItemAccessibleLabel 提供資源庫項目內容的摘要。

  • 根據使用者是否要選取庫項目,Selectable 應適當地加以設定。

鍵盤支援

  • 請考慮將 ShowScrollbar 設定為 true。 在多數的觸控式螢幕裝置上,捲動開始之前不會顯示捲軸。

  • 如果點擊資源庫項目中的任意位置就代表選取它,鍵盤使用者也必須能夠選取資源庫項目。 例如,新增含有 OnSelect 屬性設定為 Select(Parent)按鈕

    注意

    資源庫中的鍵盤導覽順序不會考慮資源庫以外的控制項。 資源庫內控制項的 TabIndex 則在範圍內。 請參閱 協助工具屬性 了解詳細資訊。

請參閱

使用 DelayItemLoading 和載入微調按鈕來提高資源庫的效能

注意

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

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