Design/Archive/Wikimedia Foundation Design/Agora Control Library

The Agora Control Library is a series of styles and behaviors for common controls that are reused across projects within MediaWiki.

Current State
There is a mediawiki.ui library (documentation) in core, written in Sass (converting it to LESS is 54485).

Each team who will be using controls from the Agora Library is writing their controls in LESS within their own project; some of these are entirely new controls, and some override or enhance the mediawiki.ui ones. The next step is to add these new or modified controls into core so they can be used by developers within their own work.

The initial look and feel of Agora Controls was outlined in this spec; however, this is an iterative process and controls will change during implementation.

Buttons
Buttons come in 4 basic types, Neutral, Progressive, Destructive, and Constructive

Quiet Action
Button with Neutral null state and Progressive/Destructive/Constructive hover, click, or post-click state

Toolbar button icon only
e.g. VE tool buttons

Toolbar button with icon and label
e.g. VE page settings

Sub-toolbar "drawer"
e.g. VE toolbar for advanced text styling

Toolbar flyout
e.g. VE toolbar junk drawer (more v)

Input Fields
Text input fields come in many styles, with special behaviors, such as search, validation, and content obscuring in the case of passwords.

Special Cases
ULS language selector control

Date picker control

Actionable
Dual action or collapsible (top, left, bottom, right anchoring)

Informational
Anchored to element and triggered by focus state (top, left, bottom, right anchoring)

Button with Image
Requestor: Growth Team (WMF)

Use: Getting started

Tracking Bug : https://bugzilla.wikimedia.org/show_bug.cgi?id=55535

Status : Not designed

Button with Status Indicator
Requestor: Core Features (WMF)

Use: Flow/submit

Tracking Bug :

Status : Not designed

Multi-line Text Button
Requestor: Growth Team (WMF)

Use: Getting started

Tracking Bug : https://bugzilla.wikimedia.org/show_bug.cgi?id=55535

Status : Not designed

Extended Actions
Requestor: Core Features (WMF)

Use: Flow/Junk Drawer

Tracking Bug : https://bugzilla.wikimedia.org/show_bug.cgi?id=55535

Status : Designed

Horizontal Action Menu
Requestor: Core Features (WMF)

Use: Flow/Flag Actions

Tracking Bug : https://bugzilla.wikimedia.org/show_bug.cgi?id=55535

Status : Designed

Language Selector
Requestor: Language Engineering (WMF)

Use: ULS

Tracking Bug :

Status : Not designed

Date Picker
Requestor: Wikidata

Use: Data Input

Tracking Bug :

Status : Not designed