Toolbar: Ribbon-skupine/Galerija

Nazaj: predstavitveni pregled

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