Toolbar: Ribbon-skupine/Galerija

Nazaj: predstavitveni pregled

Orodne vrstice z naslovljenimi skupinami in velikimi gumbi namesto niza enako majhnih ikon – kdaj se oblika Ribbon izplača in kako je sestavljena.

Stanje: [Live] – gradi na ključu group [Live] pri toolbar()-u. Referenca: DevExpress-ov videz Ribbon »Office 2019/Online« (naslovljene skupine z ločilno črto, veliki »galerija«-gumbi namesto enotno majhnih ikon).

osnovna pogodba Toolbara že razumljena (ključ group).

Poleg čisto vizualne ločitve group način ribbon ponuja:

• Naslov skupine pod skupino (majhno, umirjeno besedilo – »Oblika«, »Vstavi« …, .wk-toolbar__group-label) namesto čisto vizualne ločitve; naslovljena skupina nosi role="group" + aria-labelledby, ki kaže na naslov.
• Različico velikosti na vnos: vnos »galerija« (size => 'large', ikona nad oznako, npr. »Nova tabela«) ob več majhnih vnosih iste skupine.

echo $widgets->toolbar([
    ['label' => 'Nova tabela', 'element' => $novaTabelaButton, 'group' => 'oblikovanje', 'groupLabel' => 'Oblikovanje', 'size' => 'large'],
    ['label' => 'Stolpec',     'element' => $stolpecButton,    'group' => 'oblikovanje'],
], ['ribbonStyle' => true]);

Relevantno za orodne vrstice z veliko kategoriziranimi dejanji (npr. Table Designer s skupinama »Oblikovanje«/»Pogled«) – za preproste orodne vrstice zadošča obstoječa osnovna pogodba.

Razširitev $items: 'groupLabel' => string na prvem vnosu nove skupine (namesto ločenega polja skupin – skladno z obstoječim ravnim seznamom $items, brez strukturnega loma); 'size' => 'small'|'large' na vnos (privzeto small). Klici brez novih ključev se izrišejo bajtno identično prejšnji različici.

echo $widgets->toolbar([
    ['label' => 'Nova tabela', 'element' => $novaTabelaButton, 'group' => 'oblikovanje', 'groupLabel' => 'Oblikovanje', 'size' => 'large'],
    ['label' => 'Stolpec',     'element' => $stolpecButton,    'group' => 'oblikovanje'],
    ['label' => 'Indeks',      'element' => $indeksButton,     'group' => 'oblikovanje'],
], ['ariaLabel' => 'Dejanja Table Designerja', 'ribbonStyle' => true]);

• groupLabel na naslednjem vnosu iste skupine se prezre – le prvi vnos skupine nastavi naslov.

Naslovljene skupine so povezane s svojim vidnim naslovom prek role="group" + aria-labelledby – namerno eno samo avtoritativno ime skupine na vsebniku namesto aria-describedby na vsakem vnosu (to bi zahtevalo vrivanje v HTML elementa, ki ga izdela klicatelj); podrobnosti: Toolbar → Accessibility.

Simptom: naslov skupine se ne prikaže.

Vzrok: groupLabel ni nastavljen na prvem vnosu skupine.

Rešitev: premakniti ključ na prvi vnos skupine.

• predstavitveni pregled – vsaka kategorija
• Toolbar: osnove – podedovana pogodba group