Connect Widget Technical Reference
Prerequisites
You’ll be using a Platform API endpoint to load and configure Connect Widget. You’ll use separate API endpoints to actually read the data that has been aggregated by Connect.
Before you get started, make sure you’ve:
- Signed up for the API through the client dashboard.
- Read through the API requirements.
Browser Support
MX supports its widgets on the HTML 5-compliant browsers listed below. As of March 20, 2017, only browsers that support TLSv1.2 will be able to interact with MX products.
Supported Desktop Browsers
MX tests its web applications on the current and immediately preceding versions of the browsers listed in the following table. MX recommends using your browser’s auto-update feature to stay current on the latest version.
| Browser | PC | Mac |
|---|---|---|
| Chrome | Yes | Yes |
| Microsoft Edge | Yes | N/A |
| Firefox | Yes | Yes |
| Safari | No | Yes |
Older Desktop Browsers
Older versions of the supported desktop browsers are not explicitly tested, but MX will attempt to review and address issues as they are reported. If a reasonable accommodation cannot be made, upgrading or switching to a supported browser may be recommended.
However, MX does not support any versions of Internet Explorer and will not address bugs or issues related to it.
Blocked Desktop Browsers
We want our partners and clients to have the best possible experience while using our products. Therefore, MX may actively block some browsers from displaying our products when the results would provide an extremely poor user experience.
Degrading browser performance by using alternate browser modes (such as Quirks or Compatibility modes) may prevent MX products from functioning properly.
Supported Mobile Browsers
MX tests its web applications on the current and immediately preceding versions of the iOS and Android operating systems. For each supported OS version, MX tests on both the current and immediately preceding versions of the browsers listed below. MX recommends using your browser’s auto-update feature to stay current on the latest version.
| Browser | iOS | Android |
|---|---|---|
| Chrome | No | Yes |
| Safari | Yes | N/A |
| WKWebView | Yes | N/A |
| Android WebView | N/A | Yes |
MX no longer supports UIWebView. Apple stopped recommending the use of UIWebView beginning with the release of iOS 8 in September 2014. It now recommends using WKWebView.
Older Mobile Browsers
Older versions of browsers listed above are not explicitly tested, but MX will attempt to review and address issues as they are reported. If a reasonable accommodation cannot be made, upgrading or switching to a supported browser may be recommended.
Minimum Dimensions and Breakpoints
The Connect Widget uses a responsive design. Page styles and layout are subject to change, and elements may become hidden or visible at different widths.
The following are the minimum dimensions supported for mobile and desktop platforms.
- Minimum height: 550px
- Minimum width: 320px
The following are the width breakpoints at which the design may change. These are based on typical industry device resolutions and are subject to change in the future.
- Small: 320px to 767px
- Medium: 768px to 1199px
- Large: 1200px or greater