記事のサマリー(TL;DR)
- Polaris Web Components 1.1が安定版のPolaris CDNチャンネルで利用可能になりました。これはCDNの新しいセマンティックバージョニングモデルの下での最初のマイナーリリースです。
polaris.jsまたはpolaris-1.jsを使用しているアプリは自動的にこの更新を受け取り、追加の対応は不要です。現在のバージョンにとどまりたい場合は、polaris-1.1.jsを使ってアプリを固定できます。- 新コンポーネント(EmptyState、Number、Progress)や新プロパティの追加に加え、Overlays、Page、Modal、Popover、Menu、Tooltip、DatePicker、Select、NumberField、TextArea、DateField、ColorPickerなど多数のコンポーネントでバグ修正が行われました。
利用条件・バージョン固定について
以下のURLが現在Polaris 1.1を提供しています。
[コードは原文をご参照ください]
polaris.jsまたはpolaris-1.jsを利用しているアプリは自動的にこの更新を受け取るため、特別な対応は不要です。このバージョンにとどまる必要がある場合は、以下のURLを使ってアプリをPolaris 1.1に固定できます。
[コードは原文をご参照ください]
詳細
Polaris 1.1の新機能
新コンポーネント
- EmptyState:空のリスト、テーブル、ページ向け。TableBody内では、テーブルヘッダーの下に全幅のメッセージとして表示されます。
- Number:桁が揃うタブular figures(等幅数字)を使ったインラインの数値テキスト表示で、数値の列が揃うようになります。
- Progress:測定可能なタスクや目標がどの程度進んでいるかを表示します。
新プロパティ
- HeadingコンポーネントおよびParagraph、Textコンポーネントに
fontSize:テキストサイズを直接設定できます。 - DatePickerに
visibleMonths:1か月、2か月、またはピッカー側での自動判定を表示可能。auto、1、2のいずれかを指定できます。 - Pageに
supplementalStart:メインのページコンテンツの前に配置するコンテンツを指定できます。
バグ修正
- Overlays:
show、hide、aftershow、afterhide、aftertoggleの各イベントがtoggleと同様にバブリングしなくなりました。オーバーレイ自体でリッスンするか、対応するon*プロパティを使用してください。また、オーバーレイの外でドラッグが終了した際にオーバーレイが閉じてしまう問題も修正されました。 - Page:ヘッダーの配置と余白、長い見出しの切り詰め、印刷レイアウト、狭い画面での水平方向のオーバーフローに関する問題を修正しました。
- Modal:モーダルの端をクリックまたはドラッグがまたいだ際に意図せず閉じてしまう問題、フォーカスの戻り、見出しのオーバーフロー、ページ内でモーダルが移動された後の挙動を修正しました。また、ボタンは配置されたスロットからバリアント(variant)を継承するようになりましたが、自分で設定したバリアントは引き続き優先されます。
- PopoverおよびMenu:オーバーフロー時のスクロール、位置決め、開いた後のリサイズ、Safariでの非表示の遅延、Escapeキーで囲んでいるモーダルまで閉じてしまう問題を修正しました。
- Tooltip:位置決め、初回表示時の中央からのずれ、継承されるテキスト色、Popover APIを部分的にサポートするブラウザで発生していたエラーを修正しました。
- DatePicker:曜日見出しとスクリーンリーダーでの読み上げについて、各ロケールでの問題を修正しました。制御されたReactコンポーネントが選択後に行うような、同じ値をピッカーに再設定する操作で、2回目のinputおよびchangeイベントが発火しなくなり、onChangeが2回ではなく1回実行されるようになりました。また、ピッカーはデフォルトで利用可能な幅いっぱいに広がるようになりました。
- Select:選択肢が解析される前に空の値が表示されてしまう問題を修正しました。
- NumberField:デフォルトの最大値に関する問題を修正しました。科学的記数法(scientific notation)にも対応しました。
- TextArea:ラベルの配置とキーボードショートカットを修正しました。
- DateField:Safariでのカレンダーの非表示に関する問題を修正しました。他のフィールドと同様のサイズになるようになりました。
- ColorPicker:単一クリックでの選択に関する問題を修正しました。
- すべてのフィールド:
autocomplete="off"が設定されたフィールドは、パスワードマネージャーに対してもスキップするよう指示するようになりました。
非推奨項目:TextおよびParagraphのfontVariantNumericは引き続き動作しますが、代わりに新しいNumberコンポーネントの使用が推奨されています。