Skip to main content

Polaris CDN 1.1 is now stable

Polaris Web Components 1.1 is now available on the stable Polaris CDN channels. This is the first minor release under the CDN's new semantic versioning model.

The following URLs now serve Polaris 1.1

<script src="https://cdn.shopify.com/shopifycloud/polaris.js"></script>
<script src="https://cdn.shopify.com/shopifycloud/polaris-1.js"></script>

Apps using polaris.js or polaris-1.js receive the update automatically. No action is required.

If you need to remain on this version, you can pin your app to Polaris 1.1:

<script src="https://cdn.shopify.com/shopifycloud/polaris-1.1.js"></script>

What's new in Polaris 1.1

New components

  • EmptyState. For empty lists, tables, and pages. Inside a TableBody it renders as a full-width message beneath the table headers.
  • Number. Inline numeric text with tabular figures, so columns of numbers line up.
  • Progress. Show how far a measurable task or goal has advanced.

New properties

  • fontSize on Heading, Paragraph, and Text: Sets the text size directly.
  • visibleMonths on DatePicker: Show one month, two months, or let the picker decide. Accepts auto, 1, or 2.
  • supplementalStart on Page: Content placed before the main page content.

Bug fixes

  • Overlays. The show, hide, aftershow, afterhide, and aftertoggle events no longer bubble, matching toggle. Listen on the overlay itself, or use the matching on* properties. Also fixed overlays closing when a drag ends outside them.
  • Page. Fixed header alignment and spacing, long heading truncation, print layout, and horizontal overflow on narrow screens.
  • Modal. Fixed unintended dismissal when a click or drag crosses the modal edge, focus return, heading overflow, and behavior after a modal is moved in the page. Buttons now take their variant from the slot they sit in, and any variant you set yourself still wins.
  • Popover and Menu. Fixed overflow scrolling, positioning, resizing after open, delayed hiding in Safari, and Escape closing an enclosing modal.
  • Tooltip. Fixed positioning, off-center first render, inherited text color, and an error in browsers with partial Popover API support.
  • DatePicker. Fixed weekday headings and screen reader announcements across locales. Setting the same value back onto the picker, which controlled React components do after a selection, no longer fires a second input and change event, so onChange runs once instead of twice. The picker expands to fill the available width by default.
  • Select. Fixed an empty value showing before the options parse.
  • NumberField. Fixed the default max. Now accepts scientific notation.
  • TextArea. Fixed label alignment and keyboard shortcuts.
  • DateField. Fixed calendar dismissal in Safari. Now sizes like every other field.
  • ColorPicker. Fixed single-click selection.
  • All fields. Fields with autocomplete="off" now also tell password managers to skip them.

Deprecated

  • fontVariantNumeric on Text and Paragraph still works, however we recommend using the new Number component instead.

Related docs

Was this page helpful?