Hello everyone,
I'm excited to announce that we've released OOUI v0.26.0 today. It will be in MediaWiki core from 1.31.0-wmf.26, which will be deployed to Wikimedia production in the regular train, starting on Tuesday 27 March. In this breaking release email I would like to begin with pointing out two “normal” changes with visible user-interface amendments: - The Design team at the Wikimedia Foundation has established new icon guidelines over the course of recent months – resulting in a new set which is part of this release. The set features improved universality, consistency, neutrality, developer-friendliness and RTL language support. - We took the chance of integrating those icons by also unifying VisualEditor interface on same base size as all other Vector/OOUI interfaces already had in place. While this leads to a minimal increase of space (f.e. 2px in height) for the toolbar items, it reduces and optimizes the interface in all existing OOUI-based Special:Pages and extensions.
As there are seven breaking changes in this release, at least nominally, please carefully consider if they affect your code:
* icons: Remove 'alignCentre', renamed in v0.24.2 * icons: Remove 'arrowLast', deprecated since v0.25.0 * icons: Remove 'bellOn', deprecated in v0.25.0 * icons: Remove 'quotesAdd', deprecated in v0.24.4 * icons: Remove 'redirect', renamed in v0.24.4 * indicators: Remove 'next' and 'previous', deprecated in v0.25.0 All six changes above have been deprecated and announced in former versions. With this release we've removed them completely.
* WikimediaUI theme: Unify available variants across icon packs This could affect 'wikimedia' pack users with icons set to 'progressive'. Due to branding guideline reasons we need to remove this color variation We are not aware of any such use case in production, nonetheless mark it breaking.
Please update your icon pack references accordingly in case you're using one of those icons or variants.
Additional details on 12 new features, 53 code-level and accessibility changes, 18 styling and interaction design amendments, and all improvements since v0.25.0 are in the full changelog[0]. If you have any further queries or need help dealing with breaking changes, please let me know.
As always, library documentation is available on mediawiki.org[1], and there is comprehensive generated code-level documentation and interactive demos hosted on doc.wikimedia.org[2].
[0] - https://phabricator.wikimedia.org/diffusion/GOJU/browse/master/History.md [1] - https://www.mediawiki.org/wiki/OOUI [2] - https://doc.wikimedia.org/oojs-ui/master/
Best, Volker
-- Senior UX Engineer Wikimedia Foundation
volker.e@wikimedia.org | @Volker_E
On 2018-03-21 05:20, Volker E. wrote:
The Design team at the Wikimedia Foundation has established new icon guidelines over the course of recent months – resulting in a new set which is part of this release. The set features improved universality, consistency, neutrality, developer-friendliness and RTL language support.
Important note to follow-up on this, if your application has any custom icons: the old icons were 24x24px, while the new ones are 20x20px.
The dimensions of the graphics are actually mostly unchanged (the old ones were drawn with large "margins"), but you will need to adjust your icon files, otherwise they will be scaled down to 20px and look rather small compared to built-in icons.
If your icons already fit the guidelines [1], you can often just trim the canvas by 2px on each side.
I've updated some extensions in Wikimedia version control, but others will need work from their maintainers [2] – at a quick glance, this includes CodeEditor, CodeMirror, ContentTranslation, Echo, Flow, Kartographer, and MobileFrontend.
[1] https://wikimedia.github.io/WikimediaUI-Style-Guide/visual-style_icons.html [2] https://phabricator.wikimedia.org/T177432#4066077
wikitech-l@lists.wikimedia.org