Ovládací prvok Rozbaľovacie pole v službe Power Apps

Ovládací prvok umožňujúci používateľom vyberať z ponúknutých možností. Podporuje vyhľadávanie a výber viacerých možností.

Popis

Ovládací prvok Rozbaľovacie pole vám umožňuje vyhľadávanie položiek, ktoré si zvolíte. Vyhľadávanie prebieha na základe vlastnosti SearchField na strane servera, takže výkon nie je ovplyvnený veľkými zdrojmi údajov.

Režim jednoduchého alebo viacnásobného výberu je nakonfigurovaný prostredníctvom vlastnosti SelectMultiple.

Pri vyhľadávaní položiek, ktoré chcete vybrať, môžete zmenou nastavenia rozloženia v Table s údajmi vybrať pre každú položku na zobrazenie jednu hodnotu údajov, dve hodnoty alebo obrázok a dve hodnoty (osoba).

Pri prezeraní na malých obrazovkách sa rozbaľovacia ponuka zoznamu položiek stane ovládacím prvkom celej obrazovky pre lepšiu použiteľnosť.

Poznámka

Ak chcete vyhľadávať položky pomocou čísel, prevádzajte čísla na text pomocou funkcie Text (). Napr. Text(12345).

Obmedzenia

Ovládací prvok poľa so zoznamom má tieto obmedzenia:

  • Keď použijete ovládací prvok Combo box v galérii, jeho výber sa neuchová, keď používateľ posúva galériu. Toto nie je problém, ak používate ovládací prvok Combo box v galérii, ktorá sa neposúva. Riešenie momentálne nie je k dispozícii.

Výber osôb

Ak chcete použiť Rozbaľovacie pole ako prostriedok na výber osôb, vyberte v nastaveniach rozloženia v Table s údajmi šablónu Osoba a nakonfigurujte vlastnosti príslušných údajov, ktoré sa majú pre danú osobu zobraziť.

Základné vlastnosti

Items – zdroj údajov, z ktorého je možné vyberať.

DefaultSelectedItems – počiatočne vybratá položka alebo položky pred interakciou používateľa s ovládacím prvkom.

Poznámka

Vlastnosť Default je zastaralá, používa sa namiesto nej DefaultSelectedItems.

SelectedItems – zoznam vybratých položiek vyplývajúcich z interakcie používateľa.

SelectMultiple – možnosť používateľa vybrať jednu alebo viac položiek.

IsSearchable – možnosť používateľa vyhľadávať pred výberom.

Poznámka

IsSearchable je možné povoliť iba na zdroj údajov, ktorý obsahuje aspoň jedno textové pole. Výraz Položky musí byť delegovateľný, aby sa dotazy mohli delegovať pri vyhľadávaní. To znamená, že vyhlásenia Ak v rámci výrazu Položky nie sú podporované.

SearchFields – pri zadávaní textu používateľom sa prehľadávajú údajové polia zdroja údajov.

Poznámka

Ak chcete vyhľadávať vo viacerých poliach, nastavte vlastnosť SearchFields v tomto formáte: ["MyFirstColumn", "MySecondColumn"]. Podporované sú iba textové polia.

Ďalšie vlastnosti

AccessibleLabel – označenie pre čítačky obrazovky.

BorderColor – farba orámovania ovládacieho prvku.

BorderStyle – štýl orámovania ovládacieho prvku Solid (Plné), Dashed (Prerušované), Dotted (Bodkované) alebo None (Žiadne).

BorderThickness – hrúbka orámovania ovládacieho prvku.

DisplayFields – zoznam polí zobrazených pre každú vyhľadanú položku. Najjednoduchšie sa nakonfiguruje prostredníctvom tably s údajmi v možnostiach karty Vlastnosti.

Poznámka

Ak chcete aktualizovať viac zobrazovacích polí v danej šablóne, nastavte vlastnosť DisplayFields v tomto formáte: ["MyFirstColumn", "MySecondColumn"].

DisplayMode – údaj o tom, či ovládací prvok umožňuje vstup používateľa (Edit), iba zobrazuje údaje (View) alebo je zakázaný (Disabled).

FocusedBorderColor – farba orámovania zameraného ovládacieho prvku.

FocusedBorderThickness – hrúbka orámovania zameraného ovládacieho prvku.

Height – vzdialenosť medzi horným a dolným okrajom ovládacieho prvku.

InputTextPlaceholder – inštruktážny text zobrazený pre koncových používateľov, keď nie sú vybraté žiadne položky.

OnChange – Akcie, ktoré sa majú vykonať, keď používateľ zmení výber.

OnNavigate – Akcie, ktoré sa majú vykonať, keď používateľ vyberie položku.

OnSelect – Akcie, ktoré sa majú vykonať, keď používateľ klepne na alebo vyberie ovládací prvok.

TabIndex – príkaz na navigáciu pomocou klávesnice vo vzťahu k iným ovládacím prvkom.

Visible – možnosť zobrazenia alebo skrytia ovládacieho prvku.

Width – vzdialenosť medzi ľavým a pravým okrajom ovládacieho prvku.

X – vzdialenosť medzi ľavým okrajom ovládacieho prvku a ľavým okrajom jeho nadradeného kontajnera (alebo obrazovky, ak sa nadradený kontajner nepoužíva).

