Baseline UI migration guide

We’re internally migrating Web SDK components to Baseline UI, our in-house, accessibility-driven design system. This migration helps us not only in improving the accessibility of the SDK UI components, but also in ensuring customizability, performance, and a more consistent user experience.

The migration has required deep changes in the interface DOM structure, as well as in styling and some public class names. We try to keep such changes to a minimum so as to avoid breaking implementations. However, due to the variety of ways in which CSS selectors can be written, it isn’t possible to foresee all the scenarios where this migration can go wrong for a specific implementation.

Therefore, it’s not possible to provide an exact migration guide that covers all possible scenarios.

The best way to approach upgrading is to keep an eye on the UI changes mentioned in the changelog and revalidate any customization or logic you may have written that relied on a particular selector or class name. We also maintain a list of these migrations for reference.

Toolbars

  • Primary (main) toolbar

  • Link annotation toolbar

  • Image and signature annotation (image) toolbar

  • Stamp annotation toolbar

  • Text highlight and markup annotation toolbar

  • Ink annotation toolbar

  • Text and callout annotation toolbar

  • Content editor toolbar

  • Form creator toolbar

  • Ink eraser toolbar

  • Note annotation toolbar

  • Redaction toolbar

  • Shape annotation toolbars

  • Document crop toolbar

  • Annotations sidebar

  • Outline sidebar

  • Bookmarks sidebar

  • Thumbnails sidebar

Other

  • Comments

  • Electronic signatures

  • Password prompt

  • Stamps