From 6e2c3968bed205526c277c16715911450bb27623 Mon Sep 17 00:00:00 2001 From: Leonid Vinogradov Date: Wed, 25 Sep 2024 21:36:43 +0200 Subject: [PATCH 001/215] [ru] update `Web/API/Window/clearImmediate` translation (#23197) * [ru] update 'Web/API/Window/clearImmediate' translation * [ru] update 'Web/API/Window/clearImmediate' translation --- .../ru/web/api/window/clearimmediate/index.md | 43 +++++++++++-------- 1 file changed, 26 insertions(+), 17 deletions(-) diff --git a/files/ru/web/api/window/clearimmediate/index.md b/files/ru/web/api/window/clearimmediate/index.md index 9ea97522f4ef59..5ee760f10d404a 100644 --- a/files/ru/web/api/window/clearimmediate/index.md +++ b/files/ru/web/api/window/clearimmediate/index.md @@ -1,38 +1,46 @@ --- -title: Window.clearImmediate() +title: "Window: метод clearImmediate()" slug: Web/API/Window/clearImmediate +l10n: + sourceCommit: 44cf523714745d626317192bfbe849b47144f3ab --- -{{ Apiref() }} +{{APIRef("HTML DOM")}} {{deprecated_header}}{{non-standard_header}} -Данный метод очищает действие, определённое {{ domxref("window.setImmediate") }}. - -> [!NOTE] -> На текущий момент данный метод находится на стадии предложения на внедрение, не является стандартом и имплементирован только в последних сборках Internet Explorer. +Данный метод очищает действие, определённое методом {{DOMxRef("window.setImmediate")}}. ## Синтаксис +```js-nolint +clearImmediate(immediateID) ``` -window.clearImmediate(immediateID) -``` -где immediateID это идентификатор, возвращаемый из {{ domxref("window.setImmediate") }}. +### Параметры + +- `immediateID` + + - : ID, возвращаемый {{DOMxRef("window.setImmediate")}}. + +### Возвращаемое значение + +Нет ({{jsxref("undefined")}}). ## Примеры -``` -var immediateID = setImmediate(function () { - // Выполнение некоего кода -} +```js +let immediateID = setImmediate(() => { + // Выполнение необходимого кода +}); -document.getElementById("button").addEventListener(function () { +document.getElementById("button").addEventListener(() => { clearImmediate(immediateID); -}, false); +}); ``` ## Спецификации -{{Specifications}} +Не является частью какой-либо спецификации. +Спецификация [Efficient Script Yielding](https://w3c.github.io/setImmediate/#si-setImmediate) больше не разрабатывается. ## Совместимость с браузерами @@ -40,4 +48,5 @@ document.getElementById("button").addEventListener(function () { ## Смотрите также -{{ domxref("window.setImmediate") }} +- [Полифил `clearImmediate` в `core-js`](https://github.com/zloirock/core-js#setimmediate) +- {{DOMxRef("Window.setImmediate()")}} From 6bc2cd6053c0089291bc5d6a9efa17d8ef7f8465 Mon Sep 17 00:00:00 2001 From: skyclouds2001 <95597335+skyclouds2001@users.noreply.github.com> Date: Thu, 26 Sep 2024 10:35:48 +0800 Subject: [PATCH 002/215] [zh-CN]: sync&add translation for `PictureInPictureEvent` (#23561) Co-authored-by: A1lo Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- .../web/api/pictureinpictureevent/index.md | 40 ++++++++++++++++++ .../pictureinpictureevent/index.md | 41 +++++++++++++++++++ .../pictureinpicturewindow/index.md | 26 ++++++++++++ .../css/_colon_picture-in-picture/index.md | 8 ++-- 4 files changed, 112 insertions(+), 3 deletions(-) create mode 100644 files/zh-cn/web/api/pictureinpictureevent/index.md create mode 100644 files/zh-cn/web/api/pictureinpictureevent/pictureinpictureevent/index.md create mode 100644 files/zh-cn/web/api/pictureinpictureevent/pictureinpicturewindow/index.md diff --git a/files/zh-cn/web/api/pictureinpictureevent/index.md b/files/zh-cn/web/api/pictureinpictureevent/index.md new file mode 100644 index 00000000000000..2b4ebe2c37526d --- /dev/null +++ b/files/zh-cn/web/api/pictureinpictureevent/index.md @@ -0,0 +1,40 @@ +--- +title: PictureInPictureEvent +slug: Web/API/PictureInPictureEvent +l10n: + sourceCommit: bb4d21e3c6e71db4e0ba983a450d6ed628e82670 +--- + +{{APIRef("Picture-in-Picture API")}} + +**`PictureInPictureEvent`** 接口表示画中画相关的事件，包括 {{domxref("HTMLVideoElement/enterpictureinpicture_event", "enterpictureinpicture")}}、{{domxref("HTMLVideoElement/leavepictureinpicture_event", "leavepictureinpicture")}} 和 {{domxref("PictureInPictureWindow/resize_event", "resize")}}。 + +{{InheritanceDiagram}} + +## 构造函数 + +- {{domxref("PictureInPictureEvent.PictureInPictureEvent", "PictureInPictureEvent()")}} + - : 使用给定的参数创建一个 `PictureInPictureEvent` 事件。 + +## 实例属性 + +_此接口还从其父级 {{domxref("Event")}} 继承了属性_。 + +- {{domxref("PictureInPictureEvent.pictureInPictureWindow")}} + - : 返回与事件相关的 {{domxref("PictureInPictureWindow")}}。 + +## 实例方法 + +_此接口还从其父级 {{domxref("Event")}} 继承了方法_。 + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} + +## 参见 + +- {{domxref("Event")}} 父接口 diff --git a/files/zh-cn/web/api/pictureinpictureevent/pictureinpictureevent/index.md b/files/zh-cn/web/api/pictureinpictureevent/pictureinpictureevent/index.md new file mode 100644 index 00000000000000..6129e179f85f81 --- /dev/null +++ b/files/zh-cn/web/api/pictureinpictureevent/pictureinpictureevent/index.md @@ -0,0 +1,41 @@ +--- +title: PictureInPictureEvent：PictureInPictureEvent() 构造函数 +slug: Web/API/PictureInPictureEvent/PictureInPictureEvent +l10n: + sourceCommit: ee99bfdebd8f9c691a06afec0895285a3bf2da2a +--- + +{{APIRef("Picture-in-Picture API")}} + +**`PictureInPictureEvent()`** 构造函数返回一个新的 {{domxref("PictureInPictureEvent")}} 对象。 + +## 语法 + +```js-nolint +new PictureInPictureEvent(type, options) +``` + +### 参数 + +- `type` + - : 表示事件名称的字符串。它区分大小写，浏览器将其设置为 `enterpictureinpicture`、`leavepictureinpicture` 或 `resize`。 +- `options` + - : _除了 {{domxref("Event/Event", "Event()")}} 中定义的属性外_，该对象还可以具有以下属性： + - `pictureInPictureWindow` + - : 一个 {{domxref("PictureInPictureWindow")}} 对象。 + +### 返回值 + +一个新的 {{domxref("PictureInPictureEvent")}} 对象。 + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} + +## 参见 + +- 它所属的 {{domxref("PictureInPictureEvent")}} 接口。 diff --git a/files/zh-cn/web/api/pictureinpictureevent/pictureinpicturewindow/index.md b/files/zh-cn/web/api/pictureinpictureevent/pictureinpicturewindow/index.md new file mode 100644 index 00000000000000..11aa7d93a1aeb8 --- /dev/null +++ b/files/zh-cn/web/api/pictureinpictureevent/pictureinpicturewindow/index.md @@ -0,0 +1,26 @@ +--- +title: PictureInPictureEvent：pictureInPictureWindow 属性 +slug: Web/API/PictureInPictureEvent/pictureInPictureWindow +l10n: + sourceCommit: ee99bfdebd8f9c691a06afec0895285a3bf2da2a +--- + +{{APIRef("Picture-in-Picture API")}} + +{{domxref("PictureInPictureEvent")}} 接口的 **`pictureInPictureWindow`** 只读属性返回与事件相关的 {{domxref("PictureInPictureWindow")}}。 + +## 值 + +{{domxref("PictureInPictureWindow")}}。 + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} + +## 参见 + +- [Picture-in-Picture API](/zh-CN/docs/Web/API/Picture-in-Picture_API) diff --git a/files/zh-cn/web/css/_colon_picture-in-picture/index.md b/files/zh-cn/web/css/_colon_picture-in-picture/index.md index 6be9c083aa7494..2e81667afd1d5e 100644 --- a/files/zh-cn/web/css/_colon_picture-in-picture/index.md +++ b/files/zh-cn/web/css/_colon_picture-in-picture/index.md @@ -1,6 +1,8 @@ --- title: ":picture-in-picture" slug: Web/CSS/:picture-in-picture +l10n: + sourceCommit: 04ebe57066db2cff350018649bdb15b2a10c67ba --- {{CSSRef}} @@ -28,11 +30,11 @@ slug: Web/CSS/:picture-in-picture 页面的 HTML 如下所示： ```html -

MDN Web Docs Demo: :picture-in-picture pseudo-class

+

MDN Web Docs 演示：:picture-in-picture 伪类

- This demo uses the :picture-in-picture pseudo-class to - automatically change the style of a video entirely using CSS. + 此演示使用 CSS :picture-in-picture + 伪类自动改变视频的完整样式。

From fa5a82764726f570171252c9229bde03ab1b2158 Mon Sep 17 00:00:00 2001 From: skyclouds2001 <95597335+skyclouds2001@users.noreply.github.com> Date: Thu, 26 Sep 2024 17:02:19 +0800 Subject: [PATCH 003/215] [zh-CN]: add translation for `ShadowRoot.fullscreenElement` & sync for other three pages (#23760) --- .../web/api/document/exitfullscreen/index.md | 2 +- .../web/api/document/fullscreen/index.md | 2 +- .../api/document/fullscreenelement/index.md | 2 +- .../api/shadowroot/fullscreenelement/index.md | 34 +++++++++++++++++++ 4 files changed, 37 insertions(+), 3 deletions(-) create mode 100644 files/zh-cn/web/api/shadowroot/fullscreenelement/index.md diff --git a/files/zh-cn/web/api/document/exitfullscreen/index.md b/files/zh-cn/web/api/document/exitfullscreen/index.md index 715aec29309381..bc3c82a871d3dc 100644 --- a/files/zh-cn/web/api/document/exitfullscreen/index.md +++ b/files/zh-cn/web/api/document/exitfullscreen/index.md @@ -2,7 +2,7 @@ title: Document：exitFullscreen() 方法 slug: Web/API/Document/exitFullscreen l10n: - sourceCommit: 41a8b9c9832359d445d136b6d7a8a28737badc6b + sourceCommit: be8f7f155a48e11b30c240f8731afb1845f85378 --- {{ApiRef("Fullscreen API")}} diff --git a/files/zh-cn/web/api/document/fullscreen/index.md b/files/zh-cn/web/api/document/fullscreen/index.md index 064365fe224d9b..7d6e12a6c4937c 100644 --- a/files/zh-cn/web/api/document/fullscreen/index.md +++ b/files/zh-cn/web/api/document/fullscreen/index.md @@ -2,7 +2,7 @@ title: Document：fullscreen 属性 slug: Web/API/Document/fullscreen l10n: - sourceCommit: 41a8b9c9832359d445d136b6d7a8a28737badc6b + sourceCommit: be8f7f155a48e11b30c240f8731afb1845f85378 --- {{APIRef("Fullscreen API")}}{{Deprecated_Header}} diff --git a/files/zh-cn/web/api/document/fullscreenelement/index.md b/files/zh-cn/web/api/document/fullscreenelement/index.md index d7f0bffade6550..0d898c607e55d6 100644 --- a/files/zh-cn/web/api/document/fullscreenelement/index.md +++ b/files/zh-cn/web/api/document/fullscreenelement/index.md @@ -7,7 +7,7 @@ l10n: {{ApiRef("Fullscreen API")}} -只读属性 **`Document.fullscreenElement`** 返回当前页面中以全屏模式呈现的 {{domxref("Element")}}，如果当前页面未使用全屏模式，则返回 `null`。 +**`Document.fullscreenElement`** 只读属性返回当前页面中以全屏模式呈现的 {{domxref("Element")}}，如果当前页面未使用全屏模式，则返回 `null`。 尽管这个属性是只读的，但如果修改它，即使在严格模式下也不会抛出错误；它的 `setter` 方法是空操作将被忽略。 diff --git a/files/zh-cn/web/api/shadowroot/fullscreenelement/index.md b/files/zh-cn/web/api/shadowroot/fullscreenelement/index.md new file mode 100644 index 00000000000000..d2236c6debad31 --- /dev/null +++ b/files/zh-cn/web/api/shadowroot/fullscreenelement/index.md @@ -0,0 +1,34 @@ +--- +title: ShadowRoot：fullscreenElement 属性 +slug: Web/API/ShadowRoot/fullscreenElement +l10n: + sourceCommit: f2f9346c0c0e9f6676f2df9f1850933e274401de +--- + +{{APIRef("Shadow DOM")}} + +{{domxref("ShadowRoot")}} 接口的 **`fullscreenElement`** 只读属性返回影子树中当前全屏显示的元素。 + +## 值 + +当前以全屏模式显示的 {{domxref('Element')}}，若无全屏元素则为 `null`。 + +## 示例 + +```js +let customElem = document.querySelector("my-shadow-dom-element"); +let shadow = customElem.shadowRoot; +let fullscreenElem = shadow.fullscreenElement; +``` + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} + +## 参见 + +- {{domxref("Document.fullscreenElement")}} From 785d99c0d6876c7ee96873c54987407f5e45a547 Mon Sep 17 00:00:00 2001 From: Florian Dieminger Date: Thu, 26 Sep 2024 13:09:54 +0200 Subject: [PATCH 004/215] fix(actions): only use bash env vars in code (#23785) --- .github/workflows/pr-check-lint_content.yml | 10 +++++----- .github/workflows/pr-test.yml | 20 ++++++++++---------- 2 files changed, 15 insertions(+), 15 deletions(-) diff --git a/.github/workflows/pr-check-lint_content.yml b/.github/workflows/pr-check-lint_content.yml index 420ece9b848453..db6aa54875f824 100644 --- a/.github/workflows/pr-check-lint_content.yml +++ b/.github/workflows/pr-check-lint_content.yml @@ -32,7 +32,7 @@ jobs: run: | # Use the GitHub API to get the list of changed files # documentation: https://docs.github.com/rest/commits/commits#compare-two-commits - DIFF_DOCUMENTS=$(gh api repos/{owner}/{repo}/compare/${{ env.BASE_SHA }}...${{ env.HEAD_SHA }} \ + DIFF_DOCUMENTS=$(gh api repos/{owner}/{repo}/compare/${BASE_SHA}...${HEAD_SHA} \ --jq '.files | .[] | select(.status|IN("added", "modified", "renamed", "copied", "changed")) | .filename') # filter out files that are not markdown DIFF_DOCUMENTS=$(echo "${DIFF_DOCUMENTS}" | egrep -i ".*\.md$" | xargs) @@ -96,7 +96,7 @@ jobs: # https://docs.github.com/en/actions/using-workflows/workflow-commands-for-github-actions#multiline-strings EOF="$(openssl rand -hex 8)" - files_to_lint="${{ env.DIFF_DOCUMENTS }}" + files_to_lint="${DIFF_DOCUMENTS}" echo "Running markdownlint --fix" MD_LINT_FAILED=false @@ -160,7 +160,7 @@ jobs: env: REVIEWDOG_GITHUB_API_TOKEN: ${{ secrets.GITHUB_TOKEN }} run: | - echo "${{ env.MD_LINT_LOG }}" | \ + echo "${MD_LINT_LOG}" | \ reviewdog \ -efm="%f:%l:%c %m" \ -efm="%f:%l %m" \ @@ -172,8 +172,8 @@ jobs: if: env.FILES_MODIFIED == 'true' || env.MD_LINT_FAILED == 'true' || env.FM_LINT_FAILED == 'true' run: | echo -e "\nLogs from markdownlint:" - echo "${{ env.MD_LINT_LOG }}" + echo "${MD_LINT_LOG}" echo -e "\nLogs from front-matter linter:" - echo "${{ env.FM_LINT_LOG }}" + echo "${FM_LINT_LOG}" echo -e "\nPlease fix all the linting issues mentioned in above logs and in the review comments." exit 1 diff --git a/.github/workflows/pr-test.yml b/.github/workflows/pr-test.yml index 9d764782ab2c92..2f9710626f4117 100644 --- a/.github/workflows/pr-test.yml +++ b/.github/workflows/pr-test.yml @@ -42,7 +42,7 @@ jobs: run: | # Use the GitHub API to get the list of changed files # documentation: https://docs.github.com/rest/commits/commits#compare-two-commits - DIFF_DOCUMENTS=$(gh api repos/{owner}/{repo}/compare/${{ env.BASE_SHA }}...${{ env.HEAD_SHA }} \ + DIFF_DOCUMENTS=$(gh api repos/{owner}/{repo}/compare/${BASE_SHA}...${HEAD_SHA} \ --jq '.files | .[] | select(.status|IN("added", "modified", "renamed", "copied", "changed")) | .filename') # filter out files that are not markdown files @@ -112,23 +112,23 @@ jobs: working-directory: ${{ github.workspace }}/mdn/content run: | - mkdir -p ${{ env.BUILD_OUT_ROOT }} + mkdir -p ${BUILD_OUT_ROOT} # Don't use `yarn build` (from mdn/content) because that one hardcodes # the BUILD_OUT_ROOT and CONTENT_ROOT env vars. - node node_modules/@mdn/yari/build/cli.js ${{ env.GIT_DIFF_CONTENT }} + node node_modules/@mdn/yari/build/cli.js ${GIT_DIFF_CONTENT} echo "Disk usage size of build" - du -sh ${{ env.BUILD_OUT_ROOT }} + du -sh ${BUILD_OUT_ROOT} # Save the PR number into the build - echo ${{ github.event.number }} > ${{ env.BUILD_OUT_ROOT }}/NR + echo ${{ github.event.number }} > ${BUILD_OUT_ROOT}/NR # Download the raw diff blob and store that inside the build # directory. # The purpose of this is for the PR Review Companion to later # be able to use this raw diff file for the benefit of analyzing. - wget https://github.com/${{ github.repository }}/compare/${{ env.BASE_SHA }}...${{ env.HEAD_SHA }}.diff -O ${{ env.BUILD_OUT_ROOT }}/DIFF + wget https://github.com/${{ github.repository }}/compare/${BASE_SHA}...${HEAD_SHA}.diff -O ${BUILD_OUT_ROOT}/DIFF # Set the output variable so the next job could skip if there are no assets echo "has_assets=true" >> "$GITHUB_OUTPUT" @@ -137,9 +137,9 @@ jobs: if: ${{ env.GIT_DIFF_CONTENT }} run: | # Exclude the .map files, as they're used for debugging JS and CSS. - rsync -a --exclude "*.map" ${{ github.workspace }}/mdn/content/node_modules/@mdn/yari/client/build/ ${{ env.BUILD_OUT_ROOT }} + rsync -a --exclude "*.map" ${{ github.workspace }}/mdn/content/node_modules/@mdn/yari/client/build/ ${BUILD_OUT_ROOT} # Show the final disk usage size of the build. - du -sh ${{ env.BUILD_OUT_ROOT }} + du -sh ${BUILD_OUT_ROOT} - uses: actions/upload-artifact@v4 if: ${{ env.GIT_DIFF_CONTENT }} @@ -154,9 +154,9 @@ jobs: CONTENT_TRANSLATED_ROOT: ${{ github.workspace }}/files working-directory: ${{ github.workspace }}/mdn/content run: | - echo ${{ env.GIT_DIFF_FILES }} + echo ${GIT_DIFF_FILES} - yarn filecheck ${{ env.GIT_DIFF_FILES }} + yarn filecheck ${GIT_DIFF_FILES} review: needs: tests From 41c8e02339be293a0de50adf38fa4daf7b1fa4f3 Mon Sep 17 00:00:00 2001 From: MikeCAT Date: Sat, 21 Sep 2024 22:05:47 +0900 Subject: [PATCH 005/215] Translate Background Synchronization API --- .../background_synchronization_api/index.md | 93 +++++++++++++++++++ 1 file changed, 93 insertions(+) create mode 100644 files/ja/web/api/background_synchronization_api/index.md diff --git a/files/ja/web/api/background_synchronization_api/index.md b/files/ja/web/api/background_synchronization_api/index.md new file mode 100644 index 00000000000000..b162e009795403 --- /dev/null +++ b/files/ja/web/api/background_synchronization_api/index.md @@ -0,0 +1,93 @@ +--- +title: バックグラウンド同期 API +slug: Web/API/Background_Synchronization_API +l10n: + sourceCommit: dd84b3b089d199be3771d6afe01e068b19889e71 +--- + +{{DefaultAPISidebar("Background Sync")}}{{Securecontext_Header}}{{AvailableInWorkers}} + +**バックグラウンド同期 API** は、ウェブアプリケーションがタスクを延期し、ユーザーが安定したネットワーク接続を得たときに[サービスワーカー](/ja/docs/Web/API/Service_Worker_API)で実行できるようにします。 + +## 概念と使用法 + +バックグラウンド同期 API は、デバイスがオフラインのとき、ウェブアプリケーションがサーバーとの同期処理を延期して後でサービスワーカーで処理できるようにします。用途として、アプリケーションの使用中に送信できなかったリクエストをバックグラウンドで送信することがあるかもしれません。 + +たとえば、電子メールのクライアントアプリケーションは、デバイスがネットワークに接続されていないときを含め、いつでもユーザーがメッセージを書いて送信できるようにできます。このアプリケーションのフロントエンドは同期リクエストを登録するだけであり、ネットワークが再び使用可能になった時サービスワーカーが通知を受けて同期を処理します。 + +{{domxref('SyncManager')}} インターフェイスが {{domxref('ServiceWorkerRegistration.sync')}} を通じて利用可能です。一意なタグ識別子が同期イベントにおいて `'name'` に設定され、このイベントは {{domxref('ServiceWorker')}} のスクリプト内で受け取ることができます。イベントを受信したら、サーバーにリクエストを送信するなど、利用可能な任意の機能を実行することができます。 + +この API はサービスワーカーに依存しているので、この API が提供する機能は安全なコンテキストでのみ利用可能です。 + +## インターフェイス + +- {{domxref('SyncManager')}} {{Experimental_Inline}} + - : 後でネットワークが接続されたときサービスワーカーで実行するタスクを登録します。このようなタスクは _バックグラウンド同期の要求_ と呼ばれます。 +- {{domxref('SyncEvent')}} {{Experimental_Inline}} + - : 同期イベントを表します。このイベントは、{{domxref('ServiceWorker')}} の[グローバルスコープ](/ja/docs/Web/API/ServiceWorkerGlobalScope)に送信されます。これは、デバイスがネットワークに接続されたときタスクをサービスワーカーで実行する方法を提供します。 + +### 他のインターフェイスの拡張 + +[Service Worker API](/ja/docs/Web/API/Service_Worker_API) に追加された以下が、バックグラウンド同期をセットアップするためのエントリーポイントを提供します。 + +- {{domxref("ServiceWorkerRegistration.sync")}} {{ReadOnlyInline}} + - : デバイスがネットワークに接続されたときに実行するタスクを登録するための {{domxref("SyncManager")}} インターフェイスへの参照を返します。 +- {{domxref("ServiceWorkerGlobalScope/sync_event", "sync")}} イベント + - : {{domxref("ServiceWorkerGlobalScope/sync_event", "sync")}} イベントが発生した際常に実行されるイベントハンドラーです。これは、ネットワークが利用可能になるとすぐに発生します。 + +## 例 + +以下の例は、インターフェイスの使い方を示します。 + +### バックグラウンド同期を要求する + +以下の非同期関数は、ブラウジングコンテキストからバックグラウンド同期を登録します。 + +```js +async function syncMessagesLater() { + const registration = await navigator.serviceWorker.ready; + try { + await registration.sync.register("sync-messages"); + } catch { + console.log("バックグラウンド同期の登録に失敗しました！"); + } +} +``` + +### タグを用いてバックグラウンド同期を確認する + +このコードは、指定のタグがついたバックグラウンド同期タスクが登録されているかを確認します。 + +```js +navigator.serviceWorker.ready.then((registration) => { + registration.sync.getTags().then((tags) => { + if (tags.includes("sync-messages")) { + console.log("メッセージの同期は既に登録されています"); + } + }); +}); +``` + +### サービスワーカー内でバックグラウンド同期イベントを受け取る + +以下の例は、サービスワーカーでバックグラウンド同期イベントに応答する方法を示します。 + +```js +self.addEventListener("sync", (event) => { + if (event.tag === "sync-messages") { + event.waitUntil(sendOutboxMessages()); + } +}); +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [Introducing Background Sync](https://developer.chrome.com/blog/background-sync/) From 5c1f92867816399409557bffaf415ca1074394cb Mon Sep 17 00:00:00 2001 From: MikeCAT Date: Sat, 21 Sep 2024 22:19:47 +0900 Subject: [PATCH 006/215] Translate methods of SyncManager --- files/ja/web/api/syncmanager/gettags/index.md | 32 +++++++++++ .../ja/web/api/syncmanager/register/index.md | 55 +++++++++++++++++++ 2 files changed, 87 insertions(+) create mode 100644 files/ja/web/api/syncmanager/gettags/index.md create mode 100644 files/ja/web/api/syncmanager/register/index.md diff --git a/files/ja/web/api/syncmanager/gettags/index.md b/files/ja/web/api/syncmanager/gettags/index.md new file mode 100644 index 00000000000000..bb4649a898f3e4 --- /dev/null +++ b/files/ja/web/api/syncmanager/gettags/index.md @@ -0,0 +1,32 @@ +--- +title: "SyncManager: getTags() メソッド" +slug: Web/API/SyncManager/getTags +l10n: + sourceCommit: 56df677713fecf43ec0eb8862cb91c141aaa0005 +--- + +{{APIRef("Background Sync")}}{{AvailableInWorkers}} + +{{domxref("SyncManager")}} インターフェイスの **`getTags()`** メソッドは、`SyncManager` で登録に用いる開発者定義の識別子のリストを返します。 + +## 構文 + +```js-nolint +getTags() +``` + +### 引数 + +なし + +### 返値 + +`SyncManager` で登録に用いる開発者定義の識別子が入った文字列の配列で解決する {{jsxref("Promise")}} です。 + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} diff --git a/files/ja/web/api/syncmanager/register/index.md b/files/ja/web/api/syncmanager/register/index.md new file mode 100644 index 00000000000000..07d79ee5003b35 --- /dev/null +++ b/files/ja/web/api/syncmanager/register/index.md @@ -0,0 +1,55 @@ +--- +title: "SyncManager: register() メソッド" +slug: Web/API/SyncManager/register +l10n: + sourceCommit: 56df677713fecf43ec0eb8862cb91c141aaa0005 +--- + +{{APIRef("Background Sync")}}{{AvailableInWorkers}} + +{{domxref("SyncManager")}} インターフェイスの **`register()`** メソッドは、同期イベントを登録します。このイベントは、ネットワーク接続が利用可能になるとすぐに、関連付けられたサービスワーカー内で {{domxref("ServiceWorkerGlobalScope.sync_event", "sync")}} イベントを発生させます。 + +## 構文 + +```js-nolint +register(tag) +``` + +### 引数 + +- `tag` + - : 同期イベントの識別子です。これは、サービスワーカーの {{domxref("ServiceWorkerGlobalScope.sync_event", "sync")}} イベントのハンドラーに渡される {{domxref("SyncEvent")}} の `tag` プロパティの値になります。 + +### 返値 + +{{jsxref("undefined")}} で解決する {{jsxref("Promise")}} です。 + +### 例外 + +- `InvalidStateError` {{domxref("DOMException")}} + - : 現在のサービスワーカーがアクティブでないとき投げられます。 +- `NotAllowedError` {{domxref("DOMException")}} + - : バックグラウンド同期がユーザーにより無効化されているとき投げられます。 + +## 例 + +以下の非同期関数は、ブラウジングコンテキストからバックグラウンド同期を登録します。 + +```js +async function syncMessagesLater() { + const registration = await navigator.serviceWorker.ready; + try { + await registration.sync.register("sync-messages"); + } catch { + console.log("バックグラウンド同期の登録に失敗しました！"); + } +} +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} From 4af32402b4953813d0cd168ccb760b0ff1c99e2b Mon Sep 17 00:00:00 2001 From: MikeCAT Date: Sun, 22 Sep 2024 13:54:23 +0900 Subject: [PATCH 007/215] Translate PeriodicSyncEvent --- files/ja/web/api/periodicsyncevent/index.md | 57 +++++++++++++++++++ .../periodicsyncevent/index.md | 50 ++++++++++++++++ .../ja/web/api/periodicsyncevent/tag/index.md | 37 ++++++++++++ 3 files changed, 144 insertions(+) create mode 100644 files/ja/web/api/periodicsyncevent/index.md create mode 100644 files/ja/web/api/periodicsyncevent/periodicsyncevent/index.md create mode 100644 files/ja/web/api/periodicsyncevent/tag/index.md diff --git a/files/ja/web/api/periodicsyncevent/index.md b/files/ja/web/api/periodicsyncevent/index.md new file mode 100644 index 00000000000000..787666516ce7d2 --- /dev/null +++ b/files/ja/web/api/periodicsyncevent/index.md @@ -0,0 +1,57 @@ +--- +title: PeriodicSyncEvent +slug: Web/API/PeriodicSyncEvent +l10n: + sourceCommit: b74d47ab6e99d2bd43ef9638367d9c69fca04402 +--- + +{{APIRef("Periodic Background Sync")}}{{SeeCompatTable}}{{AvailableInWorkers("service")}} + +{{domxref('Web Periodic Background Synchronization API', 'ウェブ定期バックグラウンド同期 API', '', 'nocode')}} の **`PeriodicSyncEvent`** インターフェイスは、ネットワーク接続がある状態でサービスワーカーでタスクを実行する方法を提供します。 + +このイベントのインスタンスが {{domxref('ServiceWorkerGlobalScope.periodicsync_event', 'periodicsync')}} ハンドラーに渡されます。これは、{{domxref('PeriodicSyncManager.register()')}} メソッドで設定した以上の間隔で、定期的に行われます。実際の間隔は、ユーザーのサイトとのかかわりなど、その他の実装定義の要素によります。 + +{{InheritanceDiagram}} + +## コンストラクター + +- {{domxref("PeriodicSyncEvent.PeriodicSyncEvent", "PeriodicSyncEvent()")}} {{Experimental_Inline}} + - : 新しい `PeriodicSyncEvent` オブジェクトを生成します。このコンストラクターは通常使用されません。ブラウザーがこれらのオブジェクトを作成し、{{domxref('ServiceWorkerGlobalScope.periodicsync_event', 'onperiodicsync')}} コールバックに渡します。 + +## インスタンスプロパティ + +_親の {{domxref('ExtendableEvent')}} からプロパティを継承します。_ + +- {{domxref('PeriodicSyncEvent.tag')}} {{ReadOnlyInline}} {{Experimental_Inline}} + - : この `PeriodicSyncEvent` 用の開発者定義の識別子を返します。ウェブアプリケーションは、異なる定期的なタスクを異なる頻度で実行するため、複数のタグを使用できます。 + +## インスタンスメソッド + +_親の {{domxref('ExtendableEvent')}} からメソッドを継承します。_ + +## 例 + +以下の例は、サービスワーカーで定期的な同期のイベントに応答する方法を示します。 + +```js +self.addEventListener("periodicsync", (event) => { + if (event.tag === "get-latest-news") { + event.waitUntil(fetchAndCacheLatestNews()); + } +}); +``` + +`fetchAndCacheLatestNews` は開発者が定義した関数です。 + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [Richer offline experiences with the Periodic Background Sync API](https://developer.chrome.com/docs/capabilities/periodic-background-sync) +- [A Periodic Background Sync demo app](https://webplatformapis.com/periodic_sync/periodicSync_improved.html) diff --git a/files/ja/web/api/periodicsyncevent/periodicsyncevent/index.md b/files/ja/web/api/periodicsyncevent/periodicsyncevent/index.md new file mode 100644 index 00000000000000..614cf973428464 --- /dev/null +++ b/files/ja/web/api/periodicsyncevent/periodicsyncevent/index.md @@ -0,0 +1,50 @@ +--- +title: "PeriodicSyncEvent: PeriodicSyncEvent() コンストラクター" +slug: Web/API/PeriodicSyncEvent/PeriodicSyncEvent +l10n: + sourceCommit: b74d47ab6e99d2bd43ef9638367d9c69fca04402 +--- + +{{APIRef("Periodic Background Sync")}}{{SeeCompatTable}}{{AvailableInWorkers("service")}} + +**`PeriodicSyncEvent()`** コンストラクターは、新しい {{domxref("PeriodicSyncEvent")}} オブジェクトを生成します。このコンストラクターは、通常使用されません。ブラウザーがこれらのオブジェクトを作成し、{{domxref('ServiceWorkerGlobalScope.periodicsync_event', 'onperiodicsync')}} コールバックに渡します。 + +## 構文 + +```js-nolint +new PeriodicSyncEvent(type, options) +``` + +### 引数 + +- `type` + - : イベントの名前を表す文字列です。大文字と小文字は区別され、ブラウザーは `periodicsync` に設定します。 +- `options` + - : オブジェクトです。_{{domxref("Event/Event", "Event()")}} で定義されたプロパティに加え_、以下のプロパティを持つことができます。 + - `tag` + - : この同期イベントを表すタグです。 + +### 返値 + +与えられた入力を用いて設定された、新しい {{domxref("PeriodicSyncEvent")}} オブジェクトです。 + +## 例 + +この例では、関連するタグが関連付けられた新しい {{domxref('PeriodicSyncEvent')}} を構築します。 + +```js +const psEvent = new ExtendableEvent("periodicsync", { tag: "unique-tag" }); +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [Richer offline experiences with the Periodic Background Sync API](https://developer.chrome.com/docs/capabilities/periodic-background-sync) +- [A Periodic Background Sync demo app](https://webplatformapis.com/periodic_sync/periodicSync_improved.html) diff --git a/files/ja/web/api/periodicsyncevent/tag/index.md b/files/ja/web/api/periodicsyncevent/tag/index.md new file mode 100644 index 00000000000000..d0488e3d6265f1 --- /dev/null +++ b/files/ja/web/api/periodicsyncevent/tag/index.md @@ -0,0 +1,37 @@ +--- +title: "PeriodicSyncEvent: tag プロパティ" +slug: Web/API/PeriodicSyncEvent/tag +l10n: + sourceCommit: b74d47ab6e99d2bd43ef9638367d9c69fca04402 +--- + +{{APIRef("Periodic Background Sync")}}{{SeeCompatTable}}{{AvailableInWorkers("service")}} + +{{domxref("PeriodicSyncEvent")}} インターフェイスの読み取り専用プロパティ **`tag`** は、{{domxref('PeriodicSyncEvent')}} 用の開発者定義の識別子を返します。これは、{{domxref('PeriodicSyncManager')}} インターフェイスの {{domxref('PeriodicSyncManager.register()')}} メソッドを呼ぶ際に指定されます。ウェブアプリケーションは、異なる定期的なタスクを異なる頻度で実行するため、複数のタグを使用できます。 + +## 値 + +定義された識別子を表す {{jsxref('String')}} を返します。 + +## 例 + +以下の例は、サービスワーカーで定期的な同期イベントを受け取り、`tag` プロパティにアクセスするデモを行います。 + +```js +self.addEventListener("periodicsync", (event) => { + console.log(event.tag); // イベントのタグを記録する +}); +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [Richer offline experiences with the Periodic Background Sync API](https://developer.chrome.com/docs/capabilities/periodic-background-sync) +- [A Periodic Background Sync demo app](https://webplatformapis.com/periodic_sync/periodicSync_improved.html) From a322c54b2fe7640f4f63014e3560f66b54139e7e Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Fri, 20 Sep 2024 22:20:09 +0900 Subject: [PATCH 008/215] =?UTF-8?q?2024/04/12=20=E6=99=82=E7=82=B9?= =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?= =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../notificationclose_event/index.md | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) diff --git a/files/ja/web/api/serviceworkerglobalscope/notificationclose_event/index.md b/files/ja/web/api/serviceworkerglobalscope/notificationclose_event/index.md index 1e3a9c348f4103..b4fceddc45ced6 100644 --- a/files/ja/web/api/serviceworkerglobalscope/notificationclose_event/index.md +++ b/files/ja/web/api/serviceworkerglobalscope/notificationclose_event/index.md @@ -1,17 +1,16 @@ --- title: "ServiceWorkerGlobalScope: notificationclose イベント" +short-title: notificationclose slug: Web/API/ServiceWorkerGlobalScope/notificationclose_event l10n: - sourceCommit: e0e09b1df51489867f2e74c18586d168ba5e00d1 + sourceCommit: 28848ba41c082db2a8c55e85c804bd06363afb57 --- -{{APIRef("Service Workers API")}} +{{APIRef("Web Notifications")}}{{SecureContext_Header}}{{AvailableInWorkers("service")}} -**`notificationclose`** イベントは、 {{domxref("ServiceWorkerRegistration.showNotification()")}} によって生成された表示中の通知をユーザーが閉じたときに発生します。 +**`notificationclose`** は {{domxref("ServiceWorkerGlobalScope")}} インターフェイスのイベントで、{{domxref("ServiceWorkerRegistration.showNotification()")}} によって生成された表示中の通知をユーザーが閉じたときに発生します。 -メインスレッドや、サービスワーカー以外のワーカーが {{domxref("Notification.Notification","Notification()")}} コンストラクターを使用して生成した通知では、`Notification` オブジェクト自身が {{domxref("Notification/close_event", "close")}} イベントを受け取ります。 - -> **メモ:** {{domxref("ServiceWorkerGlobalScope")}} 内で {{domxref("Notification.Notification","Notification()")}} コンストラクターを使用して通知を生成しようとすると、エラーが発行されます。 +メインスレッドや、サービスワーカー以外のワーカーが {{domxref("Notification.Notification","Notification()")}} コンストラクターを使用して生成した通知では、{{domxref("Notification/close_event", "close")}} イベントを {{domxref("Notification")}} オブジェクト自身が受け取ります。 このイベントはキャンセル不可で、バブリングしません。 @@ -27,13 +26,13 @@ onnotificationclose = (event) => {}; ## イベント型 -{{domxref("NotificationEvent")}} です。 {{domxref("Event")}} を継承しています。 +{{domxref("NotificationEvent")}} です。{{domxref("ExtendableEvent")}} および {{domxref("Event")}} を継承しています。 {{InheritanceDiagram("NotificationEvent")}} ## イベントプロパティ -_親である {{domxref("Event")}} からプロパティを継承しています_。 +_祖先である {{domxref("ExtendableEvent")}} および {{domxref("Event")}} から継承したプロパティがあります_。 - {{domxref("NotificationEvent.notification")}} {{ReadOnlyInline}} - : クリックされイベントが発行された通知を表す {{domxref("Notification")}} オブジェクトを返します。 From 5af7434bf8117a57072c7d695f5f47d136393c5c Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Sun, 22 Sep 2024 17:31:22 +0900 Subject: [PATCH 009/215] =?UTF-8?q?2024/07/25=20=E6=99=82=E7=82=B9?= =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?= =?UTF-8?q?=E3=81=8D=E6=96=B0=E8=A6=8F=E7=BF=BB=E8=A8=B3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../paymentrequest_event/index.md | 72 +++++++++++++++++++ 1 file changed, 72 insertions(+) create mode 100644 files/ja/web/api/serviceworkerglobalscope/paymentrequest_event/index.md diff --git a/files/ja/web/api/serviceworkerglobalscope/paymentrequest_event/index.md b/files/ja/web/api/serviceworkerglobalscope/paymentrequest_event/index.md new file mode 100644 index 00000000000000..84b6cb11cd6384 --- /dev/null +++ b/files/ja/web/api/serviceworkerglobalscope/paymentrequest_event/index.md @@ -0,0 +1,72 @@ +--- +title: "ServiceWorkerGlobalScope: paymentrequest イベント" +short-title: paymentrequest +slug: Web/API/ServiceWorkerGlobalScope/paymentrequest_event +l10n: + sourceCommit: b71d118ffc6d72b77efad9661110fcc9ede464eb +--- + +{{APIRef("Payment Handler API")}}{{SeeCompatTable}}{{SecureContext_Header}}{{AvailableInWorkers("service")}} + +**`paymentrequest`** は {{domxref("ServiceWorkerGlobalScope")}} インターフェイスのイベントで、{{domxref("PaymentRequest.show()")}} メソッドを介して販売者ウェブサイト上で決済フローが開始された場合に決済アプリ上で発生します。 + +## 構文 + +このイベント名を {{domxref("EventTarget.addEventListener", "addEventListener()")}} などのメソッドで使用するか、イベントハンドラープロパティを設定するかしてください。 + +```js +addEventListener("paymentrequest", (event) => {}); + +onpaymentrequest = (event) => {}; +``` + +## イベント型 + +{{domxref("PaymentRequestEvent")}} です。{{domxref("ExtendableEvent")}} から継承しています。 + +{{InheritanceDiagram("PaymentRequestEvent")}} + +## 例 + +{{domxref("PaymentRequest.show()")}} メソッドが呼び出されると、決済アプリのサービスワーカーに決済リクエストイベントが発行されます。このイベントは、決済アプリのサービスワーカー内でリスニングされ、決済プロセスの次の段階に入ります。 + +```js +let payment_request_event; +let resolver; +let client; + +// `self` is the global object in service worker +self.addEventListener("paymentrequest", async (e) => { + if (payment_request_event) { + // If there's an ongoing payment transaction, reject it. + resolver.reject(); + } + // Preserve the event for future use + payment_request_event = e; + + // ... +}); +``` + +`paymentrequest` イベントを受信すると、決済アプリは {{domxref("PaymentRequestEvent.openWindow()")}} を呼んで決済ハンドラーウィンドウを開くことができます。決済ハンドラーウィンドウには、顧客が認証をしたり、配送先住所やオプションを選べたり、決済を承認したりできる、決済アプリのインターフェイスが表示されます。 + +決済が処理されたら、{{domxref("PaymentRequestEvent.respondWith()")}} を使用して、決済結果を販売者のウェブサイトに渡します。 + +この段階の詳細については、 [Receive a payment request event from the merchant](https://web.dev/articles/orchestrating-payment-transactions#receive-payment-request-event) を参照してください。 + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- {{domxref("Payment Handler API", "決済ハンドラー API", "", "nocode")}} +- [Web-based payment apps overview](https://web.dev/articles/web-based-payment-apps-overview) +- [Setting up a payment method](https://web.dev/articles/setting-up-a-payment-method) +- [Life of a payment transaction](https://web.dev/articles/life-of-a-payment-transaction) +- [決済リクエスト API の使用](/ja/docs/Web/API/Payment_Request_API/Using_the_Payment_Request_API) +- [決済処理の概要](/ja/docs/Web/API/Payment_Request_API/Concepts) From 5f25a903a9b247b907edf78981400ac3157613fe Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Sun, 22 Sep 2024 17:35:12 +0900 Subject: [PATCH 010/215] =?UTF-8?q?2024/04/15=20=E6=99=82=E7=82=B9?= =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?= =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../serviceworkerglobalscope/periodicsync_event/index.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/files/ja/web/api/serviceworkerglobalscope/periodicsync_event/index.md b/files/ja/web/api/serviceworkerglobalscope/periodicsync_event/index.md index 0dcdf109669920..003c4b82c2291c 100644 --- a/files/ja/web/api/serviceworkerglobalscope/periodicsync_event/index.md +++ b/files/ja/web/api/serviceworkerglobalscope/periodicsync_event/index.md @@ -1,11 +1,12 @@ --- title: "ServiceWorkerGlobalScope: periodicsync イベント" +short-title: periodicsync slug: Web/API/ServiceWorkerGlobalScope/periodicsync_event l10n: - sourceCommit: e0e09b1df51489867f2e74c18586d168ba5e00d1 + sourceCommit: b74d47ab6e99d2bd43ef9638367d9c69fca04402 --- -{{APIRef("Periodic Background Sync")}}{{SeeCompatTable}} +{{APIRef("Periodic Background Sync")}}{{SeeCompatTable}}{{SecureContext_Header}}{{AvailableInWorkers("service")}} **`periodicsync`** は {{domxref("ServiceWorkerGlobalScope")}} インターフェイスのイベントで、 {{domxref('PeriodicSyncManager')}}を登録したときに指定された時間間隔で発行されます。 @@ -64,5 +65,5 @@ self.onperiodicsync = (event) => { ## 関連情報 -- [Richer offline experiences with the Periodic Background Sync API](https://web.dev/periodic-background-sync/) +- [Richer offline experiences with the Periodic Background Sync API](https://developer.chrome.com/docs/capabilities/periodic-background-sync) - [A Periodic Background Sync demo app](https://webplatformapis.com/periodic_sync/periodicSync_improved.html) From a4715c1fe1732c1ed3bca7a2f82b934bbe05e19a Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Sun, 22 Sep 2024 17:42:35 +0900 Subject: [PATCH 011/215] =?UTF-8?q?2024/04/22=20=E6=99=82=E7=82=B9?= =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?= =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- files/ja/web/api/serviceworkerglobalscope/push_event/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/files/ja/web/api/serviceworkerglobalscope/push_event/index.md b/files/ja/web/api/serviceworkerglobalscope/push_event/index.md index 31e31e0d1584d5..8a735435fd00e7 100644 --- a/files/ja/web/api/serviceworkerglobalscope/push_event/index.md +++ b/files/ja/web/api/serviceworkerglobalscope/push_event/index.md @@ -3,10 +3,10 @@ title: "ServiceWorkerGlobalScope: push イベント" short-title: push slug: Web/API/ServiceWorkerGlobalScope/push_event l10n: - sourceCommit: acfe8c9f1f4145f77653a2bc64a9744b001358dc + sourceCommit: 3a91caa0ebbc5131ed75afe0e5168cd5bffc0976 --- -{{APIRef("Push API")}} +{{APIRef("Push API")}}{{SecureContext_Header}}{{AvailableInWorkers("service")}} **`push`** イベントは、サービスワーカーがプッシュメッセージを受信したときにサービスワーカーのグローバルスコープ ({{domxref("ServiceWorkerGlobalScope")}} インターフェイスで表現されるもの) に送られます。 From 302cf7e3b332d23920b5d581a19d0a61aac645dc Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Sun, 22 Sep 2024 17:45:36 +0900 Subject: [PATCH 012/215] =?UTF-8?q?2024/07/26=20=E6=99=82=E7=82=B9?= =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?= =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../pushsubscriptionchange_event/index.md | 23 +++++++++++++------ 1 file changed, 16 insertions(+), 7 deletions(-) diff --git a/files/ja/web/api/serviceworkerglobalscope/pushsubscriptionchange_event/index.md b/files/ja/web/api/serviceworkerglobalscope/pushsubscriptionchange_event/index.md index 749c5665f306b0..f25b5080ab8e5a 100644 --- a/files/ja/web/api/serviceworkerglobalscope/pushsubscriptionchange_event/index.md +++ b/files/ja/web/api/serviceworkerglobalscope/pushsubscriptionchange_event/index.md @@ -3,10 +3,10 @@ title: "ServiceWorkerGlobalScope: pushsubscriptionchange イベント" short-title: pushsubscriptionchange slug: Web/API/ServiceWorkerGlobalScope/pushsubscriptionchange_event l10n: - sourceCommit: acfe8c9f1f4145f77653a2bc64a9744b001358dc + sourceCommit: 4f35a8237ee0842beb9cfef3354e05464ad7ce1a --- -{{APIRef("Push API")}} +{{APIRef("Push API")}}{{SecureContext_Header}}{{AvailableInWorkers("service")}} **`pushsubscriptionchange`** イベントは[グローバルスコープ](/ja/docs/Web/API/ServiceWorkerGlobalScope)としての {{domxref("ServiceWorker")}} へ送信され、アプリケーションの制御の外から起動されたプッシュ通知への加入状況が変化したことを示します。 @@ -30,7 +30,7 @@ onpushsubscriptionchange = (event) => {}; ## 使用上のメモ -加入に関する情報をアプリケーションサーバーと共有する方法を示す例では {{domxref("fetch()")}} を使用する傾向がありますが、これは実際の使用には必ずしも最適な選択ではありません。たとえば、アプリがオフラインの場合は機能しないためです。 +加入に関する情報をアプリケーションサーバーと共有する方法を示す例では {{domxref("WorkerGlobalScope/fetch", "fetch()")}} を使用する傾向がありますが、これは実際の使用には必ずしも最適な選択ではありません。たとえば、アプリがオフラインの場合は機能しないためです。 サービスワーカーとアプリサーバー間で加入情報を同期するのに別の方法を使用することを検討するか、 `fetch()` を使用するコードが、データ交換の試行が失敗した場合を処理するのに十分堅牢であることを確認してください。 @@ -45,7 +45,15 @@ onpushsubscriptionchange = (event) => {}; self.addEventListener( "pushsubscriptionchange", (event) => { - const subscription = swRegistration.pushManager + const conv = (val) => + self.btoa(String.fromCharCode.apply(null, new Uint8Array(val))); + const getPayload = (subscription) => ({ + endpoint: subscription.endpoint, + publicKey: conv(subscription.getKey("p256dh")), + authToken: conv(subscription.getKey("auth")), + }); + + const subscription = self.registration.pushManager .subscribe(event.oldSubscription.options) .then((subscription) => fetch("register", { @@ -54,7 +62,8 @@ self.addEventListener( "Content-type": "application/json", }, body: JSON.stringify({ - endpoint: subscription.endpoint, + old: getPayload(event.oldSubscription), + new: getPayload(subscription), }), }), ); @@ -64,14 +73,14 @@ self.addEventListener( ); ``` -加入の有効期限が切れたことを示す `pushsubscriptionchange` イベントが到着すると、プッシュマネージャーの {{domxref("PushManager.subscribe", "subscribe()")}} メソッドを呼び出して再加入します。返されたプロミスが解決されると、新しい加入を受け取ります。これは、 {{domxref("fetch()")}} 呼び出しを使用してアプリサーバーに配信され、 {{Glossary("JSON")}} 形式で加入の {{domxref("PushSubscription.endpoint", "endpoint")}} の返信をアプリサーバーに送信します。 +加入の有効期限が切れたことを示す `pushsubscriptionchange` イベントが到着すると、プッシュマネージャーの {{domxref("PushManager.subscribe", "subscribe()")}} メソッドを呼び出して再加入します。返されたプロミスが解決されると、新しい加入を受け取ります。これは、 {{domxref("WorkerGlobalScope/fetch", "fetch()")}} 呼び出しを使用してアプリサーバーに配信され、 {{Glossary("JSON")}} 形式で加入の {{domxref("PushSubscription.endpoint", "endpoint")}} の返信をアプリサーバーに送信します。 `onpushsubscriptionchange` イベントハンドラープロパティを使用してイベントハンドラーを設定することもできます。 ```js self.onpushsubscriptionchange = (event) => { event.waitUntil( - swRegistration.pushManager + self.registration.pushManager .subscribe(event.oldSubscription.options) .then((subscription) => { /* ... */ From 222d8fbfdf1e5fee52ecf811cc035ce22c586a64 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Sun, 22 Sep 2024 17:50:39 +0900 Subject: [PATCH 013/215] =?UTF-8?q?2024/04/15=20=E6=99=82=E7=82=B9?= =?UTF-8?q?=E3=81=AE=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5?= =?UTF-8?q?=E3=81=8D=E6=9B=B4=E6=96=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../api/serviceworkerglobalscope/sync_event/index.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/files/ja/web/api/serviceworkerglobalscope/sync_event/index.md b/files/ja/web/api/serviceworkerglobalscope/sync_event/index.md index fd2309dfb0932d..ee920c466e7af9 100644 --- a/files/ja/web/api/serviceworkerglobalscope/sync_event/index.md +++ b/files/ja/web/api/serviceworkerglobalscope/sync_event/index.md @@ -1,11 +1,12 @@ --- title: "ServiceWorkerGlobalScope: sync イベント" +short-title: sync slug: Web/API/ServiceWorkerGlobalScope/sync_event l10n: - sourceCommit: ad50409e75b81d80e24c745cd033ee9f57fdb4ec + sourceCommit: 56df677713fecf43ec0eb8862cb91c141aaa0005 --- -{{DefaultAPISidebar("Background Sync")}} +{{APIRef("Background Sync")}}{{SecureContext_Header}}{{AvailableInWorkers("service")}} **`sync`** は {{domxref("ServiceWorkerGlobalScope")}} インターフェイスのイベントで、 {{domxref('SyncManager')}} にイベントを登録したページ（またはワーカー）が実行されているとき、ネットワーク接続が利用できるようになるとすぐに発行されます。 @@ -23,13 +24,13 @@ onsync = (event) => {}; ## イベント型 -{{domxref("SyncEvent")}} です。 {{domxref("Event")}} を継承しています。 +{{domxref("SyncEvent")}} です。{{domxref("ExtendableEvent")}} および {{domxref("Event")}} を継承しています。 {{InheritanceDiagram("SyncEvent")}} ## イベントプロパティ -_祖先である {{domxref("Event")}} からプロパティを継承しています_。 +_祖先である {{domxref("ExtendableEvent")}} および {{domxref("Event")}} からプロパティを継承しています_。 - {{domxref("SyncEvent.tag")}} {{ReadOnlyInline}} - : この `SyncEvent` の開発者が定義した識別子を返します。 @@ -66,5 +67,5 @@ self.onsync = (event) => { ## 関連情報 -- [Richer offline experiences with the Periodic Background Sync API](https://web.dev/periodic-background-sync/) +- [Richer offline experiences with the Periodic Background Sync API](https://developer.chrome.com/docs/capabilities/periodic-background-sync) - [A Periodic Background Sync demo app](https://webplatformapis.com/periodic_sync/periodicSync_improved.html) From 1debf25a2af4adb4f8d5d07bc6720dda84654df9 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Sun, 22 Sep 2024 18:53:36 +0900 Subject: [PATCH 014/215] =?UTF-8?q?sourceCommit:=20=E3=82=92=E4=BF=AE?= =?UTF-8?q?=E6=AD=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- files/ja/web/api/htmlelement/attributestylemap/index.md | 2 +- .../api/performanceobserverentrylist/getentriesbytype/index.md | 2 +- files/ja/web/api/svgelement/attributestylemap/index.md | 2 +- .../reference/global_objects/symbol/tostringtag/index.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/files/ja/web/api/htmlelement/attributestylemap/index.md b/files/ja/web/api/htmlelement/attributestylemap/index.md index 17290aa75e72ef..eb81ff61eb1987 100644 --- a/files/ja/web/api/htmlelement/attributestylemap/index.md +++ b/files/ja/web/api/htmlelement/attributestylemap/index.md @@ -3,7 +3,7 @@ title: "HTMLElement: attributeStyleMap プロパティ" short-title: attributeStyleMap slug: Web/API/HTMLElement/attributeStyleMap l10n: - sourceCommit: bba05bf24a714715f3517cf1296274dd41d6e811 + sourceCommit: 2eacf352ffb5d8a3233c13e4bf5949578b847759 --- {{APIRef("CSSOM")}} diff --git a/files/ja/web/api/performanceobserverentrylist/getentriesbytype/index.md b/files/ja/web/api/performanceobserverentrylist/getentriesbytype/index.md index 39a8662477f6e7..565a1a2afb7abf 100644 --- a/files/ja/web/api/performanceobserverentrylist/getentriesbytype/index.md +++ b/files/ja/web/api/performanceobserverentrylist/getentriesbytype/index.md @@ -3,7 +3,7 @@ title: "PerformanceObserverEntryList: getEntriesByType() メソッド" short-title: getEntriesByType() slug: Web/API/PerformanceObserverEntryList/getEntriesByType l10n: - sourceCommit: 73b2b6ee411ac094b9fc57dafac6f9c232fc20d9 + sourceCommit: c58e8c1dd6ecbcb63894c7dd17fb9495b9511b4e --- {{APIRef("Performance API")}} diff --git a/files/ja/web/api/svgelement/attributestylemap/index.md b/files/ja/web/api/svgelement/attributestylemap/index.md index 21b3d89867ca4f..19b76d2e81edf7 100644 --- a/files/ja/web/api/svgelement/attributestylemap/index.md +++ b/files/ja/web/api/svgelement/attributestylemap/index.md @@ -3,7 +3,7 @@ title: "SVGElement: attributeStyleMap プロパティ" short-title: attributeStyleMap slug: Web/API/SVGElement/attributeStyleMap l10n: - sourceCommit: bba05bf24a714715f3517cf1296274dd41d6e811 + sourceCommit: 2eacf352ffb5d8a3233c13e4bf5949578b847759 --- {{APIRef("CSSOM")}} diff --git a/files/ja/web/javascript/reference/global_objects/symbol/tostringtag/index.md b/files/ja/web/javascript/reference/global_objects/symbol/tostringtag/index.md index fdcba335328120..72d84613381acd 100644 --- a/files/ja/web/javascript/reference/global_objects/symbol/tostringtag/index.md +++ b/files/ja/web/javascript/reference/global_objects/symbol/tostringtag/index.md @@ -2,7 +2,7 @@ title: Symbol.toStringTag slug: Web/JavaScript/Reference/Global_Objects/Symbol/toStringTag l10n: - sourceCommit: 808b7d39103c946ca1b7dd5edbe7afd203c92efd + sourceCommit: 6e93ec8fc9e1f3bd83bf2f77e84e1a39637734f8 --- {{JSRef}} From fa6e8a74967c46a705c4d6071e78273b1dc79521 Mon Sep 17 00:00:00 2001 From: juner Date: Wed, 25 Sep 2024 10:35:13 +0900 Subject: [PATCH 015/215] Update index.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit コールバックあkン数 → コールバック関数 --- files/ja/web/api/htmlcanvaselement/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/ja/web/api/htmlcanvaselement/index.md b/files/ja/web/api/htmlcanvaselement/index.md index 1d8627c0387dc6..e9ee5985d81f56 100644 --- a/files/ja/web/api/htmlcanvaselement/index.md +++ b/files/ja/web/api/htmlcanvaselement/index.md @@ -22,7 +22,7 @@ _{{domxref("HTMLElement")}} から継承しているプロパティがありま - {{domxref("HTMLCanvasElement.mozOpaque")}} {{non-standard_inline}} {{deprecated_inline}} - : この {{HTMLElement("canvas")}} 要素の [`moz-opaque`](/ja/docs/Web/HTML/Element/canvas#moz-opaque) 属性を反映した論理値です。半透明の部分の有無をキャンバスに伝えることができます。キャンバスに半透明がないことがわかれば、描画のパフォーマンスを最適化することができます。これは Mozilla ベースのブラウザーでのみ対応しています。代わりに標準化された {{domxref("HTMLCanvasElement.getContext()", "canvas.getContext('2d', { alpha: false })")}} を使用してください。 - {{domxref("HTMLCanvasElement.mozPrintCallback")}} {{non-standard_inline}} - - : 初期状態では null である関数です。ウェブコンテンツでここに JavaScript 関数を設定すると、ページの印刷中にキャンバスが再描画される際に呼び出されます。呼び出される際、コールバックあkン数には "printState" オブジェクトが渡されます。これは [MozCanvasPrintState](https://searchfox.org/mozilla-central/search?q=interface%20MozCanvasPrintState&path=HTMLCanvasElement.webidl) インターフェイスです。 コールバックは printState オブジェクトから描画するコンテキストを取得することができ、完了したら done() を呼び出す必要があります。`mozPrintCallback` の目的は、使用するプリンターの解像度でキャンバスの高解像度レンダリングを行うことです。[このブログ記事を参照してください](https://blog.mozilla.org/labs/2012/09/a-new-way-to-control-printing-output/)。 + - : 初期状態では null である関数です。ウェブコンテンツでここに JavaScript 関数を設定すると、ページの印刷中にキャンバスが再描画される際に呼び出されます。呼び出される際、コールバック関数には "printState" オブジェクトが渡されます。これは [MozCanvasPrintState](https://searchfox.org/mozilla-central/search?q=interface%20MozCanvasPrintState&path=HTMLCanvasElement.webidl) インターフェイスです。 コールバックは printState オブジェクトから描画するコンテキストを取得することができ、完了したら done() を呼び出す必要があります。`mozPrintCallback` の目的は、使用するプリンターの解像度でキャンバスの高解像度レンダリングを行うことです。[このブログ記事を参照してください](https://blog.mozilla.org/labs/2012/09/a-new-way-to-control-printing-output/)。 ## メソッド From 2cc99a622f412478a23ce10beec00b84b068dbd6 Mon Sep 17 00:00:00 2001 From: osoda <18646766+osoda@users.noreply.github.com> Date: Thu, 26 Sep 2024 12:19:31 -0500 Subject: [PATCH 016/215] [es] Update example and subtitles in basic_concepts_of_grid_layout (#23713) * [es] Update example and subtitles in web/css/css_grid_layout/basic_concepts_of_grid_layout Fix some example and add subtitles level 3 at web/css/css_grid_layout/basic_concepts_of_grid_layout/index.md * Apply suggestions from linter review Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> * Update files/es/web/css/css_grid_layout/basic_concepts_of_grid_layout/index.md Change the example to the original version (en-US) --- .../basic_concepts_of_grid_layout/index.md | 78 ++++++++++++++++++- 1 file changed, 74 insertions(+), 4 deletions(-) diff --git a/files/es/web/css/css_grid_layout/basic_concepts_of_grid_layout/index.md b/files/es/web/css/css_grid_layout/basic_concepts_of_grid_layout/index.md index c935c0e7392677..53aa7d02f04716 100644 --- a/files/es/web/css/css_grid_layout/basic_concepts_of_grid_layout/index.md +++ b/files/es/web/css/css_grid_layout/basic_concepts_of_grid_layout/index.md @@ -91,6 +91,8 @@ Definimos filas y columnas en nuestra cuadrícula con las propiedades {{cssxref( ![](1_grid_track.png) +### Ejemplo básico + Puedo modificar nuestro ejemplo anterior al agregar la propiedad `grid-template-columns`, para así definir el tamaño (ancho) de las vías de cada columna. Ahora he creado una cuadrícula con tres vías por columna de 200 píxeles. Los elementos hijo se posicionarán en esta cuadrícula uno en cada una de las celdas de la cuadrícula. @@ -132,9 +134,9 @@ Ahora he creado una cuadrícula con tres vías por columna de 200 píxeles. Los } ``` -{{ EmbedLiveSample('grid_first', '610', '140') }} +{{ EmbedLiveSample('Ejemplo_basico', '610', '140') }} -### La Unidad fr +### La unidad fr Las vías se pueden definir usando cualquier unidad de medida. Grid también introduce una unidad de longitud adicional para ayudarnos a crear vías de cuadrícula flexibles. La nueva unidad fr representa una fracción del espacio disponible en el contenedor de la cuadrícula. La siguiente definición de cuadrícula crearía tres vias con el mismo ancho, que se expanden y se encogen de acuerdo el espacio disponible. @@ -175,10 +177,22 @@ Las vías se pueden definir usando cualquier unidad de medida. Grid también int } ``` -{{ EmbedLiveSample('La_Unidad_fr', '220', '140') }} +{{ EmbedLiveSample('La_unidad_fr', '220', '140') }} + +### Tamaño desigual En el próximo ejemplo creamos una definición con una vía de `2fr` y luego dos vías de `1fr`. El espacio disponible se divide en cuatro. Dos partes corresponden a la primera vía y una parte a cada una de las dos vias restantes. +```html +
+
One
+
Two
+
Three
+
Four
+
Five
+
+``` + ```css .wrapper { display: grid; @@ -186,7 +200,41 @@ En el próximo ejemplo creamos una definición con una vía de `2fr` y luego dos } ``` -En este ejemplo final mezclamos las vías de tamaño absoluto con unidades de fracción(fr). La primera vía tiene 500 píxeles, por lo que este ancho fijo se sustrae del espacio disponible.El espacio restante se divide en tres y se asigna en proporción a las dos vías flexibles. +```css hidden +* { + box-sizing: border-box; +} + +.wrapper { + border: 2px solid #f76707; + border-radius: 5px; + background-color: #fff4e6; +} + +.wrapper > div { + border: 2px solid #ffa94d; + border-radius: 5px; + background-color: #ffd8a8; + padding: 1em; + color: #d9480f; +} +``` + +{{ EmbedLiveSample('Tamaño_desigual', '220', '140') }} + +### Mezclando tamanaños absolutos y flexibles + +En este ejemplo final mezclamos las vías de tamaño absoluto con unidades de fracción(fr). La primera vía tiene 500 píxeles, por lo que este ancho fijo se sustrae del espacio disponible. El espacio restante se divide en tres y se asigna en proporción a las dos vías flexibles. + +```html +
+
One
+
Two
+
Three
+
Four
+
Five
+
+``` ```css .wrapper { @@ -195,6 +243,28 @@ En este ejemplo final mezclamos las vías de tamaño absoluto con unidades de fr } ``` +```css hidden +* { + box-sizing: border-box; +} + +.wrapper { + border: 2px solid #f76707; + border-radius: 5px; + background-color: #fff4e6; +} + +.wrapper > div { + border: 2px solid #ffa94d; + border-radius: 5px; + background-color: #ffd8a8; + padding: 1em; + color: #d9480f; +} +``` + +{{ EmbedLiveSample('Mezclando_tamanaños_absolutos_y_flexibles', '220', '140') }} + ### Listando vías con la notación `repeat()` Las cuadrículas grandes con muchas vías o celdas pueden utilizar la notación `repeat()` con el fin de repetir todas o una sección de la lista de vías. Por ejemplo la definición de cuadrícula: From de3a0638c479299440298cdd25fd62d43c4cc1c5 Mon Sep 17 00:00:00 2001 From: Quentin <59255702+quentin-rey@users.noreply.github.com> Date: Thu, 26 Sep 2024 23:23:04 +0200 Subject: [PATCH 017/215] Correction of the function call - Fixes #23672 (#23749) Correction of the function call --- files/fr/web/javascript/reference/functions/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/fr/web/javascript/reference/functions/index.md b/files/fr/web/javascript/reference/functions/index.md index a819d85beb5b87..62e76ed9849d26 100644 --- a/files/fr/web/javascript/reference/functions/index.md +++ b/files/fr/web/javascript/reference/functions/index.md @@ -295,7 +295,7 @@ La comportement de la récursion en tant que pile peut être observée avec cet function truc(i) { if (i < 0) return; console.log("début :" + i); - toto(i - 1); + truc(i - 1); console.log("fin :" + i); } truc(3); From d50a33312f761950b1c3a93ce0bdd725fa7fbe6e Mon Sep 17 00:00:00 2001 From: Pablo Rio <97156350+Pablo-Rio@users.noreply.github.com> Date: Thu, 26 Sep 2024 23:28:32 +0200 Subject: [PATCH 018/215] fix: textarea typo (#23788) --- files/fr/web/html/element/textarea/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/fr/web/html/element/textarea/index.md b/files/fr/web/html/element/textarea/index.md index aafc4f16f142d0..e89d33ad44a8aa 100644 --- a/files/fr/web/html/element/textarea/index.md +++ b/files/fr/web/html/element/textarea/index.md @@ -14,7 +14,7 @@ Dans les exemples ci-avant, on peut voir plusieurs fonctionnalités de ``. Les navigateurs pouvant être différents, c'est une bonne idée que d'utiliser ces attributs pour garantir une certaine homogénéité. -- `maxlength` définit le nombre maximal de caractères qui peuvent être saisis dans l'élément ` + +``` + +次の CSS を使用すると、クラスに基づいていくつかの異なる要素をスタイル設定することができます（下記では、色に焦点を当てるため、一部のレイアウトルールは表示されていません）。 +クラスに応じて、`cornflowerblue` または `aquamarine` の要素に背景色を設定しています。 + +```css hidden +/* フォント、境界線、パディングを設定 */ +body { + font-family: sans-serif; color: white; - background-color: brown; - margin: 10px; - width: 50px; - height: 50px; - display: inline-block; } +div, +input, +textarea { + border: 2px black solid; + padding: 4px; + margin: 4px; +} + +.container { + display: grid; + gap: 10px; +} +``` + +```css +/* それぞれのクラスに、いくつかの色を設定 */ +.one { + background-color: cornflowerblue; +} .two { - color: white; - background-color: black; - margin: 10px; - width: 150px; - height: 70px; - display: inline-block; + color: black; + background-color: aquamarine; } .three { - color: white; - background-color: brown; - margin: 10px; - width: 75px; + background-color: cornflowerblue; } .four { - color: white; - background-color: brown; - margin: 10px; - width: 100px; + background-color: cornflowerblue; } - .five { - background-color: brown; + background-color: cornflowerblue; } ``` -これを下の HTML に適用します。 +このようになるはずです。 -```html -
-
1:
-
2: Text 5 - more text
- - -
-``` +{{EmbedLiveSample("First_steps_with_custom_properties",600,360)}} -このようになるはずです。 +これらのルール全体で繰り返される値をカスタムプロパティで置き換える機会があります。 +`.container` スコープで `--main-bg-color` を定義し、その値を複数の場所で参照した後、更新されたスタイルは次のようになります。 -{{EmbedLiveSample("First_steps_with_custom_properties",600,180)}} +```css +/* ここで --main-bg-color を定義 */ +.container { + --main-bg-color: cornflowerblue; +} + +/* それぞれのクラスに、いくつかの色を設定 */ +.one { + background-color: var(--main-bg-color); +} +.two { + color: black; + background-color: aquamarine; +} +.three { + background-color: var(--main-bg-color); +} +.four { + background-color: var(--main-bg-color); +} +.five { + background-color: var(--main-bg-color); +} +``` ## :root 擬似クラスの使用 -CSS 中に同じ宣言が繰り返し出てくることに注意してください。いろいろな場所で背景色が `brown` に設定されています。 CSS の宣言によっては、カスケードの上流でこれを宣言し、 CSS の継承によってこの問題を自然に解決することもできます。些末なプロジェクトを除いて、常にこの手法が使えるわけではありません。 {{cssxref(":root")}} 擬似クラスでカスタムプロパティを宣言し、文書内の必要な場所で使用することで、繰り返して書く必要性を減らすことができるのです。 +CSS 宣言の中には、カスケードのより上位で宣言し、CSS 継承でこの問題を解決することが可能なものもあります。複雑なプロジェクトでは、常に可能であるとは限りません。CSS 作者は、{{cssxref(":root")}} 擬似クラスにカスタムプロパティを宣言し、文書内の必要な箇所でそれを使用することで、繰り返し記述の必要性を減らすことができます。 ```css +/* ここで --main-bg-color を定義 */ :root { - --main-bg-color: brown; + --main-bg-color: cornflowerblue; } +/* それぞれのクラスに、いくつかの色を設定 */ .one { - color: white; background-color: var(--main-bg-color); - margin: 10px; - width: 50px; - height: 50px; - display: inline-block; } - .two { - color: white; - background-color: black; - margin: 10px; - width: 150px; - height: 70px; - display: inline-block; + color: black; + background-color: aquamarine; } .three { - color: white; background-color: var(--main-bg-color); - margin: 10px; - width: 75px; } .four { - color: white; background-color: var(--main-bg-color); - margin: 10px; - width: 100px; } - .five { background-color: var(--main-bg-color); } ``` -```html hidden -
-
-
Text - more text
- - -
-``` - -この例では、前回の例と同じ結果になりますが、目的のプロパティ値の正規宣言を1つだけ行うことができます。後でページ全体の値を変更したい場合に、とても有益です。 +これは前回と同じ結果になりますが、望ましいプロパティ値の標準的な宣言（`--main-bg-color: cornflowerblue;`）が可能になり、これは後で自分のプロジェクト全体で値を変更したい場合にとても有益なものです。 ## カスタムプロパティの継承 カスタムプロパティは継承されます。これはつまり、もし与えられた要素にカスタムプロパティの値がない場合、その値は親の値を使用するということです。 HTML を見てみましょう。 -```html +```html live-sample___dash-custom-property-inheritance
+

One

-
-
+

Two

+

Three

+

Four

``` -下記の CSS を適用するとします。 +```css hidden live-sample___dash-custom-property-inheritance +div { + color: black; + font-family: sans-serif; + width: 75%; + height: 80%; + margin: 4px; + border: 2px black solid; + display: inline-block; +} + +p { + margin: 0; +} + +.one { + height: 250px; +} + +.two { + height: 80%; +} + +.three { + height: 40%; +} + +.four { + height: 40%; +} +``` + +```css live-sample___dash-custom-property-inheritance +div { + background-color: var(--box-color); +} -```css .two { - --test: 10px; + --box-color: cornflowerblue; } .three { - --test: 2em; + --box-color: aquamarine; } ``` -この場合、 `var(--test)` の結果は以下の通りです。 +{{embedlivesample("dash-custom-property-inheritance", "100%", "280px")}} + +`var(--box-color)` の結果は次のように、継承状況によって変わります。 + +- `class="one"`: _無効値_、これはすべてのカスタムプロパティの既定値です。 +- `class="two"`: `cornflowerblue` +- `class="three"`: `aquamarine` +- `class="four"`: `cornflowerblue`（親から継承） + +上記の例が示すカスタムプロパティの 1 つの側面は、他のプログラミング言語の変数とまったく同じには動作しないということです。 +この値は、必要とされる場所で計算され、このスタイルシートの他の場所に保存されて再利用されることはありません。 +例えば、プロパティの値を設定しても、兄弟の子孫のルールでその値を取得することはできません。 +プロパティは、一致するセレクターとその子孫に対してのみ設定されます。 -- `class="two"` の要素: `10px` -- `class="three"` の要素: `2em` -- `class="four"` の要素: `10px` (親から継承) -- `class="one"` の要素: _無効な値_、これはすべてのカスタムプロパティの既定値です。 +### `@property` を使用して継承を制御 -これらはカスタムプロパティであり、実際には他のプログラミング言語で見られるような変数ではないことに留意してください。値は必要に応じて計算され、他のルールで使用するために格納されるわけではありません。例えば、要素にプロパティを設定して、兄弟の子孫のルールで受け取ることを期待することはできません。通常の CSS と同様、プロパティは一致するセレクターおよびその子孫に対してのみ設定されます。 +`@property` アットルールでは、プロパティを継承するかどうかを明示的に指定できます。 +次の例では、`@property` アットルールを使用してカスタムプロパティを作成しています。 +継承は無効になっており、[``](/ja/docs/Web/CSS/color_value) データ型が定義され、`cornflowerblue` が初期値として設定されています。 + +親要素は、`--box-color` の値を緑に設定し、`--box-color` を背景色の値として使用します。 +子要素も `background-color: var(--box-color)` を使用しており、継承が有効になっている場合（または、ダッシュ 2 本の構文を使用して定義されている場合）には、`green` 色が設定されていることが期待されます。 + +```html live-sample___at-property-inheritance +
+

親要素

+
+

子要素で、--box-color の継承が無効になっています。

+
+
+``` + +```css hidden live-sample___at-property-inheritance +div { + color: white; + font-family: sans-serif; + width: 200px; + height: 200px; + margin: 4px; + padding: 8px; + border: 2px black solid; + display: inline-block; +} +``` + +```css live-sample___at-property-inheritance +@property --box-color { + syntax: ""; + inherits: false; + initial-value: cornflowerblue; +} + +.parent { + --box-color: green; + background-color: var(--box-color); +} + +.child { + width: 80%; + height: 40%; + background-color: var(--box-color); +} +``` + +アットルールで `inherits: false;` が設定されており、`.child` スコープ内で `--box-color` プロパティの値が宣言されていないため、親から継承されるはずの `green` の代わりに `cornflowerblue` の初期値が使用されます。 + +{{embedlivesample("at-property-inheritance", "100%", "250px")}} ## カスタムプロパティ代替値 -[`var()`](/ja/docs/Web/CSS/var) 関数を使用して、指定された変数が定義されていない場合の**代替値**を複数定義することができます。[カスタム要素](/ja/docs/Web/API/Web_components/Using_custom_elements)および[シャドウ DOM](/ja/docs/Web/API/Web_components/Using_shadow_DOM) で作業するときに便利なことがあります。 +カスタムプロパティの代替値は、`var()` 関数と `@property` アットルールの `initial-value` を使用して定義できます。 > [!NOTE] -> 代替値はブラウザーの互換性を修正するためには使用されません。ブラウザーが CSS カスタムプロパティに対応していない場合、代替値は助けになりません。これは CSS カスタムプロパティに対応しているブラウザーのための単なるバックアップであり、与えられた変数が定義されていなかったり、無効な値であったりした場合に別な値を選択させるためのものです。 +> 代替値はブラウザーの互換性を修正するためには使用されません。ブラウザーが CSS カスタムプロパティに対応していない場合、代替値は助けになりません。 +> これは CSS カスタムプロパティに対応しているブラウザーのための単なるバックアップであり、与えられた変数が定義されていなかったり、無効な値であったりした場合に別な値を選択させるためのものです。 -関数の最初の引数は、代替される[カスタムプロパティ](https://www.w3.org/TR/css-variables/#custom-property)の名前です。関数の二番目の引数は、もしあれば、参照された[カスタムプロパティ](https://www.w3.org/TR/css-variables/#custom-property)が無効であった場合に代わりに使用される代替値です。この関数は引数を 2 つだけ受け付けるので、最初のカンマの後のものは、すべて二番目の引数として割り当てます。二番目の引数が無効な場合、次のように代替処理は失敗します。 +### `var()` 関数の代替値の定義 + +[`var()`](/ja/docs/Web/CSS/var) 関数を使用して、指定された変数が定義されていない場合の**代替値**を複数定義することができます。[カスタム要素](/ja/docs/Web/API/Web_components/Using_custom_elements)および[シャドウ DOM](/ja/docs/Web/API/Web_components/Using_shadow_DOM) で作業するときに便利なことがあります。 + +関数の最初の引数は、カスタムプロパティの名前です。関数の 2 番目の引数は、省略可能で、参照されたカスタムプロパティが無効であった場合に代わりに使用される代替値です。 +この関数は引数を 2 つだけ受け付けるので、最初のカンマの後のものは、すべて 2 番目の引数として割り当てます。2 番目の引数が無効な場合、次のように代替処理は失敗します。 ```css -.two { +.one { /* --my-var が定義されていなければ red */ color: var(--my-var, red); } -.three { +.two { /* my-var 及び --my-background が定義されていなければ pink */ - background-color: var(--my-var, var(--my-background, pink)); + color: var(--my-var, var(--my-background, pink)); } .three { /* 無効: "--my-background, pink" */ - background-color: var(--my-var, --my-background, pink); + color: var(--my-var, --my-background, pink); } ``` -代替としてのカスタムプロパティを含めるには、上記の二番目の例のようにすることが、複数の代替値を提供するための正しい方法です。この技法は変数全体を解釈するのにより時間が掛かるので、性能上の問題が見られます。 +代替値としてのカスタムプロパティを含めるには、上記の 2 番目の例 (`var(--my-var, var(--my-background, pink))`) のようにすることが、`var()` で複数の代替値を提供するための正しい方法です。 +ただし、階層化された変数の解析に時間がかかるため、この方法によるパフォーマンスへの影響を認識しておく必要があります。 > [!NOTE] > 代替値の構文は、[カスタムプロパティ](https://www.w3.org/TR/css-variables/#custom-property)の場合のように、カンマを使用することができます。例えば、 `var(--foo, red, blue)` は `red, blue` という代替値を定義します。最初のカンマから関数の終わりまでが代替値とみなされます。 -## 値と妥当性 +### `@property` の初期値を使用した代替値 -CSS の各プロパティには、定義された値のセットを割り当てることができます。プロパティに有効な値の集合から外れた値を割り当てた場合、そのプロパティは「無効」とみなされます。 +`var()` を使用する以外に、`@property` アットルールで定義された `initial-value` を代替メカニズムとして使用することができます。実際、これはすでに [`@property` の継承](#property_を使用して継承を制御)の節で見てきました。 -ブラウザーは、通常のプロパティに無効な値が設定された場合、その値を破棄し、要素には、その宣言が単に存在しない場合に設定されるはずの値が割り当てられます。 +次の例では、`@property` アットルールを使用して、`--box-color` の初期値を `cornflowerblue` に設定しています。 +アットルールに続くルールセットでは、`--box-color` を `aquamarine` に設定したいのですが、値の名前にタイプミスがあります。 +3 番目の `
` でも同じことが言有効な [`` 値](/ja/docs/Web/CSS/color_value)を期待するカスタムプロパティに `2rem` を使用しています。 +`2rem` と `aqumarine` はどちらもカラー値として無効であるため、`cornflowerblue` の初期値が適用されます。 -しかし、カスタムプロパティの値が解釈されるとき、ブラウザーはその値がどこで使用されるかをまだ知らないので、ほとんどすべての値を*妥当*とみなす必要があります。 +```css live-sample___at-property-initial-value +@property --box-color { + syntax: ""; + initial-value: cornflowerblue; + inherits: false; +} -残念なことに、これらの値は妥当であっても、意味のない可能性がある場所で `var()` 関数表記で使用することができてしまいます。プロパティとカスタム変数が無効な CSS 文を生成する可能性があることから、*計算時に妥当*という新しい概念が導かれます。 +.one { + --box-color: aquamarine; + background-color: var(--box-color); +} -ブラウザーが無効な `var()` の置き換えに遭遇した場合、プロパティの[初期値](/ja/docs/Web/CSS/initial_value)または[継承値](/ja/docs/Web/CSS/Inheritance)が使用されます。 +.two { + --box-color: aqumarine; + background-color: var(--box-color); +} -次の 2 つの例でこれを説明します。 +.three { + --box-color: 2rem; + background-color: var(--box-color); +} +``` -### 無効な通常プロパティ +```css hidden live-sample___at-property-initial-value +div { + color: white; + font-family: sans-serif; + width: 100px; + height: 100px; + margin: 4px; + padding: 8px; + border: 2px black solid; + display: inline-block; +} +.one { + color: black; +} +``` -この例では、`16px` という値を {{cssxref("color")}} プロパティに適用しようとしています。これは無効であるため、CSS は破棄され、結果はルールが存在しなかったかのようになり、代わりに前回の `color: blue` ルールが適用され、段落は青色となります。 +```html hidden live-sample___at-property-initial-value +
+

One

+
+
+

Two.

+
+
+

Three.

+
+``` -#### HTML +{{embedlivesample("at-property-initial-value", "100%", "150px")}} -```html -

この段落は初期値で黒です。

-``` +## 無効なカスタムプロパティ -#### CSS +CSS の各プロパティには、定義された[値のセット](/ja/docs/Learn/CSS/Building_blocks/Values_and_units)を割り当てることができます。 +プロパティに有効な値の集合から外れた値を割り当てた場合、そのプロパティは「無効」とみなされます。 -```css +ブラウザーが通常の CSS プロパティの無効な値（例えば、{{cssxref("color")}} プロパティにおける `16px` という値）に遭遇すると、その宣言は破棄され、要素には宣言が存在しなかった場合の値が割り当てられます。 +次の例では、通常のCSS宣言が無効である場合の挙動を示しています。 `color: 16px;` は無視され、代わりに以前の `color: blue` ルールが適用されます。 + +```html live-sample___invalid-property +

この段落は初期状態で黒です。

+``` + +```css live-sample___invalid-property p { color: blue; } p { + /* おっと、有効な色ではない */ color: 16px; } ``` -#### 結果 +{{EmbedLiveSample('invalid-property', 100, 50)}} -{{EmbedLiveSample('Invalid normal properties', 100, 100)}} +しかし、カスタムプロパティの値が解釈される際には、ブラウザーはまだそれらがどこで使用されるのかを知りません。そのため、ほぼすべての値を _有効_ とみなさなければなりません。 +残念ながら、これらの有効な値は、`var()` 関数記法によって、意味をなさない可能性のあるコンテキストで使用されてしまうことがあります。 +プロパティとカスタム変数は、無効な CSS 文につながる可能性があり、「計算時に有効」という概念につながります。 -### 無効なカスタムプロパティ +ブラウザが無効な `var()` 置換に遭遇した場合は、プロパティの[初期値](/ja/docs/Web/CSS/initial_value)または[継承値](/ja/docs/Web/CSS/Inheritance)が使用されます。 +この例は、カスタムプロパティを使用している点を除いて、最後の例と同じです。 -この例は前回のものと同様ですが、カスタムプロパティを使用しています。 - -期待通りに、ブラウザーは `--text-color` の値で `var(--text-color)` の場所を置き換えようとしますが、 `16px` は {{cssxref("color")}} に妥当なプロパティ値ではありません。置き換え後、プロパティは意味をなさなくなります。ブラウザーはこの状況を 2 段階で扱います。 +期待通りに、ブラウザーは `--text-color` の値で `var(--text-color)` の場所を置き換えようとしますが、 `16px` は {{cssxref("color")}} に妥当なプロパティ値ではありません。 +置き換え後、プロパティは意味をなさなくなります。ブラウザーはこの状況を 2 段階で扱います。 1. {{cssxref("color")}} プロパティが継承可能であるかを確認します。可能ですが、 `

` には `color` プロパティを持つ親がありません。よって次の段階に進みます。 2. 値を**既定の初期値**、つまり、黒に設定します。 -#### HTML +```html live-sample___invalid-custom-property +

この段落は初期状態で黒です。

+``` -```html -

この段落は初期値で黒です。

+```css live-sample___invalid-custom-property +:root { + --text-color: 16px; +} + +p { + color: blue; +} + +p { + color: var(--text-color); +} ``` -#### CSS +{{EmbedLiveSample('invalid-custom-property', 100, 50)}} + +このような場合、`@property` アットルールを使用してプロパティの初期値を定義することで、予期せぬ結果を防ぐことができます。 + +```html live-sample___invalid-custom-property-fallbacks +

この段落は初期状態で黒です。

+``` + +```css live-sample___invalid-custom-property-fallbacks +@property --text-color { + syntax: ""; + inherits: false; + initial-value: cornflowerblue; +} -```css :root { --text-color: 16px; } @@ -293,9 +516,7 @@ p { } ``` -#### 結果 - -{{EmbedLiveSample('Invalid custom properties', 100, 100)}} +{{EmbedLiveSample('invalid-custom-property-fallbacks', 100, 50)}} ## JavaScript での値 @@ -315,4 +536,7 @@ element.style.setProperty("--my-var", jsVar + 4); ## 関連情報 - [カスタムプロパティの構文](/ja/docs/Web/CSS/--*) +- {{cssxref("@property")}} アットルール - [`var()`](/ja/docs/Web/CSS/var) +- [CSS プロパティと値 API](/ja/docs/Web/API/CSS_Properties_and_Values_API) +- [カスケード変数のための CSS カスタムプロパティ](/ja/docs/Web/CSS/CSS_cascading_variables)モジュール From 149bbaf4f67f34dbf4e53efddd8b7aae49e8f23b Mon Sep 17 00:00:00 2001 From: nekonado Date: Sun, 6 Oct 2024 01:23:12 +0900 Subject: [PATCH 170/215] =?UTF-8?q?fix:=20`Number.prototype.toFixed()`=20?= =?UTF-8?q?=E3=83=9A=E3=83=BC=E3=82=B8=E3=81=AE=E8=AA=A4=E5=AD=97=E3=82=92?= =?UTF-8?q?=E4=BF=AE=E6=AD=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit URL: https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/Number/toFixed --- .../javascript/reference/global_objects/number/tofixed/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/ja/web/javascript/reference/global_objects/number/tofixed/index.md b/files/ja/web/javascript/reference/global_objects/number/tofixed/index.md index d3450c85287b4c..dd2d4e5f5a5519 100644 --- a/files/ja/web/javascript/reference/global_objects/number/tofixed/index.md +++ b/files/ja/web/javascript/reference/global_objects/number/tofixed/index.md @@ -79,7 +79,7 @@ numObj.toFixed(6); // '12345.678900'を返す。0 を追加 ### toFixed() を負の数に使用 -メンバーアクセスは単項マイナスよりも[優先順位](/ja/docs/Web/JavaScript/Reference/Operators/Operator_precedence)が高いので、文字列を取得するためには。負の数の式全体をグループ化する必要があります。 +メンバーアクセスは単項マイナスよりも[優先順位](/ja/docs/Web/JavaScript/Reference/Operators/Operator_precedence)が高いので、文字列を取得するためには負の数の式全体をグループ化する必要があります。 ```js-nolint -2.34.toFixed(1); // -2.3, a number From 4bc75a61074cb9d367a8820fd4fcd0eb74e6bc58 Mon Sep 17 00:00:00 2001 From: MDN Web Docs GitHub Bot <108879845+mdn-bot@users.noreply.github.com> Date: Sun, 6 Oct 2024 20:00:02 +0100 Subject: [PATCH 171/215] [ru] sync translated content (#23911) ru: sync translated content --- files/ru/_redirects.txt | 1 + files/ru/_wikihistory.json | 8 ++++---- files/ru/web/api/{ => window}/setinterval/index.md | 3 ++- 3 files changed, 7 insertions(+), 5 deletions(-) rename files/ru/web/api/{ => window}/setinterval/index.md (99%) diff --git a/files/ru/_redirects.txt b/files/ru/_redirects.txt index a5d67c5d0a01ce..1d85f8101e2f8d 100644 --- a/files/ru/_redirects.txt +++ b/files/ru/_redirects.txt @@ -521,6 +521,7 @@ /ru/docs/Web/API/origin /ru/docs/Web/API/Window/origin /ru/docs/Web/API/performance_property /ru/docs/Web/API/Window/performance /ru/docs/Web/API/range.getBoundingClientRect /ru/docs/Web/API/Range/getBoundingClientRect +/ru/docs/Web/API/setInterval /ru/docs/Web/API/Window/setInterval /ru/docs/Web/API/Видимость_страницы_API /ru/docs/Web/API/Page_Visibility_API /ru/docs/Web/Apps/Fundamentals/Audio_and_video_delivery/Adding_captions_and_subtitles_to_HTML5_video /ru/docs/Web/Media/Audio_and_video_delivery/Adding_captions_and_subtitles_to_HTML5_video /ru/docs/Web/Apps/Fundamentals/Audio_and_video_delivery/buffering_seeking_time_ranges /ru/docs/Web/Media/Audio_and_video_delivery/buffering_seeking_time_ranges diff --git a/files/ru/_wikihistory.json b/files/ru/_wikihistory.json index 701eb2b01ca0ca..93a8b67bda11dd 100644 --- a/files/ru/_wikihistory.json +++ b/files/ru/_wikihistory.json @@ -7486,6 +7486,10 @@ "shimopus" ] }, + "Web/API/Window/setInterval": { + "modified": "2020-11-18T12:13:20.493Z", + "contributors": ["kosarev_va", "WhiteApfel", "lilka9", "AliaksandrZahorski"] + }, "Web/API/Window/stop": { "modified": "2019-03-23T22:28:10.946Z", "contributors": ["maximTorba"] @@ -7791,10 +7795,6 @@ "modified": "2020-10-15T22:00:31.979Z", "contributors": ["ekirpichyov", "ArtemPolanskiy"] }, - "Web/API/setInterval": { - "modified": "2020-11-18T12:13:20.493Z", - "contributors": ["kosarev_va", "WhiteApfel", "lilka9", "AliaksandrZahorski"] - }, "Web/API/setTimeout": { "modified": "2020-11-18T12:03:29.649Z", "contributors": [ diff --git a/files/ru/web/api/setinterval/index.md b/files/ru/web/api/window/setinterval/index.md similarity index 99% rename from files/ru/web/api/setinterval/index.md rename to files/ru/web/api/window/setinterval/index.md index e0ffae5659b38a..daeb52a644f412 100644 --- a/files/ru/web/api/setinterval/index.md +++ b/files/ru/web/api/window/setinterval/index.md @@ -1,6 +1,7 @@ --- title: Глобальная функция setInterval() -slug: Web/API/setInterval +slug: Web/API/Window/setInterval +original_slug: Web/API/setInterval --- {{APIRef("HTML DOM")}}{{AvailableInWorkers}} From a1a3654727997988ec9ee47dc43908835b278ed3 Mon Sep 17 00:00:00 2001 From: MDN Web Docs GitHub Bot <108879845+mdn-bot@users.noreply.github.com> Date: Mon, 7 Oct 2024 02:34:46 +0100 Subject: [PATCH 172/215] [pt-br] sync translated content (#23882) pt-br: sync translated content --- files/pt-br/_redirects.txt | 12 ++++--- files/pt-br/_wikihistory.json | 32 +++++++++---------- .../web/http}/index.md | 3 +- .../web/api/{ => window}/setinterval/index.md | 3 +- .../mime_types/common_types/index.md | 3 +- .../{basics_of_http => }/mime_types/index.md | 3 +- 6 files changed, 32 insertions(+), 24 deletions(-) rename files/pt-br/{web/http/basics_of_http => conflicting/web/http}/index.md (98%) rename files/pt-br/web/api/{ => window}/setinterval/index.md (99%) rename files/pt-br/web/http/{basics_of_http => }/mime_types/common_types/index.md (99%) rename files/pt-br/web/http/{basics_of_http => }/mime_types/index.md (99%) diff --git a/files/pt-br/_redirects.txt b/files/pt-br/_redirects.txt index fe8690bdb4140c..848ca531656020 100644 --- a/files/pt-br/_redirects.txt +++ b/files/pt-br/_redirects.txt @@ -638,7 +638,7 @@ /pt-BR/docs/Web/API/WindowOrWorkerGlobalScope/atob /pt-BR/docs/Web/API/Window/atob /pt-BR/docs/Web/API/WindowOrWorkerGlobalScope/clearTimeout /pt-BR/docs/Web/API/clearTimeout /pt-BR/docs/Web/API/WindowOrWorkerGlobalScope/fetch /pt-BR/docs/Web/API/Window/fetch -/pt-BR/docs/Web/API/WindowOrWorkerGlobalScope/setInterval /pt-BR/docs/Web/API/setInterval +/pt-BR/docs/Web/API/WindowOrWorkerGlobalScope/setInterval /pt-BR/docs/Web/API/Window/setInterval /pt-BR/docs/Web/API/WindowTimers.clearTimeout /pt-BR/docs/Web/API/clearTimeout /pt-BR/docs/Web/API/WindowTimers/clearTimeout /pt-BR/docs/Web/API/clearTimeout /pt-BR/docs/Web/API/XMLDocument/async /pt-BR/docs/conflicting/Web/API/XMLDocument @@ -670,6 +670,7 @@ /pt-BR/docs/Web/API/notificacoes /pt-BR/docs/Web/API/Notification /pt-BR/docs/Web/API/origin /pt-BR/docs/Web/API/Window/origin /pt-BR/docs/Web/API/performance_property /pt-BR/docs/Web/API/Window/performance +/pt-BR/docs/Web/API/setInterval /pt-BR/docs/Web/API/Window/setInterval /pt-BR/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_alert_role /pt-BR/docs/Web/Accessibility/ARIA/Roles/alert_role /pt-BR/docs/Web/Accessibility/ARIA/ARIA_Techniques/Utilizando_o_alert_role /pt-BR/docs/Web/Accessibility/ARIA/Roles/alert_role /pt-BR/docs/Web/Accessibility/ARIA/ARIA_Test_Cases /pt-BR/docs/Web/Accessibility/ARIA @@ -814,11 +815,14 @@ /pt-BR/docs/Web/HTML/ReferenciaHTML /pt-BR/docs/Web/HTML/Reference /pt-BR/docs/Web/HTML/formatos_midia_suportados /pt-BR/docs/Web/Media/Formats /pt-BR/docs/Web/HTML/microformatos /pt-BR/docs/Web/HTML/microformats -/pt-BR/docs/Web/HTTP/Basico_sobre_HTTP /pt-BR/docs/Web/HTTP/Basics_of_HTTP +/pt-BR/docs/Web/HTTP/Basico_sobre_HTTP /pt-BR/docs/conflicting/Web/HTTP /pt-BR/docs/Web/HTTP/Basico_sobre_HTTP/Identifying_resources_on_the_Web /pt-BR/docs/orphaned/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web -/pt-BR/docs/Web/HTTP/Basico_sobre_HTTP/MIME_types /pt-BR/docs/Web/HTTP/Basics_of_HTTP/MIME_types -/pt-BR/docs/Web/HTTP/Basico_sobre_HTTP/MIME_types/Complete_list_of_MIME_types /pt-BR/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types +/pt-BR/docs/Web/HTTP/Basico_sobre_HTTP/MIME_types /pt-BR/docs/Web/HTTP/MIME_types +/pt-BR/docs/Web/HTTP/Basico_sobre_HTTP/MIME_types/Complete_list_of_MIME_types /pt-BR/docs/Web/HTTP/MIME_types/Common_types +/pt-BR/docs/Web/HTTP/Basics_of_HTTP /pt-BR/docs/conflicting/Web/HTTP /pt-BR/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web /pt-BR/docs/orphaned/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web +/pt-BR/docs/Web/HTTP/Basics_of_HTTP/MIME_types /pt-BR/docs/Web/HTTP/MIME_types +/pt-BR/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types /pt-BR/docs/Web/HTTP/MIME_types/Common_types /pt-BR/docs/Web/HTTP/Cabecalhos_HTTP /pt-BR/docs/Web/HTTP/Headers /pt-BR/docs/Web/HTTP/Compressão /pt-BR/docs/Web/HTTP/Compression /pt-BR/docs/Web/HTTP/Controle_Acesso_CORS /pt-BR/docs/Web/HTTP/CORS diff --git a/files/pt-br/_wikihistory.json b/files/pt-br/_wikihistory.json index f6a8bc497c8211..111cbd07d6699a 100644 --- a/files/pt-br/_wikihistory.json +++ b/files/pt-br/_wikihistory.json @@ -4092,6 +4092,10 @@ "modified": "2019-03-23T22:04:49.012Z", "contributors": ["jika"] }, + "Web/API/Window/setInterval": { + "modified": "2020-10-15T22:16:56.864Z", + "contributors": ["luan0ap"] + }, "Web/API/Window/storage_event": { "modified": "2019-03-23T22:03:39.969Z", "contributors": ["GPrimola", "gustavoverasmorais"] @@ -4237,10 +4241,6 @@ "modified": "2019-03-18T21:45:25.881Z", "contributors": ["raduq"] }, - "Web/API/setInterval": { - "modified": "2020-10-15T22:16:56.864Z", - "contributors": ["luan0ap"] - }, "Web/Accessibility": { "modified": "2019-09-09T14:18:55.700Z", "contributors": [ @@ -6187,18 +6187,6 @@ "modified": "2019-03-18T20:54:05.177Z", "contributors": ["ViniciusMatias"] }, - "Web/HTTP/Basics_of_HTTP": { - "modified": "2019-03-18T20:54:14.334Z", - "contributors": ["mauromattos00", "wdot789"] - }, - "Web/HTTP/Basics_of_HTTP/MIME_types": { - "modified": "2019-12-16T17:35:45.160Z", - "contributors": ["JpOnline", "hugojunior", "marcusedu"] - }, - "Web/HTTP/Basics_of_HTTP/MIME_types/Common_types": { - "modified": "2019-03-23T22:04:21.860Z", - "contributors": ["khalid_ait", "berbare", "lpdouglas"] - }, "Web/HTTP/CORS": { "modified": "2020-10-15T21:51:46.835Z", "contributors": [ @@ -6643,6 +6631,14 @@ "modified": "2020-10-15T22:31:47.343Z", "contributors": ["FernandoKGA"] }, + "Web/HTTP/MIME_types": { + "modified": "2019-12-16T17:35:45.160Z", + "contributors": ["JpOnline", "hugojunior", "marcusedu"] + }, + "Web/HTTP/MIME_types/Common_types": { + "modified": "2019-03-23T22:04:21.860Z", + "contributors": ["khalid_ait", "berbare", "lpdouglas"] + }, "Web/HTTP/Messages": { "modified": "2020-04-19T17:43:58.667Z", "contributors": ["satoLG", "jamrocha"] @@ -10635,6 +10631,10 @@ "modified": "2019-03-23T22:43:02.407Z", "contributors": ["expalmer", "fellyph"] }, + "conflicting/Web/HTTP": { + "modified": "2019-03-18T20:54:14.334Z", + "contributors": ["mauromattos00", "wdot789"] + }, "conflicting/Web/HTTP/CORS": { "modified": "2020-04-19T11:26:06.291Z", "contributors": ["marcio1002"] diff --git a/files/pt-br/web/http/basics_of_http/index.md b/files/pt-br/conflicting/web/http/index.md similarity index 98% rename from files/pt-br/web/http/basics_of_http/index.md rename to files/pt-br/conflicting/web/http/index.md index 00a26fc059eb1c..ad60f9956ab7d4 100644 --- a/files/pt-br/web/http/basics_of_http/index.md +++ b/files/pt-br/conflicting/web/http/index.md @@ -1,6 +1,7 @@ --- title: Básico sobre HTTP -slug: Web/HTTP/Basics_of_HTTP +slug: conflicting/Web/HTTP +original_slug: Web/HTTP/Basics_of_HTTP --- {{HTTPSidebar}} diff --git a/files/pt-br/web/api/setinterval/index.md b/files/pt-br/web/api/window/setinterval/index.md similarity index 99% rename from files/pt-br/web/api/setinterval/index.md rename to files/pt-br/web/api/window/setinterval/index.md index 074b70005bccee..629cfc8f13d6ce 100644 --- a/files/pt-br/web/api/setinterval/index.md +++ b/files/pt-br/web/api/window/setinterval/index.md @@ -1,6 +1,7 @@ --- title: WindowOrWorkerGlobalScope.setInterval() -slug: Web/API/setInterval +slug: Web/API/Window/setInterval +original_slug: Web/API/setInterval --- {{APIRef("HTML DOM")}} diff --git a/files/pt-br/web/http/basics_of_http/mime_types/common_types/index.md b/files/pt-br/web/http/mime_types/common_types/index.md similarity index 99% rename from files/pt-br/web/http/basics_of_http/mime_types/common_types/index.md rename to files/pt-br/web/http/mime_types/common_types/index.md index 5880ec623ddd2a..ae09b8dfd5f3f9 100644 --- a/files/pt-br/web/http/basics_of_http/mime_types/common_types/index.md +++ b/files/pt-br/web/http/mime_types/common_types/index.md @@ -1,6 +1,7 @@ --- title: Lista Incompleta de tipos MIME -slug: Web/HTTP/Basics_of_HTTP/MIME_types/Common_types +slug: Web/HTTP/MIME_types/Common_types +original_slug: Web/HTTP/Basics_of_HTTP/MIME_types/Common_types --- {{HTTPSidebar}} diff --git a/files/pt-br/web/http/basics_of_http/mime_types/index.md b/files/pt-br/web/http/mime_types/index.md similarity index 99% rename from files/pt-br/web/http/basics_of_http/mime_types/index.md rename to files/pt-br/web/http/mime_types/index.md index 204083d2679e9c..28fbccc5b38915 100644 --- a/files/pt-br/web/http/basics_of_http/mime_types/index.md +++ b/files/pt-br/web/http/mime_types/index.md @@ -1,6 +1,7 @@ --- title: MIME types -slug: Web/HTTP/Basics_of_HTTP/MIME_types +slug: Web/HTTP/MIME_types +original_slug: Web/HTTP/Basics_of_HTTP/MIME_types --- {{HTTPSidebar}} From ebd4c8f002ff9fa44fc5c40a9e9022a9b68b57aa Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Mon, 7 Oct 2024 10:16:24 +0800 Subject: [PATCH 173/215] zh-CN: create `extension.sendRequest()` (#23535) Co-authored-by: A1lo --- .../api/extension/sendrequest/index.md | 77 +++++++++++++++++++ 1 file changed, 77 insertions(+) create mode 100644 files/zh-cn/mozilla/add-ons/webextensions/api/extension/sendrequest/index.md diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/extension/sendrequest/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/extension/sendrequest/index.md new file mode 100644 index 00000000000000..b5b41560987262 --- /dev/null +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/extension/sendrequest/index.md @@ -0,0 +1,77 @@ +--- +title: extension.sendRequest() +slug: Mozilla/Add-ons/WebExtensions/API/extension/sendRequest +l10n: + sourceCommit: 5f090dea2cacee4ff4f654241f017a9f6649124e +--- + +{{AddonSidebar}}{{Deprecated_Header}} + +> [!WARNING] +> 该方法已被弃用。请改用 {{WebExtAPIRef("runtime.sendMessage")}}。 + +向插件中其他的监听器发送请求。该方法类似于 {{WebExtAPIRef('runtime.connect')}}，但它只能发送可选地带有响应的单一请求。发送请求后在扩展的每个页面中，{{WebExtAPIRef('extension.onRequest')}} 事件都会触发。 + +## 语法 + +```js-nolint +chrome.extension.sendRequest( + extensionId, // 可选的字符串 + request, // 任意类型 + (response) => {/* … */} // 可选的函数 +) +``` + +该 API 的返回 promise 的版本同样以 `browser.extension.sendRequest()` 的形式可用。 + +### 参数 + +- `extensionId` {{optional_inline}} + - : `string`，你所希望连接到的扩展的 ID。如果省略，则默认为你自己的扩展。 +- `request` + - : `any`。 +- `responseCallback` {{optional_inline}} + + - : `function`，将传递如下参数的函数： + + - `response` + - : `any`，由请求处理器发送的 JSON 响应对象。如果在连接到插件时发生错误，回调函数将不带参数地被调用，且 {{WebExtAPIRef('runtime.lastError')}} 将被设置为错误消息。 + +## 浏览器兼容性 + +{{Compat}} + +{{WebExtExamples}} + +> [!NOTE] +> 此 API 基于 Chromium 的 [`chrome.extension`](https://developer.chrome.google.cn/docs/extensions/reference/api/extension/#method-sendRequest) API。该文档衍生自 Chromium 代码中的 [`extension.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/extension.json)。 + + From dd594a55244f5586d7c5d1f0c2e1888545488643 Mon Sep 17 00:00:00 2001 From: A1lo Date: Mon, 7 Oct 2024 11:40:11 +0800 Subject: [PATCH 174/215] zh-cn: update the translation of `Document.hasStorageAccess()` (#23900) --- .../api/document/hasstorageaccess/index.md | 58 +++++++++++++------ 1 file changed, 41 insertions(+), 17 deletions(-) diff --git a/files/zh-cn/web/api/document/hasstorageaccess/index.md b/files/zh-cn/web/api/document/hasstorageaccess/index.md index 7f64bcea5b066e..f853db18ea8bcb 100644 --- a/files/zh-cn/web/api/document/hasstorageaccess/index.md +++ b/files/zh-cn/web/api/document/hasstorageaccess/index.md @@ -1,49 +1,73 @@ --- -title: Document.hasStorageAccess() +title: Document：hasStorageAccess() 方法 slug: Web/API/Document/hasStorageAccess +l10n: + sourceCommit: be8f7f155a48e11b30c240f8731afb1845f85378 --- -{{APIRef}}{{seecompattable}}{{domxref("Document")}}的**`hasStorageAccess()`** 方法返回了一个{{jsxref("Promise")}}来判断该文档是否有访问第一方储存的权限。 +{{APIRef("Storage Access API")}} -通过 [Storage Access API](/zh-CN/docs/Web/API/Storage_Access_API) 获取更多信息。 +{{domxref("Document")}} 接口的 **`hasStorageAccess()`** 方法返回一个会兑现为指示文档是否有权访问[第三方](/zh-CN/docs/Web/Privacy/Third-party_cookies)[未分区](/zh-CN/docs/Web/API/Storage_Access_API#未分区_cookie_与分区_cookie_的对比) cookie 的布尔值的 {{jsxref("Promise")}}。 + +此方法属于[存储访问 API](/zh-CN/docs/Web/API/Storage_Access_API)。 + +> [!NOTE] +> 此方法是 {{DOMxRef("Document.hasUnpartitionedCookieAccess()")}} 的别名。目前没有计划删除此方法而采用 {{DOMxRef("Document.hasUnpartitionedCookieAccess()")}}。 ## 语法 -```plain -var promise = document.hasStorageAccess(); +```js-nolint +hasStorageAccess() ``` ### 参数 -None. +无。 ### 返回值 -一个用来判断文档是否有权利访问其第一方存储的{{jsxref("Promise")}} 。 +一个 {{jsxref("Promise")}}，会兑现一个指示文档是否有权访问第三方 cookie 的布尔值——如果可以，则返回 `true`，否则返回 `false`。 + +在以下几种情况下，此方法返回的结果可能不准确： + +1. 用户可能激活了浏览器的阻止第三方 cookie 的设置；在这种情况下，即使第三方 cookie 仍然无法访问，也可能返回 `true`。要处理这种情况，你应该优雅地处理由于无法检索 cookie 值而导致的任何错误；例如，通知用户他们的个性化设置被阻止访问，并邀请他们重新登录以使用这些设置。 +2. 浏览器可能不会默认阻止第三方 cookie 的访问；在这种情况下，即使第三方 cookie 可以访问，也可能返回 `false`，并且不需要请求存储访问权限（例如通过 {{domxref("Document.requestStorageAccess()")}}）。要解决这个问题，你可以查询 {{domxref("Document.cookie")}} 来确定是否可以访问 cookie，如果不可访问，则调用 {{domxref("Document.requestStorageAccess()")}}。 -If the promise gets resolved and a user gesture event was being processed when the function was originally called, the resolve handler will run as if a user gesture was being processed, so it will be able to call APIs that require user activation. +> [!NOTE] +> 如果 promise 得到兑现，并且在最初调用函数时正在处理用户手势事件，则兑现处理器运行的时候就好像正在处理用户手势，因此它将能够调用需要用户激活的 API。 -## Examples +### 异常 + +- `InvalidStateError` {{domxref("DOMException")}} + - : 如果当前{{domxref("Document", "文档", "", 1)}}尚未激活，则抛出此异常。 + +## 示例 ```js document.hasStorageAccess().then((hasAccess) => { if (hasAccess) { - // storage access has been granted already. + // 已获得存储访问权限。 + console.log("已获得 cookie 访问权限"); } else { - // storage access hasn't been granted already; - // you may want to call requestStorageAccess(). + // 尚未获得存储访问权限；你可能需要调用 requestStorageAccess()。 + console.log("尚未获得 cookie 访问权限"); } }); ``` -## Specifications +> [!NOTE] +> 参见[使用存储访问 API](/zh-CN/docs/Web/API/Storage_Access_API/Using) 以获取更完整的示例。 + +## 规范 -The API is currently only at the proposal stage — the standardization process has yet to begin. You can currently find specification details of the API at Apple's [Introducing Storage Access API](https://webkit.org/blog/8124/introducing-storage-access-api/) blog post, and [WHATWG HTML issue 3338 — Proposal: Storage Access API](https://github.com/whatwg/html/issues/3338). +{{Specifications}} -## Browser compatibility +## 浏览器兼容性 {{Compat}} -## See also +## 参见 -[Storage Access API](/zh-CN/docs/Web/API/Storage_Access_API) +- {{domxref("Document.hasUnpartitionedCookieAccess()")}}、{{domxref("Document.requestStorageAccess()")}}、{{domxref("Document.requestStorageAccessFor()")}} +- [使用存储访问 API](/zh-CN/docs/Web/API/Storage_Access_API/Using) +- [介绍存储访问 API](https://webkit.org/blog/8124/introducing-storage-access-api/)（WebKit 博客） From 2fd1b1f9bf883262220e948700668114eb6af6ef Mon Sep 17 00:00:00 2001 From: skyclouds2001 <95597335+skyclouds2001@users.noreply.github.com> Date: Mon, 7 Oct 2024 11:44:58 +0800 Subject: [PATCH 175/215] [zh-CN]: add translation for `KeyboardLayoutMap` (#23855) Co-authored-by: Jason Ren <40999116+jasonren0403@users.noreply.github.com> --- .../zh-cn/web/api/keyboardlayoutmap/index.md | 55 +++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 files/zh-cn/web/api/keyboardlayoutmap/index.md diff --git a/files/zh-cn/web/api/keyboardlayoutmap/index.md b/files/zh-cn/web/api/keyboardlayoutmap/index.md new file mode 100644 index 00000000000000..f5e96a8b37f736 --- /dev/null +++ b/files/zh-cn/web/api/keyboardlayoutmap/index.md @@ -0,0 +1,55 @@ +--- +title: KeyboardLayoutMap +slug: Web/API/KeyboardLayoutMap +l10n: + sourceCommit: e92950d09467164afc9dfd8b35be9c909b63a8ab +--- + +{{SeeCompatTable}}{{APIRef("Keyboard API")}} + +{{domxref("Keyboard API", "", "", "nocode")}} 的 **`KeyboardLayoutMap`** 接口是一个只读对象，具有检索与特定物理按键关联的字符串的功能。 + +`KeyboardLayoutMap` 实例是一个只读的[类 `Map` 对象](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Map#类_map_浏览器_api)，其中每个按键都是一个字符串，用于标识键盘上唯一的物理按键（“按键代码”），相应的值是关联的按键属性值（可能受键盘布局等影响）。 + +在 [UI 事件 KeyboardEvent 代码值](https://www.w3.org/TR/uievents-code/#key-alphanumeric-writing-system)规范中可以找到有效按键的列表。 + +## 实例属性 + +- {{domxref('KeyboardLayoutMap.size')}} {{ReadOnlyInline}} {{experimental_inline}} + - : 返回 `KeyboardLayoutMap` 对象中的元素数量。 + +## 实例方法 + +- `KeyboardLayoutMap[Symbol.iterator]()` {{experimental_inline}} + - : 返回一个包含键/值对的新 [Iterator](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Iterator) 对象。 +- {{domxref('KeyboardLayoutMap.entries()')}} {{experimental_inline}} + - : 返回一个包含键/值对的新 [Iterator](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Iterator) 对象。 +- {{domxref('KeyboardLayoutMap.forEach()')}} {{experimental_inline}} + - : 为 `KeyboardLayoutMap` 的每个元素执行一次提供的函数。 +- {{domxref('KeyboardLayoutMap.get()')}} {{experimental_inline}} + - : 从 `KeyboardLayoutMap` 对象返回具有给定键的元素。 +- {{domxref('KeyboardLayoutMap.has()')}} {{experimental_inline}} + - : 返回一个布尔值，指示 `KeyboardLayoutMap` 对象是否具有带指定键的元素。 +- {{domxref('KeyboardLayoutMap.keys()')}} {{experimental_inline}} + - : 返回一个新的 [Iterator](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Iterator) 对象，该对象包含 `KeyboardLayoutMap` 对象中每个索引的键。 +- {{domxref('KeyboardLayoutMap.values()')}} {{experimental_inline}} + - : 返回一个新的 [Iterator](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Iterator) 对象，该对象包含 `KeyboardLayoutMap` 对象中每个索引的值。 + +## 示例 + +以下示例说明如何获取与英语 QWERTY 键盘上“W”键对应的键盘代码关联的位置或布局特定字符串。 + +```js +navigator.keyboard.getLayoutMap().then((keyboardLayoutMap) => { + const upKey = keyboardLayoutMap.get("KeyW"); + window.alert(`按 ${upKey} 向上移动。`); +}); +``` + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} From e5bdfca27b4cd7192fb78dc3828481e65e00c565 Mon Sep 17 00:00:00 2001 From: mdn-bot <108879845+mdn-bot@users.noreply.github.com> Date: Mon, 7 Oct 2024 00:34:44 +0000 Subject: [PATCH 176/215] ja: auto-fix Markdownlint issues --- files/ja/web/javascript/reference/global_objects/map/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/files/ja/web/javascript/reference/global_objects/map/index.md b/files/ja/web/javascript/reference/global_objects/map/index.md index ac5427cbdfb4f5..757df631d24665 100644 --- a/files/ja/web/javascript/reference/global_objects/map/index.md +++ b/files/ja/web/javascript/reference/global_objects/map/index.md @@ -311,8 +311,8 @@ const keyFunc = function () {}; // 値を設定する myMap.set(keyString, "'文字列' と結び付けられた値"); -myMap.set(keyObj, 'keyObj と結び付けられた値'); -myMap.set(keyFunc, 'keyFunc と結び付けられた値'); +myMap.set(keyObj, "keyObj と結び付けられた値"); +myMap.set(keyFunc, "keyFunc と結び付けられた値"); console.log(myMap.size); // 3 From 92e84173e2e2381b5597062fd745c513090e527f Mon Sep 17 00:00:00 2001 From: foirien <77210018+foirien@users.noreply.github.com> Date: Mon, 7 Oct 2024 16:22:04 +0200 Subject: [PATCH 177/215] Correction d'une coquille orthographique (#23917) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Correction d'une coquille orthgraphique Participe passé "rafraîchit" remplacé par "rafraîchi" --- files/fr/learn/javascript/objects/basics/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/fr/learn/javascript/objects/basics/index.md b/files/fr/learn/javascript/objects/basics/index.md index d9859e66bf1ecb..afa49259501b79 100644 --- a/files/fr/learn/javascript/objects/basics/index.md +++ b/files/fr/learn/javascript/objects/basics/index.md @@ -77,7 +77,7 @@ var personne = { }; ``` -Après avoir sauvegardé et rafraîchit la page, essayez d'entrer les lignes suivantes dans le champ de saisie `input` : +Après avoir sauvegardé et rafraîchi la page, essayez d'entrer les lignes suivantes dans le champ de saisie `input` : ```js personne.nom; From dd5a9882ae7a39cbc618c79baf7d7e0d142c8f40 Mon Sep 17 00:00:00 2001 From: applemango <85370582+applemango@users.noreply.github.com> Date: Mon, 7 Oct 2024 18:33:01 +0900 Subject: [PATCH 178/215] =?UTF-8?q?[ja]=20fix=20typo=20`=E3=81=97=E3=81=AA?= =?UTF-8?q?=E3=81=91=E3=82=8C=E3=81=B0=E3=81=AA=E3=82=89=E3=81=AA=E3=82=8A?= =?UTF-8?q?=E3=81=BE=E3=81=99`=20->=20`=E3=81=97=E3=81=AA=E3=81=91?= =?UTF-8?q?=E3=82=8C=E3=81=B0=E3=81=AA=E3=82=89=E3=81=AA=E3=81=8F=E3=81=AA?= =?UTF-8?q?=E3=82=8A=E3=81=BE=E3=81=99`?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- files/ja/web/html/element/iframe/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/ja/web/html/element/iframe/index.md b/files/ja/web/html/element/iframe/index.md index ea84cf9638f7d9..1ecc86e47b72aa 100644 --- a/files/ja/web/html/element/iframe/index.md +++ b/files/ja/web/html/element/iframe/index.md @@ -206,7 +206,7 @@ DOM の {{domxref("HTMLIFrameElement")}} オブジェクトでは、スクリプ src="https://en.wikipedia.org/wiki/Avocado"> ``` -この title がないと、埋め込みコンテンツが何であるかを特定するために `