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,
--
James D. Forrester
Lead Product Manager, Editing
Wikimedia Foundation, Inc.
jforrester(a)wikimedia.org | @jdforrester