Ovládací prvek Pole se seznamem v Power Apps

Ovládací prvek umožňující uživatelům vybírat z poskytnutých možností. Podporuje vyhledávání a výběr několika možností.

Popis

Ovládací prvek Pole se seznamem vám umožňuje vyhledávat položky k výběru. Vyhledávání probíhá prostřednictvím vlastnosti SearchField na straně serveru, takže výkon není ovlivněn velkými zdroji dat.

Režim jednoduchého nebo vícenásobného výběru se konfiguruje prostřednictvím vlastnosti SelectMultiple.

Když vyhledáváte položky k výběru, můžete změnou nastavení rozložení v podokně Data u každé položky zvolit zobrazení jedné hodnoty dat, dvou hodnot nebo dvou hodnot a obrázku (osoba).

Při prohlížení na malých obrazovkách se plovoucí nabídka seznamu položek stane ovládacím prvkem celé obrazovky pro lepší použitelnost.

Omezení

Ovládací prvek Pole se seznamem má tato omezení:

• Když používáte ovládací prvek Pole se seznamem uvnitř galerie, jeho výběr se nezachová, pokud uživatel galerií posouvá. Pokud ovládací prvek Pole se seznamem použijete v galerii, ve které se není možné posouvat, bude vše v pořádku. Alternativní řešení aktuálně není k dispozici.

Výběr osob

Pokud chcete pro výběr osob použít Pole se seznamem, zvolte v nastavení rozložení v podokně Data šablonu Osoba a nakonfigurujte níže uvedené vlastnosti souvisejících dat, která se mají pro osobu zobrazit.

Základní vlastnosti

Items – zdroj dat, ze kterého je možné vybírat.

DefaultSelectedItems – výchozí vybraná položka / vybrané položky před interakcí uživatele s ovládacím prvkem

SelectedItems – seznam vybraných položek vyplývající z interakce uživatele

SelectMultiple – možnost uživatele vybrat jednu položku nebo více položek.

IsSearchable – možnost uživatele vyhledávat položky před výběrem.

SearchFields – při zadávání textu uživatelem se prohledávají datová pole datového zdroje.

Další vlastnosti

AccessibleLabel – popisek pro čtečky obrazovky.

BorderColor – barva ohraničení ovládacího prvku.

BorderStyle – styl ohraničení ovládacího prvku Solid (Plné), Dashed (Čárkované), Dotted (Tečkované) nebo None (Žádné).

BorderThickness – tloušťka ohraničení ovládacího prvku.

DisplayFields – seznam polí zobrazený u každé vyhledané položky. Nejjednodušeji se konfiguruje prostřednictvím podokna Data v možnostech karty Vlastnosti.

DisplayMode – ovládací prvek umožňuje zadávání uživatelem (Edit, Úpravy), pouze zobrazuje data (View, Prohlížení) nebo je zakázaný (Disabled, Zakázáno).

FocusedBorderColor – barva ohraničení ovládacího prvku, když je na něm fokus

FocusedBorderThickness – tloušťka ohraničení ovládacího prvku, když je na něm fokus.

Height – vzdálenost mezi horním a dolním okrajem ovládacího prvku.

InputTextPlaceholder – instruktážní text zobrazený koncovým uživatelům, když nejsou vybrané žádné položky.

OnChange - Akce, které se mají provést, když uživatel změní výběr.

OnNavigate – Akce k provedení, když uživatel vybere položku.

OnSelect – Akce k provedení, když uživatel vybere ovládací prvek.

TabIndex – pořadí při navigaci pomocí klávesnice vzhledem k jiným ovládacím prvkům.

Visible – možnost zobrazení nebo skrytí ovládacího prvku.

Width – vzdálenost mezi levým a pravým okrajem ovládacího prvku.

X – vzdálenost mezi levým okrajem ovládacího prvku a levým okrajem jeho nadřazeného kontejneru (nebo obrazovky, pokud se nadřazený kontejner nepoužívá).

Y – vzdálenost mezi horním okrajem ovládacího prvku a horním okrajem jeho nadřazeného kontejneru (nebo obrazovky, pokud se nadřazený kontejner nepoužívá).

Příklady

