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 klasse 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).

There are three kinds of element mixins, each identified with a naming convention:

Behavior mixins are identified with an ”able" suffix (e.g.,, etc.) Note that though a mixin class can create and initialize an object, it will not append it to the DOM. This must be done manually if you wish to manipulate the object directly.
 * Content &mdash; Content mixins generate elements by default (e.g., groups, icons, indicators and labels). The names of content mixins have no suffix (e.g.,,  , etc.)
 * Attribute &mdash; Attribute mixins operate on  by default (e.g., flags and titles). The names of attribute mixins have an "ed" suffix (e.g., ,  , etc.)
 * Behavior &mdash; Behavior mixins operate on  by default (e.g., clippable).

It is not uncommon to see widgets composed of multiple mixins: for example, the  class utilizes   and   mixins (and a few others). One can easily see which classes have been mixed and are available in the code-level documentation for each class. Mixin classes will always be displayed in the upper right of the documentation screen for each class. In addition, each configuration option notes the name of the class that defines it.