Polja obrazca: list editors

1. Pregled in namen

Stanje: [Live]. Referenca: DevExpress-ov ASPxListBox (seznam posamezne/večkratne izbire) in ASPxCheckBoxList (skupina potrditvenih polj).

2. Predpogoji

skupna pogodba polj že razumljena.

3. Pojmi

Dva prikaza, en podatkovni model: obe različici sprejmeta isto strukturo options kot Combo Box — razlika je čisto predstavitvena.

4. Prvi koraki

echo $widgets->listEditor([
    'name'    => 'moduli',
    'label'   => 'Vidni moduli',
    'multi'   => true,
    'display' => 'checkboxes',
    'value'   => ['wiki', 'blog'],
    'options' => [
        ['value' => 'wiki', 'label' => 'Wiki'],
        ['value' => 'blog', 'label' => 'Blog'],
        ['value' => 'pqcrypt', 'label' => 'PQ Crypto'],
    ],
]);

5. Uporaba

`$opts['display']`	Nativni kontrolnik	Primer uporabe
`list` (privzeto)	`<select multiple>` (pri `multi ⇒ true`) oziroma `<select>`	strnjen seznam, veliko možnosti
`checkboxes`	skupina `<input type="checkbox">` (oziroma `radio` pri `multi ⇒ false`)	malo možnosti, vse hkrati vidne

6. API referenca

Metoda listEditor(array $opts): string v helper_plugin_wkfluentui_widgets.

7. Parametri, možnosti in stanja

Ključ	Tip	Pomen
`options`	array	tako kot pri Combo Box
`multi`	bool	večkratna izbira, privzeto `false`
`display`	`'list'\|'checkboxes'`	glej odsek 5
`selectAllToggle`	bool	pri `display => 'checkboxes', multi => true`: dodatno potrditveno polje glave „Izberi vse„ (analogno potrditvenemu polju glave pri dataGrid() Selection — isti vzorec, uporabljen drugič)

8. Popolni primeri

echo $widgets->listEditor([
    'name'    => 'vloge',
    'label'   => 'Vloge',
    'multi'   => true,
    'display' => 'list',
    'options' => $razpolozljiveVloge,
]);

9. Omejitve in robni primeri

Nobenih onkraj strani funkcij.

10. Dostopnost in združljivost

Celoten pregled: Accessibility.

11. Odpravljanje težav

Se ne uporablja.

12. Sorodne teme

predstavitveni pregled — vsaka kategorija
Polja obrazca: Check box — posamezno potrditveno polje namesto skupine
DataGrid: selection — soroden vzorec potrditvenega polja glave