OOUI v0.27.0 release (breaking change) - Wikitech-l

9 May 2018

Hello everyone,

We've released OOUI version 0.27.0 last evening. It will be in
MediaWiki core from 1.32.0-wmf.3, which will be deployed to Wikimedia
production in the regular train, starting on Tuesday 16 May. As there
are five breaking changes in this release, at least nominally, please
carefully consider if they affect your code.

Breaking changes since last release:

* GroupElement: Remove getItem(s)FromData (Prateek Saxena)
We rename a number of getters when asking for one of 0+ items for
consistency reasons.
This and the following two changes are all on this topic.

* MultiSelectWidget: Remove getSelectedItems and getSelectedItemsData
(Prateek Saxena)

* SelectWidget: Remove getSelectedItem (Prateek Saxena)

* TagItemWidget: Replace 'disabled' items with 'fixed' (Moriel
Schottlender)
For consistency of behavior and separation of UX concerns, we don't
allow for individual tag items in a TagMultiselectWidget to be
individually disabled. Instead, allow defining 'fixed' values that
cannot be removed. We are not aware of any instance of the
TagMultiselectWidget featuring 'disabled' items, nevertheless marking
it as breaking change.

* indicators: Remove 'alert', deprecated in v0.25.2 (James D. Forrester)
'alert' indicator has been deprecated a while ago and is unused in all
known implementations, therefore we've removed it completely.

Deprecations since last release:

* icons: Deprecate 'editing-citation' icons from 'content' (Volker E.)
We've added an explicit 'editing-citation' icon pack, that helps us
standardize citation icons. Therefore we have moved existing related
icons to its own pack.

* icons: Rename 'settings' to 'pageSettings' (Volker E.)
Clarify intended usage of icon by renaming it.

Please update your icon pack references accordingly in case you're
using one of those icons.

New features, icons and highlights in this release:

* An infusable PHP NumberInputWidget was implemented by volunteer mainframe98.

* icons: 'editing-citation' pack was added (Volker E.)

* ProcessDialog: Fix footer height when actions or dialog size changes
(Bartosz Dziewoński)

Additional details on 45 code-level and accessibility changes, 34
styling and interaction design amendments, and all improvements since
v0.26.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 some comprehensive generated code-level documentation and
interactive demos hosted on doc.wikimedia.org[2].

Thanks to all contributors involved, especially volunteers mainframe98
and Daimona Eaytoy!

Best,
Volker

[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/

--
Senior User Experience Engineer
Wikimedia Foundation

volker.e(a)wikimedia.org | @Volker_E