Y – vzdialenosť medzi horným okrajom ovládacieho prvku a horným okrajom jeho nadriadeného kontajnera (alebo obrazovky, ak sa nadradený kontajner nepoužíva).

Poznámka

Vlastnosti rozbaľovacieho okraja sú riadené pomocou vlastností Orámovanie.

Príklady

Základné rozbaľovacie pole

Kroky v tomto príklade sa vzťahujú na všetky zdroje údajov, ktoré poskytujú tabuľky, ale aby ste presne dodržali tieto kroky, použite prostredie s databázou Microsoft Dataverse obsahujúcou vzorové údaje.

  1. Vyberte Vložiť > Vstup > Rozbaľovacie pole a pomenujte ho „Combobox1“.

  2. Na table Vlastnosti na pravej strane obrazovky otvorte zoznam Vybrať zdroj údajov (vedľa Položky) a potom pridajte alebo vyberte zdroj údajov, napríklad tabuľku Účty.

  3. Na tej istej table vyberte možnosť Upraviť (vedľa možnosti Polia).

  4. Na table Údaje otvorte zoznam Primárny text a potom vyberte stĺpec Primárne meno, ktorý sa zobrazí v ovládacom prvku Rozbaľovacie pole.

  5. Podržte stlačenú kláves Alt a vyberte šípku nadol, čím otvoríte ovládací prvok Rozbaľovacie pole.

    Ovládací prvok zobrazuje údaje z primárneho názvu, ktorý ste zadali v zdroj údajov, ktorý ste zadali.

(Voliteľné) Predvolene zobrazovať prvý záznam

  1. Nastavte vlastnosť DefaultSelectedItems na tento výraz, pričom nahraďte Zdroj údajov menom vášho zdroja údajov:

    First(DataSource)
    

(Voliteľné) Zobraziť vybranú hodnotu názvu účtu na označení

  1. Vyberte Vložiť > Textové označenie a potom vyberte Označenie.

  2. Nastavte vlastnosť Text tohto výrazu, pričom nahraďte Text týmto vzorcom:

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

    Poznámka

    Príkaz If skontroluje, ako môžu existovať vybrané položky, a zobrazí ich v označení s čiarkami alebo v hlásení „ŽIADNA VYBRANÁ POLOŽKA“, keď sú prázdne.

Simulujte jednoduché rozbaľovacie správanie

Nastavením IsSearchable na hodnotu false a SelectMultiple na hodnotu false môžete dosiahnuť rovnakú funkčnosť rozbaľovacej ponuky.

  1. Vyberte Vložiť > Vstup a potom vyberte Rozbaľovacie pole.

  2. Na table Vlastnosti na pravej strane obrazovky otvorte zoznam Vybrať zdroj údajov (vedľa Položky) a potom pridajte alebo vyberte zdroj údajov.

  3. Na tej istej table vyberte možnosť Upraviť (vedľa možnosti Polia).

  4. V table Údaje otvorte zoznam Primárny text a potom vyberte stĺpec, ktorý chcete zobraziť v ovládacom prvku Rozbaľovacie pole.

  5. Nastavte vlastnosť IsSearchable na hodnotu false.

  6. Nastavte vlastnosť SelectMultiple na hodnotu false.

  7. Podržte stlačenú kláves Alt a vyberte šípku nadol, čím otvoríte ovládací prvok Rozbaľovacie pole.

    Ovládací prvok zobrazuje údaje zo stĺpca, ktorý ste zadali v zdroji údajov, ktorý ste určili.

    Poznámka

    Text „Nájsť položky“ sa nezobrazuje a budete môcť vybrať iba jednu položku.

Pokyny na zjednodušenie ovládania

Farebný kontrast

Dostatočný farebný kontrast musí byť medzi:

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

Ide o doplnok k štandardným požiadavkám na farebný kontrast.

Podpora čítača obrazovky

  • Musí byť k dispozícii vlastnosť AccessibleLabel.

    Poznámka

    Na dotykových obrazovkách môžu používatelia čítačky obrazovky prechádzať obsahom rozbaľovacieho poľa postupne. Rozbaľovacie pole funguje ako tlačidlo, ktoré svoj obsah zobrazí alebo skryje pri výbere.

Podpora klávesnice

  • Vlastnosť TabIndex musí mat hodnotu nula alebo väčšiu, aby používatelia klávesnice na ňu mohli prejsť.

  • Indikátory zamerania musia byť jasne viditeľné. Dosiahnete to použitím vlastností FocusedBorderColor a FocusedBorderThickness.

    Poznámka

    Pomocou klávesu Tab možno prejsť na rozbaľovacie pole alebo mimo neho. Pomocou klávesov so šípkami možno prechádzať obsahom rozbaľovacieho poľa. Pomocou klávesu Esc možno zatvoriť otvorené rozbaľovacie pole.

Poznámka

Môžete nás informovať o svojich voľbách jazyka pre dokumentáciu? Absolvujte krátky prieskum. (upozorňujeme, že tento prieskum je v angličtine)

Prieskum bude trvať približne sedem minút. Nezhromažďujú sa žiadne osobné údaje (vyhlásenie o používaní osobných údajov).