OOUI/Toolbars/nl

Werkbalken
Werkbalken zijn complexe interfacecomponenten waarmee gebruikers eenvoudig toegang hebben tot een verscheidenheid aan hulpmiddelen (bijvoorbeeld opmaakopdrachten) en acties, die extra opdrachten zijn die deel uitmaken van de werkbalk, maar niet zijn geconfigureerd als hulpmiddelen.

Ontwikkelaars maken en passen de afzonderlijke hulpmiddelen aan en registreren ze vervolgens bij een ToolFactory, die ze op aanvraag maakt. Elk hulpmiddel heeft een symbolische naam (gebruikt bij het registreren ervan), een titel (bijvoorbeeld 'Afbeelding invoegen') en een pictogram.

Individuele hulpmiddelen zijn georganiseerd in groepen, die worden weergegeven als menu's met hulpmiddelen, lijsten met hulpmiddelen, of als een enkele balk met hulpmiddelen. U kunt de rangschikking en volgorde van de hulpmiddelengroepen aanpassen door het instellen van de werkbalk. Hulpmiddelen kunnen in elke volgorde worden weergegeven, maar ze kunnen slechts één keer in de werkbalk worden weergegeven.

Hieronder ziet u een voorbeeld van een basiswerkbalk. We zullen later in deze documentatie nader kijken naar elk van deze gebruikte componenten in dit voorbeeld. Als u deze demo live wilt zien, raadpleeg de gegenereerde documentatie.

Hulpmiddelen
Hulpmiddelen worden gemaakt door de abstracte class Tool of een van de subclasses ervan uit te breiden, PopupTool of ToolGroupTool. Elk hulpmiddel moet worden geconfigureerd met de eigenschappenː


 * : The symbolic name is used internally to register the tool with a ToolFactory. Tools must be registered with a tool factory before they can be used in a toolbar.
 * : The title text is used in different ways depending on the type of group the tool is placed inside (ToolBarGroup, ToolMenuGroup, or ToolListGroup). For ‘bar’ toolgroups, where only an icon is displayed to identify the tool, the title text is used as a tooltip that is displayed when a user moves the mouse over the tool. For ‘list’ toolgroups, the title text is used to identify the tool in the dropdown menus used in the user interface. If a keyboard shortcut has been defined for the tool, the shortcut will automatically be displayed. For tools in ‘bar’ toolgroups, the keyboard shortcut is displayed in a tooltip; for tools in ‘menu’ and 'list' toolgroups, the shortcut appears to the right of each item in the dropdown menu.
 * : The icon is also used in different ways depending on the type of toolgroup that the tool is inside. For ‘bar’ toolgroups, the icon is displayed in the toolbar to identify the tool. For ‘list’ toolgroups, the icon is displayed beside the title text in the dropdown menu. For ‘menu’ toolgroups, the icon is ignored.

In addition to the static properties, tools must also implement the following two methods:


 * onSelect, used to specify the action the tool will carry out when it is selected
 * onUpdateState, used to synchronize the state of the tool with the state of its larger context. For example, this method could be used to select the ‘bold’ tool in the toolbar when the text cursor is moved inside an area of bolded text.

Een hulpmiddel kan ook worden geconfigureerd met een statische eigenschap 'group', die later kan worden gebruikt bij het toevoegen van het hulpmiddel aan een balk, menu of toolgroep (zie ToolGroepen voor een voorbeeld van hoe dit wordt gedaan):

Voor een volledige lijst met ondersteunde methoden en configuratieopties, zie de code-level documentatie van de class Tool.

PopupTool
Pop-up hulpmiddelen openen een pop-upvenster wanneer ze worden geselecteerd op de werkbalk. In tegenstelling tot standaardhulpmiddelen vereisen pop-upss niet dat ontwikkelaars een methode van  of   opgeven, omdat deze methoden al zijn geïmplementeerd.

Voor een volledige lijst met ondersteunde methoden en configuratieopties, zie de code-level documentatie van de class PopupTool.

ToolGroupTool
A ToolGroupTool is a special sort of tool that can contain other tools and toolgroups. The ToolGroupTool was specifically designed to be used inside a ‘bar’ toolgroup to provide access to additional tools from the bar item.

For a complete list of supported methods and configuration options, please see the code-level documentation for the ToolGroupTool class.