Základní pole se seznamem

Kroky v tomto příkladu platí pro všechny zdroje dat, které poskytují tabulky, ale abyste přesně dodrželi tyto kroky, použijte prostředí s databází Microsoft Dataverse obsahující ukázková data.

1. Vyberte Vložit > Vstup > Pole se seznamem a pojmenujte jej „Combobox1“.

2. V podokně Vlastnosti na pravé straně obrazovky otevřete seznam Vyberte zdroj dat (vedle Items) a poté přidejte nebo vyberte zdroj dat, například tabulku Obchodní vztahy.

3. Na stejném panelu vyberte Upravit (vedle Pole).

4. V podokně Data otevřete seznam Primární text a poté vyberte sloupec Primární jméno, který se zobrazí v ovládacím prvku Pole se seznamem.

5. Podržte klávesu Alt a vyberte šipku dolů k otevření ovládacího prvku Pole se seznamem.

   Ovládací prvek zobrazuje data z primárního názvu, který jste zadali ve zdroji dat, který jste zadali.

(Volitelné) Ve výchozím nastavení zobrazte první záznam

1. Nastavte vlastnost DefaultSelectedItems tohoto výrazu, nahraďte Zdroj dat názvem vašeho zdroje dat:

   First(DataSource)
   

(Volitelné) Zobrazte vybranou hodnotu názvu účtu v popisku

1. Vyberte Vložit > Textový popisek a potom vyberte Label.

2. Nastavte vlastnost Text na tento výraz, nahraďte Text následujícím vzorcem:

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

   Poznámka

   Příkaz If zkontroluje, jak mohou existovat vybrané položky, a zobrazí je v popisku odděleném čárkami nebo ve zprávě „NO SELECTED ITEM“, pokud je prázdný.

Simulujte jednoduché chování rozbalovacího seznamu

Nastavením IsSearchable na false a SelectMultiple na false můžete dosáhnout stejné funkčnosti rozevíracího seznamu.

1. Vyberte Vložit > Vstup a potom vyberte Pole se seznamem.

2. V podokně Vlastnosti na pravé straně obrazovky otevřete seznam Vyberte zdroj dat (vedle Items) a poté přidejte nebo vyberte zdroj dat.

3. Na stejném panelu vyberte Upravit (vedle Pole).

4. V podokně Data otevřete seznam Primární text a poté vyberte sloupec, který chcete zobrazit, v ovládacím prvku Pole se seznamem.

5. Nastavte vlastnost IsSearchable na hodnotu false.

6. Nastavte vlastnost SelectMultiple na hodnotu false.

7. Podržte klávesu Alt a vyberte šipku dolů k otevření ovládacího prvku Pole se seznamem.

   Ovládací prvek zobrazuje data ze sloupce, který jste zadali ve specifikovaném zdroji dat.

   Poznámka

   Text „Najít položky“ zmizel a budete moci vybrat pouze jednu položku.

Pokyny pro přístupnost

Barevný kontrast

Zajistěte adekvátní barevný kontrast mezi těmito vlastnostmi:

• ChevronFill a ChevronBackground
• ChevronHoverFill a ChevronHoverBackground
• SelectionColor a SelectionFill
• SelectionFill a Fill
• SelectionTagColor a SelectionTagFill

Jde o doplněk ke standardním požadavkům na barevný kontrast.

Podpora pro čtení z obrazovky

• Musí existovat vlastnost AccessibleLabel.

  Poznámka

  Na dotykových obrazovkách můžou uživatelé čtečky obrazovky procházet obsah pole se seznamem postupně. Pole se seznamem funguje jako tlačítko, které zobrazí nebo skryje obsah při výběru.

Podpora klávesnice

• Vlastnost TabIndex musí být nulová nebo větší, aby na ni uživatelé klávesnice mohli přejít.

• Ukazatele fokusu musí být zřetelně vidět. Toho dosáhnete pomocí vlastností FocusedBorderColor a FocusedBorderThickness.

  Poznámka

  Klávesou Tab se přechází na pole se seznamem nebo mimo ně. Klávesami se šipkami se prochází obsah pole se seznamem. Klávesou Esc se zavře otevřený rozevírací seznam.