FluentUI (knjižnica oblikovalskega sistema)
FluentUI je od predloge neodvisen komplet gradnikov hiše: skupni oblikovalski žetoni --wk-*, lupina delovne površine z območji in zavihki, katalog izdelanih gradnikov (drevo, podatkovna mreža, mreža lastnosti, orodna vrstica, obrazci) in samodejni preusmeritvi na začetno stran. Paket je namenjen razvijalcem vtičnikov, ki gradijo skrbniški zaslon brez lastnega CSS, in upraviteljem, ki določijo videz, jezik in začetno stran wikija.
Prvi koraki
Hitri začetek: skrbniški zaslon na delovni površini – najkrajša pot do prvega rezultata, v dveh korakih in brez kode.
Naložite pomočnika → Izrišite lupino → Dodajte gradnik → Poiščite pogodbo metode
Pogosta opravila
| Kaj želite | Za koga | Kje to naredite | Navodilo |
|---|---|---|---|
| od začetka zgraditi skrbniški zaslon | razvijalci | lasten paket | Vodnik: gradnja prvega skrbniškega zaslona |
| dodati posamezen gradnik (orodna vrstica, podokno lastnosti, zavihki) | razvijalci | lasten paket | Navodila: dodajanje posameznih gradnikov |
| lasten paket priključiti na delovno površino | razvijalci | dogodek in deskriptor | Workbench Plugin Contract v1 |
| poiskati metodo ali parameter | razvijalci | – | Javni API pomočnika |
| poiskati oblikovalsko vrednost | razvijalci | – | Oblikovalski žetoni |
| izbrati gradnik iz kataloga | razvijalci | – | Osnovni katalog gradnikov |
| določiti kožo, poudarek ali shemo | upravitelji | Skrbništvo > Urejevalnik tem | Referenca nastavitev: videz |
| preusmeriti začetno stran wikija | upravitelji | upravitelj nastavitev | Referenca nastavitev: preusmeritev na začetno stran |
| spremeniti nastavitev in vedeti, kaj povzroči | upravitelji | upravitelj nastavitev | Referenca nastavitev |
| pogledati, kako so območja razrezana | razvijalci | – | Osnovna postavitev, Postavitev wikija |
Potek na kratko
Lupino sestavljajo poimenovana območja, ki jih paket zaseda posamično – stranska vrstica, vsebina, pomožna vrstica, vrstica stanja, poleg tega vrstice in glave. Skica prikazuje območja splošnega kompleta; celotno razporeditev, katero območje je že dobavljeno in katero prispeva hišna predloga, opisuje referenca območij.
rail
rail--right
Ključne zmožnosti
- Oblikovalski žetoni
--wk-*kot privzete vrednosti za celotno spletno mesto – barva, velikost, polmer, razmik in tipografija, izpeljani iz VS Code in Azure Data Studia - Lupina delovne površine z območji, upravljanjem zavihkov in razporeditvami, neodvisna od aktivne predloge
- Katalog gradnikov: drevo, drevesni seznam, podatkovna mreža, mreža lastnosti, orodna vrstica, navigacijska vrstica, urejevalniki, strani obrazcev in osnovni gradniki
- API pomočnika za naštevanje modulov z upoštevanjem ACL, sezname galerij, navigacijo med paketi in izračun inicialk
- Dve samodejni preusmeritvi: začetna stran glede na jezik in skupino ter kazalo imenskega prostora na začetno stran – obe je mogoče izklopiti
- Urejevalnik tem kot skrbniški zaslon za kožo, poudarek in shemo
Ključni pojmi
Predloga prinaša videz, vtičnik prinaša zgradbo. Vse, kar mora preživeti menjavo predloge – delovna površina, območja, upravljanje zavihkov, preusmeritve, naštevanje modulov, izračun inicialk, privzete vrednosti žetonov – spada v ta paket. Hišni predlogi wkbizway ostane tisto, kar ima smisel le z njo: barvni žetoni, sheme, mreža strani, glava in noga. Preizkusni kamen je hišno pravilo in del vsakega prevzema: če je tema BizWay izklopljena, delovna površina deluje nespremenjeno.
Neodvisnost zagotavlja DokuWikijev lastni mehanizem: css_pluginstyles() vključi sloge vsakega omogočenega paketa na vseh straneh spletnega mesta. Vrstni red nalaganja je jedro → vtičnik → predloga → uporabnik; aktivna predloga lahko privzete vrednosti torej povozi, če pa lastnih vrednosti ne določi, veljajo privzete vrednosti tega paketa. V celoti: Styles Contract.
Upravljanje
- Skrbništvo > Urejevalnik tem (
do=admin&page=wkfluentui_themebuilder) – koža, poudarek, shema in gostota - Referenca nastavitev – vse nastavitve s tipom, privzeto vrednostjo in prednostjo pred izbiro uporabnika
- Prednostni vrstni red privzetih vrednosti – kdo zmaga, kadar predloga, paket in uporabnik določijo različne vrednosti
Diagnostika
- Preusmeritev se ne sproži ob nobenem odprtju strani – največkrat je
landing_pagenastavljen na cilj namesto na sprožilno ime
Za razvijalce
- Workbench Plugin Contract v1 – dogodek, deskriptor, zmožnosti, pravice
- Javni API pomočnika – dejansko izvedene pogodbe metod
- Oblikovalski žetoni – barva, velikost, polmer, razmik, tipografija
- README vtičnika – angleška izdaja v repozitoriju projekta, vedno v trenutni različici
- Styles Contract – kdo sme določati katere žetone
Sorodne teme
- Vodnik: gradnja prvega skrbniškega zaslona s FluentUI – gradnja prvega skrbniškega zaslona iz nič
- Navodila: dodajanje posameznih gradnikov – dodajanje posameznih gradnikov
- FluentUI: referenca nastavitev – referenca nastavitev
- Workbench Plugin Contract v1 – Workbench Plugin Contract v1
- Katalog gradnikov – vse komponente z osnovami, dostopnostjo in prilagoditvijo
- Lupine območij – osnovna postavitev, postavitev wikija, skrbniško območje
- FluentUI: prihodnja usmeritev – Wdx kot vir navdiha – arhitekturna odločitev: Wdx kot vir navdiha, brez integracije med izvajanjem
- FluentUI: prihodnja usmeritev – strani obrazcev, podprte s shemo – zgodovina odločanja o straneh obrazcev