Newly available 条件付きOK。主要ブラウザで対応済みだが、古いバージョンでは未対応の場合がある。フォールバックを検討。

対応ブラウザ

機能 デスクトップ モバイル
Chrome
Edge
Firefox
Safari
Chrome Android
Safari iOS
119
119
122
17.2
119
17.2
CSS タイプ

xywh() は CSS の関数で、包含ブロックの左端 (x) と上端 (y) からの距離を指定し、矩形の幅 (w) と高さ (h) を指定して矩形を作成します。これは basic-shape データ型の基本シェイプ関数です。 xywh() 関数を offset-path のような CSS プロパティで使用し、要素が移動される矩形のパスを作成したり、clip-path でクリッピング領域の図形を定義したりすることができます。

119
119
122
17.2
119
17.2
1+対応 (バージョン) 未対応 注釈あり サブ機能の解説は MDN Web Docs (CC BY-SA 2.5)
注釈 3件
制限事項
  • このブラウザでは部分的にしか実装されていません
削除済み
  • このバージョンで機能が削除されました (119)
実装メモ
  • 「offset-path」プロパティでのみサポートされます。
注釈 3件
制限事項
  • このブラウザでは部分的にしか実装されていません
削除済み
  • このバージョンで機能が削除されました (119)
実装メモ
  • 「offset-path」プロパティでのみサポートされます。
注釈 3件
制限事項
  • このブラウザでは部分的にしか実装されていません
削除済み
  • このバージョンで機能が削除されました (119)
実装メモ
  • 「offset-path」プロパティでのみサポートされます。
注釈 3件
制限事項
  • このブラウザでは部分的にしか実装されていません
削除済み
  • このバージョンで機能が削除されました (119)
実装メモ
  • 「offset-path」プロパティでのみサポートされます。
注釈 3件
制限事項
  • このブラウザでは部分的にしか実装されていません
削除済み
  • このバージョンで機能が削除されました (119)
実装メモ
  • 「offset-path」プロパティでのみサポートされます。
注釈 3件
制限事項
  • このブラウザでは部分的にしか実装されていません
削除済み
  • このバージョンで機能が削除されました (119)
実装メモ
  • 「offset-path」プロパティでのみサポートされます。

基本構文

CSS
.crop {
  clip-path: rect(10px 200px 150px 20px);
}
.highlight {
  clip-path: xywh(20px 10px 180px 140px round 8px);
}

ライブデモ

Rect() clip

CSS Rect() clip demo.

プレビュー全画面表示

Xywh() clip

CSS Xywh() clip demo.

プレビュー全画面表示

xywh() + round

CSS Xywh() + round demo.

プレビュー全画面表示

実務での使いどころ

  • 画像の矩形トリミング

    rect()やxywh()を使って画像の特定の領域だけを表示し、CSSのみでトリミング効果を実現します。

注意点

  • rect()はinset()と異なりエッジからの絶対値で指定するため、レスポンシブデザインでは%値の使用を検討してください。

アクセシビリティ

  • クリッピングで隠されたコンテンツがスクリーンリーダーで読み上げられる場合があるため、意図しない情報の露出に注意してください。