OOUI/Creating interfaces programmatically/nl

De OOUI-bibliotheek biedt de bouwstenen voor het bouwen van een objectgeoriënteerde gebruikersinterface. Het bevat veel widgets en lay-outs die klaar zijn voor gebruik, evenals basiselementen die kunnen worden samengesteld om zelf iets te bouwen. Complexe systemen, zoals vensters en werkbalken, zijn ook aanwezig en kunnen worden uitgebreid en samengesteld om aan de behoeften van uw toepassing te voldoen.

Gebruikersinterfaces worden programmatisch gemaakt in OOUI, waardoor HTML-opmaak volledig wordt geabstraheerd. Met deze techniek kan de opmaak worden gewijzigd, zolang de API's die de opmaak genereren stabiel blijven. Markeringen kunnen veranderen bij het uitbreiden van een class om een nieuwe functie te ondersteunen, of bij het oplossen van een bug om de compatibiliteit te vergroten.

Alles in OOUI dat de gebruiker kan zien, is gebouwd met behulp van elementen, die samen zijn samengesteld om afzonderlijke delen van een gebruikersinterface te vormen, en ook om die delen samen te brengen. Door het hergebruik van elementen te maximaliseren, is visuele, gedrags- en API-consistentie gemakkelijker te onderhouden.



Om te beginnen
Als u nog niet bekend bent met hoe interfaces worden gemaakt met OOUI, bevat deze sectie een korte zelfstudie over het bouwen van een widget met behulp van de bibliotheek.

Het maken van een widget omvat twee basisstappen


 * 1) De widget wordt gemaakt en geconfigureerd
 * 2) De widget wordt toegevoegd aan de DOM

Houd er rekening mee dat OOUI-objecten aan de DOM moeten worden toegevoegd voordat ze zichtbaar zijn voor de gebruiker. Ontwikkelaars die code schrijven, moeten rekening houden met het feit dat een widget al dan niet aan de DOM is gekoppeld en nooit aan de DOM zal worden gekoppeld tijdens de uitvoering van de constructor. Zelfs nadat een element is bevestigd, kan het weer vrijgegeven zijn. U kunt controleren of het element op dat moment gekoppeld is met behulp van de methode.

Vergeet niet om de vereiste bibliotheken jQuery en Special:MyLanguage/OOjs op te nemen, evenals de relevante stijlinformatie (een van de OOUI-thema's, nu WikimediaUI, als standaard of Apex als alternatief) en de ''OOUI-bibliotheek zelf.



Een widget maken en configureren
Elke widget wordt gemaakt en geconfigureerd met een configuratieobject dat wordt doorgegeven aan de widgetconstructor of met behulp van methoden om de configuraties in te stellen (zie onderstaand voorbeeld). Veel van de methoden van de bibliotheek zijn koppelbaar, zoals uit het voorbeeld blijkt.

Zodra de widget is gemaakt en geconfigureerd, moet deze aan de DOM worden gekoppeld om zichtbaar te zijn voor de gebruiker. Gebruik de methode jQuery  om de nieuwe widget in de DOM in te voegen met de eigenschap.

Het volgende voorbeeld laat zien hoe u een eenvoudige  maakt en toevoegt. Wanneer er op wordt geklikt, dan wordt "https://www.mediawiki.org" in een nieuw venster geopend. wordt geconfigureerd met behulp van een configuratieobject. is geconfigureerd met behulp van de methoden van de widget:



Sommige get-methoden (bijv.  en  ) mogen niet worden gekoppeld. Deze methoden kunnen 'null' retourneren en als u probeert een andere methode op 'null' aan te roepen, treedt er een fout op.



Een 'event handler' verbinden met een widget
Widgets zenden gebeurtenissen uit wanneer ze op een bepaalde manier worden gebruikt of gewijzigd. Deze gebeurtenissen kunnen worden opgevangen door event-handlers aan de widget te koppelen. In het onderstaande voorbeeld wordt een zo een waarschuwing gegeven wanneer er op de knop wordt geklikt. Wanneer er op de knop wordt geklikt, wordt het label gereset om 'Do not click me!' te lezen via de methode setLabel van de knop.

Gebeurtenisafhandeling wordt geleverd door de class EventEmitter, die wordt "gemengd in" met alle widgets. Voor meer informatie over EventEmitter, zie OOjs primer.



Mixins begrijpen
Het concept van mixins is fundamenteel voor de bibliotheek en veel van de elementen van de bibliotheek kunnen worden aangepast via mixin-functionaliteit. Men kan bijvoorbeeld eenvoudig een pictogram toevoegen aan een knop-widget door gebruik te maken van het feit dat de class  wordt gemengd met de class.



Mixin classes kunnen worden gebruikt om nieuwe elementen te maken en toe te voegen aan een widget (zoals het pictogram in het bovenstaande voorbeeld) of om nieuw gedrag toe te voegen (zoals nieuwe methoden voor het verwerken van stijlvlaggen of titels).

Er zijn drie soorten element mixins, elk geïdentificeerd met een naamgevingsconventie:

Hoewel een mixin-class een object kan maken en initialiseren, wordt het niet aan de DOM toegevoegd. Dit moet handmatig worden gedaan als u het object rechtstreeks wilt manipuleren.
 * Content &mdash; Inhoud mixins genereren standaardelementen (bijvoorbeeld groups, icons, indicators en labels). De namen van inhouds mixins hebben geen achtervoegsel (bijvoorbeeld,  , enz.)
 * Attribute &mdash; Attribuut mixins werken standaard op  (bijvoorbeeldː flags en titles). De namen van attribuut mixins hebben "ed" achtervoegsel (bijvoorbeeld ,  , enz.)
 * Behaviour &mdash; Gedrags mixins werken standaard op  (bijvoorbeeldː clippable). Gedrag mixins worden geïdentificeerd met een achtervoegsel "able" (bijv. , enz.)

Het is niet ongebruikelijk om widgets te zien die zijn samengesteld uit meerdere mixins: de class  gebruikt bijvoorbeeld   en   mixins (en een paar andere). Men kan gemakkelijk zien welke classes zijn gemengd en beschikbaar zijn in de code-level documentatie voor elke class. Mixin classes worden altijd weergegeven in de rechterbovenhoek van het documentatiescherm voor elke class. Bovendien noteert elke configuratieoptie de naam van de class die deze definieert.