ToolGroups
Tools are organized into toolgroups, which are created by a ToolGroupFactory and then added to the toolbar when the toolbar is set up. Individual tools can be added to any type of toolgroup (bar, list, or menu). The type of toolgroup determines how the included tools are arranged in the toolbar:
 * : Tools are displayed by icon in a single row.
 * : Tools are displayed with a label and icon in a dropdown menu. The tool's title is used as the label text. The list can be configured to be collapsed and expanded with the allowCollapse config.
 * : Tools are displayed by label in a dropdown menu. The tool's title is used as the label text. ‘menu’ tool groups are generally used for sets of mutually exclusive tools, such as a group of text formatting commands (paragraph, heading, etc).

Tools can be added to a toolgroup in one of several ways: by symbolic name, by group name, or with the ' * ' (asterisk) catch-all:

Add tools by :

Add tools by. A tool's group name is specified with the tool's static 'group' property (see Tools for an example).

Add tools with the :

Developers can further curate the arrangement of the tools using the toolgroup’s  and   configuration options, which will arrange the tools at the top of the tool list (or front of the toolbar) or end, respectively. These settings are particularly useful when tools have been added to the toolbar en masse (e.g., with the asterisk catch-all or when a group of tools is added to a toolgroup) to manage their priority.

BarToolGroup
Tools in a   are displayed by icon in a single row. The title of the tool is displayed when users move the mouse over the tool.

For a complete list of supported methods and configuration options, please see the code-level documentation for the BarToolGroup class.

ListToolGroup
Tools in a   are displayed by icon and label in a dropdown menu. The tool's title is used as the label text. List groups can be configured to be expanded and collapsed. Collapsed lists will have a ‘More’ option that users can select to see the full list of tools. If a collapsed toolgroup is expanded, a ‘Fewer’ option permits users to collapse the list again.

In addition to a,   can also be configured with a   and  :

Use the  config to designate tools as collapsible (‘help’ and ‘stuff’, in the following example). By default, the list opens in its collapsed state, and users must click the 'More' option to see the collapsed tools:

To display a collapsible list in its expanded state when the list is opened, set the  config to  :

Alternatively, you may wish to specify the names of tools that should never be collapsed. This is done with the  config. In the following example, only the ‘help’ tool has been designated as expanded; all other tools are collapsed by default.

For a complete list of supported methods and configuration options, please see the code-level documentation for the ListToolGroup class.

MenuToolGroup
Tools in  s are displayed by label in a dropdown menu. The tool's title is used as the label text, and the menu label is updated to reflect which tool or tools are currently selected. Note that all tools must define an  method if a   is used.



De werkbalk configureren
In addition to containing toolgroups, the toolbar can be configured with actions, CSS, accelerator keys, and/or an optional shadow.

Note that ‘actions’ in the context of the toolbar are different from ActionWidgets. For toolbars, ‘actions’ refers to an empty container that is right-aligned and can contain whatever you’d like.



Toolgroup toebvoegen
Toolgroups are added to the toolbar with the toolbar's  method:



Een actie toevoegen
Toolbars have an optional 'actions' area, which contains commands that are available to users but are not configured as tools. In the following example, the toolbar has been configured to use actions, in this case two additional buttons, ‘Action’ and ‘Disabled’. For the purpose of brevity, only the action-specific code is included in the example (the rest is just the same as the basic toolbar).



CSS gebruiken voor opmaak labels
Tool labels can be styled with built-in CSS classes that are named after each tool: oo-ui-tool-name-&lt;symbolic name of tool> (e.g., oo-ui-tool-name-picture). The following example uses CSS classes to customize the appearance of the 'picture' and the 'help' tool labels.





Sneltoetsen gebruiken
The OOUI library does not contain an accelerator system, but the Toolbar class does contain a hook for one. To use an accelerator system, subclass the toolbar and override the  method, which is meant to return a label that describes the accelerator keys for the tool passed (by symbolic name) to the method.

Accelerator labels (e.g., Ctrl + M ) are displayed in different ways depending on the type of toolgroup used:


 * For bar toolgroups, the accelerator label appears in the tooltip displayed when users move the mouse over the tool.
 * For menu and list toolgroups, the accelerator label is right-aligned and rendered in gray text, which still complies to WCAG level AA.



De werkbalk maken
The toolbar must be appended to the document before it can be built. Once it is appended, the toolbar can be initialized:

For a complete list of supported methods and configuration options, please see the code-level documentation for Toolbars.