Polja obrazca: Button

1. Pregled in namen

Stanje: [Live] — widgets::button() plus osnovni CSS .wk-btn. Izvor in pogodba ARIA: vrstica „Button„ v osnovnem katalogu gradnikov (role=„button“/aria-pressed/aria-disabled, stanja disabled/hover/focus/checked). Referenca: DevExpress-ov ASPxButton (naštevni tip RenderMode Button/Link/Secondary/Outline/Danger).

2. Predpogoji

skupna pogodba polj že razumljena.

3. Pojmi

ASPxButton.RenderMode se skoraj dobesedno ujema z že uveljavljeno barvno semantiko Contract v3 te knjižnice (belo/modro/rdeče, glej Množične akcije → Gumbi) — pogodba prevzame to semantiko, namesto da bi izumljala četrto barvno lestvico.

4. Prvi koraki

echo $widgets->button([
    'name'  => 'do',
    'value' => 'delete',
    'label' => 'Izbriši povezavo',
    'variant' => 'danger',
]);

Napačno: uporabiti variant ⇒ 'danger' brez predhodnega pogovornega okna potrditve (glej odsek 7, Varnost).

5. Uporaba

`$opts['variant']`	Videz	Primer uporabe
`primary` (privzeto)	modro	glavno dejanje obrazca/pogovornega okna
`secondary`	belo	navadno, nedestruktivno dejanje
`outline`	belo, le rob	zadržano stransko dejanje
`danger`	rdeče	destruktivno dejanje — zahteva potrditev
`link`	podobno besedilu, brez chroma gumba	dejanje znotraj konteksta tekočega besedila

6. API referenca

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

7. Parametri, možnosti in stanja

Ključ	Tip	Pomen
`variant`	string	glej odsek 5, privzeto `primary`
`type`	`'submit'\|'button'\|'reset'`	nativni atribut `type` gumba, privzeto `submit`
`icon`	string	izbiren izris ikone pred oznako (zaupanja vreden HTML, kot `controlHtml` pri `propertyGrid()`)
`confirm`	string	če je nastavljeno: nativno besedilo `data-wk-confirm`, ki ga `scripts/formfields.js` prikaže kot potrditev `modal()` pred pošiljanjem obrazca — rezervni način brez JS: pošiljanje se izvede takoj, strežniški obravnavalnik ostane zavezujoča preverjalna instanca

Varnost: tako kot pri destruktivnih množičnih akcijah (Množične akcije) mora rdeč gumb bodisi sam sprožiti pogovorno okno potrditve modal() bodisi biti del obrazca, čigar strežniški obravnavalnik znova preveri dejanje — nikoli izvesti destruktivnega dejanja neposredno ob kliku brez povratnega vprašanja. Besedilo confirm je čista udobnost na strani odjemalca, ne varnostna meja.

8. Popolni primeri

echo $widgets->button([
    'name'    => 'do',
    'value'   => 'save',
    'label'   => 'Shrani',
    'variant' => 'primary',
    'type'    => 'submit',
]);

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
FluentUI: osnovni katalog gradnikov — predstopnja CSS/ARIA ravni 2
Styles-Contract (--wk-*) — barvna semantika, ki ji sledi variant
DataGrid: Data Editing (množična dejanja) — živ vzor za destruktivno potrditev