Page MenuHomePhabricator

[WtC-M2] Replace WiKit Message component by Codex's
Closed, ResolvedPublic3 Estimated Story Points

Description

Problem

The Mismatch Finder's user interface was composed using a combination of Vue 2 custom components and WiKit elements, such as Message. The WiKit design system is now on its deprecation path, as it has been superseded by Codex, the official Wikimedia design system. The utilization of WiKit components is not recommended, and they should be replaced in order to reduce maintenance costs and ensure consistency.

Solution

We have to replace the WiKit Message by the Codex equivalent: cdx-message(See demo). This will take us a step closer to switching to the new design system and deprecating the old.

Here are some examples of messages used in the Mismatch Finder UI:

HomeResults page
Server side error:
Screenshot 2023-09-22 at 16.37.58.png (1,978×1,434 px, 181 KB)
No results found, Log in warning:
Screenshot 2023-09-22 at 16.35.17.png (2,650×1,440 px, 523 KB)
Submission success:
Screenshot 2023-09-22 at 16.30.45.png (1,884×1,372 px, 225 KB)
Acceptance criteria
  • All types of WiKit Messages used in Mismatch Finder are replaced by their Codex equivalent

Event Timeline

Task Breakdown Notes

  • Pay close attention to RTL support
  • We can simply use Wikit Links inside the message until we get to replacing them
  • Another find and replace job

All is looking good in general, but I noticed a layout issue only in the case of the success message. Unlike the other instances, this component stops wrapping from the moment the viewport is 640px on, and it overflows the page:

Screenshot 2023-11-21 at 19.09.51.png (1,158×964 px, 144 KB)

No other issues were detected in Chrome v119, Safari v17 or Firefox v119. I couldn't trigger the server side error message, but I don't think there can be differences at a component level.

Thanks to the recent fix, the success message now adjusts properly to smaller viewports (under 640px). Verified in Chrome v119, Safari v17 or Firefox v119.