Skip to content

Commit

Permalink
Window: getScreenDetails() methodを新規翻訳 (#17172)
Browse files Browse the repository at this point in the history
* copied index.md from en-us

* 翻訳完了

* フォルダー名の生成

* 翻訳の修正

* Update files/ja/web/api/window/getscreendetails/index.md

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
  • Loading branch information
chakkun1121 and github-actions[bot] authored Dec 4, 2023
1 parent 067994e commit 463378e
Showing 1 changed file with 65 additions and 0 deletions.
65 changes: 65 additions & 0 deletions files/ja/web/api/window/getscreendetails/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
---
title: "Window: getScreenDetails()"
slug: Web/API/Window/getScreenDetails
l10n:
sourceCommit: e089abbca14964a8ce945135d954cbfd098fd6f7
---

{{APIRef("Window Management API")}}{{SeeCompatTable}}{{securecontext_header}}

{{domxref("Window")}} インターフェイスの **`getScreenDetails()`** メソッドは、ユーザーのデバイスで利用できるすべての画面の詳細を表す {{domxref("ScreenDetails")}} オブジェクトインスタンスで満たされる {{domxref("Promise")}} を返します。

## 構文

```js-nolint
getScreenDetails()
```

### 引数

なし。

### 返値

{{domxref("ScreenDetails")}} オブジェクトインスタンスで満たされる {{jsxref("Promise")}}。

### 例外

- `NotAllowedError` {{domxref("DOMException")}}
- : [Permissions-Policy](/ja/docs/Web/HTTP/Permissions_Policy) によって [Window Management API](/ja/docs/Web/API/Window_Management_API) の使用がブロックされている場合、またはユーザーが明示的にブラウザのパーミッションリクエストを拒否した場合にスローされます。

##

`getScreenDetails()` が呼び出されると、ユーザーに対してすべてのディスプレイでウィンドウを管理する許可を求めるダイアログが表示されます(この許可の状態は、`window-management` をクエリーするために {{domxref("Permissions.query()")}} を使用して確認できます)。許可が与えられた場合、結果として得られる {{domxref("ScreenDetails")}} オブジェクトには、ユーザーのシステムで利用可能なすべてのスクリーンの詳細が含まれています。

以下の例では、利用可能な各ディスプレイ上でフルサイズのウィンドウが開きます。

```js
const screenDetails = await window.getScreenDetails();

// 端末で使用可能のすべてのスクリーンに対して、フルスクリーンのウィンドウを開きます
for (const screen of screenDetails.screens) {
window.open(
"https://example.com",
"_blank",
`left=${screen.availLeft},
top=${screen.availTop},
width=${screen.availWidth},
height=${screen.availHeight}`,
);
}
```

> **メモ:** 完全な例については、[マルチウィンドウ学習環境](https://mdn.github.io/dom-examples/window-management-api/)を参照してください([ソースコード](https://github.com/mdn/dom-examples/tree/main/window-management-api)も参照してください。)
## 仕様書

{{Specifications}}

## ブラウザーの互換性

{{Compat}}

## 関連情報

- [Window Management API](/ja/docs/Web/API/Window_Management_API)

0 comments on commit 463378e

Please sign in to comment.