Hello everyone,
we've released OOjs UI 0.19.0 today. It will be in MediaWiki core from
1.29.0-wmf.11, which will be deployed to Wikimedia production in the
regular train, starting on
Tuesday 07 February. As there are three breaking changes in this
release, at least
nominally, please carefully look over them to see if they affect your code.
Breaking changes since last release:
* ButtonWidget: Switch `box-sizing` over to `border-box` (Volker E)
Switching `box-sizing` to `border-box` value, making it easier
to calculate sizes and centralizing occurrences already in use
by widgets with buttons. It also aligns with the current way other
widgets are internally calculated. A rare, though possible side-effect could be
that different sized buttons are changing the layout slightly. If you run
into broken layouts with buttons, you'll need to adapt the size,
`padding` and `border`.
* LabelElement: Drop no-op fitLabel() method. (James D. Forrester)
This was a deprecated no-op since v0.16.0. Note that ProcessDialog#fitLabel()
still exists and is not a no-op. We're now removing the old function;
if you're still using it, you'll need to switch over.
* WindowManager: Error if `.static.name` is not defined when adding a
window (Bartosz Dziewoński)
WindowManager was already emitting a warning if `.static.name` was not defined,
now it throws an error. If you're still adding windows without it
defined, you'll need to
do so.
Deprecations since last release:
* MessageDialog: Default 'verbose' option to true (James D. Forrester)
This was an arbitrary styling choice that eventually became the
default in our designs;
rather than keep actively choosing it, instead let's just do it always.
We'll remove the ability to choose compact styling in an upcoming release.
* icons: Deprecate the 'beta' and 'ribbonPrize' icons (James D.
Forrester)
If you use them, be prepared that they'll removed from the libary in
an upcoming release.
* icons: Rename '*Undo' to 'un*' (James D. Forrester)
For consistency:
** blockUndo is now unBlock
** flagUndo is now unFlag
** trashUndo is now unTrash
This fits in with the pre-existing unLock and unStar patterns.
* icons: Rename 'betaLaunch' to 'logoWikimediaDiscovery', move pack
(James D. Forrester)
Additional details 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, a general
set of library documentation is available on mediawiki.org[1], and there is some
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/OOjs_UI
[2] -
https://doc.wikimedia.org/oojs-ui/master/
Best,
Volker
--
Senior UX Engineer, Editing
Wikimedia Foundation
volker.e [at] wikimedia | @Volker_E