Hey all,
I released OOjs UI 0.15.0 today. It will be in MW from 1.27.0-wmf.11+, which will be deployed to Wikimedia production in the regular train starting on Tuesday 19 January. As there are a couple of nominal breaking changes and a deprecation, please look carefully over them to determine if they affect your code.
Breaking changes since last release:
- Drop Internet Explorer 8 support from JavaScript code (Ricordisamoa)
We have simplified and streamlined the code to drop support for Internet Explorer 8 in the JavaScript code. This follows MediaWiki's dropping of support for executing JavaScript on Internet Explorer 8 clients, as the only significant user of the library and only cause of IE8 support. This is thus a nominal breaking change in environments supported which should not have any effect on developers or end-users in practice.
As part of this, we also deprecated the add/removeCaptureEventListener methods, which existed only to support Internet Explorer 8. These will be removed in a later release.
Note that the PHP code and related styling should continue to work without issue in Internet Explorer 8; if you have any issues, please raise a task in Phabricator.
- Delete deprecated aliases 'picture' and 'insert' (Ed Sanders)
These two old icon aliases in the core module were deprecated in v0.13.3 in November. By removing them we save some overhead for all users, as part of our work to slim down the library by de-duplicating and later removing each of the old core icons.
For 'picture', use 'image' from the 'media' icon pack. For 'insert', use 'add' from core (still to be moved out).
I believe these have had no Wikimedia production usage for months now.
Deprecating change since last release:
- Create single icon for language/translation (Ed Sanders)
As part of our on-going work to slim down the library, we have merged the old 'textLanguage' icon in the 'editing-styling' icon pack, and the 'translation' icon in the 'editing-advanced' icon pack into a new icon, 'language', also in 'editing-advanced'. We have also changed the icon to now use the Chinese character '文' which means language, instead of '大' which means big.
For now, 'textLanguage' and 'translation' will still work, but please switch over to 'language' before it is removed in OOjs UI v0.17.0.
- Move 'redirect' icon to 'articleRedirect' and cleanup (Ed Sanders)
For consistency, we have moved 'redirect' in 'editing-advanced' into the 'content' pack as 'articleRedirect', so that it is alongside the other article type icons. Again, 'redirect' will still work for now, but please switch over to 'articleRedirect' before it is removed in OOjs UI v0.17.0.
Additional details are in the full change log[0]. If you have any further questions or need help dealing with deprecations, please let me know. As always, general library documentation is available on mediawiki.org[1], and on doc.wikimedia.org there is generated code-level documentation and interactive demos[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/
Yours,