-
Notifications
You must be signed in to change notification settings - Fork 8.2k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Window: getScreenDetails() methodを新規翻訳 (#17172)
* 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
1 parent
067994e
commit 463378e
Showing
1 changed file
with
65 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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) |