Power Apps 中的資源庫控制項
包含其他控制項並顯示一組資料的控制項。
描述
資源庫控制項可以顯示來自資料來源的多筆記錄，每筆記錄可以包含多種類型的資料。 例如使用資源庫控制項顯示多名連絡人，每一項顯示包括每位連絡人的名稱、地址和電話號碼的連絡資訊。
每個資料欄位都會出現在資源庫控制項的不同控制項中。 而您可以在它的範本中組態這些控制項。 範本會顯示為資源庫中的第一個項目：
- 在資源庫控制項左邊緣上朝水平/橫向方向。
- 以及在資源庫控制項頂端朝垂直/縱向方向。
您在範本中進行的任何變更都會反映在整個資源庫控制項中。
目前資源庫開放預先定義的範本顯示圖像、文字，及具有變動高度項目的資源庫。
限制
資源庫控制項具有下列限制：
- 如果使用者在載入所有專案之前捲動 Flexible height 資源庫控制項，則在完成資料載入時，可能會將目前在視圖中的項目推外和縮小。 若要避免這個問題，請使用資源庫控制項取代 Flexible height 變數。
- 資源庫中不支援下列控制項：
- 您只能在其他資源庫中新增一個資源庫。
- 最小的 TemplateSize 為 1。 當您不考慮範本大小時，可能會讓資源庫中的控制項失去預期的 X 或 Y 值。
- 如果您從資料自動產生應用程式，請儲存應用程式，並重新開啟，瀏覽資源庫可能不會立即顯示任何資料。 若要解決此問題，請在搜尋方塊中輸入至少一個字元，然後刪除鍵入的文字。 資源庫就會如預期顯示資料。
- 如果庫包含 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 (None，Controls 或 Data) - 當無時，將不會顯示微調框。 當 Controls | Data，當轉譯器發生略過導致看見空白行的情況時，將顯示微調器。
LoadingSpinnerColor - 載入微調框的填充色彩。 預設會設定為 BorderColor。
NavigationStep – 如果資源庫的 ShowNavigation 屬性設定為 true，而使用者選取該資源庫任一端的瀏覽箭頭，則資源庫會捲動多遠。
Selectable – 是否可以選取資源庫項目。 當設定為 true 時，畫面控制項讀取器會將資源庫識別為可選取清單。 而您可以選取它來選取項目。 當設定為 false 時，畫面控制項讀取器會將資源庫識別為常規清單，而選取項目不會連帶選取它。
ShowNavigation – 箭號是否出現在資源庫的每一端，讓使用者可以選取箭號來捲動資源庫中的項目。
ShowScrollbar – 使用者將滑鼠游標停留在資源庫上方時是否顯示捲軸。
TemplateFill – 資源庫的背景色彩。
TemplatePadding – 資源庫中項目之間的距離。
TemplateSize – 垂直/縱向方向的資源庫範本高度。 或依橫向/縱向方式排列資源庫範本的寬度。 最小大小為 1。
Transition – 使用者將滑鼠游標停留在資源庫中的項目上方時的視覺效果 (跳、推 或 無)。
Visible – 控制項顯示或隱藏。
Width – 控制項左邊緣與右邊緣之間的距離。
WrapCount – 根據水平或垂直配置的每個資料列或欄位顯示的項目數。
X – 控制項左邊緣與其父容器或畫面左邊緣之間的距離。
Y – 控制項上邊緣與父容器或畫面上邊緣之間的距離。
相關函數
Reset( Control ) - 將您的資源庫重新設定為初始狀態。 初始狀態包括捲動到第一個項目，並選取第一個項目或預設值 (如果有的話)。
注意
重設控制項不會遞迴重設資源庫的所有子系。
範例
顯示和篩選資料
取得使用者的資料
協助工具指南
色彩對比
如果點擊資源庫項目中的任意位置就代表選取它，以下項目之間必須有足夠的色彩對比：
- BorderColor 與資源庫之外的色彩 (如果有框線)。
- Fill 與資源庫之外的色彩 (如果沒有框線)。
螢幕助讀程式支援
AccessibleLabel 必須存在。
注意
螢幕助讀程式將在資源庫中的項目變更時宣告。 也會提及 AccessibleLabel。 這可提供宣告的內容，若同一個畫面控制項上有多個資源庫時則更重要。
當資源庫項目包含多個控制項時，請使用 ItemAccessibleLabel 顯示資源庫項目的內容。
如果您希望使用者選取庫項目，請將 Selectable 設定為 true。 否則，請將該值設定為 false。
當資源庫項目包含多個控制項時，請使用 ItemAccessibleLabel 提供資源庫項目內容的摘要。
根據使用者是否要選取庫項目，Selectable 應適當地加以設定。
鍵盤支援
請考慮將 ShowScrollbar 設定為 true。 在多數的觸控式螢幕裝置上，捲動開始之前不會顯示捲軸。
如果點擊資源庫項目中的任意位置就代表選取它，鍵盤使用者也必須能夠選取資源庫項目。 例如，新增含有 OnSelect 屬性設定為 Select(Parent) 的按鈕。