TreeView: Adaptivity
Nazaj: predstavitveni pregled
1. Pregled in namen
Stanje: [Live]. Referenca: DevExpress-ovi adaptivni načini drevesa.
2. Predpogoji
osnovna pogodba TreeViewa že razumljena.
3. Pojmi
tree() danes živi izključno v regiji stranske vrstice
(layout →
Tabela delov), ki je sama po sebi odzivna glede na vsebnik prek
resize + overflow: auto (sestavina 5 v receptu CSS, glej
DataGrid →
Adaptivity). Samo drevo nima lastnega vedenja prelomnih točk — dolge
oznake se prelomijo ali jih odreže overflow stranske vrstice, odvisno
od širine stranske vrstice.
4. Prvi koraki
Klic, kot je dokumentirano v API referenci.
5. Uporaba
Relevantno, ko se stranska vrstica zmanjša na strnjeno širino ikon (glej admin-layout) in mora drevo ostati uporabno.
6. API referenca: strnitev na vrstico ikon [Live]
Zelo ozka stranska vrstica (strnjeno stanje, oznaka
.wk-shell-sidebar.is-collapsed) zmanjša drevo na gola vozlišča
z ikonami, namesto da bi odrezala besedilo — čista CSS-vidnost na istih
vozliščih, brez ločenega izrisa.
7. Parametri, možnosti in stanja
| Ključ | Tip | Pomen |
|---|---|---|
$nodes[]['icon'] | string | zaupanja vreden HTML (.wk-tree__icon); ostane edini viden element pri strnjeni stranski vrstici; vozlišča z ikono samodejno nosijo label kot orodni namig title in aria-label na povezavi |
8. Popolni primeri
echo $widgets->tree([ ['label' => 'Tabele', 'href' => wl($ID, ['t' => 'x']), 'icon' => '<i class="fa fa-table"></i>'], ]);
9. Omejitve in robni primeri
- Vozlišče brez
iconje v strnjenem stanju nevidno — tam so ikone dejansko obvezne (isto pravilo kot pri NavBar → Adaptivity).
10. Dostopnost in združljivost
Samo orodni namigi title so za bralnike zaslona nezanesljivi — zato
tree() pri vozliščih z ikono dodatno nastavi label kot
aria-label na povezavi (dostopno ime preživi CSS-skrivanje
besedilnega vozlišča).
11. Odpravljanje težav
Simptom: v strnjenem stanju vozlišča povsem izginejo.
Vzrok: vozlišče brez icon (glej odsek 9).
Rešitev: vsakemu vozlišču dodeliti icon ali za to stransko
vrstico ne ponuditi strnjenega stanja.
12. Sorodne teme
- predstavitveni pregled — vsaka kategorija
- DataGrid: adaptivity — enako načelo, ki ga vodi vsebnik, pri DataGridu