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.
Poznámka
Pokud chcete hledat položky pomocí čísel, převeďte čísla na text pomocí funkce Text(). Příklad: Text(12345).
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
Poznámka
Vlastnost Default je zastaralá, místo ní použijte DefaultSelectedItems.
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.
Poznámka
IsSearchable lze povolit pouze na zdroj dat, který obsahuje alespoň jedno textové pole. Výraz Items výraz musí být delegovatelný pro dotazy, které mají být delegovány pomocí vyhledávání. To znamená, že výrazy If ve výrazu Items výraz nejsou podporovány.
SearchFields – při zadávání textu uživatelem se prohledávají datová pole datového zdroje.
Poznámka
Chcete-li hledat ve více polích, nastavte vlastnost SearchFields na tento formát: ["MyFirstColumn", "MySecondColumn"]. Podporována jsou pouze textová pole.
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.
Poznámka
Chcete-li aktualizovat více polí zobrazení v dané šabloně, nastavte vlastnost DisplayFields na tento formát: ["MyFirstColumn", "MySecondColumn"].
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á).
Poznámka
Vlastnosti ohraničení informačního rámečku jsou ovládány pomocí vlastnosti Border.
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.
Vyberte Vložit > Vstup > Pole se seznamem a pojmenujte jej „Combobox1“.
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.
Na stejném panelu vyberte Upravit (vedle Pole).
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.
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
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
Vyberte Vložit > Textový popisek a potom vyberte Label.
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.
Vyberte Vložit > Vstup a potom vyberte Pole se seznamem.
V podokně Vlastnosti na pravé straně obrazovky otevřete seznam Vyberte zdroj dat (vedle Items) a poté přidejte nebo vyberte zdroj dat.
Na stejném panelu vyberte Upravit (vedle Pole).
V podokně Data otevřete seznam Primární text a poté vyberte sloupec, který chcete zobrazit, v ovládacím prvku Pole se seznamem.
Nastavte vlastnost IsSearchable na hodnotu false.
Nastavte vlastnost SelectMultiple na hodnotu false.
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.
Poznámka
Můžete nám sdělit, jaké máte jazykové preference pro dokumentaci? Zúčastněte se krátkého průzkumu. (upozorňujeme, že tento průzkum je v angličtině)
Průzkum bude trvat asi sedm minut. Nejsou shromažďovány žádné osobní údaje (prohlášení o zásadách ochrany osobních údajů).