Power Apps 中的資源庫控制項

  • 發行項

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

描述

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

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

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

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

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

限制

  • 如果使用者在載入所有專案之前捲動 Flexible height 資源庫控制項，則在完成資料載入時，可能會將目前在視圖中的項目推外和縮小。 若要避免這個問題，請使用資源庫控制項取代 Flexible height 變數。
  • 資源庫中不支援下列控制項：
  • 您只能在其他資源庫中新增一個資源庫。
  • 最小的 TemplateSize 為 1。 當您不考慮範本大小時，可能會讓資源庫中的控制項失去預期的 X 或 Y 值。

索引鍵屬性

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 – 控制項上邊緣與父容器或畫面上邊緣之間的距離。

Filter( DataSource, Formula )

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

注意

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

範例

顯示和篩選資料

取得使用者的資料

協助工具指南

色彩對比

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

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

螢幕助讀程式支援

  • AccessibleLabel 必須存在。

    注意

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

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

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

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

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

鍵盤支援

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

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

    注意

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

請參閱

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

注意

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

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