From 094ab5cae7b3132b21690ee70454557375c74e4d Mon Sep 17 00:00:00 2001 From: A1lo Date: Fri, 24 Nov 2023 17:34:50 +0800 Subject: [PATCH 01/31] chore(zh): content clean up for markdown-lint-cli bump (#17083) Co-authored-by: Jason Ren <40999116+jasonren0403@users.noreply.github.com> --- files/zh-cn/.markdownlint.jsonc | 3 + files/zh-cn/glossary/grid/index.md | 4 +- .../styling_a_biography_page/index.md | 4 +- .../video_and_audio_content/index.md | 2 +- .../introduction/index.md | 2 +- .../anatomy_of_a_webextension/index.md | 6 +- .../mozilla/firefox/releases/59/index.md | 4 +- files/zh-cn/web/api/canvasgradient/index.md | 10 +- .../putimagedata/index.md | 6 +- .../zh-cn/web/api/document/adoptnode/index.md | 57 +---- .../zh-cn/web/api/domimplementation/index.md | 6 +- .../web/api/dynamicscompressornode/index.md | 2 +- .../element/lostpointercapture_event/index.md | 2 +- files/zh-cn/web/api/event/eventphase/index.md | 4 +- .../web/api/event/originaltarget/index.md | 12 +- files/zh-cn/web/api/fontface/index.md | 14 +- .../using_the_gamepad_api/index.md | 8 +- files/zh-cn/web/api/hashchangeevent/index.md | 22 +- files/zh-cn/web/api/htmlbaseelement/index.md | 10 +- files/zh-cn/web/api/htmlmediaelement/index.md | 32 +-- .../web/api/htmlmediaelement/paused/index.md | 22 +- .../web/api/htmltemplateelement/index.md | 10 +- .../web/api/inputevent/iscomposing/index.md | 28 ++- files/zh-cn/web/api/mathmlelement/index.md | 4 +- files/zh-cn/web/api/messageport/index.md | 21 +- .../web/api/navigator/getusermedia/index.md | 90 ++++---- files/zh-cn/web/api/selection/modify/index.md | 2 +- files/zh-cn/web/api/svgaelement/index.md | 63 ++---- .../index.md | 2 +- .../webgl_model_view_projection/index.md | 4 +- .../writing_websocket_servers/index.md | 4 +- files/zh-cn/web/api/webvr_api/index.md | 85 +++----- .../zh-cn/web/api/window/ondragdrop/index.md | 45 ++-- files/zh-cn/web/api/xmldocument/index.md | 4 +- .../web/css/css_generated_content/index.md | 2 +- .../web/css/overscroll-behavior-y/index.md | 2 +- .../http/headers/permissions-policy/index.md | 18 +- .../index.md | 2 +- .../guide/expressions_and_operators/index.md | 4 - .../guide/numbers_and_dates/index.md | 2 - .../global_objects/math/log1p/index.md | 2 +- .../global_objects/string/replace/index.md | 2 +- .../reference/operators/super/index.md | 2 +- files/zh-cn/web/media/autoplay_guide/index.md | 2 - .../index.md | 2 +- .../svg/attribute/stroke-dasharray/index.md | 4 +- .../web/svg/attribute/stroke-linecap/index.md | 6 +- files/zh-cn/web/svg/attribute/stroke/index.md | 2 +- .../web/svg/attribute/text-anchor/index.md | 2 - .../web/svg/element/animatetransform/index.md | 2 - files/zh-cn/web/svg/element/defs/index.md | 4 +- files/zh-cn/web/svg/element/desc/index.md | 2 +- files/zh-cn/web/svg/element/fefunca/index.md | 2 +- files/zh-cn/web/svg/element/femerge/index.md | 2 +- .../web/svg/element/font-face-src/index.md | 2 +- files/zh-cn/web/svg/element/metadata/index.md | 2 +- files/zh-cn/web/svg/element/title/index.md | 2 +- files/zh-tw/.markdownlint.jsonc | 18 +- files/zh-tw/learn/css/howto/css_faq/index.md | 60 +++--- .../anatomy_of_a_webextension/index.md | 4 +- .../tutorial/basic_animations/index.md | 2 +- files/zh-tw/web/api/customevent/index.md | 4 +- files/zh-tw/web/api/documentfragment/index.md | 2 +- files/zh-tw/web/api/keyboardevent/index.md | 8 +- .../javascript/guide/using_promises/index.md | 2 - .../reference/global_objects/array/index.md | 199 +++++++++--------- .../global_objects/array/indexof/index.md | 2 +- .../reference/statements/continue/index.md | 8 +- .../reference/statements/do...while/index.md | 2 +- .../reference/statements/for/index.md | 2 +- 70 files changed, 409 insertions(+), 570 deletions(-) diff --git a/files/zh-cn/.markdownlint.jsonc b/files/zh-cn/.markdownlint.jsonc index 2ae0cc6dff75e8..90b36b52b2b091 100644 --- a/files/zh-cn/.markdownlint.jsonc +++ b/files/zh-cn/.markdownlint.jsonc @@ -1,5 +1,8 @@ { "extends": "../../.markdownlint.jsonc", + "no-trailing-punctuation": { + "punctuation": ".,;:。," + }, "search-replace": { "rules": [ { diff --git a/files/zh-cn/glossary/grid/index.md b/files/zh-cn/glossary/grid/index.md index 28bd3bc765dcb8..f67e127aaf9356 100644 --- a/files/zh-cn/glossary/grid/index.md +++ b/files/zh-cn/glossary/grid/index.md @@ -11,9 +11,7 @@ slug: Glossary/Grid 如果开发者将内容放置在显式网格之外,或者依赖自动布局的话,网格法 (grid algorithm) 将需要创建额外的 row 或者 column、 {{glossary("grid tracks", "tracks")}} 来包含显示网格之外的内容 {{glossary("grid item", "grid items")}},为此将在隐式网格 (implicit grid) 中创建额外的轨道 (tracks)。_当内容添加到了已定义的 tracks 之外的时候,隐式网格 (implicit grid) 会被自动创建。_ -下面的例子创建了一个有两行三列的显式网格*。*由于超过显式网格可容纳的六个条目,_此网格中的第三行将是一个隐式网格行轨道 (implicit grid_ row track) - -_(注:在容器 div 上用 row 和 column 定义的网格总数,等于 行数乘以列数 个。比如一个容器 div 定义了 2 行 \* 3 列 = 6 个网格,这 6 个就是显式网格,但是假如里面有 8 个 子 div,多出来那 2 个就叫做隐式网格。)_ +下面的例子创建了一个有两行三列的显式网格。由于超过显式网格可容纳的六个条目,此网格中的第三行将是一个*隐式网格*行轨道(implicit grid row track)。 ## 示例 diff --git a/files/zh-cn/learn/css/first_steps/styling_a_biography_page/index.md b/files/zh-cn/learn/css/first_steps/styling_a_biography_page/index.md index 405e50dd3a625f..f2be55585bac50 100644 --- a/files/zh-cn/learn/css/first_steps/styling_a_biography_page/index.md +++ b/files/zh-cn/learn/css/first_steps/styling_a_biography_page/index.md @@ -39,7 +39,7 @@ slug: Learn/CSS/First_steps/Styling_a_biography_page > **备注:** 如果遇到困难,你可以向我求助——参见本页下面的[测评或请求帮助](#测评或请求帮助)部分。 -**让我们来学一些 CSS 样式** +### 让我们来学一些 CSS 样式 接下来的实例是一个个人主页,我们用 CSS 设定它的样式。以下是我用到的一些 CSS 属性,通过这些链接,你可以打开相应的 MDN 页面了解更多。 @@ -83,7 +83,7 @@ slug: Learn/CSS/First_steps/Styling_a_biography_page - 你希望测试的例子的在网络编辑器上的链接。这是很好的做法,因为如果不让帮助你的看到你的程序,他们就很难帮助你解决程序的问题。 - 你的网页的测评页面链接,这样我们就可以找到你所求助的问题。 -**接下来是什么?** +## 接下来是什么? 恭喜你完成了第一个模块的学习。现在你应该对 CSS 有了一个大致的了解 并且能够了解在样式表中发生的大多数事情。在下一个模块[CSS 构建](/zh-CN/docs/Learn/CSS/Building_blocks)中,我们将对一些关键区域进行深入的学习。 diff --git a/files/zh-cn/learn/html/multimedia_and_embedding/video_and_audio_content/index.md b/files/zh-cn/learn/html/multimedia_and_embedding/video_and_audio_content/index.md index 91fe2050eb8eec..c0cd7e11452be3 100644 --- a/files/zh-cn/learn/html/multimedia_and_embedding/video_and_audio_content/index.md +++ b/files/zh-cn/learn/html/multimedia_and_embedding/video_and_audio_content/index.md @@ -282,7 +282,7 @@ WEBVTT > **备注:** 文本轨道会使你的网站更容易被搜索引擎抓取到({{glossary("SEO")}}),由于搜索引擎的文本抓取能力非常强大,使用文本轨道甚至可以让搜索引擎通过视频的内容直接链接。 -## 实践学习:在你的网站上嵌入你自己的视频或音频。 +## 实践学习:在你的网站上嵌入你自己的视频或音频 在这个实践学习当中,我们希望你能够走出去,并且记录一些你自己的视频或者音频 — 如今,大多数手机都能够非常方便的记录视频或者音频,并且你可以将他们上传到你的电脑上面,你可以使用这些功能来记录你的视频或音频。在这时候,你可能需要做一些格式转换,如果是视频的话,你需要将它们转化为 WebM 或者 MP4,如果是音频的话,你需要将它们转化为 MP3 或者 Ogg。不过你并不需要担心,有许多的程序都能够帮你解决这些问题,例如 [Miro Video Converter](http://www.mirovideoconverter.com/) 和 [Audacity](https://sourceforge.net/projects/audacity/)。我们非常希望你能够亲自动手实现它。 diff --git a/files/zh-cn/learn/tools_and_testing/cross_browser_testing/introduction/index.md b/files/zh-cn/learn/tools_and_testing/cross_browser_testing/introduction/index.md index ef850e5d9a8c18..644ea863c2dca0 100644 --- a/files/zh-cn/learn/tools_and_testing/cross_browser_testing/introduction/index.md +++ b/files/zh-cn/learn/tools_and_testing/cross_browser_testing/introduction/index.md @@ -66,7 +66,7 @@ slug: Learn/Tools_and_testing/Cross_browser_testing/Introduction 一个项目的测试和排错工作流可以大致分为如下四个阶段(这只是粗略划分——因人而异): -**初步规划>开发>测试/查错>修复/迭代** +**初步规划** > **开发** > **测试/查错** > **修复/迭代** 步骤 2 到步骤 4 在必要时应多次重复直到开发完成。我们会在后续章节详细探讨测试程序的不同之处,但现在我们只概述每个阶段可能出现的问题。 diff --git a/files/zh-cn/mozilla/add-ons/webextensions/anatomy_of_a_webextension/index.md b/files/zh-cn/mozilla/add-ons/webextensions/anatomy_of_a_webextension/index.md index c1a375c9e4ce37..7abd851483bb63 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/anatomy_of_a_webextension/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/anatomy_of_a_webextension/index.md @@ -47,7 +47,7 @@ slug: Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension 与此同时,你也可以先引入一个后台页面,再在后台页面中引入脚本。这样做能为后台脚本添加 ES 6 模块支持,算是一个优势。 -**manifest.json** +manifest.json 的内容如下: ```json // manifest.json @@ -57,7 +57,7 @@ slug: Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension } ``` -**background-page.html** +background-page.html 的内容如下: ```html @@ -83,7 +83,7 @@ slug: Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension #### 跨域访问 -后台脚本可以向任何拥有[主机权限](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions#%E4%B8%BB%E6%9C%BA%E6%9D%83%E9%99%90)的主机发送 XHR 请求。 +后台脚本可以向任何拥有[主机权限](/zh-CN/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions#主机权限)的主机发送 XHR 请求。 #### 网页内容 diff --git a/files/zh-cn/mozilla/firefox/releases/59/index.md b/files/zh-cn/mozilla/firefox/releases/59/index.md index 32f1b0ab41e4e3..850aa0b1e38e62 100644 --- a/files/zh-cn/mozilla/firefox/releases/59/index.md +++ b/files/zh-cn/mozilla/firefox/releases/59/index.md @@ -90,13 +90,13 @@ _无变化。_ ### SVG -_无变化_ +_无变化。_ ## Mozilla 和附加组件开发者应该注意的变化 ### WebExtensions -_无变化_ +_无变化。_ ## 参见 diff --git a/files/zh-cn/web/api/canvasgradient/index.md b/files/zh-cn/web/api/canvasgradient/index.md index db1ff10040eae5..fb4833b3a5a43c 100644 --- a/files/zh-cn/web/api/canvasgradient/index.md +++ b/files/zh-cn/web/api/canvasgradient/index.md @@ -13,12 +13,12 @@ _不透明对象,没有暴露的属性。_ ## 方法 -_没有继承的方法_ +_没有继承的方法。_ - {{domxref("CanvasGradient.addColorStop()")}} - : 添加一个由偏移(`offset`)和颜色(`color`)定义的断点到渐变中。如果偏移值不在 0 到 1 之间,将抛出`INDEX_SIZE_ERR 错误,如果颜色值不能被解析为有效的 CSS 颜色值 {{cssxref("<color>")}},将抛出 SYNTAX_ERR`错误。 -## 标准 +## 规范 {{Specifications}} @@ -26,7 +26,7 @@ _没有继承的方法_ {{Compat}} -## 请参考 +## 参见 -- 创建方法在{{domxref("CanvasRenderingContext2D")}}. -- {{HTMLElement("canvas")}} 元素及其有关接口{{domxref("HTMLCanvasElement")}}. +- 创建方法在 {{domxref("CanvasRenderingContext2D")}}。 +- {{HTMLElement("canvas")}} 元素及其有关接口 {{domxref("HTMLCanvasElement")}}。 diff --git a/files/zh-cn/web/api/canvasrenderingcontext2d/putimagedata/index.md b/files/zh-cn/web/api/canvasrenderingcontext2d/putimagedata/index.md index b4c8a4693930c5..49a3ab7e5f31d1 100644 --- a/files/zh-cn/web/api/canvasrenderingcontext2d/putimagedata/index.md +++ b/files/zh-cn/web/api/canvasrenderingcontext2d/putimagedata/index.md @@ -16,10 +16,8 @@ void ctx.putImageData(imagedata, dx, dy, dirtyX, dirtyY, dirtyWidth, dirtyHeight ### 参数 -**imageData** - -{{domxref("ImageData")}} ,包含像素值的数组对象。 - +- `imageData` + - : {{domxref("ImageData")}},包含像素值的数组对象。 - `dx` - : 源图像数据在目标画布中的位置偏移量(x 轴方向的偏移量)。 - `dy` diff --git a/files/zh-cn/web/api/document/adoptnode/index.md b/files/zh-cn/web/api/document/adoptnode/index.md index 3ff3cdfac507f5..ce4a1573740ce3 100644 --- a/files/zh-cn/web/api/document/adoptnode/index.md +++ b/files/zh-cn/web/api/document/adoptnode/index.md @@ -7,64 +7,25 @@ slug: Web/API/Document/adoptNode 从其他的 document 文档中获取一个节点。该节点以及它的子树上的所有节点都会从原文档删除 (如果有这个节点的话), 并且它的[`ownerDocument`](/zh-CN/docs/DOM/Node.ownerDocument) 属性会变成当前的 document 文档。之后你可以把这个节点插入到当前文档中。 -**从 Gecko 1.9 (Firefox 3) 开始支持** - ## 语法 -```plain -node = document.adoptNode(externalNode); +```js-nolint +adoptNode(externalNode) ``` -- `node` - - : 导入当前文档的新节点。新节点的 [`parentNode`](/zh-CN/DOM/Node.parentNode) 是 `null`, 因为它还没有插入当前文档的文档树中,属于游离状态。 - `externalNode` - : 将要从外部文档导入的节点。 -## 例子 +## 示例 ```js -// 该函数用来从本文档的第一个 iframe 中获取第一个 element 元素, -// 并插入到当前文档树中 -function getEle() { - var iframe = document.getElementsByTagName("iframe")[0], - ele = iframe.contentWindow.document.body.firstElementChild; - if (ele) { - document.body.appendChild(document.adoptNode(ele)); - } else { - alert("没有更多元素了"); - } -} -document.getElementById("move").onclick = getEle; -``` +const iframe = document.querySelector("iframe"); +const iframeImages = iframe.contentDocument.querySelectorAll("img"); +const newParent = document.getElementById("images"); -HTML 文档 - -```html -// index.html - - - - - index.html - - - - - - - -// iframe.html - - - - - iframe.html - - -

Hello

-

My world!

- - +iframeImages.forEach((imgEl) => { + newParent.appendChild(document.adoptNode(imgEl)); +}); ``` ## 笔记 diff --git a/files/zh-cn/web/api/domimplementation/index.md b/files/zh-cn/web/api/domimplementation/index.md index aa6533def572ba..d69a6e5246ce42 100644 --- a/files/zh-cn/web/api/domimplementation/index.md +++ b/files/zh-cn/web/api/domimplementation/index.md @@ -13,7 +13,7 @@ _这个接口没有特定的属性,并且也没有继承到任何属性。_ ## 方法 -_没有继承的方法_ +_没有继承的方法。_ - {{domxref("DOMImplementation.createDocument()")}} - : 创建并返回一个 {{domxref("XMLDocument")}}对象。 @@ -32,6 +32,6 @@ _没有继承的方法_ {{Compat}} -## See also +## 参见 -- [The DOM interfaces index.](/zh-CN/docs/DOM/DOM_Reference) +- [DOM 接口索引](/zh-CN/docs/Web/API/Document_Object_Model) diff --git a/files/zh-cn/web/api/dynamicscompressornode/index.md b/files/zh-cn/web/api/dynamicscompressornode/index.md index 2cb20fde626299..a36b04809a3cba 100644 --- a/files/zh-cn/web/api/dynamicscompressornode/index.md +++ b/files/zh-cn/web/api/dynamicscompressornode/index.md @@ -39,7 +39,7 @@ slug: Web/API/DynamicsCompressorNode ## 属性 -_由父类 {{domxref("AudioNode")}} 派生_ +_由父类 {{domxref("AudioNode")}} 派生。_ - {{domxref("DynamicsCompressorNode.threshold")}} {{readonlyInline}} - : [比例系数](/zh-CN/docs/DOM/AudioParam#k-rate) {{domxref("AudioParam")}} 型。分贝高于此值时,将会进行压缩。 diff --git a/files/zh-cn/web/api/element/lostpointercapture_event/index.md b/files/zh-cn/web/api/element/lostpointercapture_event/index.md index f139319ddce745..116f85de394888 100644 --- a/files/zh-cn/web/api/element/lostpointercapture_event/index.md +++ b/files/zh-cn/web/api/element/lostpointercapture_event/index.md @@ -7,7 +7,7 @@ slug: Web/API/Element/lostpointercapture_event The **`onlostpointercapture`** event handler property of the {{domxref("GlobalEventHandlers")}} interface returns the event handler (function) for the `lostpointercapture` event type. -**语法** +## 语法 ```plain window.onlostpointercapture = functionReference diff --git a/files/zh-cn/web/api/event/eventphase/index.md b/files/zh-cn/web/api/event/eventphase/index.md index bb9dac2ba95e74..5cfe038c0618ec 100644 --- a/files/zh-cn/web/api/event/eventphase/index.md +++ b/files/zh-cn/web/api/event/eventphase/index.md @@ -13,13 +13,13 @@ slug: Web/API/Event/eventPhase var phase = event.eventPhase; ``` -返回一个代表当前执行阶段的 整数值,下面列出了不同的执行阶段[事件阶段常量](#事件阶段常量). +返回一个代表当前执行阶段的整数值,下面列出了不同的执行阶段[事件阶段常量](#事件阶段常量)。 ## 常量 ### 事件阶段常量 -### 下面这些值表示了事件流当前执行的阶段。 +### 下面这些值表示了事件流当前执行的阶段 | 常量 | 值 | 描述 | | ----------------------- | --- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | diff --git a/files/zh-cn/web/api/event/originaltarget/index.md b/files/zh-cn/web/api/event/originaltarget/index.md index 39cb9fce2f8798..65dc09eee131b5 100644 --- a/files/zh-cn/web/api/event/originaltarget/index.md +++ b/files/zh-cn/web/api/event/originaltarget/index.md @@ -5,19 +5,13 @@ slug: Web/API/Event/originalTarget {{ ApiRef("DOM") }} {{Non-standard_header}} -## 简介 - -original target 是事件重定向之前的原始目标。(Mozilla-特有) +**`originalTarget`** 只读属性是事件重定向之前的原始目标。(Mozilla-特有) 在 XBL 的匿名内容中,这将是该事件最初触发的匿名节点。看到匿名的内容。查看[Anonymous Content#Event_Flow_and_Targeting](/zh-CN/docs/XBL/XBL_1.0_Reference/Anonymous_Content#Event_Flow_and_Targeting) 获取更多细节。 -注意:原始目标也可能是原生的匿名内容 (参见 Bug(“208427”)),在这种情况下,它对于非特权代码是无用的。 - -查看[Comparison of Event Targets](/zh-CN/docs/DOM/event/Comparison_of_Event_Targets) - -## 示例 +注意:原始目标也可能是原生的匿名内容,在这种情况下,它对于非特权代码是无用的。 -_需要一个有意义的示例_ +参见[事件目标对比](/zh-CN/docs/Web/API/Event/Comparison_of_Event_Targets)。 ## 规范 diff --git a/files/zh-cn/web/api/fontface/index.md b/files/zh-cn/web/api/fontface/index.md index 0ac2ba41d05893..911265bbcf48d2 100644 --- a/files/zh-cn/web/api/fontface/index.md +++ b/files/zh-cn/web/api/fontface/index.md @@ -31,21 +31,21 @@ _这个接口不继承任何属性。_ - {{domxref("FontFace.featureSettings")}} - : 这是不是一个 {{domxref("DOMString")}} ?是的话将表示该字体的 _features_ 属性,相当于 {{cssxref("@font-face/feature-settings", "feature-settings")}} 。 - {{domxref("FontFace.status")}} {{readonlyinline}} - - : 返回一个表示字体当前状态的可枚举值,它可能是下列之一: `"unloaded"`, `"loading"`, `"loaded"`, `"error"`。 + - : 返回一个表示字体当前状态的可枚举值,它可能是下列之一:`"unloaded"`、`"loading"`、`"loaded"`、`"error"`。 - {{domxref("FontFace.loaded")}} {{readonlyinline}} - - : 当字体完全加载或加载失败时返回该 `FontFace` 的{{domxref("Promise")}} 。 + - : 当字体完全加载或加载失败时返回该 `FontFace` 的 {{domxref("Promise")}}。 -## Methods +## 方法 -_这个接口不继承任何方法_ +_这个接口不继承任何方法。_ - {{domxref("FontFace.load()")}} - - : 加载该字体,返回该字体完全加载或加载失败时的{{domxref("Promise")}} 。 + - : 加载该字体,返回该字体完全加载或加载失败时的 {{domxref("Promise")}}。 -## Specifications +## 规范 {{Specifications}} -## Browser compatibility +## 浏览器兼容性 {{Compat}} diff --git a/files/zh-cn/web/api/gamepad_api/using_the_gamepad_api/index.md b/files/zh-cn/web/api/gamepad_api/using_the_gamepad_api/index.md index be4b00ae8cd31b..a130b3b382f2f0 100644 --- a/files/zh-cn/web/api/gamepad_api/using_the_gamepad_api/index.md +++ b/files/zh-cn/web/api/gamepad_api/using_the_gamepad_api/index.md @@ -234,13 +234,9 @@ function gameLoop() { } ``` -### 使用坐标方向 (axes) 信息 +## 完整的示例:显示控制器状态 -**待讨论 (除了一个用 axes\[i] 一个用 button\[i].value,其他基本一样,Firefox 与 Chrome 均是。)** - -## 完整的例子:显示控制器状态 - -这个例子展示了怎样使用 {{ domxref("Gamepad") }} 对象,还有 [`gamepadconnected`](/zh-CN/docs/Web/API/Window/gamepadconnected_event) 和 [`gamepaddisconnected`](/zh-CN/docs/Web/API/Window/gamepaddisconnected_event) 事件显示所有已连接到系统的控制器的状态。你可以查看[在线演示](http://luser.github.io/gamepadtest/)并且可在 Github 上看到[完整的源代码](https://github.com/luser/gamepadtest)。 +这个示例展示了怎样使用 {{ domxref("Gamepad") }} 对象,还有 [`gamepadconnected`](/zh-CN/docs/Web/API/Window/gamepadconnected_event) 和 [`gamepaddisconnected`](/zh-CN/docs/Web/API/Window/gamepaddisconnected_event) 事件显示所有已连接到系统的控制器的状态。你可以查看[在线演示](http://luser.github.io/gamepadtest/)并且可在 Github 上看到[完整的源代码](https://github.com/luser/gamepadtest)。 ```js var haveEvents = "ongamepadconnected" in window; diff --git a/files/zh-cn/web/api/hashchangeevent/index.md b/files/zh-cn/web/api/hashchangeevent/index.md index b95c1bcc936741..d50933b5e902d5 100644 --- a/files/zh-cn/web/api/hashchangeevent/index.md +++ b/files/zh-cn/web/api/hashchangeevent/index.md @@ -22,30 +22,10 @@ _这个接口也从 {{domxref("Event")}} 中继承属性。_ ## 方法 -_这个接口没有自己的方法,但从 {{domxref("Event")}} 中继承方法_ +_这个接口没有自己的方法,但从 {{domxref("Event")}} 中继承方法。_ ## 示例 -### 井号内容变化的语法选择 - -你可以选择使用下述的任一方法监听 [`hashchange`](/zh-CN/docs/Web/API/Window/hashchange_event) 事件。 - -```js -window.onhashchange = funcRef; -``` - -**或** - -```html - -``` - -**或** - -```js -window.addEventListener("hashchange", funcRef, false); -``` - ### 基本示例 ```js diff --git a/files/zh-cn/web/api/htmlbaseelement/index.md b/files/zh-cn/web/api/htmlbaseelement/index.md index 95dd1c9d006b57..2a3200242d9373 100644 --- a/files/zh-cn/web/api/htmlbaseelement/index.md +++ b/files/zh-cn/web/api/htmlbaseelement/index.md @@ -9,7 +9,7 @@ slug: Web/API/HTMLBaseElement ## 属性 -_继承了其父级 {{domxref("HTMLElement")}} 的所有属性_ +_继承了其父级 {{domxref("HTMLElement")}} 的所有属性。_ - {{domxref("HTMLBaseElement.href")}} - : 映射自 {{domxref("DOMString")}} HTML [`href`](/zh-CN/docs/Web/HTML/Element/base#href) 特性,包含了当前文档中所有相对 URL 地址的基准 URL。 @@ -20,14 +20,14 @@ _继承了其父级 {{domxref("HTMLElement")}} 的所有属性_ _没有特殊的方法,继承了其父级 {{domxref("HTMLElement")}} 的所有特性。_ -## Specifications +## 规范 {{Specifications}} -## Browser compatibility +## 浏览器兼容性 {{Compat}} -## See also +## 参见 -- HTML element implementing this interface: {{ HTMLElement("base") }} +- 实现了该接口的 HTML 元素:{{ HTMLElement("base") }} diff --git a/files/zh-cn/web/api/htmlmediaelement/index.md b/files/zh-cn/web/api/htmlmediaelement/index.md index 4ca33ee457d1fc..aa5d2545460a66 100644 --- a/files/zh-cn/web/api/htmlmediaelement/index.md +++ b/files/zh-cn/web/api/htmlmediaelement/index.md @@ -3,11 +3,15 @@ title: HTMLMediaElement slug: Web/API/HTMLMediaElement --- -{{APIRef("HTML DOM")}}HTML 媒体元素接口在属性和方法中添加了 {{domxref("HTMLElement", "HTML 元素")}}来支持基础的媒体相关的能力,就像 audio 和 video 一样。{{domxref("HTMLVideoElement", "HTML 视频元素")}}和 {{domxref("HTMLAudioElement", "HTML 音频元素")}}元素都继承自此接口。{{InheritanceDiagram(600, 180)}} +{{APIRef("HTML DOM")}} + +HTML 媒体元素接口在属性和方法中添加了 {{domxref("HTMLElement", "HTML 元素", "", 1)}}来支持基础的媒体相关的能力,就像音频和视频一样。{{domxref("HTMLVideoElement", "HTML 视频元素", "", 1)}}和{{domxref("HTMLAudioElement", "HTML 音频元素", "", 1)}}元素都继承自此接口。 + +{{InheritanceDiagram(600, 180)}} ## 特性 -_从父级 {{domxref("HTMLElement")}}, {{domxref("Element")}}, {{domxref("Node")}}, 和 {{domxref("EventTarget")}} 继承属性_ +_从父级 {{domxref("HTMLElement")}}、{{domxref("Element")}}、{{domxref("Node")}} 和 {{domxref("EventTarget")}} 继承属性。_ @@ -30,8 +34,8 @@ _从父级 {{domxref("HTMLElement")}}, {{domxref("Element")}}, {{domxref("Node") @@ -57,8 +61,8 @@ _从父级 {{domxref("HTMLElement")}}, {{domxref("Element")}}, {{domxref("Node") @@ -95,7 +99,7 @@ _从父级 {{domxref("HTMLElement")}}, {{domxref("Element")}}, {{domxref("Node") @@ -144,7 +148,7 @@ _从父级 {{domxref("HTMLElement")}}, {{domxref("Element")}}, {{domxref("Node") @@ -152,7 +156,7 @@ _从父级 {{domxref("HTMLElement")}}, {{domxref("Element")}}, {{domxref("Node") @@ -217,7 +221,7 @@ _从父级 {{domxref("HTMLElement")}}, {{domxref("Element")}}, {{domxref("Node") @@ -226,7 +230,7 @@ _从父级 {{domxref("HTMLElement")}}, {{domxref("Element")}}, {{domxref("Node") - + @@ -413,7 +417,7 @@ _从父级 {{domxref("HTMLElement")}}, {{domxref("Element")}}, {{domxref("Node")
{{domxref("Boolean")}}

- 表示[`autoplay`](/zh-CN/docs/Web/HTML/Element/video#autoplay)的 HTML - 属性,表明在视频加载可用时是否不中断地自动播放资源 + 表示 autoplay + 的 HTML 属性,表明在视频加载可用时是否不中断地自动播放资源

{{domxref("Boolean")}} 映射在 HTML - 标签。[`controls`](/zh-CN/docs/Web/HTML/Element/video#controls)属性控制是否显示用户播放界面的控制 - HTML + 标签。controls + 属性控制是否显示用户播放界面的控制 HTML
defaultMuted {{domxref("Boolean")}} - 映射在 HTML 标签上。 [`muted`](/zh-CN/docs/Web/HTML/Element/video#muted) + 映射在 HTML 标签上。muted 属性表示媒体声音被播放时是否应该被静音。这个属性不能动态设置静音/不静音,如果希望设置静音/不静音,请使用 muted 属性 loop {{domxref("Boolean")}} - 会映射在 HTML 标签 [`loop`](/zh-CN/docs/Web/HTML/Element/video#loop) 属性 + 会映射在 HTML 标签 loop 属性 , 决定该媒体是否循环播放。
mediaGroup {{domxref("DOMString")}} - 反映在 HTML [`mediagroup`](/zh-CN/docs/Web/HTML/Element/video#mediagroup) + 反映在 HTML mediagroup 标签上。 表示元素所归属的分组,同一组的媒体元素会共享同一个控制器(controller)。
- mozSampleRate {{readonlyinline}} + mozSampleRate{{readonlyinline}} {{ non-standard_inline() }} long
mozSrcObject {{ non-standard_inline() }}mozSrcObject{{ non-standard_inline() }} {{domxref("MediaStream")}} Lets you set or get the @@ -315,10 +319,10 @@ _从父级 {{domxref("HTMLElement")}}, {{domxref("Element")}}, {{domxref("Node") preload {{ domxref("DOMString") }} - Reflects the [`preload`](/zh-CN/docs/Web/HTML/Element/video#preload) HTML + Reflects the preload HTML attribute, indicating what data should be preloaded, if any. Possible values are: none, metadata, auto. - See [`preload`](/zh-CN/docs/Web/HTML/Element/video#preload) attribute + See preload attribute documentation for details.
src {{ domxref("DOMString") }} - Reflects the [`src`](/zh-CN/docs/Web/HTML/Element/video#src) HTML + Reflects the src HTML attribute, containing the URL of a media resource to use. Gecko implements a similar functionality for streams: mozSrcObject. diff --git a/files/zh-cn/web/api/htmlmediaelement/paused/index.md b/files/zh-cn/web/api/htmlmediaelement/paused/index.md index e2d78ffdba03dd..02b63f2f559df2 100644 --- a/files/zh-cn/web/api/htmlmediaelement/paused/index.md +++ b/files/zh-cn/web/api/htmlmediaelement/paused/index.md @@ -5,24 +5,16 @@ slug: Web/API/HTMLMediaElement/paused {{APIRef("HTML DOM")}} -`属性 (只读)HTMLMediaElement.paused` 告诉视频是否正在暂停 +只读属性 `HTMLMediaElement.paused` 指示视频是否正在暂停。 -## 语法 +## 返回值 -```plain -var isPaused = audioOrVideo.paused -``` - -### 返回值 - -类型{{domxref("Boolean")}}。`true` 暂停中 `false` 没有暂停 - -_仅限暂停状态 因网络原因造成的缓冲状态仍然会告诉你不在暂停状态_ +布尔值。`true` 表示正在暂停,`false` 表示没有暂停。 -## 例子 +## 示例 ```js -var obj = document.createElement("video"); +const obj = document.createElement("video"); console.log(obj.paused); // true ``` @@ -34,6 +26,6 @@ console.log(obj.paused); // true {{Compat}} -## 参考文档 +## 参见 -- The interface defining it, {{domxref("HTMLMediaElement")}}. +- {{domxref("HTMLMediaElement")}}:用于定义 `HTMLMediaElement.paused` 属性的接口。 diff --git a/files/zh-cn/web/api/htmltemplateelement/index.md b/files/zh-cn/web/api/htmltemplateelement/index.md index 16758b6beef883..e81b541619b47d 100644 --- a/files/zh-cn/web/api/htmltemplateelement/index.md +++ b/files/zh-cn/web/api/htmltemplateelement/index.md @@ -5,20 +5,20 @@ slug: Web/API/HTMLTemplateElement {{APIRef("Web Components")}} -可以使用**`HTMLTemplateElement`** 接口来访问 HTML {{HTMLElement("template")}}元素的内容。 +可以使用 **`HTMLTemplateElement`** 接口来访问 HTML {{HTMLElement("template")}} 元素的内容。 {{InheritanceDiagram(600, 120)}} ## 属性 -_这个接口继承了 {{domxref("HTMLElement")}}的属性_ +_这个接口继承了 {{domxref("HTMLElement")}} 的属性。_ - {{domxref("HTMLTemplateElement.content")}}{{readonlyinline}} - - : {{domxref("DocumentFragment")}}对象,包裹了模板元素{{HTMLElement("template")}}的内容。这个属性是只读的 DOM 树。 + - : {{domxref("DocumentFragment")}} 对象,包裹了模板元素 {{HTMLElement("template")}} 的内容。这个属性是只读的 DOM 树。 -## Methods +## 方法 -_这个接口继承了 {{domxref("HTMLElement")}}的方法。_ +_这个接口继承了 {{domxref("HTMLElement")}} 的方法。_ ## 规范 diff --git a/files/zh-cn/web/api/inputevent/iscomposing/index.md b/files/zh-cn/web/api/inputevent/iscomposing/index.md index 4301529d0ffc45..a3ca0e56b218c5 100644 --- a/files/zh-cn/web/api/inputevent/iscomposing/index.md +++ b/files/zh-cn/web/api/inputevent/iscomposing/index.md @@ -1,36 +1,32 @@ --- -title: InputEvent.isComposing +title: InputEvent:isComposing 属性 slug: Web/API/InputEvent/isComposing --- -{{APIRef("DOM Events")}} +{{APIRef("UI Events")}} -The **`InputEvent.isComposing`** read-only property returns a {{jsxref("Boolean")}} value indicating if the event is fired after [`compositionstart`](/zh-CN/docs/Web/API/Element/compositionstart_event) and before [`compositionend`](/zh-CN/docs/Web/API/Element/compositionend_event). +**`InputEvent.isComposing`** 只读属性返回一个布尔值,表示事件是否是在 {{domxref("Element/compositionstart_event", "compositionstart")}} 之后且在 {{domxref("Element/compositionend_event", "compositionend")}} 之前触发的。 -## 这是一个只读属性,返回 boolean 类型。表示正处于输入事件的开始与结束之间,表示正在输入状态。 +## 返回值 -## Syntax +一个布尔值。 -```plain -var bool = event.isComposing; -``` - -## Example +## 示例 ```js -var inputEvent = new InputEvent("syntheticInput", false); -console.log(inputEvent.isComposing); // return false +const inputEvent = new InputEvent("syntheticInput", false); +console.log(inputEvent.isComposing); // 返回 false ``` -## Specifications +## 规范 {{Specifications}} -## Browser compatibility +## 浏览器兼容性 {{Compat}} -## See also +## 参见 -- [`compositionstart`](/zh-CN/docs/Web/API/Element/compositionstart_event) and [`compositionend`](/zh-CN/docs/Web/API/Element/compositionend_event) +- {{domxref("Element/compositionstart_event", "compositionstart")}} 和 {{domxref("Element/compositionend_event", "compositionend")}} - {{domxref("InputEvent")}} diff --git a/files/zh-cn/web/api/mathmlelement/index.md b/files/zh-cn/web/api/mathmlelement/index.md index 9a6e58b73e6aaa..937be9b4353550 100644 --- a/files/zh-cn/web/api/mathmlelement/index.md +++ b/files/zh-cn/web/api/mathmlelement/index.md @@ -9,11 +9,11 @@ slug: Web/API/MathMLElement ## 属性 -_This interface has no properties, but inherits properties from: {{DOMxRef("DocumentAndElementEventHandlers")}}, {{DOMxRef("Element")}}, {{DOMxRef("ElementCSSInlineStyle")}}, {{DOMxRef("GlobalEventHandlers")}}, {{DOMxRef("HTMLOrForeignElement")}}_ +_This interface has no properties, but inherits properties from: {{DOMxRef("DocumentAndElementEventHandlers")}}, {{DOMxRef("Element")}}, {{DOMxRef("ElementCSSInlineStyle")}}, {{DOMxRef("GlobalEventHandlers")}}, {{DOMxRef("HTMLOrForeignElement")}}._ ## 方法 -_This interface has no methods, but inherits methods from: {{DOMxRef("DocumentAndElementEventHandlers")}}, {{DOMxRef("Element")}}, {{DOMxRef("ElementCSSInlineStyle")}}, {{DOMxRef("GlobalEventHandlers")}}, {{DOMxRef("HTMLOrForeignElement")}}_ +_This interface has no methods, but inherits methods from: {{DOMxRef("DocumentAndElementEventHandlers")}}, {{DOMxRef("Element")}}, {{DOMxRef("ElementCSSInlineStyle")}}, {{DOMxRef("GlobalEventHandlers")}}, {{DOMxRef("HTMLOrForeignElement")}}._ ## 示例 diff --git a/files/zh-cn/web/api/messageport/index.md b/files/zh-cn/web/api/messageport/index.md index 4dc139ec21392b..f39d37394a911f 100644 --- a/files/zh-cn/web/api/messageport/index.md +++ b/files/zh-cn/web/api/messageport/index.md @@ -11,7 +11,7 @@ slug: Web/API/MessagePort ## 方法 -_继承自父类 {{domxref("EventTarget")}} 的方法_ +_继承自父类 {{domxref("EventTarget")}} 的方法。_ - {{domxref("MessagePort.postMessage")}} - : 从端口发送一条消息,并且可选是否将对象的所有权交给其他浏览器上下文。 @@ -22,7 +22,7 @@ _继承自父类 {{domxref("EventTarget")}} 的方法_ ## 事件回调 -_继承自父类 {{domxref("EventTarget")}} 的事件回调_ +_继承自父类 {{domxref("EventTarget")}} 的事件回调。_ - {{domxref("MessagePort.onmessage")}} - : 是一个 {{domxref("EventListener")}}, 当类型为 `message` 的 {{domxref("MessageEvent")}} 在该端口触发时,它将会被调用 ── 也就是说,该端口收到了一条消息。 @@ -38,18 +38,18 @@ _继承自父类 {{domxref("EventTarget")}} 的事件回调_ - : 当 `MessagePort` 对象收到无法被反序列化的消息时触发。 也可以通过 {{domxref("MessagePort.onmessageerror","onmessageerror")}} 属性使用。 -## 例子 +## 示例 -在下面的例子中,你可以看到一个使用 {{domxref("MessageChannel.MessageChannel","MessageChannel()")}} 构造函数创建出的新 channel. +在下面的示例中,你可以看到一个使用 {{domxref("MessageChannel.MessageChannel","MessageChannel()")}} 构造函数创建出的新通道。 -当 IFrame 加载完成后,我们给 {{domxref("MessageChannel.port1")}} 注册了一个 {{domxref("MessagePort.onmessage","onmessage")}} 回调,并且使用 {{domxref("window.postMessage")}} 方法把 {{domxref("MessageChannel.port2")}} 和一条消息一起传给 IFrame. +当 IFrame 加载完成后,我们给 {{domxref("MessageChannel.port1")}} 注册了一个 {{domxref("MessagePort.onmessage","onmessage")}} 回调,并且使用 {{domxref("window.postMessage")}} 方法把 {{domxref("MessageChannel.port2")}} 和一条消息一起传给 IFrame。 当从 IFrame 收到消息时,`onMessage` 方法会把消息输出到一个段落里。 -```plain +```js var channel = new MessageChannel(); -var output = document.querySelector('.output'); -var iframe = document.querySelector('iframe'); +var output = document.querySelector(".output"); +var iframe = document.querySelector("iframe"); // 等待 iframe 加载 iframe.addEventListener("load", onLoad); @@ -59,10 +59,11 @@ function onLoad() { channel.port1.onmessage = onMessage; // 把 port2 传给 iframe - iframe.contentWindow.postMessage('Hello from the main page!', '*', [channel.port2]); + iframe.contentWindow.postMessage("Hello from the main page!", "*", [ + channel.port2, + ]); } - // 处理 port1 收到的消息 function onMessage(e) { output.innerHTML = e.data; diff --git a/files/zh-cn/web/api/navigator/getusermedia/index.md b/files/zh-cn/web/api/navigator/getusermedia/index.md index 9189a5ef2959fb..d8e9f3f2d71517 100644 --- a/files/zh-cn/web/api/navigator/getusermedia/index.md +++ b/files/zh-cn/web/api/navigator/getusermedia/index.md @@ -5,7 +5,7 @@ slug: Web/API/Navigator/getUserMedia > **备注:** 此 API 已更名为 {{domxref("MediaDevices.getUserMedia()")}}。请使用那个版本进行替代!这个已废弃的 API 版本仅为了向后兼容而存在。 -{{APIRef}}{{deprecated_header}} +{{APIRef("Media Capture and Streams")}}{{deprecated_header}} **Navigator.getUserMedia()** 方法提醒用户需要使用音频(0 或者 1)和(0 或者 1)视频输入设备,比如相机,屏幕共享,或者麦克风。如果用户给予许可,**successCallback** 回调就会被调用,{{domxref("MediaStream")}} 对象作为回调函数的参数。如果用户拒绝许可或者没有媒体可用,**errorCallback** 就会被调用,类似的,**`PermissionDeniedError`** 或者 **`NotFoundError`** 对象作为它的参数。注意,有可能以上两个回调函数都不被调用,因为不要求用户一定作出选择(允许或者拒绝)。 @@ -17,59 +17,59 @@ navigator.getUserMedia ( constraints, successCallback, errorCallback ); ### 参数 -**constraints** +- `constraints` + - : {{domxref("MediaStreamConstaints")}} 对象指定了请求使用媒体的类型,还有每个类型的所需要的参数。具体细节请参见 {{domxref("MediaDevices.getUserMedia()")}} 方法下面的 [constraints](/zh-CN/docs/Web/API/MediaDevices/getUserMedia#Parameters) 部分。 +- `successCallback` -{{domxref("MediaStreamConstaints")}} 对象指定了请求使用媒体的类型,还有每个类型的所需要的参数。具体细节请参见 {{domxref("MediaDevices.getUserMedia()")}} 方法下面的 [constraints](/zh-CN/docs/Web/API/MediaDevices/getUserMedia#Parameters) 部分。 + - : 当调用成功后,successCallback 中指定的函数就被调用,包含了媒体流的 {{domxref("MediaStream")}} 对象作为它的参数,你可以把媒体流对象赋值给合适的元素,然后使用它,就像下面的例子一样: -**successCallback** + ```js + function(stream) { + var video = document.querySelector('video'); + video.src = window.URL.createObjectURL(stream); + video.onloadedmetadata = function(e) { + // Do something with the video here. + }; + } + ``` -当调用成功后,successCallback 中指定的函数就被调用,包含了媒体流的 {{domxref("MediaStream")}} 对象作为它的参数,你可以把媒体流对象赋值给合适的元素,然后使用它,就像下面的例子一样: +- `errorCallback` -``` -function(stream) { - var video = document.querySelector('video'); - video.src = window.URL.createObjectURL(stream); - video.onloadedmetadata = function(e) { - // Do something with the video here. - }; -} -``` + - : 当调用失败,errorCallback 中指定的函数就会被调用,{{domxref("MediaStreamError")}} 对象作为它唯一的参数;此对象基于 {{domxref("DOMException")}} 对象构建。错误码描述见参见以下: -**errorCallback** - -当调用失败,errorCallback 中指定的函数就会被调用,{{domxref("MediaStreamError")}} 对象作为它唯一的参数;此对象基于 {{domxref("DOMException")}} 对象构建。错误码描述见参见以下: - -| Error | Description | -| ----------------------- | ---------------------------------- | -| `PermissionDeniedError` | 使用媒体设备请求被用户或者系统拒绝 | -| `NotFoundError` | 找不到 constraints 中指定媒体类型 | + | 错误 | 描述 | + | ----------------------- | ---------------------------------- | + | `PermissionDeniedError` | 使用媒体设备请求被用户或者系统拒绝 | + | `NotFoundError` | 找不到 constraints 中指定媒体类型 | ## 示例 ### 宽度和高度 -使用 getUserMedia() 的示例,包括了可以适用于多种浏览器前缀的代码。注意这种使用方式已经被废除,现代的使用方法请参见 {{domxref("MediaDevices.getUserMedia()")}} 下面的[示例](/zh-CN/docs/Web/API/MediaDevices/getUserMedia#Frame_rate)部分。 +使用 `getUserMedia()` 的示例,包括了可以适用于多种浏览器前缀的代码。注意这种使用方式已经被废除,现代的使用方法请参见 {{domxref("MediaDevices.getUserMedia()")}} 下面的[示例](/zh-CN/docs/Web/API/MediaDevices/getUserMedia#Frame_rate)部分。 -``` -navigator.getUserMedia = navigator.getUserMedia || - navigator.webkitGetUserMedia || - navigator.mozGetUserMedia; +```js +navigator.getUserMedia = + navigator.getUserMedia || + navigator.webkitGetUserMedia || + navigator.mozGetUserMedia; if (navigator.getUserMedia) { - navigator.getUserMedia({ audio: true, video: { width: 1280, height: 720 } }, - function(stream) { - var video = document.querySelector('video'); - video.src = window.URL.createObjectURL(stream); - video.onloadedmetadata = function(e) { - video.play(); - }; - }, - function(err) { - console.log("The following error occurred: " + err.name); - } - ); + navigator.getUserMedia( + { audio: true, video: { width: 1280, height: 720 } }, + function (stream) { + var video = document.querySelector("video"); + video.src = window.URL.createObjectURL(stream); + video.onloadedmetadata = function (e) { + video.play(); + }; + }, + function (err) { + console.log("The following error occurred: " + err.name); + }, + ); } else { - console.log("getUserMedia not supported"); + console.log("getUserMedia not supported"); } ``` @@ -96,9 +96,9 @@ if (navigator.getUserMedia) { > **警告:** 新代码应当使用 {{domxref("Navigator.mediaDevices.getUserMedia()")}} 替代。 -## 更多参见 +## 参见 -- {{domxref("MediaDevices.getUserMedia()")}} 替代了当前废弃的版本。 -- [WebRTC](/zh-CN/docs/WebRTC) - the introductory page to the API -- [MediaStream API](/zh-CN/docs/WebRTC/MediaStream_API) - the API for the media stream objects -- [Taking webcam photos](/zh-CN/docs/WebRTC/taking_webcam_photos) - a tutorial on using `getUserMedia() for taking photos rather than video.` +- {{domxref("MediaDevices.getUserMedia()")}} 代替了这个已弃用的方法。 +- [WebRTC](/zh-CN/docs/Web/API/WebRTC_API)——该 API 的介绍页面 +- [媒体捕捉与媒体流 API](/zh-CN/docs/Web/API/Media_Capture_and_Streams_API)——媒体流对象的 API +- [使用网络摄像头拍摄照片](/zh-CN/docs/Web/API/Media_Capture_and_Streams_API/Taking_still_photos)——使用 `getUserMedia()` 拍摄照片(而不是视频)的教程。 diff --git a/files/zh-cn/web/api/selection/modify/index.md b/files/zh-cn/web/api/selection/modify/index.md index 8ea5bda084ccc3..1638890186c050 100644 --- a/files/zh-cn/web/api/selection/modify/index.md +++ b/files/zh-cn/web/api/selection/modify/index.md @@ -37,7 +37,7 @@ selection.modify("extend", "forward", "word"); ## 规范 -_无_ +_无。_ ## 浏览器兼容性 diff --git a/files/zh-cn/web/api/svgaelement/index.md b/files/zh-cn/web/api/svgaelement/index.md index a1ecc8485efb31..44bbcf4ef8a639 100644 --- a/files/zh-cn/web/api/svgaelement/index.md +++ b/files/zh-cn/web/api/svgaelement/index.md @@ -5,7 +5,7 @@ slug: Web/API/SVGAElement {{APIRef("SVG")}} -## SVG a DOM 接口 +## SVG DOM 接口 `SVGAElement`接口提供了对{{ SVGElement("a") }}元素的属性的访问,而且还提供了操作该元素的方法。 @@ -55,45 +55,26 @@ slug: Web/API/SVGAElement 这个接口同样会从父级元素 *{{domxref("SVGGraphicsElement")}}*继承属性,并实现 _{{domxref("SVGURIReference")}}_ 和 _{{domxref("HTMLHyperlinkElementUtils")}}_ 中的功能。 -**{{domxref("SVGAElement.download")}}** - -参见 {{domxref("HTMLAnchorElement.download")}} - -**{{domxref("SVGAElement.href")}}** - -See {{domxref("HTMLAnchorElement.href")}} - -**{{domxref("SVGAElement.hreflang")}}** - -是一个反映 `hreflang` 属性的字符串(DOMString),表示链接资源的语言种类。 - -**{{domxref("SVGAElement.ping")}}** - -是一个反映 ping 值的字符串(DOMString),包含以空格分隔开的 URL 列表,当超链接可以被跟踪时,浏览器会(在后台)发送有 PING 主体的 {{HTTPMethod("POST")}} 的请求,一般用于追踪。 - -**{{domxref("SVGAElement.referrerPolicy")}}** - -参见 {{domxref("HTMLAnchorElement.referrerPolicy")}} - -**{{domxref("SVGAElement.rel")}}** - -参见 {{domxref("HTMLAnchorElement.rel")}} - -**{{domxref("SVGAElement.relList")}}** - -参见{{domxref("HTMLAnchorElement.relList")}} - -**{{domxref("SVGAElement.target")}} {{readonlyInline}}** - -它和特定元素的 {{SVGAttr("target")}} 属性相同 - -**{{domxref("SVGAElement.text")}}** - -是一个字符串(DOMString),作为 {{domxref("Node.textContent")}} 属性的代名词。 - -**{{domxref("SVGAElement.type")}}** - -是一个反映 `type` 属性的字符串(DOMString),表示链接资源的 MIME 种类。 +- {{domxref("SVGAElement.download")}} + - : 参见 {{domxref("HTMLAnchorElement.download")}} +- {{domxref("SVGAElement.href")}} + - : 参见 {{domxref("HTMLAnchorElement.href")}} +- {{domxref("SVGAElement.hreflang")}} + - : 是一个反映 `hreflang` 属性的字符串(DOMString),表示链接资源的语言种类。 +- {{domxref("SVGAElement.ping")}} + - : 是一个反映 ping 值的字符串(DOMString),包含以空格分隔开的 URL 列表,当超链接可以被跟踪时,浏览器会(在后台)发送有 PING 主体的 {{HTTPMethod("POST")}} 的请求,一般用于追踪。 +- {{domxref("SVGAElement.referrerPolicy")}} + - : 参见 {{domxref("HTMLAnchorElement.referrerPolicy")}} +- {{domxref("SVGAElement.rel")}} + - : 参见 {{domxref("HTMLAnchorElement.rel")}} +- {{domxref("SVGAElement.relList")}} + - : 参见{{domxref("HTMLAnchorElement.relList")}} +- {{domxref("SVGAElement.target")}} {{readonlyInline}} + - : 它和特定元素的 {{SVGAttr("target")}} 属性相同 +- {{domxref("SVGAElement.text")}} + - : 是一个字符串(DOMString),作为 {{domxref("Node.textContent")}} 属性的代名词。 +- {{domxref("SVGAElement.type")}} + - : 是一个反映 `type` 属性的字符串(DOMString),表示链接资源的 MIME 种类。 ## 方法 @@ -127,4 +108,4 @@ linkRef.onclick = function () { ## 参见 -- {{ SVGElement("a") }} SVG Element +- {{ SVGElement("a") }} SVG 元素 diff --git a/files/zh-cn/web/api/webgl_api/tutorial/adding_2d_content_to_a_webgl_context/index.md b/files/zh-cn/web/api/webgl_api/tutorial/adding_2d_content_to_a_webgl_context/index.md index 40850a2b903f2e..5cca59f1664619 100644 --- a/files/zh-cn/web/api/webgl_api/tutorial/adding_2d_content_to_a_webgl_context/index.md +++ b/files/zh-cn/web/api/webgl_api/tutorial/adding_2d_content_to_a_webgl_context/index.md @@ -231,7 +231,7 @@ export { initBuffers }; 当上一步完成,我们创建一个 Javascript 数组去记录每一个正方体的每一个顶点。然后将其转化为 WebGL 浮点型类型的数组,并将其传到 gl 对象的 {{domxref("WebGLRenderingContext.bufferData()", "bufferData()")}} 方法来建立对象的顶点。 -**绘制场景** +## 绘制场景 当着色器和物体都创建好后,我们可以开始渲染这个场景了。因为我们这个例子不会产生动画,所以 drawScene() 方法非常简单。它还使用了几个工具函数,稍后我们会介绍。 diff --git a/files/zh-cn/web/api/webgl_api/webgl_model_view_projection/index.md b/files/zh-cn/web/api/webgl_api/webgl_model_view_projection/index.md index 0c3f9a1b62207d..54975fca98a678 100644 --- a/files/zh-cn/web/api/webgl_api/webgl_model_view_projection/index.md +++ b/files/zh-cn/web/api/webgl_api/webgl_model_view_projection/index.md @@ -669,8 +669,6 @@ gl_Position = projection * model * vec4(position, 1.0); 我们没有向后和向左移动相机,而是对盒子应用了逆变换:我们将盒子向后移动 1 米,然后向右移动 10 厘米。从两个物体的角度来看,结果是一样的。 -**<<< insert image(s) here >>>** - 最后一步是创建**视图矩阵**,该矩阵将转换场景中的对象,以便对它们进行定位以模拟相机当前位置与方向。目前的代码可以在世界空间中移动立方体并投影所有内容以获得透视图,但我们仍然无法移动相机。 想象一下使用物理摄像机拍摄电影。你可以自由地将相机放到任何你想放置的位置,并对准任何你选择的方向。为了在 3D 图形中对此进行仿真,我们使用视图矩阵来模拟物理相机的位置和旋转。 @@ -733,7 +731,7 @@ gl_Position = projection * view * model * vec4(position, 1.0); - 向视图矩阵中添加一些旋转矩阵以四处看看。 - 最后,跟踪鼠标的位置。使用 2 个旋转矩阵可以根据用户鼠标在屏幕上的位置上下移动相机。 -**参见** +## 参见 - [WebGL](/zh-CN/docs/Web/API/WebGL_API) - [3D projection](https://zh.wikipedia.org/wiki/3D_projection) diff --git a/files/zh-cn/web/api/websockets_api/writing_websocket_servers/index.md b/files/zh-cn/web/api/websockets_api/writing_websocket_servers/index.md index 32d474f39dd410..c3281c3802ca3a 100644 --- a/files/zh-cn/web/api/websockets_api/writing_websocket_servers/index.md +++ b/files/zh-cn/web/api/websockets_api/writing_websocket_servers/index.md @@ -170,9 +170,7 @@ WebSocket 扩展和子协议是在握手过程中通过头信息进行协商的 Think of an extension as compressing a file before e-mailing it to someone. Whatever you do, you're sending the _same_ data in different forms. The recipient will eventually be able to get the same data as your local copy, but it is sent differently. That's what an extension does. WebSockets defines a protocol and a simple way to send data, but an extension such as compression could allow sending the same data but in a shorter format. -> **备注:** 扩展在规范的 5.8, 9, 11.3.2, and 11.4 进行了解释 - -_TODO_ +> **备注:** 扩展在规范的第 5.8、9、11.3.2 和 11.4 条进行了解释。 ### 子协议 diff --git a/files/zh-cn/web/api/webvr_api/index.md b/files/zh-cn/web/api/webvr_api/index.md index 6a711f0fe6dcfc..5cb80d2ba0f265 100644 --- a/files/zh-cn/web/api/webvr_api/index.md +++ b/files/zh-cn/web/api/webvr_api/index.md @@ -5,31 +5,19 @@ slug: Web/API/WebVR_API {{DefaultAPISidebar("WebVR API")}}{{SeeCompatTable}} -**WebVR API 能为虚拟现实设备的渲染提供支持 — 例如像 Oculus Rift 或者**HTC Vive **这样的头戴式设备与 Web apps 的连接。它能让开发者将位置和动作信息转换成 3D 场景中的运动。基于这项技术能产生很多有趣的应用,比如虚拟的产品展示,可交互的培训课程,以及超强沉浸感的第一人称游戏。** +WebVR API 能为虚拟现实设备的渲染提供支持——例如像 Oculus Rift 或者 HTC Vive 这样的头戴式设备与 Web 应用的连接。它能让开发者将位置和动作信息转换成 3D 场景中的运动。基于这项技术能产生很多有趣的应用,比如虚拟的产品展示,可交互的培训课程,以及超强沉浸感的第一人称游戏。 ## 概念及使用方法 -**【K】** - ![Sketch of a person in a chair with wearing goggles labelled "Head mounted display (HMD)" facing a monitor with a webcam labelled "Position sensor"](hw-setup.png) -Any VR devices attached to your computer will be returned by the {{domxref("Navigator.getVRDevices()")}} method. This returns an array of objects to represent the attached devices, which inherit from the general {{domxref("VRDevice")}} object — generally a head mounted display will have two devices — the head mounted display itself, represented by {{domxref("HMDVRDevice")}}, and a position sensor camera that keeps track of your head position, represented by {{domxref("PositionSensorVRDevice")}}. - -**连接到电脑的所有 VR 设备都将由 {{domxref("Navigator.getVRDevices()")}} 方法返回。这个方法将返回一个包含了所有已连接设备的对象数组,每个设备对应一个对象,该对象继承自 {{domxref("VRDevice")}} — 通常一个头显将包含两个设备 — 头显自身由 {{domxref("HMDVRDevice")}} 表示,和一个跟踪头部位置的位置捕捉传感器,由 {{domxref("PositionSensorVRDevice")}} 表示。** - -The {{domxref("PositionSensorVRDevice")}} object contains the {{domxref("PositionSensorVRDevice.getState","getState()")}} method, which returns a {{domxref("VRPositionState")}} object — this represents the sensor’s state at a given timestamp, and includes properties containing useful data such as current velocity, acceleration, and orientation, useful for updating the rendering of a scene on each frame according to the movement of the VR head mounted display. - -**{{domxref("PositionSensorVRDevice")}} 对象有一个 {{domxref("PositionSensorVRDevice.getState","getState()")}} 方法,该方法返回一个{{domxref("VRPositionState")}} 对象 — 这个对象代表位置传感器在指定时刻的状态,包含了一些十分有用的信息,例如速度、加速度以及运动方向,可用于根据头部运动刷新画面显示。** +连接到电脑的所有 VR 设备都将由 {{domxref("Navigator.getVRDevices()")}} 方法返回。这个方法将返回一个包含了所有已连接设备的对象数组,每个设备对应一个对象,该对象继承自 {{domxref("VRDevice")}}——通常一个头显将包含两个设备——头显自身由 {{domxref("HMDVRDevice")}} 表示,和一个跟踪头部位置的位置捕捉传感器,由 {{domxref("PositionSensorVRDevice")}} 表示。 -The {{domxref("HMDVRDevice.getEyeParameters()")}} method returns a {{domxref("VREyeParameters")}} object, which can be used to return field of view information — how much of the scene the head mounted display can see. The {{domxref("VREyeParameters.currentFieldOfView")}} returns a {{domxref("VRFieldOfView")}} object that contains 4 angles describing the current view from a center point. You can also change the field of view using {{domxref("HMDVRDevice.setFieldOfView()")}}. +{{domxref("PositionSensorVRDevice")}} 对象有一个 {{domxref("PositionSensorVRDevice.getState","getState()")}} 方法,该方法返回一个{{domxref("VRPositionState")}} 对象——这个对象代表位置传感器在指定时刻的状态,包含了一些十分有用的信息,例如速度、加速度以及运动方向,可用于根据头部运动刷新画面显示。 -**{{domxref("HMDVRDevice.getEyeParameters()")}} 方法返回一个 {{domxref("VREyeParameters")}} 对象,可用于获取显示区域的信息 — 头显可以看到多少画面。 {{domxref("VREyeParameters.currentFieldOfView")}} 返回一个 {{domxref("VRFieldOfView")}} 对象,该对象包含了 4 个角度信息来描述当前的显示区域。你可以用 {{domxref("HMDVRDevice.setFieldOfView()")}} 来改变当前的显示区域。** +{{domxref("HMDVRDevice.getEyeParameters()")}} 方法返回一个 {{domxref("VREyeParameters")}} 对象,可用于获取显示区域的信息——头显可以看到多少画面。 {{domxref("VREyeParameters.currentFieldOfView")}} 返回一个 {{domxref("VRFieldOfView")}} 对象,该对象包含了 4 个角度信息来描述当前的显示区域。你可以用 {{domxref("HMDVRDevice.setFieldOfView()")}} 来改变当前的显示区域。 -> **备注:** To find out more about using these interfaces in your own app, read [Using the WebVR API](/zh-CN/docs/Web/API/WebVR_API/Using_the_WebVR_API). To learn more about the basic concepts behind VR, read [WebVR concepts](/zh-CN/docs/Web/API/WebVR_API/WebVR_concepts). -> -> 注释:要了解更多关于如何在你的应用程序中使用这些接口,请阅读文章[Using the WebVR API](/zh-CN/docs/Web/API/WebVR_API/Using_the_WebVR_API). 要学习更多关于 VR 技术背后的基础概念,请阅读文章 [WebVR concepts](/zh-CN/docs/Web/API/WebVR_API/WebVR_concepts). - -### Using controllers: Combining WebVR with the Gamepad API +> **备注:** 要了解更多关于如何在你的应用程序中使用这些接口,请阅读文章[使用 WebVR API](/zh-CN/docs/Web/API/WebVR_API/Using_the_WebVR_API)。要学习更多关于 VR 技术背后的基础概念,请阅读文章 [WebVR 概念](/zh-CN/docs/Web/API/WebVR_API/WebVR_concepts)。 ### 使用控制器:将 WebVR 与 Gamepad API 相结合 @@ -40,44 +28,28 @@ Many WebVR hardware setups feature controllers that go along with the headset. T ## WebVR 接口 - {{domxref("Navigator.getVRDevices")}} - - : Returns a promise that resolves to an array of objects representing the VR devices attached to the computer. - **返回一个 Promise 对象,并通过 resolve 方式返回参数,参数为链接到电脑的 VR 设备数组。** + - : 返回一个会兑现连接到电脑的 VR 设备数组的 promise。 - {{domxref("VRDevice")}} - - : A generic VR device, includes information such as device IDs and descriptions. Inherited by `HMDVRDevice` and `PositionSensorVRDevice`. - **返回一个包括了 VR 设备 IDs,描述等信息的类。HMDVRDevice 和 PositionSensorVRDevice 继承了 VRDevice。** + - : 返回一个包括了 VR 设备 IDs,描述等信息的类。由 `HMDVRDevice` 和 `PositionSensorVRDevice` 继承。 - {{domxref("HMDVRDevice")}} - - : Represents a head mounted display, providing access to information about each eye, and the current field of view. - **头戴设备。提供设备双眼、当前 FOV(field of view)信息。** + - : 头戴设备。提供设备双眼、当前视野(FOV)信息。 - {{domxref("PositionSensorVRDevice")}} - - : Represents the position sensor for the VR hardware, allowing access to information such as position and orientation. - **VR 设备的位置传感器。获取位置、方向信息。** + - : VR 设备的位置传感器。获取位置、方向信息。 - {{domxref("VRPose")}} - - : Represents the position state at a given timestamp (which includes orientation, position, velocity, and acceleration.) - **根据一个时间戳返回包括(方向、位置、速度、加速度)的状态。** + - : 根据一个时间戳返回包括(方向、位置、速度、加速度)的状态。 - {{domxref("VREyeParameters")}} - - : Provides access to all the information required to correctly render a scene for each given eye, including field of view information. - **给双眼提供正确渲染场景的所有信息,包括 FOV。** + - : 给双眼提供正确渲染场景的所有信息,包括 FOV。 - {{domxref("VRFieldOfView")}} - - : Represents a field of view defined by 4 different degree values describing the view from a center point. - **返回以视窗的中心点为基点的,表示 FOV 的 4 个角度值(downDegrees, leftDegrees, rightDegrees, upDegrees)。** + - : 返回以视窗的中心点为基点的,表示 FOV 的 4 个角度值(downDegrees, leftDegrees, rightDegrees, upDegrees)。 - {{domxref("VRFieldOfViewReadOnly")}} - - : Contains the raw definition for the degree value properties required to define a field of view. Inherited by `VRFieldOfView`. - **定义一个 FOV 必须的角度属性。VRFieldOfView 继承了 VRFieldOfViewReadOnly。** + - : 定义一个 FOV 必须的角度属性。由 `VRFieldOfView` 继承。 ## 示例 -**【K】** - -You can find a number of examples at these Github repos: +你可以在 Github 的协议中找到一系列的案例: -**你可以在 Github 的协议中找到一系列的案例:** - -- [mdn/webvr-tests](https://github.com/mdn/webvr-tests): Simple demos built to illiustrate basic feature usage. -- **[mdn/webvr-tests](https://github.com/mdn/webvr-tests): 简单构建的 demos 用于阐明基本的使用方法。** -- -- [MozVR team](https://github.com/MozVR/): More advanced demos, the WebVR spec source, and more! -- **[MozVR team](https://github.com/MozVR/): 更多复杂的 demos,关于 WebVR 特别的资源,以及更多的内容!** -- **【K】** +- [mdn/webvr-tests](https://github.com/mdn/webvr-tests):简单构建的演示用于阐明基本的使用方法。 +- [MozVR team](https://github.com/MozVR/):更多复杂的演示,关于 WebVR 特别的资源,以及更多的内容! ## 规范 @@ -89,19 +61,12 @@ You can find a number of examples at these Github repos: {{Compat}} -## 相关文章 - -- [WebVR environment setup](/zh-CN/docs/Web/API/WebVR_API/WebVR_environment_setup) -- **建立 WEBVR 的运行环境。** -- [WebVR concepts](/zh-CN/docs/Web/API/WebVR_API/WebVR_concepts) -- **WEBVR 的相关概念。** -- [Using the WebVR API](/zh-CN/docs/Web/API/WebVR_API/Using_the_WebVR_API) -- **怎样使用 WEBVR API。** -- [MozVr.com](http://mozvr.com/) — demos, downloads, and other resources from the Mozilla VR team. -- **[MozVr.com](http://mozvr.com/) — demos,下载,以及其他的来自 MOZILLA VR 团队的资源。** -- [Console Game on Web](http://dsmu.me/ConsoleGameOnWeb/) — a collection of interesting game concept demos, some of which include WebVR. -- **[Console Game on Web](http://dsmu.me/ConsoleGameOnWeb/) — 一系列有趣的概念游戏 DEMO 的收集,其中有些包括了 WEBVR。** -- [threejs-vr-boilerplate](https://github.com/MozVR/vr-web-examples/tree/master/threejs-vr-boilerplate) — a very useful starter template for writing WebVR apps into. -- **[threejs-vr-boilerplate](https://github.com/MozVR/vr-web-examples/tree/master/threejs-vr-boilerplate) — 一个当你编写 WEBVR APP 时,非常有用的用于开始编程的模板。** -- [Oculus Rift homepage](https://developer.oculus.com/) -- **[Oculus Rift](https://developer.oculus.com/) 主页** +## 参见 + +- [建立 WebVR 的运行环境](/zh-CN/docs/Web/API/WebVR_API/WebVR_environment_setup) +- [WebVR 的相关概念](/zh-CN/docs/Web/API/WebVR_API/WebVR_concepts) +- [怎样使用 WebVR API](/zh-CN/docs/Web/API/WebVR_API/Using_the_WebVR_API) +- [MozVr.com](http://mozvr.com/)——演示、下载,以及其他的来自 MOZILLA VR 团队的资源。 +- [Console Game on Web](http://dsmu.me/ConsoleGameOnWeb/)——一系列有趣的概念游戏演示的集合,其中有些包括了 WebVR。 +- [threejs-vr-boilerplate](https://github.com/MozVR/vr-web-examples/tree/master/threejs-vr-boilerplate)——一个当你编写 WebVR APP 时,非常有用的用于开始编程的模板。 +- [Oculus Rift 主页](https://developer.oculus.com/) diff --git a/files/zh-cn/web/api/window/ondragdrop/index.md b/files/zh-cn/web/api/window/ondragdrop/index.md index 41b7538bd9020a..0beff2188f5736 100644 --- a/files/zh-cn/web/api/window/ondragdrop/index.md +++ b/files/zh-cn/web/api/window/ondragdrop/index.md @@ -9,45 +9,44 @@ slug: Web/API/Window/ondragdrop 一个事件处理程序,用于将拖放事件发送到窗口。 -**语法** +## 语法 -``` +```js-nolint window.ondragdrop = funcRef; window.addEventListener("dragdrop", funcRef, useCapturing); ``` -- funcRef +- `funcRef` - : 要注册的事件处理函数。 -[Gecko](/zh-CN/docs/Web/API/Window/en/Gecko)([Firefox bug 112288](https://bugzil.la/112288)) 中未实现`window.ondragdrop`属性和`ondragdrop`属性,你必须使用`addEventListener`。有关详细信息,请参见[addEventListener](/zh-CN/docs/Web/API/Window/en/DOM/element.addEventListener)。 +Firefox 中未实现 `window.ondragdrop` 属性和 `ondragdrop` 属性([Firefox bug 112288](https://bugzil.la/112288)),你必须使用 `addEventListener`。有关详细信息,请参见 [addEventListener](/zh-CN/docs/Web/API/EventTarget/addEventListener)。 -**示例** +## 示例 ### 在拖放时触发 alert 在此示例中,事件侦听器被添加到窗口(事件目标)。如果从外部源将选项卡,链接,标记的文本或文件拖放到此窗口上,则会触发警报。注意`event.stopPropagation()`; 阻止浏览器加载放置的标签,链接或文件。 -``` +```html -dragdroptest - - - - - -I am bodytext - + + dragdroptest + + + + + I am bodytext + ``` -**规范** +## 规范 不属于规范部分。 diff --git a/files/zh-cn/web/api/xmldocument/index.md b/files/zh-cn/web/api/xmldocument/index.md index 7e78a965fd5926..6026793331e6ca 100644 --- a/files/zh-cn/web/api/xmldocument/index.md +++ b/files/zh-cn/web/api/xmldocument/index.md @@ -11,11 +11,11 @@ The **XMLDocument** interface represents an XML document. It inherits from the g ## 属性 -_Also inherits properties from: {{DOMxRef("Document")}}_ +_Also inherits properties from: {{DOMxRef("Document")}}._ ## 方法 -_Also inherits methods from: {{DOMxRef("Document")}}_ +_Also inherits methods from: {{DOMxRef("Document")}}._ ## 规范 diff --git a/files/zh-cn/web/css/css_generated_content/index.md b/files/zh-cn/web/css/css_generated_content/index.md index d30ebbf70b7c69..8730f83822a0c8 100644 --- a/files/zh-cn/web/css/css_generated_content/index.md +++ b/files/zh-cn/web/css/css_generated_content/index.md @@ -5,7 +5,7 @@ slug: Web/CSS/CSS_generated_content {{CSSRef}} -**CSS Generated Content 是 CSS 其中一个模块,定义了如何给一个元素添加内容** +CSS 生成内容(Generated Content)是 CSS 其中一个模块,定义了如何给一个元素添加内容。 ## 参考 diff --git a/files/zh-cn/web/css/overscroll-behavior-y/index.md b/files/zh-cn/web/css/overscroll-behavior-y/index.md index ca748ef5d3d12a..84576b26136ab5 100644 --- a/files/zh-cn/web/css/overscroll-behavior-y/index.md +++ b/files/zh-cn/web/css/overscroll-behavior-y/index.md @@ -46,7 +46,7 @@ overscroll-behavior-y: unset; ## 示例 -### 阻止底部元素在垂直方向上滚动。 +### 阻止底部元素在垂直方向上滚动 ```css .messages { diff --git a/files/zh-cn/web/http/headers/permissions-policy/index.md b/files/zh-cn/web/http/headers/permissions-policy/index.md index b4ec73e22af696..d7ab2fb9f9005a 100644 --- a/files/zh-cn/web/http/headers/permissions-policy/index.md +++ b/files/zh-cn/web/http/headers/permissions-policy/index.md @@ -19,20 +19,16 @@ slug: Web/HTTP/Headers/Permissions-Policy Permissions-Policy: ``` -**\** +- `` -- `*`: 允许在当前文档和所有包含的内容(比如 iframes)中使用本特性。 -- `'self'`: 允许在当前文档中使用本特性,但在包含的内容(比如 iframes)仍使用原值。 -- `'src'`: (只在 iframe 中允许) 只要在{{HTMLElement('iframe','src','#Attributes')}} 中的 URL 和加载 iframe 用的 URL 相同,则本特性在 iframe 中允许, -- `'none'`: 从最上层到包含的内容都禁止本特性。 \: 在特定的源中允许,源 URL 以空格分割。 + - : 一个来源列表,在括号中包含的以下一个或多个值,并用空格分隔: - + - `*`: 允许在当前文档和所有包含的内容(比如 iframes)中使用本特性。 + - `'self'`: 允许在当前文档中使用本特性,但在包含的内容(比如 iframes)仍使用原值。 + - `'src'`: (只在 iframe 中允许) 只要在{{HTMLElement('iframe','src','#Attributes')}} 中的 URL 和加载 iframe 用的 URL 相同,则本特性在 iframe 中允许, + - `'none'`: 从最上层到包含的内容都禁止本特性。 \: 在特定的源中允许,源 URL 以空格分割。 -- `*`: 本特性默认在最上层和包含的内容中(iframes)允许。 -- `'self'`: 本特性默认在最上层允许,而包含的内容中(iframes)使用源地址相同设定。也就是说本特性在 iframe 中不允许跨域访问。 -- `'none'`: 本特性默认在最上层和包含的内容中(iframes)都禁止。 - -`*`(在所有源地址启用)`或'none'`(在所有源地址禁用) 只允许单独使用,而`'self'`和`'src'`可以与多个源地址一起使用。 +`*` 或 `none` 值只允许单独使用,而 `self` 和 `src` 值可以与多个源一起使用。 所有的特性都有一个如下的默认的 allowlist diff --git a/files/zh-cn/web/http/proxy_servers_and_tunneling/proxy_auto-configuration_pac_file/index.md b/files/zh-cn/web/http/proxy_servers_and_tunneling/proxy_auto-configuration_pac_file/index.md index 4bd2f37d2090aa..8860f2e651493e 100644 --- a/files/zh-cn/web/http/proxy_servers_and_tunneling/proxy_auto-configuration_pac_file/index.md +++ b/files/zh-cn/web/http/proxy_servers_and_tunneling/proxy_auto-configuration_pac_file/index.md @@ -316,7 +316,7 @@ myIpAddress() #### 参数 -**(无)** +无。 获取当前 Firefox 所在设备的 IP 地址,并返回为标准格式的 IP 地址字符串。 diff --git a/files/zh-cn/web/javascript/guide/expressions_and_operators/index.md b/files/zh-cn/web/javascript/guide/expressions_and_operators/index.md index d4be73311020e5..baedf915326fa5 100644 --- a/files/zh-cn/web/javascript/guide/expressions_and_operators/index.md +++ b/files/zh-cn/web/javascript/guide/expressions_and_operators/index.md @@ -186,8 +186,6 @@ var var2 = 4; 逻辑运算符常用于布尔(逻辑)值之间; 当操作数都是布尔值时,返回值也是布尔值。不过实际上`&&`和`||`返回的是一个特定的操作数的值,所以当它用于非布尔值的时候,返回值就可能是非布尔值。逻辑运算符的描述如下。 -**逻辑运算符** - | 运算符 | 范例 | 描述 | | ---------------------------------------------------------------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [逻辑与](/zh-CN/docs/Web/JavaScript/Reference/Operators/Logical_Operators#Logical_AND) `(&&`) | `expr1 && expr2` | (逻辑与) 如果 expr1 能被转换为 false,那么返回 expr1;否则,返回`expr2`。因此`,&&`用于布尔值时,当操作数都为 true 时返回 true;否则返回 false. | @@ -505,8 +503,6 @@ if (theDay instanceof Date) { 下表列出了描述符的优先级,从最高到最低。 -**运算符优先级** - | Operator type | Individual operators | | ---------------------- | ----------------------------------------- | | member | `. []` | diff --git a/files/zh-cn/web/javascript/guide/numbers_and_dates/index.md b/files/zh-cn/web/javascript/guide/numbers_and_dates/index.md index 0855ab822c4d18..3ea1647f9b7edc 100644 --- a/files/zh-cn/web/javascript/guide/numbers_and_dates/index.md +++ b/files/zh-cn/web/javascript/guide/numbers_and_dates/index.md @@ -97,8 +97,6 @@ const notANum = Number.NaN; 下面的表格汇总了数字对象的属性: -**数字的属性** - | 属性 | 描述 | | -------------------------------------- | ----------------------------------------------------------------- | | {{jsxref("Number.MAX_VALUE")}} | 可表示的最大值 | diff --git a/files/zh-cn/web/javascript/reference/global_objects/math/log1p/index.md b/files/zh-cn/web/javascript/reference/global_objects/math/log1p/index.md index 0a640008a81c90..eb606b6c3656bc 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/math/log1p/index.md +++ b/files/zh-cn/web/javascript/reference/global_objects/math/log1p/index.md @@ -28,7 +28,7 @@ Math.log1p(x) ![log(x+1)](logx1.jpg) -**示例** +## 示例 ```js Math.log1p(Math.E - 1); // 1 diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/replace/index.md b/files/zh-cn/web/javascript/reference/global_objects/string/replace/index.md index 6a641992c3cdc4..9536cb81ac8cec 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/replace/index.md +++ b/files/zh-cn/web/javascript/reference/global_objects/string/replace/index.md @@ -154,7 +154,7 @@ console.log(newstr); // Cruz, Maria 这将打印 `'Cruz, Maria'`。 -### 使用內联函数来修改匹配到的字符。 +### 使用内联函数来修改匹配到的字符 在这个例子中,字符串中所有出现的大写字母都被转换为小写,并且在匹配位置前插入一个连字符。重要的是,在将匹配项作为替换返回之前,需要对匹配项进行额外的操作。 diff --git a/files/zh-cn/web/javascript/reference/operators/super/index.md b/files/zh-cn/web/javascript/reference/operators/super/index.md index 4d820e830249d5..2ad98a52f74963 100644 --- a/files/zh-cn/web/javascript/reference/operators/super/index.md +++ b/files/zh-cn/web/javascript/reference/operators/super/index.md @@ -239,7 +239,7 @@ Object.setPrototypeOf(Extended, AnotherBase); console.log(Extended.staticGetX()); //现在打印 "4" ``` -### 设置 super.prop 将在此基础上设置属性。 +### 设置 super.prop 将在此基础上设置属性 设置 `super` 的属性,比如 `super.x = 1`,就像 `Reflect.set(Object.getPrototypeOf(objectLiteral), "x", 1, this)` 的行为。这是一个将 `super` 简单理解为“原型对象的引用”的情况,因为它实际上是在 `this` 上设置属性。 diff --git a/files/zh-cn/web/media/autoplay_guide/index.md b/files/zh-cn/web/media/autoplay_guide/index.md index 8e43d525edc811..61013efb20762f 100644 --- a/files/zh-cn/web/media/autoplay_guide/index.md +++ b/files/zh-cn/web/media/autoplay_guide/index.md @@ -151,8 +151,6 @@ if (startPlayPromise !== undefined) { 在 [Web Audio API](/zh-CN/docs/Web/API/Web_Audio_API) 中,网站或应用程序可以使用链接到 {{domxref("AudioContext")}} 的源节点上的 `start()` 方法开始播放音频。在处理用户输入事件的上下文之外执行此操作受自动播放规则的约束。 -_更多内容即将推出;Mozilla 仍在致力于阻止自动播放。如果其他人已经拥有它,欢迎他们参与本部分……_ - ## 自动播放功能策略 除了上述的浏览器端管理和对自动播放功能的控制之外,web 服务器也可以表示愿意让自动播放功能发挥作用。{{Glossary("HTTP")}} {{HTTPHeader("Permissions-Policy")}} 标头的 [`autoplay`](/zh-CN/docs/Web/HTTP/Headers/Permissions-Policy/autoplay) 指令用于控制哪些域(如果有)可用于自动播放媒体。默认情况下, `autoplay` 功能策略设置为 `'self'`(_包括单引号字符_),表示允许自动播放,因为它们与文档托管在同一域中。 diff --git a/files/zh-cn/web/media/dash_adaptive_streaming_for_html_5_video/index.md b/files/zh-cn/web/media/dash_adaptive_streaming_for_html_5_video/index.md index 656128c8d24a22..e8a90eb726eb2d 100644 --- a/files/zh-cn/web/media/dash_adaptive_streaming_for_html_5_video/index.md +++ b/files/zh-cn/web/media/dash_adaptive_streaming_for_html_5_video/index.md @@ -15,7 +15,7 @@ Firefox 23 移除了针对 HTML5 WebM 视频的 DASH 实现。此功能将被 [ 首先,你需要将 WebM 视频转换为带有不同比特率的随附视频文件的 DASH 清单。根据你的需求,启动从 [ffmpeg.org](http://www.ffmpeg.org) 的 ffmpeg 程序,就可以使用 libvpx 和 libbvorbis 支持的 WebM 视频和音频(版本 2.5 以上,3.2.5 版本已通过测试)。 -### 1. 使用现有的 WebM 文件创建一个音频文件和多个视频文件。 +### 1. 使用现有的 WebM 文件创建一个音频文件和多个视频文件 例如: diff --git a/files/zh-cn/web/svg/attribute/stroke-dasharray/index.md b/files/zh-cn/web/svg/attribute/stroke-dasharray/index.md index 385b11bbb09a01..090d4d25a3f9fb 100644 --- a/files/zh-cn/web/svg/attribute/stroke-dasharray/index.md +++ b/files/zh-cn/web/svg/attribute/stroke-dasharray/index.md @@ -56,13 +56,13 @@ slug: Web/SVG/Attribute/stroke-dasharray ``` -**示例输出** +### 示例输出 {{ EmbedLiveSample('示例','220','220') }} ## 元素 -下列元素可以使用`stroke-dasharray 属性:` +下列元素可以使用 `stroke-dasharray` 属性: - [形状元素](/zh-CN/SVG/Element#Shape_elements) » - [文本内容元素](/zh-CN/SVG/Element#Text_content_elements) » diff --git a/files/zh-cn/web/svg/attribute/stroke-linecap/index.md b/files/zh-cn/web/svg/attribute/stroke-linecap/index.md index 5953085e517bf1..9b88e516ca1a4c 100644 --- a/files/zh-cn/web/svg/attribute/stroke-linecap/index.md +++ b/files/zh-cn/web/svg/attribute/stroke-linecap/index.md @@ -16,7 +16,7 @@ slug: Web/SVG/Attribute/stroke-linecap | 属性值 | butt \| round \| square \| inherit | | 可动画化 | 是 | -## Example +## 示例 ```html @@ -57,9 +57,7 @@ slug: Web/SVG/Attribute/stroke-linecap ``` -**实时样例** - -{{ EmbedLiveSample('Example','120','120') }} +{{ EmbedLiveSample('示例','120','120') }} ## 元素 diff --git a/files/zh-cn/web/svg/attribute/stroke/index.md b/files/zh-cn/web/svg/attribute/stroke/index.md index 8631dfa7157902..b016fd9b5219f6 100644 --- a/files/zh-cn/web/svg/attribute/stroke/index.md +++ b/files/zh-cn/web/svg/attribute/stroke/index.md @@ -18,7 +18,7 @@ slug: Web/SVG/Attribute/stroke ## SVG 描边的线 -### 示例 1:用 stroke 属性画一条绿色的直线。 +### 示例 1:用 stroke 属性画一条绿色的直线 ```html diff --git a/files/zh-cn/web/svg/attribute/text-anchor/index.md b/files/zh-cn/web/svg/attribute/text-anchor/index.md index ab244bcd9cf8ce..4be1e1c36a6acd 100644 --- a/files/zh-cn/web/svg/attribute/text-anchor/index.md +++ b/files/zh-cn/web/svg/attribute/text-anchor/index.md @@ -62,8 +62,6 @@ slug: Web/SVG/Attribute/text-anchor ``` -**Live sample** - {{ EmbedLiveSample('示例','120','120') }} ## 元素 diff --git a/files/zh-cn/web/svg/element/animatetransform/index.md b/files/zh-cn/web/svg/element/animatetransform/index.md index 106582270df4ea..bf691c18e082e8 100644 --- a/files/zh-cn/web/svg/element/animatetransform/index.md +++ b/files/zh-cn/web/svg/element/animatetransform/index.md @@ -35,8 +35,6 @@ slug: Web/SVG/Element/animateTransform ``` -**示例输出** - {{ EmbedLiveSample('示例','120','120') }} ## 属性 diff --git a/files/zh-cn/web/svg/element/defs/index.md b/files/zh-cn/web/svg/element/defs/index.md index 829924ef1fb34c..508a18be777e8e 100644 --- a/files/zh-cn/web/svg/element/defs/index.md +++ b/files/zh-cn/web/svg/element/defs/index.md @@ -44,7 +44,7 @@ SVG 允许我们定义以后需要重复使用的图形元素。建议把所有 ### 专有属性 -_没有专有属性_ +_没有专有属性。_ ## DOM 接口 @@ -54,6 +54,6 @@ _没有专有属性_ {{Compat}} -## 相关内容 +## 参见 - {{ SVGElement("use") }} diff --git a/files/zh-cn/web/svg/element/desc/index.md b/files/zh-cn/web/svg/element/desc/index.md index e508436a327930..b54655b0349377 100644 --- a/files/zh-cn/web/svg/element/desc/index.md +++ b/files/zh-cn/web/svg/element/desc/index.md @@ -23,7 +23,7 @@ SVG 绘画中的每个容器元素或图形元素都可以提供一个`desc`描 ### 专有属性 -_没有专有属性_ +_没有专有属性。_ ## DOM 接口 diff --git a/files/zh-cn/web/svg/element/fefunca/index.md b/files/zh-cn/web/svg/element/fefunca/index.md index 2182464429287b..9e70f5d065eb5b 100644 --- a/files/zh-cn/web/svg/element/fefunca/index.md +++ b/files/zh-cn/web/svg/element/fefunca/index.md @@ -20,7 +20,7 @@ slug: Web/SVG/Element/feFuncA ### 专有属性 -_无_ +_无。_ ## DOM 接口 diff --git a/files/zh-cn/web/svg/element/femerge/index.md b/files/zh-cn/web/svg/element/femerge/index.md index d7f897cfc1775e..3f3916802fe1ed 100644 --- a/files/zh-cn/web/svg/element/femerge/index.md +++ b/files/zh-cn/web/svg/element/femerge/index.md @@ -25,7 +25,7 @@ slug: Web/SVG/Element/feMerge ### 专有属性 -_无_ +_无。_ ## DOM 接口 diff --git a/files/zh-cn/web/svg/element/font-face-src/index.md b/files/zh-cn/web/svg/element/font-face-src/index.md index 3fced6ffc00f94..c5e4d3241053aa 100644 --- a/files/zh-cn/web/svg/element/font-face-src/index.md +++ b/files/zh-cn/web/svg/element/font-face-src/index.md @@ -21,7 +21,7 @@ slug: Web/SVG/Element/font-face-src ### 专有属性 -_无_ +_无。_ ## DOM 接口 diff --git a/files/zh-cn/web/svg/element/metadata/index.md b/files/zh-cn/web/svg/element/metadata/index.md index 2a3c0203b3fe85..1d6cc3491182ca 100644 --- a/files/zh-cn/web/svg/element/metadata/index.md +++ b/files/zh-cn/web/svg/element/metadata/index.md @@ -21,7 +21,7 @@ slug: Web/SVG/Element/metadata ### 专有属性 -_没有专有属性_ +_没有专有属性。_ ## DOM 接口 diff --git a/files/zh-cn/web/svg/element/title/index.md b/files/zh-cn/web/svg/element/title/index.md index 9d1c93f0b1c7f1..969480f596a499 100644 --- a/files/zh-cn/web/svg/element/title/index.md +++ b/files/zh-cn/web/svg/element/title/index.md @@ -37,7 +37,7 @@ SVG 绘图中的每个窗口元素或图形元素都可以提供一个`title`描 ### 专有属性 -_没有专有属性_ +_没有专有属性。_ ## DOM 接口 diff --git a/files/zh-tw/.markdownlint.jsonc b/files/zh-tw/.markdownlint.jsonc index ef3f5fff9a7fcc..0b1ced60fe026d 100644 --- a/files/zh-tw/.markdownlint.jsonc +++ b/files/zh-tw/.markdownlint.jsonc @@ -1,5 +1,8 @@ { "extends": "../../.markdownlint.jsonc", + "no-trailing-punctuation": { + "punctuation": ".,;:。," + }, "search-replace": { "rules": [ { @@ -84,15 +87,14 @@ "searchPattern": "/\\]\\(https:\\/\\/developer.mozilla.org\\/(?!en-US\\/blog\\/)/g", "replace": "](/", "searchScope": "text" + }, + { + "name": "localhost-links", + "message": "Don't use localhost for links", + "searchPattern": "/\\]\\(https?:\\/\\/localhost:\\d+\\//g", + "replace": "](/", + "searchScope": "text" } - // XXX Many instances still found in translated content - // { - // "name": "localhost-links", - // "message": "Don't use localhost for links", - // "searchPattern": "/\\]\\(https?:\\/\\/localhost:\\d+\\//g", - // "replace": "](/", - // "searchScope": "text" - // } ] } } diff --git a/files/zh-tw/learn/css/howto/css_faq/index.md b/files/zh-tw/learn/css/howto/css_faq/index.md index 0018dd4425c6a6..65090ed01fd66b 100644 --- a/files/zh-tw/learn/css/howto/css_faq/index.md +++ b/files/zh-tw/learn/css/howto/css_faq/index.md @@ -5,7 +5,7 @@ slug: Learn/CSS/Howto/CSS_FAQ {{LearnSidebar}} -#### 我的 CSS 合乎規格,但繪出的版面有誤 +## 我的 CSS 合乎規格,但繪出的版面有誤 如果想讓大部分的瀏覽器都能正確繪製標準 HTML/CSS 頁面,便須於 HTML 檔案中放上完整的正確 DOCTYPE。 @@ -34,7 +34,7 @@ slug: Learn/CSS/Howto/CSS_FAQ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> ``` -#### `id` 與 `class` 之間的差別 +## `id` 與 `class` 之間的差別 HTML 元素都可有 `id` 及 `class` 屬性。`id` 屬性是讓你為元素命名的,整個頁面中的元素名稱也不應有重複;`class` 屬性則可將元素歸為某特定類別,通常也會有很多元素屬於同一種類別 (意即 `class` 屬性值相同。) CSS 可以讓你以 `id` 或 `class` 來決定某元素的樣式。 @@ -44,7 +44,7 @@ HTML 元素都可有 `id` 及 `class` 屬性。`id` 屬性是讓你為元素命 這方面的資訊亦可參考 [CSS 選取符](zh_tw/CSS/Getting_Started/Selectors)。 -#### 恢復某特性的預設值 +## 恢復某特性的預設值 CSS2 並不提供任何指定某特性預設值的方法,所以要恢復某特性預設值的唯一方法就是重新指定此值。此外你自己得知道預設值是什麼,因為 CSS 也沒有所謂 _default_ 的關鍵字。 @@ -52,30 +52,33 @@ CSS2 並不提供任何指定某特性預設值的方法,所以要恢復某特 此外,由於 CSS 具*串聯*特性,指定選取符時通常越明確越好,以免把不相干的元素都牽扯進來。 -#### 相依樣式 +## 相依樣式 CSS 並不支援「以另一個樣式規則為基準」的樣式設定法。 (參考 [Eric Meyer 所寫、關於 CSS 工作小組的說明](http://archivist.incutio.com/viewlist/css-discuss/2685)。) 不過,你可以為某單一元素套上多重樣式,製作出類似效果。 -#### 套用多重類別 +## 套用多重類別 你可以在 HTML 元素的 `class` 屬性裡以空白字元分隔填上多個樣式類別名稱,便能同時套用多重類別。 -```plain +```html
-... content ... -... content ... -... content ... +
``` 若是這些規則中設定了同一種特性值,則會依序以明確性(specificity)、定義位置先後決定顯示方式,與`class` 屬性中的次序無關。 -#### 無用樣式 +## 無用樣式 即使樣式規則已經正確設定完畢,還是可能為瀏覽器所忽略,此時通常是經過語法及優先權法則判斷後的正常現象。 @@ -87,26 +90,25 @@ CSS 並不支援「以另一個樣式規則為基準」的樣式設定法。 ( - 使用 `*` 選取符 - CSS 明確性 -你可以使用 [DOM 觀察器](zh_tw/DOM_%e8%a7%80%e5%af%9f%e5%99%a8) 的 _CSS Style Rules_ 來檢查上述問題。 +你可以使用 [DOM 觀察器](https://firefox-source-docs.mozilla.org/devtools-user/page_inspector/how_to/examine_and_edit_css/index.html) 的 _CSS Style Rules_ 來檢查上述問題。 -**HTML 元素層次問題** +### HTML 元素層次問題 此時 CSS 樣式套用與否與元素的層次大有相關,請留意:套用到子元素的樣式必定會蓋過母元素的樣式,跟明確性或 CSS 規則的優先權無關。 -```plain -#section { font-weight: bold; } -.redtext { font-weight: normal; color: red; } +```html +#section { font-weight: bold; } .redtext { font-weight: normal; color: red; }
- 粗體、 - 正常紅字、 - 又見粗體 + 粗體、 + 正常紅字、 + 又見粗體
``` 如果你的 HTML 層級錯綜複雜,發生規則意外被忽略的情形時,請檢查元素層級問題。可能有某個子元素套上了不該用的樣式。 -**樣式規則重新定義** +### 樣式規則重新定義 在 CSS 樣式表中,先後次序**非常**重要。如果你定義了某規則後又重新定義一次,則晚定義的才算數。 @@ -127,7 +129,7 @@ CSS 並不支援「以另一個樣式規則為基準」的樣式設定法。 ( 為避免此類錯誤發生,每個特定選取符請僅定義一次樣式,集中特性一次定義也便於管理些。 -**特性的簡寫法** +### 特性的簡寫法 使用簡寫法來定義樣式簡明扼要,是個不錯的方法。你也可以用簡寫法設定某組特性中的部分特性值,但須留意其他沒寫到的部分會自動採用預設值。這表示之前的規則中為某單一特性定義的值可能失效。 @@ -144,14 +146,14 @@ CSS 並不支援「以另一個樣式規則為基準」的樣式設定法。 ( 前一個例子中,套用到不同元素範圍的同族特性是問題所在,但就算特性都寫在同一條規則裡也可能出問題,因為順序**真的**很重要。 -```plain +```css #section { - font-weight: bold; - font: 12px Verdana; /* 有了這行,font-weight 又回到預設的 normal 了 */ + font-weight: bold; + font: 12px Verdana; /* 有了這行,font-weight 又回到預設的 normal 了 */ } ``` -**使用 `*` 選取符** +### 使用 `*` 選取符 `*` 選取符表示任何元素皆符合,但使用上應多加小心。 @@ -172,7 +174,7 @@ body * { font-weight: normal; } 在此例中,選取符為 `body *` 的規則會套用到所有 `body` 內的元素,也包括 _redtext_,所以原先套用到 _boldtext_ 的 `font-weight: bold;` 就被覆蓋為 `font-weight: normal;` 了。 -**CSS 明確性** +### CSS 明確性 如果某元素會套用好幾條規則,則相衝突的特性就要靠規則的明確性來分高下。行內樣式(放在 HTML 各標籤的 `style` 屬性中)優先權最高,其次是以 `id` 做選取符的規則,再其次是以 `class` 套用的類別,最後則是單純以元素名稱當選取符的規則。 @@ -186,6 +188,6 @@ div { color: black; } 如果樣式規則的選取符分成好幾段,計算方式就更為複雜一些。需要瞭解完整資訊者,請參考 [CSS 2.1 規格書的 6.4.3 一節](https://www.w3.org/TR/CSS21/cascade.html#specificity)。 -#### -moz-\* 特性是什麼玩意? +## -moz-\* 特性是什麼玩意? -請見 [Mozilla 擴充的 CSS](zh_tw/Mozilla_%e6%93%b4%e5%85%85%e7%9a%84_CSS)。由於這些擴充規格不是 W3C 標準的一部分,因此並不建議使用。 +請見 [Mozilla 擴充的 CSS](/zh-TW/docs/Web/CSS/Mozilla_Extensions)。由於這些擴充規格不是 W3C 標準的一部分,因此並不建議使用。 diff --git a/files/zh-tw/mozilla/add-ons/webextensions/anatomy_of_a_webextension/index.md b/files/zh-tw/mozilla/add-ons/webextensions/anatomy_of_a_webextension/index.md index b0ff56006dbdb5..e66cce47e87ecb 100644 --- a/files/zh-tw/mozilla/add-ons/webextensions/anatomy_of_a_webextension/index.md +++ b/files/zh-tw/mozilla/add-ons/webextensions/anatomy_of_a_webextension/index.md @@ -46,7 +46,7 @@ slug: Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension 然而,你也可以先載入一個後台頁面,然後在後台頁面中載入腳本。這樣的做法能為後台腳本提供 ES 6 模組的支援,算是一个優點。 -**manifest.json** +manifest.json: ```json // manifest.json @@ -56,7 +56,7 @@ slug: Mozilla/Add-ons/WebExtensions/Anatomy_of_a_WebExtension } ``` -**background-page.html** +background-page.html: ```html diff --git a/files/zh-tw/web/api/canvas_api/tutorial/basic_animations/index.md b/files/zh-tw/web/api/canvas_api/tutorial/basic_animations/index.md index e9e094aa0f8a4d..60935adab38189 100644 --- a/files/zh-tw/web/api/canvas_api/tutorial/basic_animations/index.md +++ b/files/zh-tw/web/api/canvas_api/tutorial/basic_animations/index.md @@ -334,7 +334,7 @@ function draw() { ``` -**Live sample** +##### 結果 {{EmbedLiveSample("循環景色", "830", "230")}} diff --git a/files/zh-tw/web/api/customevent/index.md b/files/zh-tw/web/api/customevent/index.md index f06d074ff00be7..ef1360710a6b40 100644 --- a/files/zh-tw/web/api/customevent/index.md +++ b/files/zh-tw/web/api/customevent/index.md @@ -18,7 +18,7 @@ slug: Web/API/CustomEvent ## 屬性 -_此介面繼承了其父介面 {{domxref("Event")}} 的屬性_ +_此介面繼承了其父介面 {{domxref("Event")}} 的屬性。_ - {{domxref("CustomEvent.initCustomEvent()")}} {{deprecated_inline}} - : 初始化一個`CustomEvent`物件。若該事件已經被觸發,則不會進行任何動作。 @@ -31,7 +31,7 @@ _此介面繼承了其父介面 {{domxref("Event")}} 的屬性_ {{Compat}} -## 延伸閱讀 +## 參見 - {{domxref("Window.postMessage()")}} - [Creating and triggering events](/zh-TW/docs/Web/Events/Creating_and_triggering_events) diff --git a/files/zh-tw/web/api/documentfragment/index.md b/files/zh-tw/web/api/documentfragment/index.md index a0f8108dd58ab3..2c6bf39d18c3f3 100644 --- a/files/zh-tw/web/api/documentfragment/index.md +++ b/files/zh-tw/web/api/documentfragment/index.md @@ -33,7 +33,7 @@ _This interface has no specific properties, but inherits those of its parent,_ _ ## 方法 -_This interface inherits the methods of its parent, {{domxref("Node")}}, and implements those of the {{domxref("ParentNode")}} interface*.*_ +_This interface inherits the methods of its parent, {{domxref("Node")}}, and implements those of the {{domxref("ParentNode")}} interface._ - {{domxref("DocumentFragment.find()")}} {{experimental_inline}} - : Returns the first matching {{domxref("Element")}} in the tree of the `DocumentFragment`. diff --git a/files/zh-tw/web/api/keyboardevent/index.md b/files/zh-tw/web/api/keyboardevent/index.md index bfe4740f8d19b8..4a182582229fd9 100644 --- a/files/zh-tw/web/api/keyboardevent/index.md +++ b/files/zh-tw/web/api/keyboardevent/index.md @@ -9,14 +9,14 @@ slug: Web/API/KeyboardEvent > **備註:** `KeyboardEvent` 僅顯示在鍵盤上發生的事。當你需要進行文字輸入的操作,請使用 HTML5 [`input`](/zh-TW/docs/DOM/DOM_event_reference/input) event 代替 `KeyboardEvent` 。舉例來說,當使用者在手寫系統,例如平板電腦,輸入文字時,並不會啟動 key events 。 -## Constructor +## 建構子 - {{domxref("KeyboardEvent.KeyboardEvent", "KeyboardEvent()")}} - - : 建立一 `KeyboardEvent` object。 + - : 建立一 `KeyboardEvent` 物件。 -## Methods +## 方法 -_本介面( interface)亦繼承其父, {{domxref("UIEvent")}} 和 {{domxref("Event")}} ,的 methods_ +_本介面(interface)亦繼承其父 {{domxref("UIEvent")}} 和 {{domxref("Event")}} 的方法。_ - {{domxref("KeyboardEvent.getModifierState()")}} - : 回傳一 {{jsxref("Boolean")}}。用來表示當事件建立時,修飾鍵(例如 AltShiftCtrl、或是 Meta) 是否是按下的。 diff --git a/files/zh-tw/web/javascript/guide/using_promises/index.md b/files/zh-tw/web/javascript/guide/using_promises/index.md index e67c2ad8e90d58..73fa4741a34395 100644 --- a/files/zh-tw/web/javascript/guide/using_promises/index.md +++ b/files/zh-tw/web/javascript/guide/using_promises/index.md @@ -71,8 +71,6 @@ let promise2 = doSomething().then(successCallback, failureCallback); 在古時候,多個非同步函數會使用 Callback 方式,導致波動拳問題: -_(原文 Pyramid of Doom 查無中文翻譯,以較常見之波動拳取代)_ - ```js doSomething(function (result) { doSomethingElse( diff --git a/files/zh-tw/web/javascript/reference/global_objects/array/index.md b/files/zh-tw/web/javascript/reference/global_objects/array/index.md index 546eeaa6199fe4..28f4815b421db5 100644 --- a/files/zh-tw/web/javascript/reference/global_objects/array/index.md +++ b/files/zh-tw/web/javascript/reference/global_objects/array/index.md @@ -7,112 +7,9 @@ slug: Web/JavaScript/Reference/Global_Objects/Array JavaScript 中的 **`Array`** 全域物件被用於建構陣列;陣列為高階(high-level)、似列表(list-like)的物件。陣列在 Javascript 裡面並沒有固定的長度與型別。由於陣列的長度可以隨時被改變,所以並不能保證陣列的密度。這取決於開發者如何使用陣列。一般來說,這是個非常方便的特性,但如果這並不適用於你的開發工作,你也許會考慮使用型別陣列。 -**建立陣列** - -```js -var fruits = ["Apple", "Banana"]; - -console.log(fruits.length); -// 2 -``` - -**(透過索引)取得陣列項目** - -```js -var first = fruits[0]; -// Apple - -var last = fruits[fruits.length - 1]; -// Banana -``` - -**迭代陣列** - -```js -fruits.forEach(function (item, index, array) { - console.log(item, index); -}); -// Apple 0 -// Banana 1 -``` - -**加入項目至陣列末端** - -```js -var newLength = fruits.push("Orange"); -// ["Apple", "Banana", "Orange"] -``` - -**移除陣列末端項目** - -```js -var last = fruits.pop(); // 移除 (最末端的) Orange -// ["Apple", "Banana"]; -``` - -**移除陣列前端項目** - -```js -var first = fruits.shift(); // 移除 (最前端的) Apple -// ["Banana"]; -``` - -**加入項目至陣列前端** - -```js -var newLength = fruits.unshift("Strawberry"); // 加到陣列前端 -// ["Strawberry", "Banana"]; -``` - -**在陣列中尋找項目的索引** - -```js -fruits.push("Mango"); -// ["Strawberry", "Banana", "Mango"] - -var pos = fruits.indexOf("Banana"); -// 1 -``` - -**移除指定索引位置的項目** - -```js -var removedItem = fruits.splice(pos, 1); // 移除 pos 起的 1 個項目 - -// ["Strawberry", "Mango"] -``` - -**移除指定索引位置起的多個項目** - -```js -var vegetables = ["Cabbage", "Turnip", "Radish", "Carrot"]; -console.log(vegetables); -// ["Cabbage", "Turnip", "Radish", "Carrot"] - -var pos = 1, - n = 2; - -var removedItems = vegetables.splice(pos, n); -// 這就是移除項目的方式, -// n 表示從該位置 (pos) 開始,一直到陣列的尾端有多少項目需要移除 - -console.log(vegetables); -// ["Cabbage", "Carrot"] (原始的陣列被改變) - -console.log(removedItems); -// ["Turnip", "Radish"] -``` - -**複製陣列** - -```js -var shallowCopy = fruits.slice(); // 這就是複製陣列的方式 -// ["Strawberry", "Mango"] -``` - ## 語法 -```plain +```js-nolint [element0, element1, ..., elementN] new Array(element0, element1[, ...[, elementN]]) new Array(arrayLength) @@ -362,6 +259,100 @@ if (msgArray.length === 100) { } ``` +### (透過索引)取得陣列項目 + +```js +var first = fruits[0]; +// Apple + +var last = fruits[fruits.length - 1]; +// Banana +``` + +### 迭代陣列 + +```js +fruits.forEach(function (item, index, array) { + console.log(item, index); +}); +// Apple 0 +// Banana 1 +``` + +### 加入項目至陣列末端 + +```js +var newLength = fruits.push("Orange"); +// ["Apple", "Banana", "Orange"] +``` + +### 移除陣列末端項目 + +```js +var last = fruits.pop(); // 移除(最末端的)Orange +// ["Apple", "Banana"]; +``` + +### 移除陣列前端項目 + +```js +var first = fruits.shift(); // 移除(最前端的)Apple +// ["Banana"]; +``` + +### 加入項目至陣列前端 + +```js +var newLength = fruits.unshift("Strawberry"); // 加到陣列前端 +// ["Strawberry", "Banana"]; +``` + +### 在陣列中尋找項目的索引 + +```js +fruits.push("Mango"); +// ["Strawberry", "Banana", "Mango"] + +var pos = fruits.indexOf("Banana"); +// 1 +``` + +### 移除指定索引位置的項目 + +```js +var removedItem = fruits.splice(pos, 1); // 移除 pos 起的 1 個項目 + +// ["Strawberry", "Mango"] +``` + +### 移除指定索引位置起的多個項目 + +```js +var vegetables = ["Cabbage", "Turnip", "Radish", "Carrot"]; +console.log(vegetables); +// ["Cabbage", "Turnip", "Radish", "Carrot"] + +var pos = 1, + n = 2; + +var removedItems = vegetables.splice(pos, n); +// 這就是移除項目的方式, +// n 表示從該位置開始,一直到陣列的尾端有多少項目需要移除 + +console.log(vegetables); +// ["Cabbage", "Carrot"](原始的陣列被改變) + +console.log(removedItems); +// ["Turnip", "Radish"] +``` + +### 複製陣列 + +```js +var shallowCopy = fruits.slice(); // 這就是複製陣列的方式 +// ["Strawberry", "Mango"] +``` + ### 建立二維陣列 以下範例會用字串產生一張西洋棋盤的二維陣列。第一步是將士兵 'p' 從 (6,4) 移動至 (4,4),然後清空原本的位置 (6,4)。 diff --git a/files/zh-tw/web/javascript/reference/global_objects/array/indexof/index.md b/files/zh-tw/web/javascript/reference/global_objects/array/indexof/index.md index 2b3166eb236436..a30e258087c633 100644 --- a/files/zh-tw/web/javascript/reference/global_objects/array/indexof/index.md +++ b/files/zh-tw/web/javascript/reference/global_objects/array/indexof/index.md @@ -62,7 +62,7 @@ console.log(indices); // [0, 2, 4] ``` -### 尋找元素是否存在於陣列中,若沒有則加入到陣列裡。 +### 尋找元素是否存在於陣列中,若沒有則加入到陣列裡 ```js function updateVegetablesCollection(veggies, veggie) { diff --git a/files/zh-tw/web/javascript/reference/statements/continue/index.md b/files/zh-tw/web/javascript/reference/statements/continue/index.md index da00270970523b..4f82c520144e32 100644 --- a/files/zh-tw/web/javascript/reference/statements/continue/index.md +++ b/files/zh-tw/web/javascript/reference/statements/continue/index.md @@ -3,6 +3,8 @@ title: continue 語法 slug: Web/JavaScript/Reference/Statements/continue --- +{{jsSidebar("Statements")}} + `continue` 語法可用來重新開始 `while`、`do-while`、`for`、`label` 語法。 - 當你使用沒加標籤的 `continue` 時,他會終止這一次的最內層的 `while`、`do-while`、`for` 語法的反覆過程,並繼續執行下一次的反覆過程。與 `break` 語法相較之下,`continue` 不會終止整個循環的執行。在 `while` 循環中,他會跳回條件處。在 `for` 循環中,他會跳回遞增表達式。 @@ -13,7 +15,7 @@ slug: Web/JavaScript/Reference/Statements/continue 1. `continue` 2. `continue label` -**範例 1** +## 範例 1 以下範例示範加上 `continue` 語法的 `while` 循環,`continue` 語法會在 `i` 值為 3 時執行。因此,`n` 的值依序為 1、3、7、12。 @@ -27,7 +29,7 @@ while (i < 5) { } ``` -**範例 2** +## 範例 2 已加上標籤的語法 `checkiandj` 內含已加上標籤的語法 `checkj`。如果遇到 `continue`,程式會終止 `checkj` 這一次的反覆過程,並開始下一次的反覆過程。每當遇到 `continue`,就會反覆執行 `checkj` 直到他的條件返回 false 為止。當返回 false 時,`checkiandj` 語句完成了餘數的計算,且 `checkiandj` 會反覆執行,直到他的條件返回為 false 為止。當返回 false 時,程式繼續執行 `checkiandj` 後面的語句。 @@ -47,5 +49,3 @@ checkiandj: while (i < 4) { document.write("j = " + j + "
"); } ``` - -{{ PreviousNext("Core_JavaScript_1.5_教學:循環語法:break_語法", "Core_JavaScript_1.5_教學:物件的操作語法") }} diff --git a/files/zh-tw/web/javascript/reference/statements/do...while/index.md b/files/zh-tw/web/javascript/reference/statements/do...while/index.md index 006da95381d8d3..b144874e05b115 100644 --- a/files/zh-tw/web/javascript/reference/statements/do...while/index.md +++ b/files/zh-tw/web/javascript/reference/statements/do...while/index.md @@ -15,7 +15,7 @@ while (condition); `statement` 會在檢測條件之前就先執行一次。若要執行多個語句,就使用區塊語法(`{ ... }`)把語句群組化。如果 `condition` 為 true,就會再執行一次語句。每回執行以後,就會檢測條件。當條件為 false 時,就停止執行並把控制權轉移給 `do...while` 後面的語句。 -**範例** +## 範例 在以下範例中,do 循環至少會反覆執行一次,並一直反覆到 i 不再小於 5 為止。 diff --git a/files/zh-tw/web/javascript/reference/statements/for/index.md b/files/zh-tw/web/javascript/reference/statements/for/index.md index 426bd96d3871e4..379b1daa093077 100644 --- a/files/zh-tw/web/javascript/reference/statements/for/index.md +++ b/files/zh-tw/web/javascript/reference/statements/for/index.md @@ -16,7 +16,7 @@ for ([initialExpression]; [condition]; [incrementExpression]) statement; 3. 執行 `statement`。若要執行多個語句,就使用區塊語法(`{ ... }`)把這些語句群組化。 4. 執行更新表達式 `incrementExpression`,並回到第 2 步驟。 -**範例** +## 範例 以下函數內含 `for` 語法,計數至下拉式選單的已選擇選項的數目為止(Select 物件允許複選)。`for` 語法宣告變數 `i` 並以 0 初始化。他會檢驗 `i` 是否小於 `Select` 物件的選項數目,持續執行 `if` 語句,並在每一次循環之後以 1 遞增 `i`。 From 354f9d50ca9aa50268d03d881fdd625ec1c091ee Mon Sep 17 00:00:00 2001 From: Jason Ren <40999116+jasonren0403@users.noreply.github.com> Date: Fri, 24 Nov 2023 18:55:09 +0800 Subject: [PATCH 02/31] [zh-cn] update 'Techniques for game development' (#17088) --- files/zh-cn/games/techniques/index.md | 30 +++++++++++++-------------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/files/zh-cn/games/techniques/index.md b/files/zh-cn/games/techniques/index.md index 3e439a7cf7eaea..2e370ae71042a3 100644 --- a/files/zh-cn/games/techniques/index.md +++ b/files/zh-cn/games/techniques/index.md @@ -1,23 +1,23 @@ --- -title: Techniques for game development +title: 游戏开发技术 slug: Games/Techniques +l10n: + sourceCommit: 56db19e6b8d19932c1b6150bc42e752e12a2b21f --- {{GamesSidebar}} -这个页面为想要使用开放的网页技术来开发游戏的人列举出了必要的核心技术。 +这个页面为想要使用开放的 web 技术来开发游戏的人列举出了必要的核心技术。 - [使用 asm.js 中的异步脚本](/zh-CN/docs/Games/Techniques/Async_scripts) - - : 尤其在制作中大型游戏时,异步脚本是一项必备技术,你游戏中的 JavaScript 因此可以在主进程之外被编译,并被缓存以之后游戏的运行,这会带来显著的性能提升。这篇文章解释了如何做到。 -- [Optimizing startup performance](/zh-CN/docs/Apps/Developing/Optimizing_startup_performance) - - : How to make sure your game starts up quickly, smoothly, and without appearing to lock up the user's browser or device. -- [Using WebRTC peer-to-peer data channels](/zh-CN/docs/Games/WebRTC_data_channels) - - : In addition to providing support for audio and video communication, WebRTC lets you set up peer-to-peer data channels to exchange text or binary data actively between your players. This article explains what this can do for you, and shows how to use libraries that make this easy. -- [Efficient animation for web games](/zh-CN/docs/Games/Techniques/Efficient_animation_for_web_games) - - : This article covers techniques and advice for creating efficient animation for web games, with a slant towards supporting lower end devices such as mobile phones. We touch on CSS transitions and CSS animations, and JavaScript loops involving {{ domxref("window.requestAnimationFrame") }}. -- [Audio for Web Games](/zh-CN/docs/Games/Techniques/Audio_for_Web_Games) - - : Audio is an important part of any game — it adds feedback and atmosphere. Web-based audio is maturing fast, but there are still many browser differences to negotiate. This article provides a detailed guide to implementing audio for web games, looking at what works currently across as wide a range of platforms as possible. -- [2D collision detection](/zh-CN/docs/Games/Techniques/2D_collision_detection) - - : A concise introduction to collision detection in 2D games. -- [Tilemaps](/zh-CN/docs/Games/Techniques/Tilemaps) - - : Tiles are a very popular technique in 2D games for building the game world. These articles provide an introduction to tilemaps and how to implement them with the Canvas API. + - : 尤其在制作中大型游戏时,异步脚本是一项必备技术,它可以让游戏的 JavaScript 脱离主线程进行编译,并在以后运行游戏时缓存起来,从而显著提高用户的性能。本文将介绍如何使用异步脚本。 +- [优化启动性能](/zh-CN/docs/Web/Performance/Optimizing_startup_performance) + - : 如何确保游戏启动快速、流畅,并且不会占用用户的浏览器或设备太久。 +- [使用 WebRTC 点对点数据通道](/zh-CN/docs/Games/Techniques/WebRTC_data_channels) + - : 除了支持音频和视频通信外,WebRTC 还能建立点对点数据通道,在播放器之间主动交换文本或二进制数据。本文将解释 WebRTC 的功能,并介绍如何使用库来轻松实现这一功能。 +- [Web 游戏音频](/zh-CN/docs/Games/Techniques/Audio_for_Web_Games) + - : 音频是任何游戏的重要组成部分——它能增加反馈,活跃气氛。基于 web 的音频技术正在迅速成熟,但仍有许多浏览器差异需要解决。本文提供了实现 web 游戏音频的详细指南,尽可能广泛地介绍了目前在各种平台上都能使用的音频。 +- [2D 碰撞检测](/zh-CN/docs/Games/Techniques/2D_collision_detection) + - : 简明介绍 2D 游戏中的碰撞检测。 +- [平铺贴图](/zh-CN/docs/Games/Techniques/Tilemaps) + - : 在 2D 游戏中,贴图是一种非常流行的构建游戏世界的技术。这些文章介绍了平铺贴图是什么,以及如何使用 Canvas API 实现平铺贴图。 From b2363887ef496d491cade07be50013a65776b2ac Mon Sep 17 00:00:00 2001 From: SphinxKnight Date: Fri, 24 Nov 2023 13:33:20 +0100 Subject: [PATCH 03/31] Follow-up of #16974 - Cleanup console work (#17090) Cleanup: typofixes and flaws / anchors --- .../fr/web/api/console/assert_static/index.md | 2 +- .../fr/web/api/console/count_static/index.md | 2 +- .../api/console/countreset_static/index.md | 4 ++-- .../fr/web/api/console/debug_static/index.md | 2 +- files/fr/web/api/console/dir_static/index.md | 2 +- .../fr/web/api/console/error_static/index.md | 2 +- .../fr/web/api/console/group_static/index.md | 2 +- .../console/groupcollapsed_static/index.md | 2 +- .../web/api/console/groupend_static/index.md | 2 +- files/fr/web/api/console/index.md | 22 +++++++++---------- files/fr/web/api/console/info_static/index.md | 2 +- files/fr/web/api/console/log_static/index.md | 2 +- files/fr/web/api/console/time_static/index.md | 6 ++--- .../web/api/console/timeend_static/index.md | 2 +- .../web/api/console/timelog_static/index.md | 4 ++-- .../web/api/console/timestamp_static/index.md | 2 +- .../fr/web/api/console/trace_static/index.md | 2 +- files/fr/web/api/console/warn_static/index.md | 2 +- 18 files changed, 32 insertions(+), 32 deletions(-) diff --git a/files/fr/web/api/console/assert_static/index.md b/files/fr/web/api/console/assert_static/index.md index e312bee4ea7362..6715ddff2367c3 100644 --- a/files/fr/web/api/console/assert_static/index.md +++ b/files/fr/web/api/console/assert_static/index.md @@ -57,7 +57,7 @@ for (let nombre = 2; nombre <= 5; nombre++) { // Assertion failed: {nombre: 5, messageErreur: "le nombre n'est pas pair"} ``` -Voir [la page sur les chaînes de caractères de substitution avec `console`](/fr/docs/Web/API/console#utiliser_les_caractères_de_substitution) pour plus de détails. +Voir [la page sur les chaînes de caractères de substitution avec `console`](/fr/docs/Web/API/console#utiliser_des_chaînes_de_substitution) pour plus de détails. ## Spécifications diff --git a/files/fr/web/api/console/count_static/index.md b/files/fr/web/api/console/count_static/index.md index 1c4898ac613b43..9f82b23546f08e 100644 --- a/files/fr/web/api/console/count_static/index.md +++ b/files/fr/web/api/console/count_static/index.md @@ -7,7 +7,7 @@ l10n: {{APIRef("Console API")}} -La méthode **`console.count()`** affiche le nombre de fois que `count()` a été appelée (le compteur pouvat être identifié par l'argument passé à la méthode). +La méthode **`console.count()`** affiche le nombre de fois que `count()` a été appelée (le compteur pouvant être identifié par l'argument passé à la méthode). {{AvailableInWorkers}} diff --git a/files/fr/web/api/console/countreset_static/index.md b/files/fr/web/api/console/countreset_static/index.md index 85190af6d1f968..c9e094c31881fc 100644 --- a/files/fr/web/api/console/countreset_static/index.md +++ b/files/fr/web/api/console/countreset_static/index.md @@ -7,7 +7,7 @@ l10n: {{APIRef("Console API")}} -La méthode **`console.countReset()`** permet de réinitialiser le compteur utilisé avec [`console.count()`](/fr/docs/Web/API/console/count). +La méthode **`console.countReset()`** permet de réinitialiser le compteur utilisé avec [`console.count()`](/fr/docs/Web/API/console/count_static). {{AvailableInWorkers}} @@ -21,7 +21,7 @@ countReset(libelle) ### Paramètres - `libelle` {{optional_inline}} - - : Une chaîne de caractères. Si cet argument est fourni, `countReset()` remet à zéro le compteur associé à ce libellé. Si l'argumetn est absent, `countReset()` remet à zéro le compteur par défaut. + - : Une chaîne de caractères. Si cet argument est fourni, `countReset()` remet à zéro le compteur associé à ce libellé. Si l'argument est absent, `countReset()` remet à zéro le compteur par défaut. ### Valeur de retour diff --git a/files/fr/web/api/console/debug_static/index.md b/files/fr/web/api/console/debug_static/index.md index 1a2c3cee3ffe6c..166a8bb7ff6015 100644 --- a/files/fr/web/api/console/debug_static/index.md +++ b/files/fr/web/api/console/debug_static/index.md @@ -27,7 +27,7 @@ debug(msg, subst1, /* …, */ substN) - `msg` - : Une chaîne de caractères JavaScript qui contient zéro ou plusieurs chaînes de substitution qui seront remplacées par `subst1` … `substN` dans l'ordre. - `subst1` … `substN` - - : Des objets JavaScript avec lesquels remplacer les chaînes de substitution dans `msg`. Ce paramètre permet un contrôle supplémentaire sur le format de ce qui est affiché. Voir [la page sur les chaînes de caractères de substitution avec `console`](/fr/docs/Web/API/console#utiliser_les_caractères_de_substitution) pour plus de détails. + - : Des objets JavaScript avec lesquels remplacer les chaînes de substitution dans `msg`. Ce paramètre permet un contrôle supplémentaire sur le format de ce qui est affiché. Voir [la page sur les chaînes de caractères de substitution avec `console`](/fr/docs/Web/API/console#utiliser_des_chaînes_de_substitution) pour plus de détails. Voir [Afficher du texte dans la console](/fr/docs/Web/API/console#afficher_du_texte_dans_la_console) pour plus de détails. diff --git a/files/fr/web/api/console/dir_static/index.md b/files/fr/web/api/console/dir_static/index.md index 12ba31febc6a24..c26c01e3b99b30 100644 --- a/files/fr/web/api/console/dir_static/index.md +++ b/files/fr/web/api/console/dir_static/index.md @@ -7,7 +7,7 @@ l10n: {{APIRef("Console API")}} -La méthode **`console.dir()`** affiche une liste interactive des propriétés de l'objet JavaScript passé en argument. L'affichage est une hiérarchie avec des flèches/triangles qui permettent de déplier/replier le contneu des propriétés et objets enfants. +La méthode **`console.dir()`** affiche une liste interactive des propriétés de l'objet JavaScript passé en argument. L'affichage est une hiérarchie avec des flèches/triangles qui permettent de déplier/replier le contenu des propriétés et objets enfants. Autrement dit, `console.dir()` permet de voir l'ensemble des propriétés d'un objet JavaScript dans la console et de manipuler les niveaux hiérarchiques. diff --git a/files/fr/web/api/console/error_static/index.md b/files/fr/web/api/console/error_static/index.md index 5ccf3560d5e9a7..763bf668a46d48 100644 --- a/files/fr/web/api/console/error_static/index.md +++ b/files/fr/web/api/console/error_static/index.md @@ -27,7 +27,7 @@ error(msg, subst1, /* …, */ substN) - `msg` - : Une chaîne de caractères JavaScript qui contient zéro ou plusieurs chaînes de substitution qui seront remplacées par `subst1` … `substN` dans l'ordre. - `subst1` … `substN` - - : Des objets JavaScript avec lesquels remplacer les chaînes de substitution dans `msg`. Ce paramètre permet un contrôle supplémentaire sur le format de ce qui est affiché. Voir [la page sur les chaînes de caractères de substitution avec `console`](/fr/docs/Web/API/console#utiliser_les_caractères_de_substitution) pour plus de détails. + - : Des objets JavaScript avec lesquels remplacer les chaînes de substitution dans `msg`. Ce paramètre permet un contrôle supplémentaire sur le format de ce qui est affiché. Voir [la page sur les chaînes de caractères de substitution avec `console`](/fr/docs/Web/API/console#utiliser_des_chaînes_de_substitution) pour plus de détails. Voir [Afficher du texte dans la console](/fr/docs/Web/API/console#afficher_du_texte_dans_la_console) pour plus de détails. diff --git a/files/fr/web/api/console/group_static/index.md b/files/fr/web/api/console/group_static/index.md index 298a45c64d6502..0057b881b6e1f1 100644 --- a/files/fr/web/api/console/group_static/index.md +++ b/files/fr/web/api/console/group_static/index.md @@ -50,7 +50,7 @@ L'affichage dans la console ressemblera à ceci : ![Une capture d'écran des messages imbriqués dans la sortie de la console.](nesting.png) -Voir [Utiliser les groupes dans la console](/fr/docs/Web/API/Console#utiliser_des_groupes_dans_la_console) pour plus de détails. +Voir [Utiliser les groupes dans la console](/fr/docs/Web/API/console#utiliser_des_groupes_dans_la_console) pour plus de détails. ## Spécifications diff --git a/files/fr/web/api/console/groupcollapsed_static/index.md b/files/fr/web/api/console/groupcollapsed_static/index.md index dacd27895df83a..339534040b7644 100644 --- a/files/fr/web/api/console/groupcollapsed_static/index.md +++ b/files/fr/web/api/console/groupcollapsed_static/index.md @@ -11,7 +11,7 @@ La méthode **`console.groupCollapsed()`** crée un nouveau groupe dans le journ Il faudra appeler [`console.groupEnd()`](/fr/docs/Web/API/console/groupend_static) pour fermer le groupe courant et revenir au niveau du groupe parent. -Voir [Utiliser les groupes dans la console](/fr/docs/Web/API/Console#utiliser_des_groupes_dans_la_console) pour plus de détails et d'exemples. +Voir [Utiliser les groupes dans la console](/fr/docs/Web/API/console#utiliser_des_groupes_dans_la_console) pour plus de détails et d'exemples. {{AvailableInWorkers}} diff --git a/files/fr/web/api/console/groupend_static/index.md b/files/fr/web/api/console/groupend_static/index.md index f0f2bdd2551592..06a6723e03a70d 100644 --- a/files/fr/web/api/console/groupend_static/index.md +++ b/files/fr/web/api/console/groupend_static/index.md @@ -7,7 +7,7 @@ l10n: {{APIRef("Console API")}} -La méthode **`console.groupEnd()`** clôture le groupe courant dans la console. Voir [Utiliser les groupes dans la console](/fr/docs/Web/API/Console#utiliser_des_groupes_dans_la_console) pour plus de détails et d'exemples. +La méthode **`console.groupEnd()`** clôture le groupe courant dans la console. Voir [Utiliser les groupes dans la console](/fr/docs/Web/API/console#utiliser_des_groupes_dans_la_console) pour plus de détails et d'exemples. {{AvailableInWorkers}} diff --git a/files/fr/web/api/console/index.md b/files/fr/web/api/console/index.md index fd059fabccafd7..3d8cb6632ed704 100644 --- a/files/fr/web/api/console/index.md +++ b/files/fr/web/api/console/index.md @@ -19,7 +19,7 @@ Dans cette page, nous verrons [les méthodes](#méthodes) disponibles sur l'obje {{AvailableInWorkers}} -> **Note :** Certains IDE et éditeurs peuvent implémenter l'API Console différemment. Cela se traduit par un comportement différent ou un absence de certaines fonctionnalités de l'API. Par exemple, les méthodes liées aux chronomètres pourraient ne pas afficher les durées en sortie. En cas de doute, utilisez la console des outils de développement de votre navigateur pour observer le fonctionnement décrit dans cette documentation. +> **Note :** Certains IDE et éditeurs peuvent implémenter l'API Console différemment. Cela se traduit par un comportement différent ou une absence de certaines fonctionnalités de l'API. Par exemple, les méthodes liées aux chronomètres pourraient ne pas afficher les durées en sortie. En cas de doute, utilisez la console des outils de développement de votre navigateur pour observer le fonctionnement décrit dans cette documentation. ## Méthodes statiques @@ -29,7 +29,7 @@ Dans cette page, nous verrons [les méthodes](#méthodes) disponibles sur l'obje - : Vide le contenu de la console. - [`console.count()`](/fr/docs/Web/API/console/count_static) - : Affiche le nombre de fois que le compteur avec le libellé correspondant a été appelé. -- [`console.countReset()`](/fr/docs/Web/API/console/countReset_static) +- [`console.countReset()`](/fr/docs/Web/API/console/countreset_static) - : Réinitialise la valeur du compteur avec le libellé corredpondant. - [`console.debug()`](/fr/docs/Web/API/console/debug_static) - : Affiche un message de débogage dans la console. @@ -43,28 +43,28 @@ Dans cette page, nous verrons [les méthodes](#méthodes) disponibles sur l'obje - : Un synonyme pour `console.error()`. - [`console.group()`](/fr/docs/Web/API/console/group_static) - : Crée un nouveau [groupe](#utiliser_des_groupes_dans_la_console), indentant l'affichage des messages suivants. Pour revenir au niveau courant, on appellera `console.groupEnd()`. -- [`console.groupCollapsed()`](/fr/docs/Web/API/console/groupCollapsed_static) +- [`console.groupCollapsed()`](/fr/docs/Web/API/console/groupcollapsed_static) - : Crée un nouveau [groupe](#utiliser_des_groupes_dans_la_console), indentant l'affichage des messages suivants. Toutefois, contrairement à `console.group()`, les messages du groupe sont repliés. Pour revenir au niveau courant, on appellera `console.groupEnd()`. -- [`console.groupEnd()`](/fr/docs/Web/API/console/groupEnd_static) +- [`console.groupEnd()`](/fr/docs/Web/API/console/groupend_static) - : Ferme le [groupe](#utiliser_des_groupes_dans_la_console) courant. - [`console.info()`](/fr/docs/Web/API/console/info_static) - : Affiche des informations dans la console. Ce message peut contenir des [chaînes de caractères de substitution](#utiliser_des_chaînes_de_substitution) et d'autres valeurs fournies comme arguments complémentaires. - [`console.log()`](/fr/docs/Web/API/console/log_static) - : Affiche des messages généraux dans la console. Ce message peut contenir des [chaînes de caractères de substitution](#utiliser_des_chaînes_de_substitution) et d'autres valeurs fournies comme arguments complémentaires. - [`console.profile()`](/fr/docs/Web/API/console/profile_static) {{Non-standard_inline}} - - : Démarre l'enregistrement d'un profil de performance. Un nom peut être fourni en argument et asocié au profil ainsi créé. -- [`console.profileEnd()`](/fr/docs/Web/API/console/profileEnd_static) {{Non-standard_inline}} + - : Démarre l'enregistrement d'un profil de performance. Un nom peut être fourni en argument et associé au profil ainsi créé. +- [`console.profileEnd()`](/fr/docs/Web/API/console/profileend_static) {{Non-standard_inline}} - : Arrête l'enregistrement du profil de performance. - [`console.table()`](/fr/docs/Web/API/console/table_static) - : Affiche des données tabulaires sous forme d'un tableau. - [`console.time()`](/fr/docs/Web/API/console/time_static) - : Démarre un [chronomètre](#chronomètres) avec un nom fourni en paramètre. -- [`console.timeEnd()`](/fr/docs/Web/API/console/timeEnd_static) +- [`console.timeEnd()`](/fr/docs/Web/API/console/timeend_static) - : Arrête le [chronomètre](#chronomètres) indiqué et affiche la durée écoulée (exprimée en millisecondes) depuis le début de la mesure. -- [`console.timeLog()`](/fr/docs/Web/API/console/timeLog_static) +- [`console.timeLog()`](/fr/docs/Web/API/console/timelog_static) - : Affiche la valeur du [chronomètre](#chronomètres) indiqué dans la console. -- [`console.timeStamp()`](/fr/docs/Web/API/console/timeStamp_static) {{Non-standard_inline}} - - : Ajoute un marqueur de performance pour l'outil de mesure des performance du navigateur ([Firefox](https://profiler.firefox.com/docs/#/), [Chrome](https://developer.chrome.com/docs/devtools/evaluate-performance/reference/)). +- [`console.timeStamp()`](/fr/docs/Web/API/console/timestamp_static) {{Non-standard_inline}} + - : Ajoute un marqueur de performance pour l'outil de mesure des performances du navigateur ([Firefox](https://profiler.firefox.com/docs/#/), [Chrome](https://developer.chrome.com/docs/devtools/evaluate-performance/reference/)). - [`console.trace()`](/fr/docs/Web/API/console/trace_static) - : Affiche la [trace de la pile d'appels](#trace_de_piles_dappels). - [`console.warn()`](/fr/docs/Web/API/console/warn_static) @@ -221,7 +221,7 @@ L'affichage dans la console ressemblera à ceci : ### Chronomètres -On peut démarrer un chronomètre pour mesurer la durée d'une opération donnée. Pour lancer un chronomètre, on appellera la méthode `console.time()`, à laquelle on pourra passer un nom comme paramètre. Pour arrêter le chronomètre et obtenir la durée écoulée, on appellera la méthode `console.timeEnd()` (à laquelle on pourra aussi passer un nom en argument pour arrêter un chronomètre donné). Pour une page web donnée, on peut exécuter jusqu'à 10 000 chronomètres simultanément. +On peut démarrer un chronomètre pour mesurer la durée d'une opération donnée. Pour lancer un chronomètre, on appellera la méthode `console.time()`, à laquelle on pourra passer un nom comme paramètre. Pour arrêter le chronomètre et obtenir la durée écoulée, on appellera la méthode `console.timeEnd()` (à laquelle on pourra aussi passer un nom en argument pour arrêter un chronomètre donné). Pour une page web donnée, on peut exécuter jusqu'à 10 000 chronomètres simultanément. Si on écrit cela, par exemple : diff --git a/files/fr/web/api/console/info_static/index.md b/files/fr/web/api/console/info_static/index.md index 5c3bb9f59ead4b..6077572cc3c0b8 100644 --- a/files/fr/web/api/console/info_static/index.md +++ b/files/fr/web/api/console/info_static/index.md @@ -27,7 +27,7 @@ info(msg, subst1, /* …, */ substN) - `msg` - : Une chaîne de caractères JavaScript qui contient zéro ou plusieurs chaînes de substitution qui seront remplacées par `subst1` … `substN` dans l'ordre. - `subst1` … `substN` - - : Des objets JavaScript avec lesquels remplacer les chaînes de substitution dans `msg`. Ce paramètre permet un contrôle supplémentaire sur le format de ce qui est affiché. Voir [la page sur les chaînes de caractères de substitution avec `console`](/fr/docs/Web/API/console#utiliser_les_caractères_de_substitution) pour plus de détails. + - : Des objets JavaScript avec lesquels remplacer les chaînes de substitution dans `msg`. Ce paramètre permet un contrôle supplémentaire sur le format de ce qui est affiché. Voir [la page sur les chaînes de caractères de substitution avec `console`](/fr/docs/Web/API/console#utiliser_des_chaînes_de_substitution) pour plus de détails. Voir [Afficher du texte dans la console](/fr/docs/Web/API/console#afficher_du_texte_dans_la_console) pour plus de détails. diff --git a/files/fr/web/api/console/log_static/index.md b/files/fr/web/api/console/log_static/index.md index b227a334df7c27..ecbfe9c70bc01f 100644 --- a/files/fr/web/api/console/log_static/index.md +++ b/files/fr/web/api/console/log_static/index.md @@ -27,7 +27,7 @@ log(msg, subst1, /* …, */ substN) - `msg` - : Une chaîne de caractères JavaScript qui contient zéro ou plusieurs chaînes de substitution qui seront remplacées par `subst1` … `substN` dans l'ordre. - `subst1` … `substN` - - : Des objets JavaScript avec lesquels remplacer les chaînes de substitution dans `msg`. Ce paramètre permet un contrôle supplémentaire sur le format de ce qui est affiché. Voir [la page sur les chaînes de caractères de substitution avec `console`](/fr/docs/Web/API/console#utiliser_les_caractères_de_substitution) pour plus de détails. + - : Des objets JavaScript avec lesquels remplacer les chaînes de substitution dans `msg`. Ce paramètre permet un contrôle supplémentaire sur le format de ce qui est affiché. Voir [la page sur les chaînes de caractères de substitution avec `console`](/fr/docs/Web/API/console#utiliser_des_chaînes_de_substitution) pour plus de détails. Voir [Afficher du texte dans la console](/fr/docs/Web/API/console#afficher_du_texte_dans_la_console) pour plus de détails. diff --git a/files/fr/web/api/console/time_static/index.md b/files/fr/web/api/console/time_static/index.md index 2a7cdd8c48d831..60db710d814aae 100644 --- a/files/fr/web/api/console/time_static/index.md +++ b/files/fr/web/api/console/time_static/index.md @@ -1,5 +1,5 @@ --- -title: "console: time() static method" +title: "console : méthode statique time()" slug: Web/API/console/time_static l10n: sourceCommit: 022399901bdc60df947ee15e11a49be029e290d0 @@ -7,9 +7,9 @@ l10n: {{APIRef("Console API")}} -La méthode **`console.time()`** démarre un chronomètre qui permet de mesurer la durée d'une opération. Chaque chronomètre peut être identifié avec un nom donné et on peut avoir jusqu'à 10 000 chronomètres simultanés sur une même page. Lorsqu'on appelle [`console.timeEnd()`](/fr/docs/Web/API/console/timeend_static) avec le même nom, la durée associée depuis le démarrage du chronomètre correspondant s'affichera dans la console (exprimée en millisecondes). +La méthode **`console.time()`** démarre un chronomètre qui permet de mesurer la durée d'une opération. Chaque chronomètre peut être identifié avec un nom donné et on peut avoir jusqu'à 10 000 chronomètres simultanés sur une même page. Lorsqu'on appelle [`console.timeEnd()`](/fr/docs/Web/API/console/timeend_static) avec le même nom, la durée associée depuis le démarrage du chronomètre correspondant s'affichera dans la console (exprimée en millisecondes). -Voir [la section sur les chronomètres de la documentation de `console`](/fr/docs/Web/API/console#chronométrage) pour plus de détails et d'exemples. +Voir [la section sur les chronomètres de la documentation de `console`](/fr/docs/Web/API/console#chronomètres) pour plus de détails et d'exemples. {{AvailableInWorkers}} diff --git a/files/fr/web/api/console/timeend_static/index.md b/files/fr/web/api/console/timeend_static/index.md index 1d9951248a6335..db71b091b3541d 100644 --- a/files/fr/web/api/console/timeend_static/index.md +++ b/files/fr/web/api/console/timeend_static/index.md @@ -9,7 +9,7 @@ l10n: La méthode **`console.timeEnd()`** arrête un chronomètre qui avait été démarré à l'aide de [`console.time()`](/fr/docs/Web/API/console/time_static). -Voir [la section sur les chronomètres de la documentation de `console`](/fr/docs/Web/API/console#chronométrage) pour plus de détails et d'exemples. +Voir [la section sur les chronomètres de la documentation de `console`](/fr/docs/Web/API/console#chronomètres) pour plus de détails et d'exemples. {{AvailableInWorkers}} diff --git a/files/fr/web/api/console/timelog_static/index.md b/files/fr/web/api/console/timelog_static/index.md index 45bb2b0e5e7d0e..cf8e9fea66dba2 100644 --- a/files/fr/web/api/console/timelog_static/index.md +++ b/files/fr/web/api/console/timelog_static/index.md @@ -23,7 +23,7 @@ timeLog(libelle, val1, /* …, */ valN) - `libelle` {{optional_inline}} - : Le nom du chronomètre dont on souhaite afficher la mesure dans la console. Si cet argument est absent, c'est le libellé `"default"` qui est utilisé. - `valN` {{optional_inline}} - - : Des valeurs additionnelels à afficher dans la console après la mesure temporelle. + - : Des valeurs additionnelles à afficher dans la console après la mesure temporelle. ### Valeur de retour @@ -73,7 +73,7 @@ console.timeLog("default", "Coucou", "monde"); // default : 780ms Coucou monde ``` -Voir [la section sur les chronomètres de la documentation de `console`](/fr/docs/Web/API/console#chronométrage) pour plus de détails et d'exemples. +Voir [la section sur les chronomètres de la documentation de `console`](/fr/docs/Web/API/console#chronomètres) pour plus de détails et d'exemples. ## Exemples diff --git a/files/fr/web/api/console/timestamp_static/index.md b/files/fr/web/api/console/timestamp_static/index.md index 046596b9a82b14..1b342ce2bb5757 100644 --- a/files/fr/web/api/console/timestamp_static/index.md +++ b/files/fr/web/api/console/timestamp_static/index.md @@ -7,7 +7,7 @@ l10n: {{APIRef("Console API")}}{{Non-standard_header}} -La méthode **`console.timeStamp()`** permet d'ajouter un marqueur de performance pour l'outil de mesure des performance du navigateur ([Firefox](https://profiler.firefox.com/docs/#/), [Chrome](https://developer.chrome.com/docs/devtools/evaluate-performance/reference/)). Cela permet de dresser des corrélations entre un moment dans le code et d'autres évènements mesurés dans la chronologie (comme ceux relatifs à la disposition ou au rendu à l'écran). +La méthode **`console.timeStamp()`** permet d'ajouter un marqueur de performance pour l'outil de mesure des performances du navigateur ([Firefox](https://profiler.firefox.com/docs/#/), [Chrome](https://developer.chrome.com/docs/devtools/evaluate-performance/reference/)). Cela permet de dresser des corrélations entre un moment dans le code et d'autres évènements mesurés dans la chronologie (comme ceux relatifs à la disposition ou au rendu à l'écran). Un argument optionnel permet de fournir un libellé pour le marqueur. diff --git a/files/fr/web/api/console/trace_static/index.md b/files/fr/web/api/console/trace_static/index.md index 63a3fd41e31892..de44b29298136d 100644 --- a/files/fr/web/api/console/trace_static/index.md +++ b/files/fr/web/api/console/trace_static/index.md @@ -13,7 +13,7 @@ La méthode **`console.trace()`** permet d'afficher la trace de la pile d'appels > **Note :** Dans certains navigateurs, `console.trace()` pourra également afficher la séquence des appels et des évènements asynchrones qui ont mené à l'appel courant de `console.trace()` et qui ne sont pas nécessairement dans la pile d'appels, pour aider à déterminer l'origine de la boucle d'évaluation courante. -Voir [la section sur le traçage des piles d'appels dans la documentation de `console`](/fr/docs/Web/API/console#traces_dappel) pour plus de détails et d'exemples. +Voir [la section sur le traçage des piles d'appels dans la documentation de `console`](/fr/docs/Web/API/console#traces_de_piles_dappels) pour plus de détails et d'exemples. ## Syntaxe diff --git a/files/fr/web/api/console/warn_static/index.md b/files/fr/web/api/console/warn_static/index.md index 1699ca18b6c531..d999f53bdfa1d2 100644 --- a/files/fr/web/api/console/warn_static/index.md +++ b/files/fr/web/api/console/warn_static/index.md @@ -29,7 +29,7 @@ warn(msg, subst1, /* …, */ substN) - `msg` - : Une chaîne de caractères JavaScript qui contient zéro ou plusieurs chaînes de substitution qui seront remplacées par `subst1` … `substN` dans l'ordre. - `subst1` … `substN` - - : Des objets JavaScript avec lesquels remplacer les chaînes de substitution dans `msg`. Ce paramètre permet un contrôle supplémentaire sur le format de ce qui est affiché. Voir [la page sur les chaînes de caractères de substitution avec `console`](/fr/docs/Web/API/console#utiliser_les_caractères_de_substitution) pour plus de détails. + - : Des objets JavaScript avec lesquels remplacer les chaînes de substitution dans `msg`. Ce paramètre permet un contrôle supplémentaire sur le format de ce qui est affiché. Voir [la page sur les chaînes de caractères de substitution avec `console`](/fr/docs/Web/API/console#utiliser_des_chaînes_de_substitution) pour plus de détails. Voir [Afficher du texte dans la console](/fr/docs/Web/API/console#afficher_du_texte_dans_la_console) pour plus de détails. From 4bb15961fa21be78f7d529fb2d31832f8e90289e Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Mon, 20 Nov 2023 00:42:49 +0900 Subject: [PATCH 04/31] =?UTF-8?q?2023/03/21=20=E6=99=82=E7=82=B9=E3=81=AE?= =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?= =?UTF-8?q?=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 --- files/ja/web/api/abstractrange/index.md | 176 ++++++++++++++++++++++++ 1 file changed, 176 insertions(+) create mode 100644 files/ja/web/api/abstractrange/index.md diff --git a/files/ja/web/api/abstractrange/index.md b/files/ja/web/api/abstractrange/index.md new file mode 100644 index 00000000000000..77e071ad6bb2f5 --- /dev/null +++ b/files/ja/web/api/abstractrange/index.md @@ -0,0 +1,176 @@ +--- +title: AbstractRange +slug: Web/API/AbstractRange +l10n: + sourceCommit: a099faec8924e48de30a5aa06d086432915ae420 +--- + +{{APIRef("DOM")}} + +**`AbstractRange`** は抽象インターフェイスで、すべての {{Glossary("DOM")}} の範囲型を定義するための基本クラスです。 **range** は、文書内のコンテンツの区間の開始点と終了点を示すオブジェクトです。 + +> **メモ:** 抽象インターフェイスなので、 `AbstractRange` タイプのオブジェクトを直接インスタンス化することはありません。代わりに {{domxref("Range")}} または {{domxref("StaticRange")}} インターフェイスを使用してください。これら 2 つのインターフェイスの異なる点を理解し、自分のニーズに合ったものを選ぶには、それぞれのインターフェイスのドキュメントを参照してください。 + +{{InheritanceDiagram}} + +## インスタンスプロパティ + +- {{domxref("AbstractRange.collapsed", "collapsed")}} {{ReadOnlyInline}} + - : 論理値で、範囲が折りたたまれている場合は `true` となります。折りたたまれた範囲とは、開始位置と末尾位置が同じで、 0 文字の長さの範囲です。 +- {{domxref("AbstractRange.endContainer", "endContainer")}} {{ReadOnlyInline}} + - : `endOffset` プロパティで指定された範囲の末尾がある場所の {{domxref("Node")}} オブジェクトです。 +- {{domxref("AbstractRange.endOffset", "endOffset")}} {{ReadOnlyInline}} + - : ノードの内容の先頭から、この範囲オブジェクトで表す範囲の先頭までのオフセットを文字数で表した整数値です。この値は `endContainer` ノードの長さよりも小さくなければなりません。 +- {{domxref("AbstractRange.startContainer", "startContainer")}} {{ReadOnlyInline}} + - : `startOffset` プロパティで指定された範囲の先頭がある場所の {{domxref("Node")}} オブジェクトです。 +- {{domxref("AbstractRange.startOffset", "startOffset")}} {{ReadOnlyInline}} + - : ノードの内容の先頭から、範囲オブジェクトが参照する内容の先頭の文字までのオフセットを文字数で表した整数値です。この値は `startContainer` で示すノードの長さよりも小さくなければなりません。 + +## インスタンスメソッド + +_`AbstractRange` メソッドを提供していません。_ + +## 使用上の注意 + +### Range 型 + +{{domxref("Document", "文書")}}内のコンテンツの範囲は、すべて `AbstractRange` に基づくインターフェイスのインスタンスを使用して記述します。このようなインターフェイスは 2 つあります。 + +- {{domxref("Range")}} + - : `Range` インターフェイスは長い間存在していましたが、他にも範囲データを定義する必要性が生じたため、最近になって `AbstractRange` をベースに再定義されました。 `Range` は範囲の端点を変更するメソッドや、範囲を比較するメソッド、範囲間の交差を検出するメソッドなどを提供します。 +- {{domxref("StaticRange")}} + - : `StaticRange` は一度作成した範囲を変更することができない基本的な範囲です。つまり、ノードツリーが変化しても範囲は変更されません。より複雑な {{domxref("Range")}} インターフェイスのパフォーマンスやリソースへの影響を避けることができるので、一度だけ使用する範囲を指定する必要がある場合に有益です。 + +### 要素の内容 + +要素の内容にアクセスする場合、要素自体もノードですが、要素内のテキストもノードであることに注意してください。要素のテキスト内に範囲端点を設定するには、必ず要素内のテキストノードを探してください。 + +```js +const startElem = document.querySelector("p"); +const endElem = startElem.querySelector("span"); +const range = document.createRange(); + +range.setStart(startElem, 0); +range.setEnd(endElem, endElem.childNodes[0].length / 2); +const contents = range.cloneContents(); + +document.body.appendChild(contents); +``` + +この例では、新しい範囲 `range` を作成し、その始点をクラスが `elementclass` である最初の要素の 3 つ目の子ノードに設定します。終点は span の最初の子の中央に設定し、その後、範囲のコンテンツをコピーするために使用しています。 + +### 範囲と DOM の階層構造 + +文書内の文字の範囲を定義する際に、 0 個以上のノード境界をまたぐことが可能で、 DOM の変化にできるだけ強い方法で定義するために、 {{Glossary("HTML")}} 内の最初の文字と最後の文字のオフセットを指定することはできません。それにはいくつか理由があります。 + +最初に、ページが読み込まれた後、ブラウザーは HTML の観点で考えていません。読み込まれた後のページは DOM の {{domxref("Node")}} オブジェクトのツリーなので、範囲の先頭とあ末尾の位置をノードとノード内の位置で指定する必要があります。 + +2 つ目に、 DOM ツリーの変更可能性に可能な限り対応するために、文書全体の中でのグローバルな位置ではなく、ツリー内のノードとの相対的な位置を表す方法が必要です。文書内の点を指定されたノード内のオフセットとして定義すれば、 DOM ツリー内でノードが追加されたり除去されたり移動したりしても、その位置はコンテンツと矛盾しません。かなり明白な制限がありますが(ノードが範囲の終点の後に移動された場合や、ノードのコンテンツが大きく変更された場合など)、何もしないよりははるかにましです。 + +3 つ目に、ノード相対位置を使用して開始位置と終了位置を定義すると、一般的にパフォーマンスが向上しやすくなります。グローバルオフセットが何を参照しているのか DOM と交渉する必要がなく、{{Glossary("user agent", "ユーザーエージェント")}}(ブラウザー)は開始位置で示されるノードに直接移動してそこから開始し、指定されたオフセットに達するまで終了ノードに進むことができます。 + +これを示すために、下記の HTML を考えてみましょう。 + +```html +
+
+ +

The Ultimate Website

+
+
+
+

Section 1: An interesting thing…

+

A very interesting thing happened on the way to the forum…

+ +
+
+

+
+``` + +HTML を読み込んで文書の DOM 表現を構築すると、結果の DOM ツリーは次のようになります。 + +[![単純なウェブページの DOM 図](simpledom.svg)](simpledom.svg) + +この図では、 HTML 要素を表すノードを緑色で表示しています。その下の各行は、 DOM ツリーの次の階層を表示させます。青いノードはテキストノードで、画面に表示させるテキストを格納します。各要素のコンテンツはツリーの下記でリンクされており、要素が他の要素やテキストノードを含めるために、その下に一連の分岐を生む可能性があります。 + +もし {{HTMLElement("p")}} 要素のコンテンツが `"A very interesting thing happened on the way to the forum…"` である範囲を作成したい場合は、次のようにします。 + +```js +const pRange = document.createRange(); +pRange.selectNodeContents(document.querySelector("#entry1 p")); +``` + +`

` 要素の子孫を含めるために、そのコンテンツ全体を選択したいので、これはうまく動作します。 + +代わりに {{HTMLElement("section")}} の見出し({{HTMLElement("Heading_Elements", "h2")}} 要素)から {{HTMLElement("em")}} の "ve "の終わりを通り、その下の段落に "An interesting thing…" というテキストをコピーしたい場合、以下のコードで動作します。 + +```js +const range = document.createRange(); +const startNode = document.querySelector("section h2").childNodes[0]; +range.setStart(startNode, 11); + +const endNode = document.querySelector("#entry1 p em").childNodes[0]; +range.setEnd(endNode, 2); + +const fragment = range.cloneContents(); +``` + +ここで興味深い問題が発生します。DOM階層の異なるレベルにある複数のノードからコンテンツをキャプチャし、そのうちの一部だけをキャプチャしているのです。結果はどのように見ていけばいいのでしょうか? + +幸いなことに、 DOM 仕様はこの課題に的確に対応しています。例えば、この例では {{domxref("Range.cloneContents", "cloneContents()")}} を範囲に呼び出して、指定した範囲のコンテンツを複製する DOM サブツリーを提供する新しい {{domxref("DocumentFragment")}} オブジェクトを作成しています。これを行うために、`cloneContents()` は示す範囲の構造を保持するために必要なすべてのノードを構築しますが、必要以上のノードは構築しません。 + +この例では、指定する範囲の先頭は節の見出しの下のテキストノード内に得られます。つまり、新しい `DocumentFragment` は {{HTMLElement("Heading_Elements", "h2")}} を持ち、その下にテキストノードを格納する必要があります。 + +範囲の終わりは {{HTMLElement("p")}} 要素の下記なので、新しいフラグメント内で必要になります。 "A" という単語を格納するテキストノードも範囲に含めるために必要です。最後に、 `` とその下のテキストノードが、同様に `

` の下に追加されます。 + +テキストノードの内容は {{domxref("Range.setStart", "setStart()")}} と {{domxref("Range.setEnd", "setEnd()")}} を呼び出すときに指定されたテキストノードへのオフセットによって決まります。見出しのテキストに 11 のオフセットが指定された場合、そのノードは "An interesting thing…" を格納します。同様に、終わりノードの最初の2文字のリクエストが指定された場合、最後のテキストノードには "ve" が格納されます。 + +できあがった文書フラグメントは次のようになります。 + +![複製したコンテンツを表す DocumentFragment](dom-fragment.svg) + +このフラグメントの内容はすべて、その中の最上位ノードの共有された共通の親の下にあることに特に注意してください。親である `

` は複製された内容を複製するために必要ではないので、含まれていません。 + +## 例 + +この単純な HTML の断片を考えてみましょう。 + +```html +

This is a paragraph.

+``` + +{{domxref("Range")}} を使用して、ここから "paragraph" という単語を抽出することを想像してみてください。そのためのコードは以下のようになります。 + +```js +const paraNode = document.querySelector("p"); +const paraTextNode = paraNode.childNodes[1]; + +const range = document.createRange(); +range.setStart(paraTextNode, 6); +range.setEnd(paraTextNode, paraTextNode.length - 1); + +const fragment = range.cloneContents(); +document.body.appendChild(fragment); +``` + +最初に、段落ノード自体への参照と、段落内の 2 番目の子ノードへの参照を取得します。最初の子は {{HTMLElement("strong")}} 要素です。 2 つ目の子はテキストノード " is a paragraph." です。 + +テキストノードの参照を手に入れたら、 `Document` 自体に対して {{domxref("Document.createRange", "createRange()")}} を呼び出して新しい `Range` オブジェクトを作成します。範囲の始める位置にはテキストノードの文字列の 6 文字目を設定し、終わりの位置にはテキストノードの文字列の長さから 1 を引いた値を設定します。これにより、 "paragraph" という単語を含む範囲が設定されます。 + +そして、 `Range` に対して {{domxref("Range.cloneContents", "cloneContents()")}} を呼び出して、範囲に含まれる文書部分を格納した新しい {{domxref("DocumentFragment")}} オブジェクトを作成して完了です。その後、 {{domxref("Node.appendChild", "appendChild()")}} を使用して、 {{domxref("document.body")}} から取得した文書本体の最後にそのフラグメントを追加します。 + +結果はこのようになります。 + +{{EmbedLiveSample("Example", 600, 80)}} + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} From b3e9a6bf71da47826664140cde801ebdbd72ab66 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Mon, 20 Nov 2023 00:47:03 +0900 Subject: [PATCH 05/31] =?UTF-8?q?2023/04/06=20=E6=99=82=E7=82=B9=E3=81=AE?= =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?= =?UTF-8?q?=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 --- .../web/api/abstractrange/collapsed/index.md | 29 +++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 files/ja/web/api/abstractrange/collapsed/index.md diff --git a/files/ja/web/api/abstractrange/collapsed/index.md b/files/ja/web/api/abstractrange/collapsed/index.md new file mode 100644 index 00000000000000..05560ef8199d5f --- /dev/null +++ b/files/ja/web/api/abstractrange/collapsed/index.md @@ -0,0 +1,29 @@ +--- +title: "AbstractRange: collapsed プロパティ" +short-title: collapsed +slug: Web/API/AbstractRange/collapsed +l10n: + sourceCommit: 135b8311a5e3d12789e8421845be3ce026ef72b8 +--- + +{{APIRef("DOM")}} + +**`collapsed`** は {{domxref("AbstractRange")}} インターフェイスの読み取り専用プロパティで、範囲の開始位置と終了位置が同じであれば `true` を返します。 + +## 値 + +論理値で、範囲が折りたたまれている場合に `true` となります。折りたたまれた範囲とは、開始位置と終了位置が同じで、 0 文字の長さの範囲です。 + +## 例 + +```js +let isCollapsed = range.collapsed; +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} From c96ded9201659550dd9575ecd81913af4de8601e Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Mon, 20 Nov 2023 00:49:45 +0900 Subject: [PATCH 06/31] =?UTF-8?q?2023/04/06=20=E6=99=82=E7=82=B9=E3=81=AE?= =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?= =?UTF-8?q?=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 --- .../api/abstractrange/endcontainer/index.md | 29 +++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 files/ja/web/api/abstractrange/endcontainer/index.md diff --git a/files/ja/web/api/abstractrange/endcontainer/index.md b/files/ja/web/api/abstractrange/endcontainer/index.md new file mode 100644 index 00000000000000..8d559fe820608c --- /dev/null +++ b/files/ja/web/api/abstractrange/endcontainer/index.md @@ -0,0 +1,29 @@ +--- +title: "AbstractRange: endContainer プロパティ" +short-title: endContainer +slug: Web/API/AbstractRange/endContainer +l10n: + sourceCommit: 135b8311a5e3d12789e8421845be3ce026ef72b8 +--- + +{{APIRef("DOM")}} + +**`endContainer`** は {{domxref("AbstractRange")}} インターフェイスの読み取り専用プロパティで、範囲の末尾がある {{domxref("Node")}} を返します。 + +## 値 + +範囲の最後の文字を含む {{domxref("Node")}} です。 + +## 例 + +```js +let endNode = range.endContainer; +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} From bc68d976f22605838298ef64dcbf4ae0e9339c7b Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Mon, 20 Nov 2023 00:52:31 +0900 Subject: [PATCH 07/31] =?UTF-8?q?2023/04/06=20=E6=99=82=E7=82=B9=E3=81=AE?= =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?= =?UTF-8?q?=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 --- .../web/api/abstractrange/endoffset/index.md | 29 +++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 files/ja/web/api/abstractrange/endoffset/index.md diff --git a/files/ja/web/api/abstractrange/endoffset/index.md b/files/ja/web/api/abstractrange/endoffset/index.md new file mode 100644 index 00000000000000..d4387a51babb3e --- /dev/null +++ b/files/ja/web/api/abstractrange/endoffset/index.md @@ -0,0 +1,29 @@ +--- +title: "AbstractRange: endOffset プロパティ" +short-title: endOffset +slug: Web/API/AbstractRange/endOffset +l10n: + sourceCommit: 135b8311a5e3d12789e8421845be3ce026ef72b8 +--- + +{{APIRef("DOM")}} + +**`endOffset`** は {{domxref("AbstractRange")}} インターフェイスの読み取り専用プロパティで、範囲の終了位置の最後のノードの中のオフセットを返します。 + +## 値 + +範囲の最後の文字が位置する {{domxref("AbstractRange.endContainer", "endContainer")}} が示す {{domxref("Node")}} 内の文字数を示す整数値です。 + +## 例 + +```js +let endOffset = range.endOffset; +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} From 06244b21cf90f2fb57f3e35725903e41cea28259 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Mon, 20 Nov 2023 00:55:00 +0900 Subject: [PATCH 08/31] =?UTF-8?q?2023/04/06=20=E6=99=82=E7=82=B9=E3=81=AE?= =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?= =?UTF-8?q?=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 --- .../api/abstractrange/startcontainer/index.md | 29 +++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 files/ja/web/api/abstractrange/startcontainer/index.md diff --git a/files/ja/web/api/abstractrange/startcontainer/index.md b/files/ja/web/api/abstractrange/startcontainer/index.md new file mode 100644 index 00000000000000..4fe18b62544ff0 --- /dev/null +++ b/files/ja/web/api/abstractrange/startcontainer/index.md @@ -0,0 +1,29 @@ +--- +title: "AbstractRange: startContainer プロパティ" +short-title: startContainer +slug: Web/API/AbstractRange/startContainer +l10n: + sourceCommit: 135b8311a5e3d12789e8421845be3ce026ef72b8 +--- + +{{APIRef("DOM")}} + +**`startContainer`** は {{domxref("AbstractRange")}} インターフェイスの読み取り専用プロパティで、範囲の先頭の {{domxref("Node")}} を返します。 + +## 値 + +範囲の開始位置が内部にある {{domxref("Node")}} です。 + +## 例 + +```js +let startNode = range.startContainer; +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} From 0926629e1f2b74f425867669016fe434b719dfbb Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Mon, 20 Nov 2023 00:58:34 +0900 Subject: [PATCH 09/31] =?UTF-8?q?2023/04/06=20=E6=99=82=E7=82=B9=E3=81=AE?= =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?= =?UTF-8?q?=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 --- .../api/abstractrange/startoffset/index.md | 29 +++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 files/ja/web/api/abstractrange/startoffset/index.md diff --git a/files/ja/web/api/abstractrange/startoffset/index.md b/files/ja/web/api/abstractrange/startoffset/index.md new file mode 100644 index 00000000000000..cfc62c0c255ba1 --- /dev/null +++ b/files/ja/web/api/abstractrange/startoffset/index.md @@ -0,0 +1,29 @@ +--- +title: "AbstractRange: startOffset プロパティ" +short-title: startOffset +slug: Web/API/AbstractRange/startOffset +l10n: + sourceCommit: 135b8311a5e3d12789e8421845be3ce026ef72b8 +--- + +{{APIRef("DOM")}} + +**`startOffset`** は {{domxref("AbstractRange")}} インターフェイスの読み取り専用プロパティで、開始ノードにおける範囲の開始位置のオフセットを返します。 + +## 値 + +範囲の最初の文字が位置を {{domxref("AbstractRange.startContainer", "startContainer")}} が示す {{domxref("Node")}} 内の文字数で示す整数値です。 + +## 例 + +```js +let startOffset = range.startOffset; +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} From 632d7effef16ac5fffa759be1ea206fc31c8344f Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Mon, 20 Nov 2023 01:54:15 +0900 Subject: [PATCH 10/31] =?UTF-8?q?2023/02/19=20=E6=99=82=E7=82=B9=E3=81=AE?= =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?= =?UTF-8?q?=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 --- files/ja/web/api/staticrange/index.md | 53 +++++++++++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 files/ja/web/api/staticrange/index.md diff --git a/files/ja/web/api/staticrange/index.md b/files/ja/web/api/staticrange/index.md new file mode 100644 index 00000000000000..45c386ae7aba4a --- /dev/null +++ b/files/ja/web/api/staticrange/index.md @@ -0,0 +1,53 @@ +--- +title: StaticRange +slug: Web/API/StaticRange +l10n: + sourceCommit: 6d194a9afcce7beef0082c1dc50644bd0fcda635 +--- + +{{APIRef("DOM")}} + +[DOM](/ja/docs/Web/API/Document_Object_Model) の **`StaticRange`** インターフェイスは {{domxref("AbstractRange")}} を拡張し、 DOM ツリー内で発生した変更を反映しない、 DOM 内のコンテンツの範囲を指定するメソッドを提供します。 + +このインターフェイスは `AbstractRange` と同じプロパティとメソッドの集合を提供します。 + +`AbstractRange` と `StaticRange` は[ウェブワーカー](/ja/docs/Web/API/Web_Workers_API)からは利用できません。 + +{{InheritanceDiagram}} + +## コンストラクター + +- {{domxref("StaticRange.StaticRange", "StaticRange()")}} + - : プロパティの既定値を指定したオブジェクトを指定して、新しい `StaticRange` オブジェクトを作成します。 + +## インスタンスプロパティ + +_以下のプロパティは親インターフェイスである {{domxref("AbstractRange")}} から継承しています。_ + +- {{domxref("StaticRange.collapsed")}} {{ReadOnlyInline}} + - : 論理値で、範囲が折りたたまれている場合は `true` となります。折りたたまれた範囲とは、開始位置と末尾位置が同じで、 0 文字の長さの範囲です。 +- {{domxref("StaticRange.endContainer", "endContainer")}} {{ReadOnlyInline}} + - : `endOffset` プロパティで指定された範囲の末尾がある場所の {{domxref("Node")}} オブジェクトです。 +- {{domxref("StaticRange.endOffset")}} {{ReadOnlyInline}} + - : ノードの内容の先頭から、この範囲オブジェクトで表す範囲の先頭までのオフセットを文字数で表した整数値です。この値は `endContainer` ノードの長さよりも小さくなければなりません。 +- {{domxref("StaticRange.startContainer")}} {{ReadOnlyInline}} + - : `startOffset` プロパティで指定された範囲の先頭がある場所の {{domxref("Node")}} オブジェクトです。 +- {{domxref("StaticRange.startOffset")}} {{ReadOnlyInline}} + - : ノードの内容の先頭から、範囲オブジェクトが参照する内容の先頭の文字までのオフセットを文字数で表した整数値です。この値は `startContainer` で示すノードの長さよりも小さくなければなりません。 + +## 使用上のメモ + +DOM 範囲は文書内のコンテンツの範囲を指定します。あるノード(または要素)の内部で始まり、別のノード(または要素)の内部で終わる可能性があります。 {{domxref("Range")}} とは異なり、 `StaticRange` はその時点で固定された範囲を表します。文書が変更されても、変更されずに同じ範囲を維持しようとします。DOM に何らかの変更が加えられた場合、 `StaticRange` で指定した範囲に格納する実際のデータは変更される可能性があります。これにより、{{Glossary("user agent", "ユーザーエージェント")}}は、ウェブアプリケーションやウェブサイトがライブ更新される範囲を必要としない場合、不必要な多くの作業を避けることができます。 + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- ライブで更新される DOM 内のコンテンツ範囲: {{domxref("Range")}} +- {{domxref("AbstractRange")}}: すべての範囲が派生する抽象インターフェイス From 101e322a16012b954bf84c877ad5d90f8d7aea0b Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Mon, 20 Nov 2023 02:04:55 +0900 Subject: [PATCH 11/31] =?UTF-8?q?2023/04/08=20=E6=99=82=E7=82=B9=E3=81=AE?= =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?= =?UTF-8?q?=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 --- .../web/api/staticrange/staticrange/index.md | 51 +++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 files/ja/web/api/staticrange/staticrange/index.md diff --git a/files/ja/web/api/staticrange/staticrange/index.md b/files/ja/web/api/staticrange/staticrange/index.md new file mode 100644 index 00000000000000..b3109e07058599 --- /dev/null +++ b/files/ja/web/api/staticrange/staticrange/index.md @@ -0,0 +1,51 @@ +--- +title: "StaticRange: StaticRange() コンストラクター" +short-title: StaticRange() +slug: Web/API/StaticRange/StaticRange +l10n: + sourceCommit: 6d194a9afcce7beef0082c1dc50644bd0fcda635 +--- + +{{APIRef("DOM")}} + +**`StaticRange()`** コンストラクターは、 DOM 内のコンテンツの範囲を表す新しい {{domxref("StaticRange")}} オブジェクトを作成します。 + +このコンストラクターは、範囲の開始位置と終了位置を示すプロパティと、範囲が**折りたたまれている**(つまり空である)かどうかを示す論理値を含みます。 + +## 構文 + +```js-nolint +new StaticRange(rangeSpec) +``` + +### 引数 + +- `rangeSpec` + + - : 要求される `rangeSpec` 引数は、以下の 4 つのプロパティを格納したオブジェクトです。 + + - `startContainer` + - : 範囲の始点がある {{domxref("Node")}} です。 + - `startOffset` + - : 範囲の最初の文字が見つかる開始ノード内のオフセットです。 + - `endContainer` + - : 範囲の終点がある `Node` です。 + - `endOffset` + - : `endOffset` で示される、ノード内で範囲内の最後の文字がある位置のオフセットです。 + +### 返値 + +`rangeSpec` オブジェクトで指定された値で初期化された新しい `StaticRange` オブジェクト。 + +### 例外 + +- `InvalidNodeTypeError` + - : `startContainer` と `endContainer` のどちらか、または両方が範囲を含めることができないノード種別である場合に {{domxref("DOMException")}} が発生します。これらのノード種別は `Node.DOCUMENT_TYPE_NODE` (例えば、HTMLの `doctype` プリアンブルを使用して識別された {{Glossary("Doctype", "DTD")}} から派生した {{domxref("DocumentType")}} ノードを表します)と DOM 上の要素の属性を記述する {{domxref("Attr")}} ノードです。 + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} From 8204ec1c2eafee38afd00d610b882f712b71c20c Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Mon, 20 Nov 2023 02:07:30 +0900 Subject: [PATCH 12/31] =?UTF-8?q?2023/04/08=20=E6=99=82=E7=82=B9=E3=81=AE?= =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?= =?UTF-8?q?=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 --- .../ja/web/api/staticrange/collapsed/index.md | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 files/ja/web/api/staticrange/collapsed/index.md diff --git a/files/ja/web/api/staticrange/collapsed/index.md b/files/ja/web/api/staticrange/collapsed/index.md new file mode 100644 index 00000000000000..193e371036bd22 --- /dev/null +++ b/files/ja/web/api/staticrange/collapsed/index.md @@ -0,0 +1,23 @@ +--- +title: "StaticRange: collapsed プロパティ" +short-title: collapsed +slug: Web/API/StaticRange/collapsed +l10n: + sourceCommit: 101ffc9479db6aaa530f2aac3992734dd97d1b86 +--- + +{{APIRef("DOM WHATWG")}} + +**`collapsed`** は {{domxref("StaticRange")}} インターフェイスの読み取り専用プロパティで、範囲の開始位置と終了位置が同じであれば `true` を返します。 + +## 値 + +論理値で、範囲が折りたたまれている場合に `true` となります。折りたたまれた範囲とは、開始位置と終了位置が同じで、 0 文字の長さの範囲です。 + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} From fa168f11684fbe50e304af674fac83f5c9c73891 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Mon, 20 Nov 2023 02:09:41 +0900 Subject: [PATCH 13/31] =?UTF-8?q?2023/04/08=20=E6=99=82=E7=82=B9=E3=81=AE?= =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?= =?UTF-8?q?=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 --- .../web/api/staticrange/endcontainer/index.md | 24 +++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 files/ja/web/api/staticrange/endcontainer/index.md diff --git a/files/ja/web/api/staticrange/endcontainer/index.md b/files/ja/web/api/staticrange/endcontainer/index.md new file mode 100644 index 00000000000000..65fc3d17f63fd8 --- /dev/null +++ b/files/ja/web/api/staticrange/endcontainer/index.md @@ -0,0 +1,24 @@ +--- +title: "StaticRange: endContainer プロパティ" +short-title: endContainer +slug: Web/API/StaticRange/endContainer +l10n: + sourceCommit: 101ffc9479db6aaa530f2aac3992734dd97d1b86 +--- + +{{APIRef("DOM + WHATWG")}} + +**`endContainer`** は {{domxref("StaticRange")}} インターフェイスの読み取り専用プロパティで、範囲の末尾がある {{domxref("Node")}} を返します。 + +## 値 + +範囲の最後の文字を含む {{domxref("Node")}} です。 + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} From 8c825ac756cb459465ba0de2d53a1b244004ade8 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Mon, 20 Nov 2023 02:11:44 +0900 Subject: [PATCH 14/31] =?UTF-8?q?2023/04/08=20=E6=99=82=E7=82=B9=E3=81=AE?= =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?= =?UTF-8?q?=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 --- .../ja/web/api/staticrange/endoffset/index.md | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 files/ja/web/api/staticrange/endoffset/index.md diff --git a/files/ja/web/api/staticrange/endoffset/index.md b/files/ja/web/api/staticrange/endoffset/index.md new file mode 100644 index 00000000000000..6e1eaa6debd1bf --- /dev/null +++ b/files/ja/web/api/staticrange/endoffset/index.md @@ -0,0 +1,23 @@ +--- +title: "StaticRange: endOffset プロパティ" +short-title: endOffset +slug: Web/API/StaticRange/endOffset +l10n: + sourceCommit: 101ffc9479db6aaa530f2aac3992734dd97d1b86 +--- + +{{APIRef("DOM")}} + +**`endOffset`** は {{domxref("StaticRange")}} インターフェイスの読み取り専用プロパティで、範囲の終了位置の最後のノードの中のオフセットを返します。 + +## 値 + +範囲の最後の文字が位置する {{domxref("StaticRange.endContainer", "endContainer")}} が示す {{domxref("Node")}} 内の文字数を示す整数値です。 + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} From 05622c3824996b6b15878ec1d9fcb7d3271f2cb1 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Mon, 20 Nov 2023 02:15:44 +0900 Subject: [PATCH 15/31] =?UTF-8?q?2023/04/08=20=E6=99=82=E7=82=B9=E3=81=AE?= =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?= =?UTF-8?q?=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 --- .../api/staticrange/startcontainer/index.md | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 files/ja/web/api/staticrange/startcontainer/index.md diff --git a/files/ja/web/api/staticrange/startcontainer/index.md b/files/ja/web/api/staticrange/startcontainer/index.md new file mode 100644 index 00000000000000..60542f15443515 --- /dev/null +++ b/files/ja/web/api/staticrange/startcontainer/index.md @@ -0,0 +1,23 @@ +--- +title: "StaticRange: startContainer プロパティ" +short-title: startContainer +slug: Web/API/StaticRange/startContainer +l10n: + sourceCommit: 101ffc9479db6aaa530f2aac3992734dd97d1b86 +--- + +{{APIRef("DOM")}} + +**`startContainer`** は {{domxref("StaticRange")}} インターフェイスの読み取り専用プロパティで、範囲の先頭の {{domxref("Node")}} を返します。 + +## 値 + +範囲の開始位置が内部にある {{domxref("Node")}} です。 + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} From e5d18632d453627a5d5f9afbefc01de82c269a3a Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Mon, 20 Nov 2023 02:17:40 +0900 Subject: [PATCH 16/31] =?UTF-8?q?2023/04/08=20=E6=99=82=E7=82=B9=E3=81=AE?= =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?= =?UTF-8?q?=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 --- .../web/api/staticrange/startoffset/index.md | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 files/ja/web/api/staticrange/startoffset/index.md diff --git a/files/ja/web/api/staticrange/startoffset/index.md b/files/ja/web/api/staticrange/startoffset/index.md new file mode 100644 index 00000000000000..eb71e0a5f758f6 --- /dev/null +++ b/files/ja/web/api/staticrange/startoffset/index.md @@ -0,0 +1,23 @@ +--- +title: "StaticRange: startOffset プロパティ" +short-title: startOffset +slug: Web/API/StaticRange/startOffset +l10n: + sourceCommit: 101ffc9479db6aaa530f2aac3992734dd97d1b86 +--- + +{{APIRef("DOM")}} + +**`startOffset`** は {{domxref("StaticRange")}} インターフェイスの読み取り専用プロパティで、開始ノードにおける範囲の開始位置のオフセットを返します。 + +## 値 + +範囲の最初の文字が位置を {{domxref("StaticRange.startContainer", "startContainer")}} が示す {{domxref("Node")}} 内の文字数で示す整数値です。 + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} From 5ef87f9ac217175e284d43e2f604c6e3e9e69158 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Mon, 20 Nov 2023 03:10:39 +0900 Subject: [PATCH 17/31] =?UTF-8?q?2023/04/08=20=E6=99=82=E7=82=B9=E3=81=AE?= =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?= =?UTF-8?q?=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 --- files/ja/web/api/range/range/index.md | 72 +++++++++++++++++++++++++++ 1 file changed, 72 insertions(+) create mode 100644 files/ja/web/api/range/range/index.md diff --git a/files/ja/web/api/range/range/index.md b/files/ja/web/api/range/range/index.md new file mode 100644 index 00000000000000..4fd3d895f77756 --- /dev/null +++ b/files/ja/web/api/range/range/index.md @@ -0,0 +1,72 @@ +--- +title: "Range: Range() コンストラクター" +short-title: Range() +slug: Web/API/Range/Range +l10n: + sourceCommit: c58e8c1dd6ecbcb63894c7dd17fb9495b9511b4e +--- + +{{ APIRef("DOM") }} + +**`Range()`** コンストラクターは、グローバルな {{domxref("Document")}} オブジェクトを始点および終点とする、新しく作成された {{domxref("Range")}} オブジェクトを返します。 + +## 構文 + +```js-nolint +new Range() +``` + +### 引数 + +なし。 + +## 例 + +この例では、 `Range()` コンストラクターで新しい範囲を作成し、 {{domxref("Range.setStartBefore()")}} メソッドと {{domxref("Range.setEndAfter()")}} メソッドを使用してその開始位置と終了位置を設定します。そして、 {{domxref("window.getSelection()")}} と {{domxref("Selection.addRange()")}} を使用して範囲を選択します。 + +### HTML + +```html +

First paragraph.

+

Second paragraph.

+

Third paragraph.

+

Fourth paragraph.

+``` + +### JavaScript + +```js +const paragraphs = document.querySelectorAll("p"); + +// 新しい範囲を作成 +const range = new Range(); + +// 範囲を 2 つ目の段落から開始 +range.setStartBefore(paragraphs[1]); + +// 範囲を 3 つ目の段落で終了 +range.setEndAfter(paragraphs[2]); + +// window の選択範囲を取得 +const selection = window.getSelection(); + +// window の選択範囲に範囲を追加 +selection.addRange(range); +``` + +### 結果 + +{{EmbedLiveSample("Examples", 400, 210)}} + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [DOM インターフェイス索引](/ja/docs/Web/API/Document_Object_Model) +- {{domxref("Document.createRange()")}} From 2ae248adc5d71987cd8f083a6bbd14431cc8b2be Mon Sep 17 00:00:00 2001 From: Leonid Vinogradov Date: Mon, 20 Nov 2023 00:30:54 +0300 Subject: [PATCH 18/31] [ja] add sidebar to Glossary pages (part 2) --- files/ja/glossary/cryptography/index.md | 2 ++ files/ja/glossary/csp/index.md | 2 ++ files/ja/glossary/csrf/index.md | 2 ++ files/ja/glossary/css/index.md | 2 ++ files/ja/glossary/css_descriptor/index.md | 2 ++ files/ja/glossary/css_pixel/index.md | 2 ++ files/ja/glossary/css_preprocessor/index.md | 2 ++ files/ja/glossary/css_selector/index.md | 2 ++ files/ja/glossary/cssom/index.md | 2 ++ files/ja/glossary/data_structure/index.md | 2 ++ files/ja/glossary/database/index.md | 2 ++ files/ja/glossary/decryption/index.md | 2 ++ files/ja/glossary/deep_copy/index.md | 2 +- files/ja/glossary/delta/index.md | 2 ++ files/ja/glossary/denial_of_service/index.md | 2 ++ files/ja/glossary/deserialization/index.md | 2 ++ files/ja/glossary/developer_tools/index.md | 2 ++ files/ja/glossary/digest/index.md | 2 ++ files/ja/glossary/digital_certificate/index.md | 2 ++ files/ja/glossary/distributed_denial_of_service/index.md | 2 ++ files/ja/glossary/dmz/index.md | 2 ++ files/ja/glossary/dns/index.md | 2 ++ files/ja/glossary/doctype/index.md | 2 ++ files/ja/glossary/document_directive/index.md | 2 ++ files/ja/glossary/document_environment/index.md | 2 ++ files/ja/glossary/dom/index.md | 2 ++ files/ja/glossary/domain/index.md | 2 ++ files/ja/glossary/domain_name/index.md | 2 ++ files/ja/glossary/domain_sharding/index.md | 2 ++ files/ja/glossary/dominator/index.md | 2 ++ files/ja/glossary/dos_attack/index.md | 2 ++ files/ja/glossary/dsl/digital_subscriber_line/index.md | 2 ++ files/ja/glossary/dsl/domain_specific_language/index.md | 2 ++ files/ja/glossary/dsl/index.md | 2 ++ files/ja/glossary/dtls/index.md | 2 ++ files/ja/glossary/dtmf/index.md | 2 ++ files/ja/glossary/dynamic_typing/index.md | 2 ++ files/ja/glossary/ecma/index.md | 2 ++ files/ja/glossary/ecmascript/index.md | 2 ++ files/ja/glossary/effective_connection_type/index.md | 2 ++ files/ja/glossary/element/index.md | 2 ++ files/ja/glossary/encapsulation/index.md | 2 ++ files/ja/glossary/encryption/index.md | 2 ++ files/ja/glossary/endianness/index.md | 2 ++ files/ja/glossary/engine/index.md | 2 ++ files/ja/glossary/entity/index.md | 2 ++ files/ja/glossary/entity_header/index.md | 2 ++ files/ja/glossary/enumerated/index.md | 2 ++ files/ja/glossary/event/index.md | 2 ++ files/ja/glossary/exception/index.md | 2 ++ files/ja/glossary/exif/index.md | 2 ++ files/ja/glossary/expando/index.md | 2 ++ files/ja/glossary/fallback_alignment/index.md | 2 ++ files/ja/glossary/falsy/index.md | 2 ++ files/ja/glossary/favicon/index.md | 2 ++ files/ja/glossary/fetch_directive/index.md | 2 ++ files/ja/glossary/fetch_metadata_request_header/index.md | 2 ++ files/ja/glossary/firefox_os/index.md | 2 ++ files/ja/glossary/firewall/index.md | 2 ++ files/ja/glossary/first-class_function/index.md | 2 ++ files/ja/glossary/first_contentful_paint/index.md | 2 ++ files/ja/glossary/first_cpu_idle/index.md | 2 ++ files/ja/glossary/first_meaningful_paint/index.md | 2 ++ files/ja/glossary/first_paint/index.md | 2 ++ files/ja/glossary/flex/index.md | 2 ++ files/ja/glossary/flex_container/index.md | 2 ++ files/ja/glossary/flex_item/index.md | 2 ++ files/ja/glossary/flexbox/index.md | 2 ++ files/ja/glossary/forbidden_header_name/index.md | 2 ++ files/ja/glossary/forbidden_response_header_name/index.md | 2 ++ files/ja/glossary/fork/index.md | 2 ++ files/ja/glossary/fps/index.md | 2 ++ files/ja/glossary/ftp/index.md | 2 ++ files/ja/glossary/ftu/index.md | 2 ++ files/ja/glossary/function/index.md | 2 ++ files/ja/glossary/fuzzing/index.md | 2 ++ files/ja/glossary/gamut/index.md | 2 ++ files/ja/glossary/garbage_collection/index.md | 2 ++ files/ja/glossary/gecko/index.md | 2 ++ files/ja/glossary/general_header/index.md | 2 ++ files/ja/glossary/gif/index.md | 2 ++ files/ja/glossary/git/index.md | 2 ++ files/ja/glossary/global_object/index.md | 2 ++ files/ja/glossary/global_scope/index.md | 2 ++ files/ja/glossary/global_variable/index.md | 2 ++ files/ja/glossary/glyph/index.md | 2 ++ files/ja/glossary/google_chrome/index.md | 2 ++ files/ja/glossary/gpl/index.md | 2 ++ files/ja/glossary/gpu/index.md | 2 ++ files/ja/glossary/graceful_degradation/index.md | 2 ++ files/ja/glossary/grid/index.md | 2 ++ files/ja/glossary/grid_areas/index.md | 2 ++ files/ja/glossary/grid_axis/index.md | 2 ++ files/ja/glossary/grid_cell/index.md | 2 ++ files/ja/glossary/grid_column/index.md | 2 ++ files/ja/glossary/grid_container/index.md | 2 ++ files/ja/glossary/grid_lines/index.md | 2 ++ files/ja/glossary/grid_row/index.md | 2 ++ files/ja/glossary/grid_tracks/index.md | 2 ++ 99 files changed, 197 insertions(+), 1 deletion(-) diff --git a/files/ja/glossary/cryptography/index.md b/files/ja/glossary/cryptography/index.md index 5d43a103690c5e..89efd3c478f7ce 100644 --- a/files/ja/glossary/cryptography/index.md +++ b/files/ja/glossary/cryptography/index.md @@ -3,6 +3,8 @@ title: Cryptography (暗号学) slug: Glossary/Cryptography --- +{{GlossarySidebar}} + **暗号学**(Cryptography、cryptology)は、メッセージを安全に符号化して送信する方法を研究する科学です。暗号学は、安全でない環境でメッセージを符号化および復号するために使用されるアルゴリズムの設計および研究と、それらの応用です。 **データの機密性**だけではなく、暗号学はまた、**識別**、**認証**、**否認防止**、および**データの完全性**にも取り組んでいます。したがって、**暗号システム**、つまり文脈における暗号方式の使い方も研究します。 1. 一般知識 diff --git a/files/ja/glossary/csp/index.md b/files/ja/glossary/csp/index.md index caf6733a007b88..9aa518757163e1 100644 --- a/files/ja/glossary/csp/index.md +++ b/files/ja/glossary/csp/index.md @@ -3,6 +3,8 @@ title: CSP slug: Glossary/CSP --- +{{GlossarySidebar}} + CSP ([Content Security Policy](/ja/docs/Web/HTTP/CSP)) は特定の種類のウェブサイト関連攻撃 ( {{Glossary("XSS")}} やデータインジェクション) を検出して軽減するのに使われます。 実装は {{Glossary("HTTP")}} の {{HTTPHeader("Content-Security-Policy")}} というヘッダーを元にしています。 diff --git a/files/ja/glossary/csrf/index.md b/files/ja/glossary/csrf/index.md index c591aebdc4ce23..4cb9fdabce5637 100644 --- a/files/ja/glossary/csrf/index.md +++ b/files/ja/glossary/csrf/index.md @@ -3,6 +3,8 @@ title: CSRF slug: Glossary/CSRF --- +{{GlossarySidebar}} + **CSRF** (クロスサイトリクエストフォージェリー、Cross-Site Request Forgery) は、信頼されたユーザーになりすまし、ウェブサイトに対して不正なコマンドを送信する攻撃です。 例えば、どこかへ移動すると称したリンクの {{glossary("URL")}} 内に、悪意のある引数を含めたりすることで実行されます。 diff --git a/files/ja/glossary/css/index.md b/files/ja/glossary/css/index.md index db2490329f02a0..d7cb21c900bc67 100644 --- a/files/ja/glossary/css/index.md +++ b/files/ja/glossary/css/index.md @@ -3,6 +3,8 @@ title: CSS slug: Glossary/CSS --- +{{GlossarySidebar}} + **CSS** (Cascading StyleSheets) は {{glossary("browser","ブラウザー")}} でウェブページの見た目を調整する宣言型の言語です。ウェブブラウザーは、指定された要素を適切に表示するために CSS スタイル宣言を適用する働きを持ちます。スタイルの宣言には、ウェブページの見た目を決定するプロパティとプロパティの値が含まれています。 CSS は {{Glossary("HTML")}} と {{Glossary("JavaScript")}} と合わせて、核となる 3 つのウェブ技術のうちの 1 つです。CSS は普通、{{Glossary("Element","HTML 要素")}} のデザインをしますが、{{Glossary("SVG")}} や {{Glossary("XML")}} のような他のマークアップ言語でも使用できます。 diff --git a/files/ja/glossary/css_descriptor/index.md b/files/ja/glossary/css_descriptor/index.md index 72c9ebe4a0bf7c..dfc2a5bfe0b214 100644 --- a/files/ja/glossary/css_descriptor/index.md +++ b/files/ja/glossary/css_descriptor/index.md @@ -3,6 +3,8 @@ title: Descriptor (CSS) (記述子) slug: Glossary/CSS_Descriptor --- +{{GlossarySidebar}} + **CSS 記述子**は、[アットルール](/ja/docs/Web/CSS/At-rule)の性質を定義します。アットルールは 1 つ以上の記述子を持つことができます。それぞれの記述子には、以下のものがあります。 - 名前 diff --git a/files/ja/glossary/css_pixel/index.md b/files/ja/glossary/css_pixel/index.md index 1012d7d6b84969..ea5d0509e2da30 100644 --- a/files/ja/glossary/css_pixel/index.md +++ b/files/ja/glossary/css_pixel/index.md @@ -3,6 +3,8 @@ title: CSS pixel slug: Glossary/CSS_pixel --- +{{GlossarySidebar}} + **CSS Pixel** —{{Glossary("CSS")}} で接尾辞 `px` とともに示されます— は、人間の目で負担なく快適に見ることができるけれどなるべく小さい、1 ドットの高さや幅におおよそ一致する、長さの単位です。定義によれば、これは閲覧者の目から腕の長さまで離れた位置での、画素密度 96DPI の単一ピクセルの物理的サイズです。 その定義には、もちろん大きな揺らぎがあります。「快適に見ることができる」や「腕の長さ」などの不正確な用語は、人から人へと伝えるうちに変化してしまいます。例えば、あるユーザーがデスクトップの前にある机に着くとき、そのディスプレイは一般的に、例えば携帯電話に向かうときと比べて、ユーザーの目からかなり遠い位置にあります。 diff --git a/files/ja/glossary/css_preprocessor/index.md b/files/ja/glossary/css_preprocessor/index.md index 88f28fb62037f2..3f11997641e283 100644 --- a/files/ja/glossary/css_preprocessor/index.md +++ b/files/ja/glossary/css_preprocessor/index.md @@ -3,6 +3,8 @@ title: CSS preprocessor (CSS プリプロセッサー) slug: Glossary/CSS_preprocessor --- +{{GlossarySidebar}} + **CSS プリプロセッサー** は、プリプロセッサー独自の {{Glossary("syntax","構文")}} で {{Glossary("CSS")}} を生成するプログラムです。 CSS プリプロセッサーには多くの種類がありますが、ほとんどの CSS プリプロセッサーは、純粋な CSS には無い、ミックスイン、セレクターの入れ子、セレクターの継承などの機能を追加しています。これらの機能によって、 CSS の可読性や保守性が向上します。 CSS プリプロセッサーを使うためには、 CSS コンパイラーをウェブ{{Glossary("server", "サーバー")}}にインストールするか、 CSS プリプロセッサーを使用して開発環境でコンパイルしてから、コンパイル済みの CSS ファイルをウェブサーバーにアップロードする必要があります。 diff --git a/files/ja/glossary/css_selector/index.md b/files/ja/glossary/css_selector/index.md index d779403501bab4..aae1fe6332ad3c 100644 --- a/files/ja/glossary/css_selector/index.md +++ b/files/ja/glossary/css_selector/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: ed947b2c608428b62a60f07d09dc543f732dc09b --- +{{GlossarySidebar}} + **CSS セレクター**は CSS のルールの一部で、文書中のどの要素がルールと一致するかを記述します。一致した要素にはルールで指定されたスタイルが適用されます。 ## 例 diff --git a/files/ja/glossary/cssom/index.md b/files/ja/glossary/cssom/index.md index 3e88402362c3fd..6f553e1f31e45f 100644 --- a/files/ja/glossary/cssom/index.md +++ b/files/ja/glossary/cssom/index.md @@ -3,6 +3,8 @@ title: CSS Object Model (CSSOM) slug: Glossary/CSSOM --- +{{GlossarySidebar}} + **CSS Object Model (CSSOM)** とは、すべての CSS セレクターとそれぞれのセレクターに関連するプロパティを、ルートノード、兄弟、子孫、子、その他の関係からなるツリーの形に変換したものです。CSSOM は、{{glossary('DOM', 'Document Object Model (DOM)')}} とよく似ています。それらの両方は、ウェブサイトを適切にレンダリングするために必ず発生する一連のステップである、クリティカルレンダリングパスの一部です。 CSSOM は、DOM とともに、レンダリングツリーを構築し、さらにブラウザーによってウェブページをレイアウトし描画するために使用されます。 diff --git a/files/ja/glossary/data_structure/index.md b/files/ja/glossary/data_structure/index.md index f6d0bbb857afc1..5d3214bba45ed7 100644 --- a/files/ja/glossary/data_structure/index.md +++ b/files/ja/glossary/data_structure/index.md @@ -3,6 +3,8 @@ title: Data structure (データ構造) slug: Glossary/Data_structure --- +{{GlossarySidebar}} + **データ構造**は、データを効率的に使用できるように整理する特別な方法です。 ## より詳しく知る diff --git a/files/ja/glossary/database/index.md b/files/ja/glossary/database/index.md index 83f879d65e8b3f..2b8071ebb0ce5e 100644 --- a/files/ja/glossary/database/index.md +++ b/files/ja/glossary/database/index.md @@ -3,6 +3,8 @@ title: Database slug: Glossary/Database --- +{{GlossarySidebar}} + **データベース** は、データの整理や収集を行い保存をするシステムです。データベースを使うことで検索、構造化、拡張などの作業を簡単に行うことができます。 ウェブ開発で使用されるほとんどのデータベースはリレーショナルデータベース (RDBMS) を使用してデータを整理し、{{Glossary("SQL")}} と呼ばれるプログラミング言語を使用します。ただし、一部のデータベースは NoSQL と呼ばれる非リレーショナルベースを使用しています。このデータベースはデータを整理せず収集のみを行います。 diff --git a/files/ja/glossary/decryption/index.md b/files/ja/glossary/decryption/index.md index 2e338ce75c423d..356144d2a86a43 100644 --- a/files/ja/glossary/decryption/index.md +++ b/files/ja/glossary/decryption/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: d2a9f2e26a8139d4bb270d7dc3cddd8b848719fe --- +{{GlossarySidebar}} + {{glossary("cryptography","暗号学")}}では、**復号**とは{{glossary("ciphertext","暗号文")}}を{{glossary("Plaintext","平文")}}に変換することです。 復号は暗号プリミティブであり、{{glossary("cipher","サイファー")}}と呼ばれる暗号アルゴリズムを使用して暗号文メッセージを平文に変換します。 暗号化と同様に、現代のサイファーの復号は、特定のアルゴリズムと{{glossary("key","鍵")}}と呼ばれる秘密を使用して実行されます。 アルゴリズムはしばしば公開されるので、暗号化が安全なままであれば、鍵は秘密にしておく必要があります。 diff --git a/files/ja/glossary/deep_copy/index.md b/files/ja/glossary/deep_copy/index.md index 7c0a19c206015d..f0ea8aa74a591c 100644 --- a/files/ja/glossary/deep_copy/index.md +++ b/files/ja/glossary/deep_copy/index.md @@ -3,7 +3,7 @@ title: Deep copy (ディープコピー) slug: Glossary/Deep_copy --- -{{MDNSidebar}} +{{GlossarySidebar}} オブジェクトの **ディープコピー** とは、コピー先のオブジェクトのプロパティがコピー元のオブジェクトのプロパティと同一の参照(同じ値を指す)を共有しないコピーのことです。 diff --git a/files/ja/glossary/delta/index.md b/files/ja/glossary/delta/index.md index 1c3c1f5ebdb854..ec8cc932247fb7 100644 --- a/files/ja/glossary/delta/index.md +++ b/files/ja/glossary/delta/index.md @@ -3,6 +3,8 @@ title: Delta (デルタ) slug: Glossary/Delta --- +{{GlossarySidebar}} + **デルタ**は、2 つの値または状態の差分を表す用語です。 名前の由来はギリシャ文字の Δ (delta) で、 ローマ字の _D_ に相当します。*デルタ*は、省略形の文字 Δ を使用して*差分*を表します。 diff --git a/files/ja/glossary/denial_of_service/index.md b/files/ja/glossary/denial_of_service/index.md index 92e6439eb3825f..72918a99fb0d5f 100644 --- a/files/ja/glossary/denial_of_service/index.md +++ b/files/ja/glossary/denial_of_service/index.md @@ -3,6 +3,8 @@ title: Denial of Service (サービス拒否) slug: Glossary/Denial_of_Service --- +{{GlossarySidebar}} + サービス拒否 (DoS, Denial of Service)とは、ネットワーク攻撃のカテゴリーで、サーバーにリクエストを殺到させることによって、利用可能なサーバーリソースを消費させるものです。サーバーの動作が重くなったり、正規のユーザーが利用できなくなったりします。 詳しくは、 [DoS 攻撃](/ja/docs/Glossary/DOS_attack)を参照してください。 diff --git a/files/ja/glossary/deserialization/index.md b/files/ja/glossary/deserialization/index.md index 115f08ed065751..523e08292b21a9 100644 --- a/files/ja/glossary/deserialization/index.md +++ b/files/ja/glossary/deserialization/index.md @@ -3,6 +3,8 @@ title: Deserialization (デシリアライズ) slug: Glossary/Deserialization --- +{{GlossarySidebar}} + 下位レベルのフォーマット(例えば、ネットワークを介して転送された、またはデータストアに格納された)が、読み取り可能なオブジェクトまたは他のデータ構造に変換されるプロセス。 たとえば、{{Glossary("JavaScript")}} では、{{jsxref("JSON.parse()")}} {{Glossary("function","関数")}}を呼び出すことで、{{Glossary("JSON")}} {{Glossary("string","文字列")}}をオブジェクトにデシリアライズすることができます。 diff --git a/files/ja/glossary/developer_tools/index.md b/files/ja/glossary/developer_tools/index.md index 4ecda20908e86a..a7514fca6e79b7 100644 --- a/files/ja/glossary/developer_tools/index.md +++ b/files/ja/glossary/developer_tools/index.md @@ -3,6 +3,8 @@ title: 開発者ツール slug: Glossary/Developer_Tools --- +{{GlossarySidebar}} + 開発者ツール("DevTools"と略されます)は開発者がソフトウェアを作成、テスト、{{Glossary("debug", "デバッグ")}} するのを助けるプログラムです。 現在のブラウザーには、ウェブサイトの調査を可能にする開発者ツールが統合されています。ブラウザーの開発者ツールによって、ウェブサイトの{{Glossary("HTML")}}/{{Glossary("CSS")}}/{{Glossary("JavaScript")}}の調査やデバッグ、ウェブサイトによって発生したネットワークトラフィックの調査、ウェブサイトのパフォーマンスの計測など、たくさんのことが可能となります。 diff --git a/files/ja/glossary/digest/index.md b/files/ja/glossary/digest/index.md index 7d196cd6352441..7329692d7e9ebe 100644 --- a/files/ja/glossary/digest/index.md +++ b/files/ja/glossary/digest/index.md @@ -3,6 +3,8 @@ title: Digest slug: Glossary/Digest --- +{{GlossarySidebar}} + ダイジェストはメッセージ全体から{{glossary("cryptographic hash function", "ハッシュ関数")}}によって生成された小さな値です。理想的にはダイジェストは即座に計算でき、不可逆であり、予測不可能なため、メッセージが改ざんされたかどうかの判定に利用することができます。 ダイジェストを使用して、下記のようないくつかのタスクを実行できます: diff --git a/files/ja/glossary/digital_certificate/index.md b/files/ja/glossary/digital_certificate/index.md index 172d3d92eb7a46..4679e008c0f26c 100644 --- a/files/ja/glossary/digital_certificate/index.md +++ b/files/ja/glossary/digital_certificate/index.md @@ -3,6 +3,8 @@ title: デジタル証明書 slug: Glossary/Digital_certificate --- +{{GlossarySidebar}} + デジタル証明書は、公開{{Glossary("Key", "鍵")}}暗号を組織に結びつけるデータファイルです。デジタル証明書には、コモンネーム(例:mozilla.org)、組織単位(例:Mozilla Corporation)、場所(例:Mountain View)などの組織に関する情報が含まれています。デジタル証明書は、証明書の信頼性を証明する{{Glossary("certificate_authority", "認証局")}}によって最も一般的に署名されます。 ## 関連項目 diff --git a/files/ja/glossary/distributed_denial_of_service/index.md b/files/ja/glossary/distributed_denial_of_service/index.md index ca01912346369d..333813d4ea5b4d 100644 --- a/files/ja/glossary/distributed_denial_of_service/index.md +++ b/files/ja/glossary/distributed_denial_of_service/index.md @@ -3,6 +3,8 @@ title: Distributed Denial of Service slug: Glossary/Distributed_Denial_of_Service --- +{{GlossarySidebar}} + **Distributed Denial-of-Service**(**DDoS**、分散型サービス拒否)は、サーバー資源を襲って正当なユーザーをブロックするために、多数の侵害されたシステムが単一のターゲットを攻撃する攻撃です。 通常、多くの人が多くのボットを使用して、銀行やクレジットカード決済ゲートウェイなどの注目を浴びるウェブ{{glossary("server","サーバー")}}を攻撃します。DDoS は、コンピューターネットワークと CPU 資源管理に関係します。 diff --git a/files/ja/glossary/dmz/index.md b/files/ja/glossary/dmz/index.md index 6208fcd226ee32..00aeda55fb5be8 100644 --- a/files/ja/glossary/dmz/index.md +++ b/files/ja/glossary/dmz/index.md @@ -3,6 +3,8 @@ title: DMZ slug: Glossary/DMZ --- +{{GlossarySidebar}} + DMZ は、内部ネットワーク(企業または個人)と外部の信頼できない世界(通常はインターネット)との間に絶縁された安全なインターフェイスを提供する方法です。それは{{Glossary('node/networking', '外部ノード')}}からの内部ネットワークへのアクセスを拒否しながら、特定のエンドポイントだけを公開します。 ## 関連項目 diff --git a/files/ja/glossary/dns/index.md b/files/ja/glossary/dns/index.md index 70fe6c3677b895..a9001a9430df20 100644 --- a/files/ja/glossary/dns/index.md +++ b/files/ja/glossary/dns/index.md @@ -3,6 +3,8 @@ title: DNS slug: Glossary/DNS --- +{{GlossarySidebar}} + **DNS (Domain Name System)** は、インターネットに接続されたリソースのための階層化された分散型の名前付けシステムです。 DNS は{{Glossary("domain name","ドメイン名")}}のリストを、それらに関連付けられた IP アドレスなどのリソースとともに管理しています。 DNS の最も顕著な機能は、人間に優しいドメイン名 (mozilla.org など) を数字の{{Glossary("IP address","IP アドレス")}} (151.106.5.172 など) に変換することで、ドメイン名を適切な IP アドレスに対応付けするこのプロセスは **DNS ルックアップ**として知られています。対照的に、**逆引き DNS ルックアップ** (rDNS) は、 IP アドレスに関連付けられたドメイン名を決定するために使用されます。 diff --git a/files/ja/glossary/doctype/index.md b/files/ja/glossary/doctype/index.md index 894c5539799c8f..6fb23458e65ec3 100644 --- a/files/ja/glossary/doctype/index.md +++ b/files/ja/glossary/doctype/index.md @@ -3,6 +3,8 @@ title: Doctype slug: Glossary/Doctype --- +{{GlossarySidebar}} + {{Glossary("HTML")}} において、 doctype はすべての文書の先頭に見られる "``" という必須の前置きです。その唯一の目的は、{{Glossary("browser","ブラウザー")}}が文書をレンダリングするときにいわゆる[「後方互換モード (quirks mode)」](/ja/docs/Quirks_Mode_and_Standards_Mode)に切り替わるのを防ぐことです。つまり、 "``" という doctype は、ブラウザーがいくつかの仕様で互換性のない別のレンダリングモードを使用するのではなく、関連する仕様に従って最大限の努力を試みるようにします。 ## より詳しく知る diff --git a/files/ja/glossary/document_directive/index.md b/files/ja/glossary/document_directive/index.md index 858b612612bd58..46c3f42bd834cb 100644 --- a/files/ja/glossary/document_directive/index.md +++ b/files/ja/glossary/document_directive/index.md @@ -3,6 +3,8 @@ title: Document directive (文書ディレクティブ) slug: Glossary/Document_directive --- +{{GlossarySidebar}} + **{{Glossary("CSP")}} の文書ディレクティブ**は {{HTTPHeader("Content-Security-Policy")}} ヘッダーで使用され、ポリシーが適用される文書または[ワーカー](/ja/docs/Web/API/Web_Workers_API)環境のプロパティを管理します。 文書ディレクティブは {{CSP("default-src")}} ディレクティブで代替されることはありません。 diff --git a/files/ja/glossary/document_environment/index.md b/files/ja/glossary/document_environment/index.md index cea690a498815e..82f3df2d23a8d9 100644 --- a/files/ja/glossary/document_environment/index.md +++ b/files/ja/glossary/document_environment/index.md @@ -3,6 +3,8 @@ title: ドキュメント環境 slug: Glossary/Document_environment --- +{{GlossarySidebar}} + JavaScript のグローバル環境が window または iframe の場合、それはドキュメント環境と呼ばれます。グローバル環境は、それよりも外側の環境を持たない環境です。 ## より詳しく知る diff --git a/files/ja/glossary/dom/index.md b/files/ja/glossary/dom/index.md index f0b86dab6d4d2d..8a9f4b6251cea2 100644 --- a/files/ja/glossary/dom/index.md +++ b/files/ja/glossary/dom/index.md @@ -3,6 +3,8 @@ title: DOM slug: Glossary/DOM --- +{{GlossarySidebar}} + DOM (Document Object Model) とは、すべての {{glossary("HTML")}} または {{glossary("XML")}} 文書を表現・操作する {{glossary("API")}} です。 DOM はブラウザーで文書構造をノードのツリーとして読み込み、それぞれのノードを文書の一部 (例えば{{Glossary("element", "要素")}}、テキスト文字列、コメント) として表します。 DOM は文書内のすべてのノードにアクセスし操作するためにコードをブラウザー内で実行することができるので、{{glossary("World Wide Web","ウェブ")}}上で最も使用されいる {{Glossary("API")}} のひとつです。ノードの生成や移動、変更が可能です。イベントリスナーをノードに追加し、特定のイベントの発生時に実行させることもできます。 diff --git a/files/ja/glossary/domain/index.md b/files/ja/glossary/domain/index.md index e574fed4857d9b..210596178d7108 100644 --- a/files/ja/glossary/domain/index.md +++ b/files/ja/glossary/domain/index.md @@ -3,6 +3,8 @@ title: Domain (ドメイン) slug: Glossary/Domain --- +{{GlossarySidebar}} + ドメインとは、インターネット上の独自のリソースを識別し管理する機関のことです。 "ドメイン名"は、{{Glossary("URL")}}の階層の一部として使用します。たいていはブランド名のような最も記憶に残る部分です。 完全修飾ドメイン名(FQDN)には、インターネットの{{Glossary("DNS")}}システムを使用してこの権限を名前で一意に検索するために必要なすべてが含まれています。 diff --git a/files/ja/glossary/domain_name/index.md b/files/ja/glossary/domain_name/index.md index eae35babb9d644..668b2701ae8f83 100644 --- a/files/ja/glossary/domain_name/index.md +++ b/files/ja/glossary/domain_name/index.md @@ -3,6 +3,8 @@ title: Domain name (ドメイン名) slug: Glossary/Domain_name --- +{{GlossarySidebar}} + **ドメイン名**は {{Glossary("Internet","インターネット")}} 上でのウェブサイトの住所です。ドメイン名は {{Glossary("URL")}} で特定のウェブページが所属するサーバーを識別するために使用されています。ドメイン名はピリオド (ドット) で区切られ、{{Glossary("TLD","トップレベルドメイン")}}で終わる階層的な名前で構成されています。 ## 詳細情報 diff --git a/files/ja/glossary/domain_sharding/index.md b/files/ja/glossary/domain_sharding/index.md index f88f7c424e99c1..05a0623d35130b 100644 --- a/files/ja/glossary/domain_sharding/index.md +++ b/files/ja/glossary/domain_sharding/index.md @@ -3,6 +3,8 @@ title: Domain sharding (ドメインシャーディング) slug: Glossary/Domain_sharding --- +{{GlossarySidebar}} + ブラウザはアクティブな接続数をドメインごとに制限します。この制限を超えてアセットを同時ダウンロードできるようにするために、**ドメインシャーディング**はコンテンツを複数のサブドメインに分割します。複数のアセットを提供するために複数のドメインが使用されると、ブラウザはより多くのリソースを同時にダウンロードすることができるため、より速いページ読み込み時間とユーザ体験の向上をもたらします。 ドメインシャーディングの性能面での問題は各ドメインの DNS ルックアップの追加コストと各 TCP コネクション確立のオーバヘッドです。 diff --git a/files/ja/glossary/dominator/index.md b/files/ja/glossary/dominator/index.md index fc4c7fa5485af4..e9d5f725013e1f 100644 --- a/files/ja/glossary/dominator/index.md +++ b/files/ja/glossary/dominator/index.md @@ -3,6 +3,8 @@ title: Dominator (ドミネーター) slug: Glossary/Dominator --- +{{GlossarySidebar}} + グラフ理論では、ルートノードからノード B へのすべてのパスがノード A を通過する場合、ノード A はノード B をドミネート (支配) すると言います。 この概念は{{Glossary("garbage collection","ガベージコレクション")}}にとって重要です。 なぜなら、B は A を介してのみ到達可能であるということです。 ガベージコレクターが A に到達できず、再利用可能であると判断した場合、B も到達不能で、したがって、A が支配するオブジェクトは、A の保持するサイズに寄与します。 つまり、A 自身が解放された場合に解放される可能性のあるメモリの合計量です。 diff --git a/files/ja/glossary/dos_attack/index.md b/files/ja/glossary/dos_attack/index.md index 61e06ba81d4795..56b953cbd87b56 100644 --- a/files/ja/glossary/dos_attack/index.md +++ b/files/ja/glossary/dos_attack/index.md @@ -3,6 +3,8 @@ title: DoS攻撃 slug: Glossary/DOS_attack --- +{{GlossarySidebar}} + DoS (Denial of Service) は、大量のリクエスト送信により{{glossary("server", "サーバー")}}の適正なリソース使用を妨げるネットワーク攻撃手法です。 コンピューターは、計算能力やメモリーなどのリソースが限られています。リソースが使い尽くされると、プログラムはフリーズまたはクラッシュし使用できなくなります。DoS 攻撃にはサーバーのリソースを使い果たさせるための様々な手法があり、正当なユーザーにサーバーやネットワークを利用できないようにし、少なくともサーバーの処理速度を低下させます。 diff --git a/files/ja/glossary/dsl/digital_subscriber_line/index.md b/files/ja/glossary/dsl/digital_subscriber_line/index.md index cba1edbf63f852..d7115dfd6d83c3 100644 --- a/files/ja/glossary/dsl/digital_subscriber_line/index.md +++ b/files/ja/glossary/dsl/digital_subscriber_line/index.md @@ -3,6 +3,8 @@ title: DSL (デジタル加入者線) slug: Glossary/DSL/Digital_subscriber_line --- +{{GlossarySidebar}} + **DSL (デジタル加入者線)** は、ブロードバンドインターネット接続の一種で、電話回線を使って有線データ通信を行うものです。 ダウンロードとアップロードの速度は同じである必要はありません。このような場合、回線は _非対称_ と言われ、 ADSL の略称が使用されます。 diff --git a/files/ja/glossary/dsl/domain_specific_language/index.md b/files/ja/glossary/dsl/domain_specific_language/index.md index d132ae07725f59..522dd29347aa7c 100644 --- a/files/ja/glossary/dsl/domain_specific_language/index.md +++ b/files/ja/glossary/dsl/domain_specific_language/index.md @@ -3,6 +3,8 @@ title: DSL (ドメイン固有言語) slug: Glossary/DSL/Domain_specific_language --- +{{GlossarySidebar}} + **DSL(ドメイン固有言語)** とは、あるアプリケーションドメイン内の特定の問題に対処するために設計された、範囲が限定されたコンピューター言語の一種です。 DSL は、ドメインにまたがる様々な問題に対応するように設計された _汎用言語(GPL)_ とは対照的となります。 diff --git a/files/ja/glossary/dsl/index.md b/files/ja/glossary/dsl/index.md index 0068adf5888c8e..25c4f36698713d 100644 --- a/files/ja/glossary/dsl/index.md +++ b/files/ja/glossary/dsl/index.md @@ -3,6 +3,8 @@ title: DSL slug: Glossary/DSL --- +{{GlossarySidebar}} + **DSL** という用語は、文脈によって意味が異なることがあります。以下の可能性があります。 {{GlossaryDisambiguation}} diff --git a/files/ja/glossary/dtls/index.md b/files/ja/glossary/dtls/index.md index 22899e8d51587c..d6264020c9c7a7 100644 --- a/files/ja/glossary/dtls/index.md +++ b/files/ja/glossary/dtls/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: a160395a1e4baa10be746c56ec2f25e9d902e5cd --- +{{GlossarySidebar}} + **Datagram Transport Layer Security** (**DTLS**) とは、データグラムベースの通信を安全にするためのプロトコルです。ストリーム中心の Transport Layer Security ({{Glossary("TLS")}}) に基づいており、類似の水準のセキュリティーを提供します。一般的なデータグラムプロトコルと同様に、DTLSはメッセージが届く順番は愚か、メッセージが届くかどうかさえ保証しません。しかしながら、DTLSはデータグラムプロトコルの恩恵 ―― 特に低いオーバーヘッドや、レイテンシーの縮小 ――ももたらします。 こうした特徴は DTLS が活躍する最もありふれた領域、{{Glossary("WebRTC")}} において有用です。WebRTC に関連するすべてのプロトコルは DTLS で通信を暗号化することが求められています。これには {{Glossary("SCTP")}}や {{Glossary("RTP", "SRTP")}}、 {{Glossary("STUN")}} も含まれます。 diff --git a/files/ja/glossary/dtmf/index.md b/files/ja/glossary/dtmf/index.md index c2e7de753e229b..e440a13bb054f5 100644 --- a/files/ja/glossary/dtmf/index.md +++ b/files/ja/glossary/dtmf/index.md @@ -3,6 +3,8 @@ title: DTMF (Dual-Tone Multi-Frequency signaling) slug: Glossary/DTMF --- +{{GlossarySidebar}} + **Dual-Tone Multi-Frequency** (**DTMF**) シグナリングは、キーパッド上で押されているボタンを表すために可聴音を使用するシステムです。 米国ではしばしば「タッチトーン」と呼ばれています(パルスダイヤルから DTMF への移行が開始されたときにタッチトーンの商標が使用されたので)。 DTMF は、数字 \[0] 〜 \[9] と、文字 \[A] 〜 \[D] と、記号 \[#] と \[\*] を送信することができます。 いくつかの電話のキーパッドは、電話網による制御シグナリングのために典型的に使用される文字を含みます。 コンピュータは、モデムにダイヤルするとき、または電話会議または他の目的のためにメニューシステムにコマンドを送信するときに、DTMF を利用することができます。 diff --git a/files/ja/glossary/dynamic_typing/index.md b/files/ja/glossary/dynamic_typing/index.md index fb6c1f37315067..989b8c4392b3fc 100644 --- a/files/ja/glossary/dynamic_typing/index.md +++ b/files/ja/glossary/dynamic_typing/index.md @@ -3,6 +3,8 @@ title: Dynamic typing (動的型付け) slug: Glossary/Dynamic_typing --- +{{GlossarySidebar}} + **動的型付け言語**では、({{glossary("JavaScript")}} のように) インタプリターが実行時に、変数の{{glossary( "value", "値")}} に基づいて、{{glossary("variable","変数")}} に{{glossary("type", "データ型")}} を割り当てます。 ## 関連項目 diff --git a/files/ja/glossary/ecma/index.md b/files/ja/glossary/ecma/index.md index 8cc5bf077c5a91..64e98e526f0694 100644 --- a/files/ja/glossary/ecma/index.md +++ b/files/ja/glossary/ecma/index.md @@ -3,6 +3,8 @@ title: ECMA slug: Glossary/ECMA --- +{{GlossarySidebar}} + **Ecma International**(正式名:欧州電子計算機工業会; European Computer Manufacturers Association)は、コンピュータ・ハードウェアや通信、プログラム言語の標準規格を策定する非営利組織です。 ウェブの世界では、 {{Glossary("JavaScript")}} 言語の中核的規格である [ECMA-262 規格](http://www.ecma-international.org/publications/standards/Ecma-262.htm)(別名: {{Glossary("ECMAScript")}} )を維持・管理する組織として有名です。 diff --git a/files/ja/glossary/ecmascript/index.md b/files/ja/glossary/ecmascript/index.md index cb48d2e673714b..d661522a0ae527 100644 --- a/files/ja/glossary/ecmascript/index.md +++ b/files/ja/glossary/ecmascript/index.md @@ -3,6 +3,8 @@ title: ECMAScript slug: Glossary/ECMAScript --- +{{GlossarySidebar}} + **ECMAScript** は {{glossary("JavaScript")}} のベースとなっているスクリプト言語仕様です。[Ecma International](http://www.ecma-international.org) が ECMAScript の標準化を担当しています。 ## 詳細情報 diff --git a/files/ja/glossary/effective_connection_type/index.md b/files/ja/glossary/effective_connection_type/index.md index 3ae03e9bd8939d..2c4676342ccbe0 100644 --- a/files/ja/glossary/effective_connection_type/index.md +++ b/files/ja/glossary/effective_connection_type/index.md @@ -3,6 +3,8 @@ title: Effective connection type (有効接続種別) slug: Glossary/Effective_connection_type --- +{{GlossarySidebar}} + **有効接続種別** (ECT) とは、測定されたネットワーク性能のことで、実際の接続がテザリングされたブロードバンドや WiFi であっても、ブラウザーのページのリクエストの時間とと有効接続種別に基づいて、 3G などの携帯通信接続種別を返します。 観測されたラウンドトリップと下り接続速度の値を使用して、 '`slow-2g`', '`2g`', '`3g`', '`4g`' の値が特定されます。 diff --git a/files/ja/glossary/element/index.md b/files/ja/glossary/element/index.md index cdb23a7d83951d..a1f679ee1e004a 100644 --- a/files/ja/glossary/element/index.md +++ b/files/ja/glossary/element/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: 4a9f9d2e9c1811ce3519a7061e906db9200a5e97 --- +{{GlossarySidebar}} + **要素** (element) はウェブページの一部分です。 {{Glossary("XML")}} と {{Glossary("HTML")}} では、要素はデータ項目やテキストのかたまりや画像を含んだり、何も含まなかったりします。ふつうは要素は {{Glossary("attribute", "属性")}} (attribute) つきの開始タグ (opening tag) と、囲まれたテキストコンテンツと、閉じタグ (closing tag) を含んでいます。 ![例:

Hello world!

においては、 '

' が開始タグで、 'class="nice"' が属性とその値で、 'Hello world!' が囲まれたテキストコンテンツで、 '

' が閉じタグです。](anatomy-of-an-html-element.png) diff --git a/files/ja/glossary/encapsulation/index.md b/files/ja/glossary/encapsulation/index.md index cbbb57209a1904..b38abafc8e647c 100644 --- a/files/ja/glossary/encapsulation/index.md +++ b/files/ja/glossary/encapsulation/index.md @@ -3,6 +3,8 @@ title: Encapsulation (カプセル化) slug: Glossary/Encapsulation --- +{{GlossarySidebar}} + Encapsulation (カプセル化) とは、データと{{glossary("function","関数")}}を一つのコンポーネント (例えば、{{glossary("class","クラス")}}) に閉じ込め、そのコンポーネントへのアクセスを制御することにより、その{{glossary("object", "オブジェクト")}}を "ブラックボックス" にすることです。これにより、そのクラスのユーザは隠れた実装ではなくインターフェース(すなわち、そのクラスの外に対して公開されているデータと関数)を知っているだけで済みます。 ## 詳細情報 diff --git a/files/ja/glossary/encryption/index.md b/files/ja/glossary/encryption/index.md index a4d1a8e7d8513e..b8df9370698e59 100644 --- a/files/ja/glossary/encryption/index.md +++ b/files/ja/glossary/encryption/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: d2a9f2e26a8139d4bb270d7dc3cddd8b848719fe --- +{{GlossarySidebar}} + {{glossary("cryptography","暗号学")}} において**暗号化**とは、 {{glossary("plaintext","平文")}}を{{glossary("ciphertext","暗号文")}}に変換することを意味します。暗号文とは、認証されていない読み手にとって解読不能な文章のことです。 暗号化は、暗号プリミティブ ( {{glossary("cipher","サイファー")}}と呼ばれる暗号化アルゴリズムを用いて、平文を暗号文へと変換する方法) です。現代的なサイファーによる暗号化は、特定の暗号化アルゴリズムと、{{glossary("key","暗号鍵")}}と呼ばれる秘密の値を用いて行われます。アルゴリズムはだいたい公開されるので、暗号化が安全なままであれば、暗号鍵は秘密のままにしておかなければなりません。 diff --git a/files/ja/glossary/endianness/index.md b/files/ja/glossary/endianness/index.md index 30511944d343e2..dd703f909d3c7a 100644 --- a/files/ja/glossary/endianness/index.md +++ b/files/ja/glossary/endianness/index.md @@ -3,6 +3,8 @@ title: Endianness (エンディアン) slug: Glossary/Endianness --- +{{GlossarySidebar}} + **エンディアン** (もしくは**バイト順**) は、コンピューターが数字を表現するために各バイトを構成する方法を説明するものです。 メモリの個々の領域にはインデックス、もしくはアドレスが付与されています。各バイトには 8 ビット (つまり `0x00` から `0xff` まで) の数値しか保存できないため、それ以上大きな値を保存するには 1 バイトよりも大きな領域を予約しなければなりません。1 つの数値における複数のバイトの*順序*で断然最もよく使われているものは**リトルエンディアン**で、インテルのすべてのプロセッサーで使用されています。リトルエンディアンは小さいバイトから大きいバイトの順で (つまり、もっとも小さなバイトを最初または最下位のアドレスに) 格納するので、ちょうどヨーロッパの日付の書き方 (例えば 31 December 2050) と同様です。 diff --git a/files/ja/glossary/engine/index.md b/files/ja/glossary/engine/index.md index bbf30d7c0f49de..823a6e02f3251d 100644 --- a/files/ja/glossary/engine/index.md +++ b/files/ja/glossary/engine/index.md @@ -3,6 +3,8 @@ title: Engine slug: Glossary/Engine --- +{{GlossarySidebar}} + {{glossary("JavaScript")}} エンジンは、 JavaScript のプログラムを構文解析して実行するインタープリターです。 ## 詳細情報 diff --git a/files/ja/glossary/entity/index.md b/files/ja/glossary/entity/index.md index e11b190209333e..af9006755a8031 100644 --- a/files/ja/glossary/entity/index.md +++ b/files/ja/glossary/entity/index.md @@ -3,6 +3,8 @@ title: Entity (エンティティ) slug: Glossary/Entity --- +{{GlossarySidebar}} + {{glossary("HTML")}} **エンティティ**とは、アンパサンド (`&`) で始まりセミコロン (`;`)で終わるテキスト (文字列) のひと固まりです。エンティティは(通常は HTML コードとして解釈される)予約済み文字や、(ノーブレークスペースのように) 見えない文字を表示するためによく使用されます。標準キーボードでは入力が難しい文字の代わりに使用することもできます。 > **メモ:** 多くの文字は覚えやすいエンティティです。例えば、コピーライト記号 (`©`) のエンティティは `©` です。覚えにくものとしては、`—` や `—` があります。[リファレンス表](https://html.spec.whatwg.org/multipage/named-characters.html#named-character-references)や[デコーダーツール](https://mothereff.in/html-entities)を使用してみてください。 diff --git a/files/ja/glossary/entity_header/index.md b/files/ja/glossary/entity_header/index.md index f037232d387485..93961eb61d8f84 100644 --- a/files/ja/glossary/entity_header/index.md +++ b/files/ja/glossary/entity_header/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: f4f8e2f18ccf19a0bee59e1fe78753e276b98232 --- +{{GlossarySidebar}} + > **警告:** 現在の HTTP/1.1 仕様書では、エンティティ、エンティティヘッダー、エンティティ本体を参照することはなくなりました。一部のフィールドは{{glossary("Representation header", "表現ヘッダー")}}フィールドとして参照されるようになりました。 エンティティヘッダーは {{glossary("HTTP_header", "HTTP ヘッダー")}}の一種で、 HTTP メッセージの本体を説明します(すなわちメッセージ本体についてのメタデータです)。エンティティヘッダーには、 {{HTTPHeader("Content-Length")}}, {{HTTPHeader("Content-Language")}}, {{HTTPHeader("Content-Encoding")}}, {{HTTPHeader("Content-Type")}}, {{HTTPHeader("Expires")}}, などがあります。エンティティヘッダーは HTTP のリクエストおよびレスポンスの両方に存在することがあります。 diff --git a/files/ja/glossary/enumerated/index.md b/files/ja/glossary/enumerated/index.md index 1e1a442c8fe759..20b9b4970a9155 100644 --- a/files/ja/glossary/enumerated/index.md +++ b/files/ja/glossary/enumerated/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: 4bd65a01204446af2254bb8864bd22ad87bc86b0 --- +{{GlossarySidebar}} + コンピューター科学では、**列挙**型は、名前の付いた値の限られた集合からなるデータ型です。 ## HTML 列挙型属性 diff --git a/files/ja/glossary/event/index.md b/files/ja/glossary/event/index.md index 2cdc43805a4dc0..84d089e4995044 100644 --- a/files/ja/glossary/event/index.md +++ b/files/ja/glossary/event/index.md @@ -3,6 +3,8 @@ title: Event (イベント) slug: Glossary/Event --- +{{GlossarySidebar}} + Events は [DOM](/ja/docs/Glossary/DOM) 要素によって生成される資産であり、Javascript コードから操作できます。 ## 関連項目 diff --git a/files/ja/glossary/exception/index.md b/files/ja/glossary/exception/index.md index 3df111864fa5c3..f1e42f86bf40aa 100644 --- a/files/ja/glossary/exception/index.md +++ b/files/ja/glossary/exception/index.md @@ -3,6 +3,8 @@ title: Exception (例外) slug: Glossary/Exception --- +{{GlossarySidebar}} + **例外**とは、通常のコード実行を強制停止する条件です。 JavaScript {{glossary("syntax error", "構文エラー")}} は、とてもよくある例外の情報源です。 ## より詳しく知る diff --git a/files/ja/glossary/exif/index.md b/files/ja/glossary/exif/index.md index 6fcdf6f9b380fb..fb5ad983345134 100644 --- a/files/ja/glossary/exif/index.md +++ b/files/ja/glossary/exif/index.md @@ -3,6 +3,8 @@ title: EXIF slug: Glossary/EXIF --- +{{GlossarySidebar}} + **Exchangeable Image File Format (EXIF)** は、マルチメディアファイルのメタデータをファイル内に埋め込む方法を定めた規格です。例えば画像の場合、次のような情報を記述した EXIF データを含んでいることがあります。ピクセル単位の幅や高さ、解像度、シャッタースピード、絞り、 ISO 設定、撮影日など。 ## 関連情報 diff --git a/files/ja/glossary/expando/index.md b/files/ja/glossary/expando/index.md index f480879c50d4b2..935904fce03182 100644 --- a/files/ja/glossary/expando/index.md +++ b/files/ja/glossary/expando/index.md @@ -3,6 +3,8 @@ title: Expando slug: Glossary/Expando --- +{{GlossarySidebar}} + expando プロパティは、 {{glossary("JavaScript")}} によって {{glossary("DOM")}} ノードに追加されたプロパティであり、 DOM {{glossary("object","オブジェクト")}}の仕様書に含まれていないものです。 ```js diff --git a/files/ja/glossary/fallback_alignment/index.md b/files/ja/glossary/fallback_alignment/index.md index d0010c9dc826b1..a031d921d2388e 100644 --- a/files/ja/glossary/fallback_alignment/index.md +++ b/files/ja/glossary/fallback_alignment/index.md @@ -3,6 +3,8 @@ title: Fallback alignment (代替配置) slug: Glossary/Fallback_Alignment --- +{{GlossarySidebar}} + [CSS ボックス配置](/ja/docs/Web/CSS/CSS_Box_Alignment)では、代替配置を要求された配置が実現できない場合に対処するために指定します。例えば、`justify-content: space-between` を指定した場合、複数の[配置対象物](/ja/docs/Glossary/Alignment_Subject)が存在しなければなりません。存在しない場合は、代替配置が使用されます。これは、以下のように配置方法ごとに決まります。 - first baseline diff --git a/files/ja/glossary/falsy/index.md b/files/ja/glossary/falsy/index.md index 64e0775ede90d3..da9f54c7c7abd9 100644 --- a/files/ja/glossary/falsy/index.md +++ b/files/ja/glossary/falsy/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: 19036f6d79250ddc254d17e2b08bd0c45944b0ef --- +{{GlossarySidebar}} + **偽値** (**falsy** または **falsey**) な値とは、論理型コンテキストに現れたときに偽とみなされる値です。 {{Glossary("JavaScript")}} は{{Glossary("Conditional", "条件文")}}や{{Glossary("Loop", "繰り返し")}}などの場面で、任意の値を強制的に論理型に{{Glossary("Type_Conversion", "型変換")}}します。 diff --git a/files/ja/glossary/favicon/index.md b/files/ja/glossary/favicon/index.md index 7d76989f7f1e3f..99dc3c2ec92a4c 100644 --- a/files/ja/glossary/favicon/index.md +++ b/files/ja/glossary/favicon/index.md @@ -3,6 +3,8 @@ title: Favicon (ファビコン) slug: Glossary/Favicon --- +{{GlossarySidebar}} + ファビコン (お気に入りアイコン) はウェブサイトに含まれる小さなアイコンです。ブラウザのアドレスバー、ページタブ、ブックマークメニューなどに表示されます。ただし最新のブラウザのほとんどは、アドレスバーのファビコンをウェブサイトが {{Glossary("https","HTTPS")}} を使用しているかどうかを示す画像に置換しています。 通常、ファビコンは 16x16 ピクセルの {{Glossary("GIF")}}、 {{Glossary("PNG")}}、または ICO 形式で保存されます。 diff --git a/files/ja/glossary/fetch_directive/index.md b/files/ja/glossary/fetch_directive/index.md index 85e2732ef21637..b1302b89fab304 100644 --- a/files/ja/glossary/fetch_directive/index.md +++ b/files/ja/glossary/fetch_directive/index.md @@ -3,6 +3,8 @@ title: Fetch directive (フェッチディレクティブ) slug: Glossary/Fetch_directive --- +{{GlossarySidebar}} + **{{Glossary("CSP")}} のフェッチディレクティブ**は {{HTTPHeader("Content-Security-Policy")}} ヘッダーで使用され、特定のリソース種別の読み込み先を制御します。たとえば、 {{CSP("script-src")}} では、開発者は信頼できるスクリプトのソースを許可してページ上で実行できるようし、 {{CSP("font-src")}} では、ウェブフォントのソースを制御できます。 すべてのフェッチディレクティブは {{CSP("default-src")}} で代替することができます。つまり、フェッチディレクティブが CSP ヘッダーにない場合、ユーザーエージェントは `default-src` ディレクティブを探します。 diff --git a/files/ja/glossary/fetch_metadata_request_header/index.md b/files/ja/glossary/fetch_metadata_request_header/index.md index 533dd1d74d0c20..9d63bca421b5b8 100644 --- a/files/ja/glossary/fetch_metadata_request_header/index.md +++ b/files/ja/glossary/fetch_metadata_request_header/index.md @@ -3,6 +3,8 @@ title: フェッチメタデータリクエストヘッダー slug: Glossary/Fetch_metadata_request_header --- +{{GlossarySidebar}} + **フェッチメタデータリクエストヘッダー**は、リクエストの発信元のコンテキストに関する追加情報を提供する HTTP リクエストヘッダーです。これらのヘッダー名には `Sec-` の接頭辞が付いており、{{Glossary("Forbidden header name", "禁止ヘッダー名")}}であるため、 JavaScript からヘッダーを変更することはできません。 フェッチメタデータリクエストヘッダーは、リクエストがどこから来たのかという追加情報をサーバーに提供し、悪意のあるリクエストを無視できるようになります。 diff --git a/files/ja/glossary/firefox_os/index.md b/files/ja/glossary/firefox_os/index.md index 0fb799c05b7e45..545db11449133c 100644 --- a/files/ja/glossary/firefox_os/index.md +++ b/files/ja/glossary/firefox_os/index.md @@ -3,6 +3,8 @@ title: Firefox OS slug: Glossary/Firefox_OS --- +{{GlossarySidebar}} + Firefox OS は、Linux と {{glossary("Mozilla Firefox","Firefox")}} の強力な {{glossary("Gecko")}} レンダリングエンジンをベースにした Mozilla のモバイル OS です。Firefox OS は主に、{{glossary("Gaia")}}、 {{glossary("Gecko")}}、{{glossary("Gonk")}} から構成されています。 ## 関連項目 diff --git a/files/ja/glossary/firewall/index.md b/files/ja/glossary/firewall/index.md index 8223ac16e7fae3..b94a996c39b3cd 100644 --- a/files/ja/glossary/firewall/index.md +++ b/files/ja/glossary/firewall/index.md @@ -3,6 +3,8 @@ title: firewall (ファイアウォール) slug: Glossary/Firewall --- +{{GlossarySidebar}} + **ファイアウォール**はネットワークトラフィックをフィルタするシステムです。 特定の規則に従ってトラフィックを通過させたりブロックしたりすることができます。たとえば、特定のポートを宛先とする着信接続や、特定の IP アドレスへの発信接続をブロックすることができます。 ファイアウォールは単一のソフトウェアのようなシンプルなものから、ファイアウォールとしてのみ機能する専用マシンのような複雑なものまで存在します。 diff --git a/files/ja/glossary/first-class_function/index.md b/files/ja/glossary/first-class_function/index.md index b6ab0aefe2b628..19db5f242f7b8a 100644 --- a/files/ja/glossary/first-class_function/index.md +++ b/files/ja/glossary/first-class_function/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: fead53324d271aa05e93b369966a773bb328c64b --- +{{GlossarySidebar}} + あるプログラミング言語が**第一級関数 (First-class functions)** を持つと言われる場合、その言語の関数がその他の変数と同様に扱われることを表します。例えば、こうした言語では、関数を他の関数への引数として渡したり、他の関数から返却したり、変数の値として代入したりすることができます。 ## 例 diff --git a/files/ja/glossary/first_contentful_paint/index.md b/files/ja/glossary/first_contentful_paint/index.md index 5545c65f4cd113..e68b9b9dabc3c2 100644 --- a/files/ja/glossary/first_contentful_paint/index.md +++ b/files/ja/glossary/first_contentful_paint/index.md @@ -3,6 +3,8 @@ title: First contentful paint slug: Glossary/First_contentful_paint --- +{{GlossarySidebar}} + **First Contentful Paint** (FCP) は、ブラウザーが DOM からコンテンツの最初のビットをレンダリングし、ページが実際読み込み中というユーザーへの最初のフィードバックがなされる時間です。FCP が終わった時に「起こっているのか」という質問は「はい」です。 FCP タイムスタンプは、ブラウザーがテキスト、画像(背景画像を含む)、白以外の canvas や SVG を描画した時です。これには iframe は含まず、ただ仮の webfont でのテキストは含んでいます。これはユーザーがページコンテンツを消費する最初の時間です。 diff --git a/files/ja/glossary/first_cpu_idle/index.md b/files/ja/glossary/first_cpu_idle/index.md index 808a0492afc649..93f1c1233eae5e 100644 --- a/files/ja/glossary/first_cpu_idle/index.md +++ b/files/ja/glossary/first_cpu_idle/index.md @@ -3,4 +3,6 @@ title: First CPU idle slug: Glossary/First_CPU_idle --- +{{GlossarySidebar}} + **First CPU Idle** は、ページが最小限のインタラクティブであるとき、またはウィンドウがユーザ入力を処理するのに十分に静かな時を測定します。これは非標準の Google Web パフォーマンスメトリックです。一般に、全ての表示されている UI 要素がインタラクティブであるとは限らない場合に発生します。UI は平均して 50ms 以内にほとんどのユーザ入力に応答します。また、これは [First interactive](/ja/docs/Glossary/First_interactive) とも呼ばれます。 diff --git a/files/ja/glossary/first_meaningful_paint/index.md b/files/ja/glossary/first_meaningful_paint/index.md index 93aa5ee3715575..e0c8787b8f2062 100644 --- a/files/ja/glossary/first_meaningful_paint/index.md +++ b/files/ja/glossary/first_meaningful_paint/index.md @@ -3,6 +3,8 @@ title: First Meaningful Paint slug: Glossary/First_meaningful_paint --- +{{GlossarySidebar}} + **First Meaningful Paint** (FMP) は、スクロールせずに見える最大のレイアウト変更が行われ、ウェブフォントが読み込まれた後のペイントです。 "お役に立ちましたか?" 最初に意味のあるペイントが完了すると "はい" になります。 ## 関連項目 diff --git a/files/ja/glossary/first_paint/index.md b/files/ja/glossary/first_paint/index.md index ae553b379bd462..33a60a47c1da76 100644 --- a/files/ja/glossary/first_paint/index.md +++ b/files/ja/glossary/first_paint/index.md @@ -3,6 +3,8 @@ title: First paint slug: Glossary/First_paint --- +{{GlossarySidebar}} + FirstPaint は [Paint Timing API](/ja/docs/) の一部です。ナビゲーションからブラウザーが読み込んだ最初のピクセルを画面にレンダリングします。 ナビゲーション前の画面と視覚的に異なるものをレンダリングすることで「それが起きているのか?」という質問に答えます。 diff --git a/files/ja/glossary/flex/index.md b/files/ja/glossary/flex/index.md index 230df357fada7f..067c9be219c6bb 100644 --- a/files/ja/glossary/flex/index.md +++ b/files/ja/glossary/flex/index.md @@ -3,6 +3,8 @@ title: Flex slug: Glossary/Flex --- +{{GlossarySidebar}} + `flex` は CSS {{cssxref("display")}}のプロパティに新しく追加された値です。`inline-flex` と同じく、使用すると Element(要素)に {{glossary("flex container", "Flex コンテナ")}} が適用されます。また、その Element(要素)の子 Element(要素)それぞれには {{glossary("flex item", "Flex アイテム")}} が適用されます。flex アイテムが適用された Element(要素)は flex layout を構成し、CSS Flexible Box Layout Module で定義されているプロパティの全てが適用されるはずです。 `flex` プロパティは flexbox プロパティを縮めて表したプロパティです。`flex-grow` や `flex-shrink`、`flex-basis` 等があります。 diff --git a/files/ja/glossary/flex_container/index.md b/files/ja/glossary/flex_container/index.md index 170b74e6207561..2bc994456329bb 100644 --- a/files/ja/glossary/flex_container/index.md +++ b/files/ja/glossary/flex_container/index.md @@ -3,6 +3,8 @@ title: Flex コンテナ slug: Glossary/Flex_Container --- +{{GlossarySidebar}} + {{glossary("Flexbox")}} レイアウトは親要素の `display` プロパティの値に `flex` または `inline-flex` を指定することで定義されます。この親要素が**「flex コンテナ」**となり、その子要素が 「flex アイテム」({{glossary("flex item")}}) となります。 値に `flex` を指定すると、この要素はブロックレベルの flex コンテナとなり、`inline-flex` を指定すると、インラインレベルの flex コンテナとなります。これらの指定は、その要素に対する**「flex 整形文脈 (flex formatting context)」**を作成します。Flex 整形文脈は、フロートがコンテナに侵入せず、コンテナのマージンがアイテムのマージンによって相殺されないという点で、ブロック整形文脈と同様のものです。 diff --git a/files/ja/glossary/flex_item/index.md b/files/ja/glossary/flex_item/index.md index c3d03540962e54..052d1b0d840a33 100644 --- a/files/ja/glossary/flex_item/index.md +++ b/files/ja/glossary/flex_item/index.md @@ -3,6 +3,8 @@ title: Flex アイテム slug: Glossary/Flex_Item --- +{{GlossarySidebar}} + {{glossary("Flex Container")}} (`display: flex` または `display: inline-flex` が設定された要素) の直下の子要素が**「flex アイテム」**となります。 Flex コンテナ内で直下に続くテキストも flex アイテムになります。 diff --git a/files/ja/glossary/flexbox/index.md b/files/ja/glossary/flexbox/index.md index e33bf0f693bc74..c13a14134f53ce 100644 --- a/files/ja/glossary/flexbox/index.md +++ b/files/ja/glossary/flexbox/index.md @@ -3,6 +3,8 @@ title: Flexbox (フレックスボックス) slug: Glossary/Flexbox --- +{{GlossarySidebar}} + Flexbox は、アイテムを列方向や行方向など一次元に並べて表示するためのレイアウトモデルである [CSS Flexible Box Layout Module](https://www.w3.org/TR/css-flexbox-1/) に対する一般的な通称です。 この仕様書では、Flexbox はユーザーインターフェイスの設計のためのレイアウトモデルとして説明されています。Flexbox の重要な特徴として、フレックスレイアウト内のアイテムが伸縮することができるという点が挙げられます。余白はアイテム自体に割り当てることも、アイテム間やアイテム周りに配分することも出来ます。 diff --git a/files/ja/glossary/forbidden_header_name/index.md b/files/ja/glossary/forbidden_header_name/index.md index cc09d95ab0bea1..e40b3bef247b18 100644 --- a/files/ja/glossary/forbidden_header_name/index.md +++ b/files/ja/glossary/forbidden_header_name/index.md @@ -3,6 +3,8 @@ title: Forbidden header name (禁止ヘッダー名) slug: Glossary/Forbidden_header_name --- +{{GlossarySidebar}} + **禁止ヘッダー名**はプログラムから変更することができない [HTTP ヘッダー](/ja/docs/Web/HTTP/Headers)の名前、特に、 HTTP **リクエスト**ヘッダーの名前です (反対に、{{Glossary("Forbidden response header name", "禁止レスポンスヘッダー名")}}もあります)。 このようなヘッダーを変更することは禁止されています。なぜなら、ユーザーエージェントがヘッダーを完全に制御できるからです。`Sec-` で始まる名前は、{{domxref("XMLHttpRequest")}} のような、開発者にヘッダーの制御を許可する [Fetch](/ja/docs/Web/API/Fetch_API) を使った {{glossary("API")}} から安全に新しいヘッダーを作成するために予約されています。 diff --git a/files/ja/glossary/forbidden_response_header_name/index.md b/files/ja/glossary/forbidden_response_header_name/index.md index 98257bbc6899cf..ab279110574df5 100644 --- a/files/ja/glossary/forbidden_response_header_name/index.md +++ b/files/ja/glossary/forbidden_response_header_name/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: ed947b2c608428b62a60f07d09dc543f732dc09b --- +{{GlossarySidebar}} + 禁止レスポンスヘッダー名は、プログラムから変更することができない [HTTP ヘッダー](/ja/docs/Web/HTTP/Headers)の名前 (`Set-Cookie`) です。 ## 関連情報 diff --git a/files/ja/glossary/fork/index.md b/files/ja/glossary/fork/index.md index edd8c8d25529fc..cbff539c7eb86a 100644 --- a/files/ja/glossary/fork/index.md +++ b/files/ja/glossary/fork/index.md @@ -3,6 +3,8 @@ title: Fork (フォーク) slug: Glossary/Fork --- +{{GlossarySidebar}} + Fork (フォーク) とは、ある時点での既存のソフトウェアプロジェクトのコピーであり、自分自身の変更をプロジェクトに追加するためのものです。基本的に、元のソフトウェアのライセンスが許せば、コードをコピーして変更を加えて独自のバージョンを開発することができます。それ自体が「フォーク」となります。 フォークは、フリーでオープンソースのソフトウェア開発でよく見られます。 これは、 Git (及び GitHub プラットフォーム) を使用した貢献モデルにより、有名な用語になりました。 diff --git a/files/ja/glossary/fps/index.md b/files/ja/glossary/fps/index.md index aca786650cf3de..b45a121b660aee 100644 --- a/files/ja/glossary/fps/index.md +++ b/files/ja/glossary/fps/index.md @@ -3,6 +3,8 @@ title: frame rate (フレームレート, FPS) slug: Glossary/FPS --- +{{GlossarySidebar}} + **フレームレート**は、ブラウザーが表示するコンテンツの再計算、レイアウト、描画をすることができる速度です。**フレーム毎秒** (frame per second) または **fps** は、1 秒間に何枚のフレームを再描画できるかを表します。ウェブサイトのコンピューターグラフィックスでのフレームレートの目標値は 60fps です。 映画では一般に、フレームレートは 24fps です。フレームレートが低くても大丈夫なのは、被写体ぶれで錯覚が発生するためです。コンピューターの画面上を動く場合は被写体ぶれはありません (被写体ぶれのある画像[スプライト](/ja/docs/Web/CSS/CSS_Images/Implementing_image_sprites_in_CSS)を動かしている場合を除いて)。 diff --git a/files/ja/glossary/ftp/index.md b/files/ja/glossary/ftp/index.md index 0202c866ea1e27..b2a9bcc83388c0 100644 --- a/files/ja/glossary/ftp/index.md +++ b/files/ja/glossary/ftp/index.md @@ -3,6 +3,8 @@ title: FTP slug: Glossary/FTP --- +{{GlossarySidebar}} + **FTP** (File Transfer Protocol、ファイル転送プロトコル) は、ある{{glossary("host","ホスト")}}から別のホストに、インターネットを介してファイルを転送するための長年の標準的な{{glossary("protocol","プロトコル")}}でした。しかし、チームやホスティングアカウントは FTP を許可せず、代わりに Git などのバージョン管理システムに依存することが増えています。古いホスティングアカウントでも使用されていますが、もはや FTP はベストプラクティスとは見なされていないと言っても過言ではありません。 ## もっと学ぶ diff --git a/files/ja/glossary/ftu/index.md b/files/ja/glossary/ftu/index.md index 7f87d232147841..bd785c656e42fc 100644 --- a/files/ja/glossary/ftu/index.md +++ b/files/ja/glossary/ftu/index.md @@ -3,6 +3,8 @@ title: FTU slug: Glossary/FTU --- +{{GlossarySidebar}} + FTU ( First Time Use、ファーストタイムユース) は、{{glossary("Firefox OS")}} 端末上に新しくインストールした {{glossary("Gecko")}} の起動時に読み込まれるアプリです。 FTU は、タイムゾーンや WiFi の詳細、デフォルト言語、連絡先のインポートといった、様々な重要オプションの設定や、端末の詳細確認に使う「Phone Tour」に使うことができます。 diff --git a/files/ja/glossary/function/index.md b/files/ja/glossary/function/index.md index c5ea08aff41b6d..51f3ffa38b8d03 100644 --- a/files/ja/glossary/function/index.md +++ b/files/ja/glossary/function/index.md @@ -3,6 +3,8 @@ title: Function (関数) slug: Glossary/Function --- +{{GlossarySidebar}} + **関数** は、他のコードや自分自身、関数を参照する {{Glossary("variable", "変数")}} から呼ばれるコード断片です。関数が呼ばれると、{{Glossary("Argument", "引数")}} が関数への入力として渡され、次に関数は任意で値を戻します。{{glossary("JavaScript")}} における関数は、{{glossary("object", "オブジェクト")}} でもあります。 関数名は、関数宣言の一部または関数式に含まれる {{Glossary("identifier", "識別子")}} です。関数名の {{Glossary("scope", "スコープ")}} は、関数名が宣言か式かによって決まります。 diff --git a/files/ja/glossary/fuzzing/index.md b/files/ja/glossary/fuzzing/index.md index 8aa5eb0486fe82..c1529f0c76c91c 100644 --- a/files/ja/glossary/fuzzing/index.md +++ b/files/ja/glossary/fuzzing/index.md @@ -3,6 +3,8 @@ title: Fuzz testing (ファズテスティング) slug: Glossary/Fuzzing --- +{{GlossarySidebar}} + **ファジング**はプログラムがクラッシュしたり不適切に動作したりしていないかを確認する手法です。自動化されたツールで予期せぬデータや無効なデータを入力し、その結果を見ます。プログラムがクラッシュしたり不適切な動作をするようであればその内容を確認します。これは、ソフトウェアの安定性、信頼性、安全性を確かめる重要な方法であり、Mozilla ではファジングを多く利用しています。 - [Jesse's blog posts about fuzzing](http://www.squarefree.com/categories/fuzzing/) diff --git a/files/ja/glossary/gamut/index.md b/files/ja/glossary/gamut/index.md index 4f2402dafa7ae5..c3187584d270a4 100644 --- a/files/ja/glossary/gamut/index.md +++ b/files/ja/glossary/gamut/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: 5272602a89c279c42e18a0ab3434396fd33808f8 --- +{{GlossarySidebar}} + **色域** (gamut)とは、色のサブセットのことで、通例ディスプレイや印刷用デバイスが表現できる色の範囲を指します。 いかなるディスプレイやプリンターでも、人間の目が知覚できるあらゆる範囲の色を表現することはできません。デバイスの*色域*とは、そのデバイスがサポートする色の集合のことを指します。 diff --git a/files/ja/glossary/garbage_collection/index.md b/files/ja/glossary/garbage_collection/index.md index 6c39f429a3346b..4d15a613b81e97 100644 --- a/files/ja/glossary/garbage_collection/index.md +++ b/files/ja/glossary/garbage_collection/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: 4bd65a01204446af2254bb8864bd22ad87bc86b0 --- +{{GlossarySidebar}} + [**ガベージコレクション**](/ja/docs/Web/JavaScript/Memory_Management#ガベージコレクション)とは、{{Glossary("computer programming","コンピュータプログラミング")}}で用いられる用語で、{{Glossary("object", "オブジェクト")}}が、他のオブジェクトによって{{Glossary("object reference", "参照")}}されなくなったものを見つけて削除する処理を記述します。 言い換えれば、ガベージコレクションは、他のオブジェクトによって使用されていないオブジェクトを削除するプロセスです。 "GC" と省略されることが多いが、ガベージコレクションは、{{Glossary("JavaScript")}} で使用される[メモリー管理](/ja/docs/Web/JavaScript/Memory_Management)システムの基本的なコンポーネントです。 diff --git a/files/ja/glossary/gecko/index.md b/files/ja/glossary/gecko/index.md index 32a34274ac66c1..1f207f6ac9be21 100644 --- a/files/ja/glossary/gecko/index.md +++ b/files/ja/glossary/gecko/index.md @@ -3,6 +3,8 @@ title: Gecko slug: Glossary/Gecko --- +{{GlossarySidebar}} + **Gecko** は Mozilla プロジェクトによって開発された レイアウトエンジンであり、{{glossary("Mozilla Firefox","Firefox")}} や {{glossary("Firefox OS")}} を含む多くのアプリ / デバイスで使用されています。 ウェブブラウザーは HTML、CSS、Javascript、埋め込みコンテンツ(画像など)を解釈して画面に表示するためのレイアウトエンジンと呼ばれるソフトウェアが必要です。また Gecko はサポート対象のすべての OS 上で API と適切に連携し、また適切な API が関連するサポート対象にのみ公開されるようにも動作します。そのため Gecko はネットワークスタック、グラフィックススタック、レイアウトエンジン、JavaScript 仮想マシン、移植レイヤーといった機能などを併せ持っています。 diff --git a/files/ja/glossary/general_header/index.md b/files/ja/glossary/general_header/index.md index dcb5f9119691b7..d2bb80e5fde359 100644 --- a/files/ja/glossary/general_header/index.md +++ b/files/ja/glossary/general_header/index.md @@ -3,6 +3,8 @@ title: General header (一般ヘッダー) slug: Glossary/General_header --- +{{GlossarySidebar}} + **一般ヘッダー**は、リクエスト及びレスポンスメッセージの両方で使用できるものの、内容物そのものには適用されない {{glossary('Header', 'HTTP ヘッダー')}}です。使用されている文脈に応じて、一般ヘッダーは{{glossary("Response header", "レスポンスヘッダー")}}又は{{glossary("request header", "リクエストヘッダー")}}のどちらかになります。しかし、{{glossary("entity header", "エンティティヘッダー")}}ではありません。 最も一般的な一般的なヘッダーは、 {{HTTPHeader('Date')}}, {{HTTPheader("Cache-Control")}}, {{HTTPHeader("Connection")}} です。 diff --git a/files/ja/glossary/gif/index.md b/files/ja/glossary/gif/index.md index f985e030b5dfb3..ddbd955c46e52d 100644 --- a/files/ja/glossary/gif/index.md +++ b/files/ja/glossary/gif/index.md @@ -3,6 +3,8 @@ title: GIF slug: Glossary/GIF --- +{{GlossarySidebar}} + GIF (Graphics Interchange Format)は、可逆圧縮とアニメーションに使える画像フォーマットです。GIF は 1 ピクセル毎 8 ビットまでと、24 ビットの色領域から最大 256 色まで扱えます。 ## 詳細 diff --git a/files/ja/glossary/git/index.md b/files/ja/glossary/git/index.md index a110b327fcefbd..716320844d6b8f 100644 --- a/files/ja/glossary/git/index.md +++ b/files/ja/glossary/git/index.md @@ -3,6 +3,8 @@ title: Git slug: Glossary/Git --- +{{GlossarySidebar}} + **Git**はオープンソースで無償の、分散型ソースコードマネジメント ({{Glossary("SCM", "SCM", 1)}})システムです。Git を用いることで、分散した開発チームがコードベースを取り扱うことができます。従来の SCM システムから一線を画しているのは、一般的な操作(ブランチ(branching)、コミット(commiting)など)を自身の開発機で、master リポジトリを変更することなしに、それどころか master リポジトリへの書き込み権限がなくても行うことができる機能です。 ## 詳細 diff --git a/files/ja/glossary/global_object/index.md b/files/ja/glossary/global_object/index.md index bb57750e4fdc52..6c739209b4b30d 100644 --- a/files/ja/glossary/global_object/index.md +++ b/files/ja/glossary/global_object/index.md @@ -3,6 +3,8 @@ title: Global object (グローバルオブジェクト) slug: Glossary/Global_object --- +{{GlossarySidebar}} + グローバルオブジェクトは、{{glossary("global scope", "グローバルスコープ")}}上に常時存在する{{glossary("object", "オブジェクト")}}です。 JavaScript では、グローバルオブジェクトが常に定義されています。ウェブブラウザー上でスクリプトがグローバル変数を生成する時、グローバルオブジェクトのメンバーとして作成されます。 ({{Glossary("Node.js")}} ではこの限りではありません。) グローバルオブジェクトが実装する{{Glossary("interface", "インターフェイス")}}は、どのようなコンテキストでスクリプトが実行されているかによって変化します。例えば、 diff --git a/files/ja/glossary/global_scope/index.md b/files/ja/glossary/global_scope/index.md index 98789e5d913c5e..d86b331fa9939e 100644 --- a/files/ja/glossary/global_scope/index.md +++ b/files/ja/glossary/global_scope/index.md @@ -3,6 +3,8 @@ title: Global scope (グローバルスコープ) slug: Glossary/Global_scope --- +{{GlossarySidebar}} + プログラミング環境において、グローバルスコープとは、他のすべてのスコープを含み、他のすべてのスコープからアクセス可能な{{glossary("scope", "スコープ")}}を指します。 クライアントサイド JavaScript においては、一般的にすべてのコードが実行されている Web ページがグローバルスコープとなります。 diff --git a/files/ja/glossary/global_variable/index.md b/files/ja/glossary/global_variable/index.md index 93db40a8db0bc1..817633dcb94b7d 100644 --- a/files/ja/glossary/global_variable/index.md +++ b/files/ja/glossary/global_variable/index.md @@ -3,6 +3,8 @@ title: Global variable (グローバル変数) slug: Glossary/Global_variable --- +{{GlossarySidebar}} + グローバル変数は{{glossary("global scope","グローバルスコープ")}}で宣言された{{glossary("variable","変数")}}です。言い換えると、他のすべてのスコープから参照可能な変数です。 JavaScript では、グローバル変数は{{glossary("global object","グローバルオブジェクト")}}の{{glossary("property","プロパティ")}}です。 diff --git a/files/ja/glossary/glyph/index.md b/files/ja/glossary/glyph/index.md index 7fa083b90f023c..56a5cdc57f30c6 100644 --- a/files/ja/glossary/glyph/index.md +++ b/files/ja/glossary/glyph/index.md @@ -3,6 +3,8 @@ title: Glyph (字体) slug: Glossary/Glyph --- +{{GlossarySidebar}} + **字体**は、1 つ以上の{{Glossary("character", "文字")}}を視覚的に表現するためにタイポグラフィで使用される用語です。 ウェブサイトで使用されるフォントには、フォントの文字を表すさまざまな字体のセットが含まれています。 diff --git a/files/ja/glossary/google_chrome/index.md b/files/ja/glossary/google_chrome/index.md index ade0be933277ff..f7f8a6caa4e61b 100644 --- a/files/ja/glossary/google_chrome/index.md +++ b/files/ja/glossary/google_chrome/index.md @@ -3,6 +3,8 @@ title: Google Chrome slug: Glossary/Google_Chrome --- +{{GlossarySidebar}} + Google Chrome は Google が開発した無償の{{glossary("browser", "ブラウザー")}}です。オープンソースプロジェクトである [Chromium](http://www.chromium.org/) がベースとなっています。重要な違いについては [Chromium wiki](https://code.google.com/p/chromium/wiki/ChromiumBrowserVsGoogleChrome) で説明されています。 Chrome は独自のレイアウトエンジンである {{glossary("Blink")}} に対応しています。なお、 iOS 版の Chrome は Blink ではなくプラットフォームの WebView を使用しています。 ## Learn more diff --git a/files/ja/glossary/gpl/index.md b/files/ja/glossary/gpl/index.md index d53ad78229de2b..a4cafbd495799d 100644 --- a/files/ja/glossary/gpl/index.md +++ b/files/ja/glossary/gpl/index.md @@ -3,6 +3,8 @@ title: GPL slug: Glossary/GPL --- +{{GlossarySidebar}} + (GNU) GPL (General Public License: 一般公開ライセンス) はフリーソフトウェア財団が公開した 「コピーレフト(copyleft)」 のフリーソフトウェアライセンスです。GPL ライセンスで公開されたプログラムの利用者は、プログラムソースコードを読むこと、変更すること、 また同じライセンスであれば(変更の有無問わず)再配布することにも自由にできます。 ## 詳細 diff --git a/files/ja/glossary/gpu/index.md b/files/ja/glossary/gpu/index.md index 9c988fa730cddd..09a915c87b2ade 100644 --- a/files/ja/glossary/gpu/index.md +++ b/files/ja/glossary/gpu/index.md @@ -3,4 +3,6 @@ title: GPU slug: Glossary/GPU --- +{{GlossarySidebar}} + GPU (Graphics Processing Unit) は、コンピューターの構成要素で、CPU (Central Processing Unit) に似ています。モニター上のグラフィックス (2D と 3D の両方) の描画に特化しています。 diff --git a/files/ja/glossary/graceful_degradation/index.md b/files/ja/glossary/graceful_degradation/index.md index 8ff70be1f06d8b..65b2d4d4a50b3f 100644 --- a/files/ja/glossary/graceful_degradation/index.md +++ b/files/ja/glossary/graceful_degradation/index.md @@ -3,6 +3,8 @@ title: Graceful degradation (グレースフルデグラデーション) slug: Glossary/Graceful_degradation --- +{{GlossarySidebar}} + **グレースフルデグラデーション** (上品な劣化) とは設計哲学の一つで、最新のブラウザーで動作するように新しいウェブサイトやアプリケーションを構築するものの、古いブラウザーでも、良いものでなくても基本的なコンテンツや機能を引き続き提供する使用方法で代替できるようにしようとすることを目指したものです。 {{Glossary("Polyfill","ポリフィル")}}を使用して JavaScript で[不足している機能](/ja/docs/Learn/Tools_and_testing/Cross_browser_testing/Feature_detection)を構築することは可能ですが、 CSS のカスケードや HTML の代替の振る舞いなど、可能な限りスタイル付けやレイアウトなどの機能の代替案を用意する必要があります。いくつかの良い事例は、[一般的な HTML と CSS の問題の扱い](/ja/docs/Learn/Tools_and_testing/Cross_browser_testing/HTML_and_CSS)で見ることができます。 diff --git a/files/ja/glossary/grid/index.md b/files/ja/glossary/grid/index.md index 45e79fcc9ad2ab..5e225f3d09480b 100644 --- a/files/ja/glossary/grid/index.md +++ b/files/ja/glossary/grid/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: 4a9f9d2e9c1811ce3519a7061e906db9200a5e97 --- +{{GlossarySidebar}} + **CSS グリッド** は {{cssxref("display")}} プロパティの値に `grid` を指定して定義します。グリッドの列や行は {{cssxref("grid-template-rows")}} や {{cssxref("grid-template-columns")}} プロパティで定義します。 これらのプロパティを使って定義したグリッドのことを **明示的グリッド** _(explicit grid)_ と呼びます。 diff --git a/files/ja/glossary/grid_areas/index.md b/files/ja/glossary/grid_areas/index.md index 94bb6cb248b972..d0d5ec3fadfff3 100644 --- a/files/ja/glossary/grid_areas/index.md +++ b/files/ja/glossary/grid_areas/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: 4a9f9d2e9c1811ce3519a7061e906db9200a5e97 --- +{{GlossarySidebar}} + **グリッド領域**はグリッド上で一つ以上の {{glossary("grid cell", "グリッドセル")}} からなる長方形の領域です。グリッド領域は [ライン指定による配置](/ja/docs/Web/CSS/CSS_Grid_Layout/Line-based_Placement_with_CSS_Grid) や [名前付きグリッド領域](/ja/docs/Web/CSS/CSS_Grid_Layout/Grid_Template_Areas)で領域を定義すると作成されます。 ![Image showing a highlighted grid area](1_grid_area.png) diff --git a/files/ja/glossary/grid_axis/index.md b/files/ja/glossary/grid_axis/index.md index acbcd9aabd5872..8cc5bd2ebf9a1d 100644 --- a/files/ja/glossary/grid_axis/index.md +++ b/files/ja/glossary/grid_axis/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: 4a9f9d2e9c1811ce3519a7061e906db9200a5e97 --- +{{GlossarySidebar}} + CSS グリッドレイアウトはコンテンツを**行**と**列**でレイアウトできるようにする 2 次元レイアウトです。従って全てのグリッドには、**ブロックもしくは列の軸**と、**インラインもしくは行の列**という、 2 つの軸があります。 各アイテムはこれら 2 つの軸に沿って、[ボックス配置仕様書](/ja/docs/Web/CSS/CSS_Grid_Layout/Box_Alignment_in_CSS_Grid_Layout)で定義されているプロパティを使って配置されます。 diff --git a/files/ja/glossary/grid_cell/index.md b/files/ja/glossary/grid_cell/index.md index 014938476d92c5..4830ba5c1e820d 100644 --- a/files/ja/glossary/grid_cell/index.md +++ b/files/ja/glossary/grid_cell/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: 4a9f9d2e9c1811ce3519a7061e906db9200a5e97 --- +{{GlossarySidebar}} + [CSS グリッドレイアウト](/ja/docs/Web/CSS/CSS_Grid_Layout)における CSS グリッドの最小単位が**グリッドセル**です。 4 つの交差する {{glossary("grid lines", "グリッド線")}} に囲まれた領域のことで、表におけるセルと考え方はほぼ同じです。 ![Diagram showing an individual cell on the grid.](1_grid_cell.png) diff --git a/files/ja/glossary/grid_column/index.md b/files/ja/glossary/grid_column/index.md index e1038be3edc74a..185e1650b8950f 100644 --- a/files/ja/glossary/grid_column/index.md +++ b/files/ja/glossary/grid_column/index.md @@ -3,6 +3,8 @@ title: Grid 列 slug: Glossary/Grid_Column --- +{{GlossarySidebar}} + **グリッド列**とは [CSS グリッドレイアウト](/ja/docs/Web/CSS/CSS_Grid_Layout)における縦のトラックであり、二つの垂直方向のグリッドラインに挟まれた領域のことです。グリッド列は {{cssxref("grid-template-columns")}} プロパティまたは短縮記法の {{cssxref("grid")}} や {{cssxref("grid-template")}} プロパティで定義されます。 加えて、明示的グリッド _(explicit grid)_ で作られる列の外にアイテムが配置される場合は、暗黙的グリッド _(implicit grid)_ にもグリッド列が作られます。これらの列はデフォルトでは自動的に大きさが決定されますが、{{cssxref("grid-auto-columns")}} プロパティでサイズ指定することもできます。 diff --git a/files/ja/glossary/grid_container/index.md b/files/ja/glossary/grid_container/index.md index 1c21ff33253e5b..bfb82b065072fc 100644 --- a/files/ja/glossary/grid_container/index.md +++ b/files/ja/glossary/grid_container/index.md @@ -3,6 +3,8 @@ title: Grid container slug: Glossary/Grid_Container --- +{{GlossarySidebar}} + 要素に `grid` または `inline-grid` を使用すると、[CSS グリッドレイアウト](/ja/docs/Web/CSS/CSS_Grid_Layout)の**グリッドコンテナー**になります。そして直下の子要素はグリッドアイテムになります。 要素がグリッドコンテナーになると、**グリッド整形文脈**を形成します。グリッドコンテナー直下の子要素は、{{cssxref("grid-template-columns")}} や {{cssxref("grid-template-rows")}}を使って明示的に定義されたグリッドや、明示的に定義されたグリッドの外側に置かれた時には暗黙的に形成されるグリッドに沿って、配置されます。 diff --git a/files/ja/glossary/grid_lines/index.md b/files/ja/glossary/grid_lines/index.md index d336c45c49bf83..b0e9e59b4ec335 100644 --- a/files/ja/glossary/grid_lines/index.md +++ b/files/ja/glossary/grid_lines/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: d2a9f2e26a8139d4bb270d7dc3cddd8b848719fe --- +{{GlossarySidebar}} + **Grid 線**は [CSS グリッドレイアウト](/ja/docs/Web/CSS/CSS_Grid_Layout)を用いて明示的グリッドとして {{glossary("Grid tracks", "トラック")}} を定義すると作成されます。 ## 例 diff --git a/files/ja/glossary/grid_row/index.md b/files/ja/glossary/grid_row/index.md index a527dabe79226a..5ca0b77855b9b3 100644 --- a/files/ja/glossary/grid_row/index.md +++ b/files/ja/glossary/grid_row/index.md @@ -3,6 +3,8 @@ title: Grid 行 slug: Glossary/Grid_Row --- +{{GlossarySidebar}} + **グリッド行**とは [CSS グリッドレイアウト](/ja/docs/Web/CSS/CSS_Grid_Layout)における水平トラックであり、二つの水平方向のグリッドラインに挟まれた領域のことです。グリッド行は {{cssxref("grid-template-rows")}} プロパティまたは短縮記法の {{cssxref("grid")}} や {{cssxref("grid-template")}} プロパティで定義されます。 加えて、明示的グリッド _(explicit grid)_ で作られる行の外にアイテムが配置される場合は、暗黙的グリッド _(implicit grid)_ にもグリッド行が作られます。これらの行はデフォルトでは自動的に大きさが決定されますが、{{cssxref("grid-auto-rows")}} プロパティでサイズ指定することもできます。 diff --git a/files/ja/glossary/grid_tracks/index.md b/files/ja/glossary/grid_tracks/index.md index f0496b2b4e97d3..332445224dd9cb 100644 --- a/files/ja/glossary/grid_tracks/index.md +++ b/files/ja/glossary/grid_tracks/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: d2a9f2e26a8139d4bb270d7dc3cddd8b848719fe --- +{{GlossarySidebar}} + **グリッドトラック**とは、2 本の{{glossary("grid lines", "グリッド線")}}の間の空間のことです。*明示的なグリッド*では、 {{cssxref("grid-template-columns")}} と {{cssxref("grid-template-rows")}} プロパティ、または一括指定の {{cssxref("grid")}} または {{cssxref("grid-template")}} プロパティを使用して定義します。明示的グリッドで作成したトラックの外側にグリッドアイテムを配置することで、*暗黙的グリッド*にもトラックが生成されます。 次の画像は、グリッドにおける最初の行トラックを表しています。 From 8add72a231c554c0af82704097d0812fbd77dc44 Mon Sep 17 00:00:00 2001 From: Leonid Vinogradov Date: Mon, 20 Nov 2023 00:34:51 +0300 Subject: [PATCH 19/31] [ja] add sidebar to Glossary pages (part 3) --- files/ja/glossary/guard/index.md | 2 ++ files/ja/glossary/gutters/index.md | 2 ++ files/ja/glossary/gzip_compression/index.md | 2 ++ files/ja/glossary/hash/index.md | 2 ++ files/ja/glossary/head/index.md | 2 ++ files/ja/glossary/high-level_programming_language/index.md | 2 ++ files/ja/glossary/hmac/index.md | 2 ++ files/ja/glossary/hoisting/index.md | 2 ++ files/ja/glossary/host/index.md | 2 ++ files/ja/glossary/hotlink/index.md | 2 ++ files/ja/glossary/hpkp/index.md | 2 ++ files/ja/glossary/hsts/index.md | 2 ++ files/ja/glossary/html/index.md | 2 ++ files/ja/glossary/html5/index.md | 2 ++ files/ja/glossary/http/index.md | 2 ++ files/ja/glossary/http_2/index.md | 2 ++ files/ja/glossary/http_3/index.md | 2 ++ files/ja/glossary/http_header/index.md | 2 ++ files/ja/glossary/https/index.md | 2 ++ files/ja/glossary/hyperlink/index.md | 2 ++ files/ja/glossary/hypertext/index.md | 2 ++ files/ja/glossary/iana/index.md | 2 ++ files/ja/glossary/icann/index.md | 2 ++ files/ja/glossary/ice/index.md | 2 ++ files/ja/glossary/ide/index.md | 2 ++ files/ja/glossary/idempotent/index.md | 2 ++ files/ja/glossary/identifier/index.md | 2 ++ files/ja/glossary/idl/index.md | 2 ++ files/ja/glossary/ietf/index.md | 2 ++ files/ja/glossary/iife/index.md | 2 ++ files/ja/glossary/imap/index.md | 2 ++ files/ja/glossary/immutable/index.md | 2 ++ files/ja/glossary/indexeddb/index.md | 2 ++ files/ja/glossary/information_architecture/index.md | 2 ++ files/ja/glossary/inheritance/index.md | 2 ++ files/ja/glossary/inline-level_content/index.md | 2 ++ files/ja/glossary/input_method_editor/index.md | 2 ++ files/ja/glossary/instance/index.md | 2 ++ files/ja/glossary/internet/index.md | 2 ++ files/ja/glossary/intrinsic_size/index.md | 2 ++ files/ja/glossary/ip_address/index.md | 2 ++ files/ja/glossary/ipv4/index.md | 2 ++ files/ja/glossary/ipv6/index.md | 2 ++ files/ja/glossary/irc/index.md | 2 ++ files/ja/glossary/iso/index.md | 2 ++ files/ja/glossary/isp/index.md | 2 ++ files/ja/glossary/itu/index.md | 2 ++ files/ja/glossary/jank/index.md | 2 ++ files/ja/glossary/java/index.md | 4 ++-- files/ja/glossary/javascript/index.md | 2 ++ files/ja/glossary/jpeg/index.md | 2 ++ files/ja/glossary/json/index.md | 2 ++ files/ja/glossary/key/index.md | 2 ++ files/ja/glossary/keyword/index.md | 2 ++ files/ja/glossary/khronos/index.md | 2 ++ files/ja/glossary/latency/index.md | 2 ++ files/ja/glossary/lazy_load/index.md | 2 ++ files/ja/glossary/lgpl/index.md | 2 ++ files/ja/glossary/ligature/index.md | 2 ++ files/ja/glossary/literal/index.md | 2 ++ files/ja/glossary/local_scope/index.md | 2 ++ files/ja/glossary/local_variable/index.md | 2 ++ files/ja/glossary/locale/index.md | 2 ++ files/ja/glossary/localization/index.md | 2 ++ files/ja/glossary/long_task/index.md | 2 ++ files/ja/glossary/loop/index.md | 2 ++ files/ja/glossary/lossless_compression/index.md | 2 ++ files/ja/glossary/ltr/index.md | 4 ++-- files/ja/glossary/main_axis/index.md | 2 ++ files/ja/glossary/main_thread/index.md | 2 ++ files/ja/glossary/markup/index.md | 2 ++ files/ja/glossary/mathml/index.md | 2 ++ files/ja/glossary/metadata/index.md | 2 ++ files/ja/glossary/method/index.md | 2 ++ files/ja/glossary/microsoft_edge/index.md | 2 ++ files/ja/glossary/microsoft_internet_explorer/index.md | 2 ++ files/ja/glossary/middleware/index.md | 2 ++ files/ja/glossary/mime/index.md | 2 ++ files/ja/glossary/mime_type/index.md | 2 ++ files/ja/glossary/minification/index.md | 2 ++ files/ja/glossary/mitm/index.md | 2 ++ files/ja/glossary/mixin/index.md | 2 ++ files/ja/glossary/mobile_first/index.md | 2 ++ files/ja/glossary/modem/index.md | 2 ++ files/ja/glossary/modularity/index.md | 2 ++ files/ja/glossary/mozilla_firefox/index.md | 2 ++ files/ja/glossary/mutable/index.md | 2 ++ files/ja/glossary/mvc/index.md | 2 ++ files/ja/glossary/namespace/index.md | 2 ++ files/ja/glossary/nan/index.md | 2 ++ files/ja/glossary/nat/index.md | 2 ++ files/ja/glossary/native/index.md | 2 ++ files/ja/glossary/navigation_directive/index.md | 2 ++ files/ja/glossary/netscape_navigator/index.md | 2 ++ files/ja/glossary/network_throttling/index.md | 2 ++ files/ja/glossary/nntp/index.md | 2 ++ files/ja/glossary/node/dom/index.md | 2 ++ files/ja/glossary/node/index.md | 2 ++ files/ja/glossary/node/networking/index.md | 2 ++ 99 files changed, 198 insertions(+), 4 deletions(-) diff --git a/files/ja/glossary/guard/index.md b/files/ja/glossary/guard/index.md index 2702764710b39f..e2f100c4c092d4 100644 --- a/files/ja/glossary/guard/index.md +++ b/files/ja/glossary/guard/index.md @@ -3,4 +3,6 @@ title: Guard (ガード) slug: Glossary/Guard --- +{{GlossarySidebar}} + ガードは、{{domxref("Fetch_API","Fetch 仕様")}}で定義されている {{domxref("Headers")}} オブジェクトの機能で、{{domxref("Headers.set","set()")}} や {{domxref("Headers.append","append()")}} などのメソッドがヘッダーのコンテンツを変更できるかどうかに影響します。 例えば、`immutable`(不変)ガードは、ヘッダーを変更できないことを意味します。 詳しくは、[Fetch の基本概念: ガード](/ja/docs/Web/API/Fetch_API/Basic_concepts#Guard)を参照してください。 diff --git a/files/ja/glossary/gutters/index.md b/files/ja/glossary/gutters/index.md index dacb2858526283..e2bbf60241e320 100644 --- a/files/ja/glossary/gutters/index.md +++ b/files/ja/glossary/gutters/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: 21bed6549ed179757c999336ef4637d16f663137 --- +{{GlossarySidebar}} + **ガター** もしくはアレーはコンテンツトラック間のスペースです。[CSS グリッドレイアウト](/ja/docs/Web/CSS/CSS_Grid_Layout)で {{cssxref("column-gap")}}、{{cssxref("row-gap")}}、{{cssxref("gap")}} プロパティを使うとガターが作成されます。 ## 例 diff --git a/files/ja/glossary/gzip_compression/index.md b/files/ja/glossary/gzip_compression/index.md index 95e946a75c6618..d8d67bf821a81f 100644 --- a/files/ja/glossary/gzip_compression/index.md +++ b/files/ja/glossary/gzip_compression/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: d2a9f2e26a8139d4bb270d7dc3cddd8b848719fe --- +{{GlossarySidebar}} + gzip はファイルの圧縮および展開に使われるファイル形式です。これは Deflate アルゴリズムに基づいており、ファイルをより小さくすることができ、より高速なネットワーク転送を可能にします。gzip はウェブサーバーや最近のブラウザーが広く対応しており、サーバーは送信前に自動的にファイルを圧縮し、ブラウザーは受信時に展開することができます。 ## 関連情報 diff --git a/files/ja/glossary/hash/index.md b/files/ja/glossary/hash/index.md index d5b87f3fe00d09..74040844737d5d 100644 --- a/files/ja/glossary/hash/index.md +++ b/files/ja/glossary/hash/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: 4bd65a01204446af2254bb8864bd22ad87bc86b0 --- +{{GlossarySidebar}} + ハッシュ関数は、可変長のメッセージ入力を受けて固定長のハッシュ出力を生成します。出力は、通常、128 ビットの「フィンガープリント」や「メッセージダイジェスト」の形を取ります。 ハッシュは{{glossary("cryptography", "暗号化")}}にとても便利です。送信データの完全性を保証したり、メッセージ認証を提供する {{glossary("HMAC")}} の基礎となったりします。 ## 関連情報 diff --git a/files/ja/glossary/head/index.md b/files/ja/glossary/head/index.md index d65a0a2454d24b..2eb6e9396dde71 100644 --- a/files/ja/glossary/head/index.md +++ b/files/ja/glossary/head/index.md @@ -3,6 +3,8 @@ title: Head slug: Glossary/Head --- +{{GlossarySidebar}} + **Head** **は** {{glossary("HTML")}} 文書の一部で、その文書の {{glossary("metadata", "メタデータ")}} 、例えば著者や、説明や、HTML に適用される {{glossary("CSS")}} や {{glossary("JavaScript")}} ファイルへのリンクといったものを含んでいます。 ## 詳細情報 diff --git a/files/ja/glossary/high-level_programming_language/index.md b/files/ja/glossary/high-level_programming_language/index.md index b1ecc7bfd6e69f..7aecab00e3f416 100644 --- a/files/ja/glossary/high-level_programming_language/index.md +++ b/files/ja/glossary/high-level_programming_language/index.md @@ -3,6 +3,8 @@ title: High-level programming language (高水準言語) slug: Glossary/High-level_programming_language --- +{{GlossarySidebar}} + 高水準言語は、コンピューターの命令の詳細を**大幅に抽象化**します。人間が容易に理解できるように設計されているため、別のソフトウェアで翻訳する必要があります。低水準言語とは異なり、自然言語要素を使用したり、コンピューティングシステムの大半の領域を自動化(または完全に隠蔽)して、低水準言語に比べて開発プロセスをより簡単で理解しやすいものにします。提供される抽象化の量によって、プログラミング言語がいかに「高水準」であるかが定義されます。 マシンコードに自動的に変換可能だが人間のロジックに近い言語のアイデアは、1950 年代にコンピューターサイエンスに導入されました。特に **John Backus**(IBM)の仕事のおかげで、最初の高水準言語 Fortran が広く流通しました。この革新により、Backus はチューリング賞を受賞しました。 diff --git a/files/ja/glossary/hmac/index.md b/files/ja/glossary/hmac/index.md index 6b81b2c3013cee..d7a23766b843bd 100644 --- a/files/ja/glossary/hmac/index.md +++ b/files/ja/glossary/hmac/index.md @@ -3,6 +3,8 @@ title: HMAC slug: Glossary/HMAC --- +{{GlossarySidebar}} + HMAC は、{{Glossary("cryptography", "暗号的")}}にメッセージを認証するために使用されるプロトコルです。 どのような種類の{{Glossary("Cryptographic hash function", "暗号化関数")}}も使用でき、その強さは基礎となる関数(たとえば SHA1 または MD5)と選択された秘密鍵に依存します。このような組み合わせでは、HMAC-SHA1 などの複合名で HMAC 検証{{Glossary("Algorithm", "アルゴリズム")}}が認識されます。 HMAC は、完全性と認証の両方を保証するために使用されます。 diff --git a/files/ja/glossary/hoisting/index.md b/files/ja/glossary/hoisting/index.md index f40be0f14f92ee..fb7e3953ddefec 100644 --- a/files/ja/glossary/hoisting/index.md +++ b/files/ja/glossary/hoisting/index.md @@ -3,6 +3,8 @@ title: Hoisting (巻き上げ、ホイスティング) slug: Glossary/Hoisting --- +{{GlossarySidebar}} + 巻き上げ (Hoisting) は、[ECMAScript® 2015 言語仕様](http://www.ecma-international.org/ecma-262/6.0/index.html)より前には、どんな規範的な仕様書にもなかったものです。巻き上げは JavaScript の実行コンテキスト (特に作成と実行のフェーズで) では一般的な方法と考えられていました。しかし、巻き上げの概念は誤解に繋がる可能性があります。 概念的には、例えば、厳密な定義では、変数や関数の宣言が物理的にコードの先頭に移動されることを示唆していますが、実際にはそうではありません。変数や関数の宣言は*コンパイル*時にメモリに格納されますが、コード内で入力された場所は変わりません。 diff --git a/files/ja/glossary/host/index.md b/files/ja/glossary/host/index.md index d94d44b36ae919..7d888d5d3b93ce 100644 --- a/files/ja/glossary/host/index.md +++ b/files/ja/glossary/host/index.md @@ -3,6 +3,8 @@ title: Host (ホスト) slug: Glossary/Host --- +{{GlossarySidebar}} + ホストは、{{glossary("Internet", "インターネット")}} (またはローカルネットワーク) に接続する端末です。{{glossary("server","サーバー")}}と呼ばれるホストは、ウェブページの提供や、ファイルやメールの保存のような付加サービスを提供します。 ホストはハードウェアのインスタンスである必要はありません。仮想マシンで生成することもできます。仮想マシンで生成されたホストは「仮想ホスト」と呼ばれています。 diff --git a/files/ja/glossary/hotlink/index.md b/files/ja/glossary/hotlink/index.md index e8bb5e340f6720..2052b6521e53dc 100644 --- a/files/ja/glossary/hotlink/index.md +++ b/files/ja/glossary/hotlink/index.md @@ -3,6 +3,8 @@ title: Hotlink (直リンク) slug: Glossary/Hotlink --- +{{GlossarySidebar}} + **直リンク** (**ホットリンク**、**インラインリンク**とも呼ばれる) は、別のサイトから直接リンクされたオブジェクト (通常は画像) です。たとえば、 site1.com でホストされている画像が site2.com に直接表示されるものです。 この行為は、リンク先のオブジェクトをホストしているウェブサイトの帯域幅を勝手に利用することになるため、多くの場合はひんしゅくを買う行為であり、また著作権上の懸念 — 許可なく行われた場合は窃盗とみなされます — を引き起こす可能性もあるためです。 diff --git a/files/ja/glossary/hpkp/index.md b/files/ja/glossary/hpkp/index.md index 585b8e821d3c2e..ec9fbdad200972 100644 --- a/files/ja/glossary/hpkp/index.md +++ b/files/ja/glossary/hpkp/index.md @@ -3,6 +3,8 @@ title: HPKP slug: Glossary/HPKP --- +{{GlossarySidebar}} + **HPKP** (HTTP 公開鍵ピンニング、 HTTP Public Key Pinning) は、偽造された証明書による {{Glossary("MITM")}} 攻撃のリスクを減らすために、特定の暗号化公開鍵を特定のウェブサーバーに関連付けるようにウェブクライアントに指示するセキュリティ機能です。 ## より詳しく知る diff --git a/files/ja/glossary/hsts/index.md b/files/ja/glossary/hsts/index.md index c652d006e130ef..3f12bdaa430525 100644 --- a/files/ja/glossary/hsts/index.md +++ b/files/ja/glossary/hsts/index.md @@ -3,6 +3,8 @@ title: HSTS slug: Glossary/HSTS --- +{{GlossarySidebar}} + **HTTP Strict Transport Security** を使用すると、ウェブサイトはブラウザーに、HTTP を使用してサイトを読み込まないことと、HTTP を使用してサイトにアクセスしようとするすべての試みを HTTPS リクエストへ自動的に変換する必要があることを通知することができます。 これは、{{HTTPHeader("Strict-Transport-Security")}} という 1 つの HTTP ヘッダーで構成され、サーバーによってリソースとともに送り返されます。 言い換えれば、URL でプロトコルを HTTP から HTTPS に変更するだけで、より安全に動作することをブラウザーに伝え、すべてのリクエストに対してそれを行うようにブラウザーに依頼します。 diff --git a/files/ja/glossary/html/index.md b/files/ja/glossary/html/index.md index 13e24073614529..572e36848975ed 100644 --- a/files/ja/glossary/html/index.md +++ b/files/ja/glossary/html/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: 4bd65a01204446af2254bb8864bd22ad87bc86b0 --- +{{GlossarySidebar}} + **HTML** (HyperText Markup Language) は、ウェブページの構造を指定する記述言語です。 ## 略歴 diff --git a/files/ja/glossary/html5/index.md b/files/ja/glossary/html5/index.md index 71b9a6692b0188..a37437eeec7b74 100644 --- a/files/ja/glossary/html5/index.md +++ b/files/ja/glossary/html5/index.md @@ -3,6 +3,8 @@ title: HTML5 slug: Glossary/HTML5 --- +{{GlossarySidebar}} + HTML5 は、{{Glossary("HTML")}} の最新の安定バージョンであり、ドキュメントを構築するだけのマークアップであった HTML をアプリケーション開発基盤へと昇華させました。また、その他にも HTML5 は新しい Element (要素) と {{glossary("JavaScript")}} {{glossary("API","API")}} を含んでおり、ストレージやマルチメディア、ハードウェアアクセスが強化されています。 ## 詳細 diff --git a/files/ja/glossary/http/index.md b/files/ja/glossary/http/index.md index efbb5bc36a38a8..f81c7342570e33 100644 --- a/files/ja/glossary/http/index.md +++ b/files/ja/glossary/http/index.md @@ -3,6 +3,8 @@ title: HTTP slug: Glossary/HTTP --- +{{GlossarySidebar}} + **HTTP** (HyperText Transfer Protocol、ハイパーテキスト転送プロトコル) は、{{glossary("World Wide Web","Web")}}上のハイパーメディア文書の転送を可能にする、基盤となるネットワーク{{glossary("protocol", "プロトコル")}}です。一般にブラウザーとサーバーの間で用いられ、人間が読むことができます。現行の HTTP 仕様のバージョンは {{glossary("HTTP_2", "HTTP/2")}} と呼ばれています。 {{glossary("URI")}}の一部として「`http://example.com/`」の中の「http」は「スキーマ」と呼ばれ、これを使ったリソースは、通常 HTTP プロトコルを用いた非暗号化コネクションで転送されます。(「`https://developer.mozilla.org`」にあるような)「https」スキーマでは、リソースは HTTP プロトコルで転送されますが、安全な {{glossary("TLS")}}チャンネルを経由します。 diff --git a/files/ja/glossary/http_2/index.md b/files/ja/glossary/http_2/index.md index 4467a371601250..86f04511230a68 100644 --- a/files/ja/glossary/http_2/index.md +++ b/files/ja/glossary/http_2/index.md @@ -3,6 +3,8 @@ title: HTTP/2 slug: Glossary/HTTP_2 --- +{{GlossarySidebar}} + **HTTP/2** は [HTTP ネットワークプロトコル](/ja/docs/Web/HTTP/Basics_of_HTTP)の改訂版です。 HTTP/2 の主な目的は、リクエストとレスポンス全体を全二重化できるようにすることで、{{glossary("latency", "レイテンシー")}}を縮小し、 HTTP ヘッダーフィールドを効率的に圧縮することでプロトコルのオーバーヘッドを最小化し、リクエストの優先度やサーバーからのプッシュ通知に対応することです。 HTTP/2 は HTTP のアプリケーション的な意味を何も変更していません。 HTTP 1.1 にあった主要な概念、たとえば HTTP メソッド、ステータスコード、 URI、ヘッダーフィールドなどはすべてそのまま残っています。その代わり、 HTTP/2 はデータを書式化 (フレーム化) するしてクライアントとサーバー間で転送する方法を、プロセス全体の管理と、新しいフレーム化レイヤーの中の複雑さをアプリケーションから隠蔽することの両面で変更しました。結果として、既存のすべてのアプリケーションが変更なしに配信することができます。 diff --git a/files/ja/glossary/http_3/index.md b/files/ja/glossary/http_3/index.md index 7ae8026d3ed54f..4368d5267fd872 100644 --- a/files/ja/glossary/http_3/index.md +++ b/files/ja/glossary/http_3/index.md @@ -3,6 +3,8 @@ title: HTTP/3 slug: Glossary/HTTP_3 --- +{{GlossarySidebar}} + **HTTP/3** は {{glossary("HTTP 2", "HTTP/2")}} に続く [HTTP ネットワークプロトコル](/ja/docs/Web/HTTP/Basics_of_HTTP) の今後のメジャーリビジョンです。 HTTP/3 の主なポイントは {{glossary("TCP")}} の代わりに QUIC という新しい {{glossary("UDP")}} プロトコルを使用することです。 1. 一般知識 diff --git a/files/ja/glossary/http_header/index.md b/files/ja/glossary/http_header/index.md index 2c4149b5f4e584..4318a9cf606168 100644 --- a/files/ja/glossary/http_header/index.md +++ b/files/ja/glossary/http_header/index.md @@ -3,6 +3,8 @@ title: HTTP header (HTTP ヘッダー) slug: Glossary/HTTP_header --- +{{GlossarySidebar}} + **HTTP ヘッダー**は、 HTTP リクエストおよび HTTP レスポンスのフィールドで、メッセージや本文のセマンティクスを変更したり、より詳細に説明したりするための追加情報を渡します。ヘッダーは大文字と小文字を区別せず、行の先頭から始まり、直後に `':'` とヘッダー自体に依存する値が続きます。値は、次の CRLF またはメッセージの最後で終了します。 従来より、ヘッダーはカテゴリ分けされてきましたが、この分類は仕様書では定義されていません。 diff --git a/files/ja/glossary/https/index.md b/files/ja/glossary/https/index.md index 14fc7739b05805..a1a3a83fd55ee9 100644 --- a/files/ja/glossary/https/index.md +++ b/files/ja/glossary/https/index.md @@ -3,6 +3,8 @@ title: HTTPS slug: Glossary/HTTPS --- +{{GlossarySidebar}} + **HTTPS** (**_HyperText Transfer Protocol Secure_**) は {{Glossary("HTTP")}} プロトコルを暗号化したバージョンです。 HTTPS は通常、 {{Glossary("SSL")}} または {{Glossary("TLS")}} を用いてクライアントとサーバー間のすべての通信を暗号化します。この安全な接続により、クライアントは機密データをサーバーと安全に交換できます (例えば、銀行取引やオンラインショッピングなどで)。 1. 一般知識 diff --git a/files/ja/glossary/hyperlink/index.md b/files/ja/glossary/hyperlink/index.md index 1e576976f93fc5..a99b8614379353 100644 --- a/files/ja/glossary/hyperlink/index.md +++ b/files/ja/glossary/hyperlink/index.md @@ -3,6 +3,8 @@ title: Hyperlink (ハイパーリンク) slug: Glossary/Hyperlink --- +{{GlossarySidebar}} + ハイパーリンクはウェブページやデータ項目をお互いに接続します。HTML では {{HTMLElement("a")}} 要素が、ウェブページのある場所 (テキスト文字や画像のようなもの) から、その他のウェブページ (や同じページでも) のどこかの場所へのハイパーリンクを定義します。 ## 詳細情報 diff --git a/files/ja/glossary/hypertext/index.md b/files/ja/glossary/hypertext/index.md index 8fedb38e6bb324..2229ef475e6fc0 100644 --- a/files/ja/glossary/hypertext/index.md +++ b/files/ja/glossary/hypertext/index.md @@ -3,6 +3,8 @@ title: Hypertext (ハイパーテキスト) slug: Glossary/Hypertext --- +{{GlossarySidebar}} + ハイパーテキストは、ほかのテキストへのリンクを含むテキストであり、小説のように単一で線形の流れのものとは対照的なものです。 この用語は、テッド・ネルソンによって 1965 年に造られました。 diff --git a/files/ja/glossary/iana/index.md b/files/ja/glossary/iana/index.md index 3f257f5e337ade..c2afcf6ec91fa6 100644 --- a/files/ja/glossary/iana/index.md +++ b/files/ja/glossary/iana/index.md @@ -3,6 +3,8 @@ title: IANA slug: Glossary/IANA --- +{{GlossarySidebar}} + **IANA** (Internet Assigned Numbers Authority) は、インターネット{{glossary("protocol","プロトコル")}}で使用される{{glossary("domain name","ドメイン名")}}、{{glossary("IP address","IP アドレス")}}、その他の名前と番号の記録および/または割り当てを担当する {{glossary("ICANN")}} の下部組織です。 ## より詳しく知る diff --git a/files/ja/glossary/icann/index.md b/files/ja/glossary/icann/index.md index 87ef94b0f40928..2ccb10db068f24 100644 --- a/files/ja/glossary/icann/index.md +++ b/files/ja/glossary/icann/index.md @@ -3,6 +3,8 @@ title: ICANN slug: Glossary/ICANN --- +{{GlossarySidebar}} + **ICANN** (Internet Corporation for Assigned Names and Numbers、**アイキャン**) は国際非営利組織で、{{glossary("DNS","ドメインネームシステム")}} や {{glossary("IP address","IP アドレス")}}のレコードをメンテナンスしています。 ## 関連項目 diff --git a/files/ja/glossary/ice/index.md b/files/ja/glossary/ice/index.md index e2d8df645c24a0..e351c19271d468 100644 --- a/files/ja/glossary/ice/index.md +++ b/files/ja/glossary/ice/index.md @@ -3,6 +3,8 @@ title: ICE slug: Glossary/ICE --- +{{GlossarySidebar}} + **ICE** (_Interactive Connectivity Establishment_) は、ネットワークトポロジー (通常は音声および/またはビデオのチャット) に関係なく、2 つのピアを互いに接続するための {{glossary("WebRTC")}} に (他の技術があまたある中で) 使用されるフレームワークです。 このプロトコルを使用すると、ネットワークアドレストランスレーター ({{glossary("NAT")}}) を使用してそれぞれのローカルネットワーク上の他のデバイスとグローバル IP アドレスを共有していても、2 つのピアが相互に接続を見つけて確立することができます。 フレームワークのアルゴリズムは、以下のオプションを順番に試して、2つのピアを接続するために最低遅延のパスを探します。 diff --git a/files/ja/glossary/ide/index.md b/files/ja/glossary/ide/index.md index 178006426de514..365717626735d4 100644 --- a/files/ja/glossary/ide/index.md +++ b/files/ja/glossary/ide/index.md @@ -3,6 +3,8 @@ title: IDE (統合開発環境) slug: Glossary/IDE --- +{{GlossarySidebar}} + 統合開発環境(Integrated Development Environment、**IDE**)または、対話型開発環境(Interactive Development environment)は、ソフトウェア開発のためにコンピュータープログラマーに包括的な機能を提供するソフトウェアアプリケーションです。 IDE は、通常、ソースコードエディター、ビルド自動化ツール、デバッガーで構成されています。 ## より詳しく知る diff --git a/files/ja/glossary/idempotent/index.md b/files/ja/glossary/idempotent/index.md index e30701fa466801..fa812540b95851 100644 --- a/files/ja/glossary/idempotent/index.md +++ b/files/ja/glossary/idempotent/index.md @@ -3,6 +3,8 @@ title: Idempotent (べき等) slug: Glossary/Idempotent --- +{{GlossarySidebar}} + ある HTTP メソッドが**べき等**であるとは、サーバーが同じ状況にあるとき、特定のリクエストに対して何回でも続けて同じ効果が起こることをいいます。このことは、べき等なメソッドでは (統計を取る際のことを除いて) 副作用が生じるはずではないと言うこともできます 。 適切に実装された {{HTTPMethod("GET")}}、{{HTTPMethod("HEAD")}}、{{HTTPMethod("PUT")}}、{{HTTPMethod("DELETE")}} の各メソッドは**べき等**ですが、{{HTTPMethod("POST")}} メソッドはそうではありません。{{Glossary("Safe/HTTP", "安全な")}}メソッドはすべてべき等です。 べき等であるためには、サーバーにおける裏側の実際の状態だけが考慮されるので、返される状態コードはリクエストごとに異なる場合があります。 例えば、最初に {{HTTPMethod("DELETE")}} メソッドが呼び出された場合は、おそらく {{HTTPStatus("200")}} を返しますが、それ以降は {{HTTPStatus("404")}} を返すでしょう。RESTful な API の設計において、*最後の入力操作を削除する*機能を `DELETE` メソッドを使って実装すべきでないとされるのも、{{HTTPMethod("DELETE")}} メソッドがべき等であることを示唆しています。 diff --git a/files/ja/glossary/identifier/index.md b/files/ja/glossary/identifier/index.md index 03042db02405b9..f7442ec2cc50d9 100644 --- a/files/ja/glossary/identifier/index.md +++ b/files/ja/glossary/identifier/index.md @@ -3,6 +3,8 @@ title: Identifier (識別子) slug: Glossary/Identifier --- +{{GlossarySidebar}} + **識別子** (identifier) は {{glossary("variable", "変数")}}、{{glossary("function", "関数")}}、{{glossary("property", "プロパティ")}} などを識別するコード内の文字の並びです。 {{glossary("JavaScript")}} においては、識別子は大文字小文字の区別があり、{{glossary("Unicode")}} の文字、 `$`、 `_`、 数字 (0-9) を含めることができますが、数字で始めることはできません。 diff --git a/files/ja/glossary/idl/index.md b/files/ja/glossary/idl/index.md index e4185761f2018e..bd7b4a06ecad6d 100644 --- a/files/ja/glossary/idl/index.md +++ b/files/ja/glossary/idl/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: a4d73f3e2a41b98e26f8f39af143338ad4900bd5 --- +{{GlossarySidebar}} + **IDL** (_Interface Description Language_、インターフェイス記述言語) は、特定のプログラミング言語とは別にオブジェクトのインターフェイスを指定するために使用される汎用言語です。 ## コンテンツ属性と IDL 属性 diff --git a/files/ja/glossary/ietf/index.md b/files/ja/glossary/ietf/index.md index e351f126d962c1..15c921427e29f5 100644 --- a/files/ja/glossary/ietf/index.md +++ b/files/ja/glossary/ietf/index.md @@ -3,6 +3,8 @@ title: IETF slug: Glossary/IETF --- +{{GlossarySidebar}} + Internet Engineering Task Force (IETF) は、{{glossary("Internet","インターネット")}}の背後にあるメカニズム (特に {{glossary("TCP")}}/{{glossary("IPv6","IP")}} やインターネット{{glossary("Protocol","プロトコル")}}スイート) を規定する{{glossary('specification','仕様書')}}を作成する世界的な組織です。IETF はオープンで、ボランティアが運営し、インターネットソサエティが後援します。 ## より詳しく知る diff --git a/files/ja/glossary/iife/index.md b/files/ja/glossary/iife/index.md index f1563b8f662781..771f29ef6d50c3 100644 --- a/files/ja/glossary/iife/index.md +++ b/files/ja/glossary/iife/index.md @@ -3,6 +3,8 @@ title: IIFE (即時実行関数式) slug: Glossary/IIFE --- +{{GlossarySidebar}} + **IIFE** (Immediately Invoked Function Expression; 即時実行関数式) は定義されるとすぐに実行される {{glossary("JavaScript")}} の{{glossary("function", "関数")}}です。 IIFE という名前は [Ben Alman のブログ](https://web.archive.org/web/20171201033208/http://benalman.com/news/2010/11/immediately-invoked-function-expression/#iife)で付けられました。 diff --git a/files/ja/glossary/imap/index.md b/files/ja/glossary/imap/index.md index 57aa76393ac7ae..8b2ea8a95bf9c9 100644 --- a/files/ja/glossary/imap/index.md +++ b/files/ja/glossary/imap/index.md @@ -3,6 +3,8 @@ title: IMAP slug: Glossary/IMAP --- +{{GlossarySidebar}} + IMAP (Internet Message Access Protocol) は、電子メールの取得と保存に使用される{{Glossary("protocol","プロトコル")}}です。 {{Glossary("POP3")}} より新しい IMAP では、サーバー上のフォルダとルールが可能です。 POP3 とは異なり IMAP では、1 つのメールボックスへの複数同時接続が可能です。 メールボックスにアクセスするクライアントは、他のクライアントからの状態変更に関する情報を受け取ることができます。 IMAP はまた、クライアントが接続を維持し、必要に応じて情報を受け取るモードを提供します。 diff --git a/files/ja/glossary/immutable/index.md b/files/ja/glossary/immutable/index.md index bb9cf3af9990d7..e723b1112df115 100644 --- a/files/ja/glossary/immutable/index.md +++ b/files/ja/glossary/immutable/index.md @@ -3,6 +3,8 @@ title: Immutable (イミュータブル) slug: Glossary/Immutable --- +{{GlossarySidebar}} + イミュータブル(不変){{glossary("object","オブジェクト")}}とは、内容を変更できないオブジェクトのことです。 オブジェクトは、さまざまな理由でイミュータブルである可能性があります。 diff --git a/files/ja/glossary/indexeddb/index.md b/files/ja/glossary/indexeddb/index.md index eb937a27ef1990..89a773ced1e139 100644 --- a/files/ja/glossary/indexeddb/index.md +++ b/files/ja/glossary/indexeddb/index.md @@ -3,6 +3,8 @@ title: IndexedDB slug: Glossary/IndexedDB --- +{{GlossarySidebar}} + IndexedDB は大きなデータ構造をブラウザーに保管して高パフォーマンスな検索用にインデックスする Web {{glossary("API")}} です。{{glossary("SQL")}}-ベースの [RDBMS](https://en.wikipedia.org/wiki/Relational_database_management_system) と同様に、IndexedDB はトランザクションできるデータベースシステムです。しかし、データを保管するのに固定長のカラムではなく {{glossary("JavaScript")}} オブジェクトを使います。 ## 詳細情報 diff --git a/files/ja/glossary/information_architecture/index.md b/files/ja/glossary/information_architecture/index.md index fea414b5f998fa..7d13fb873c9f87 100644 --- a/files/ja/glossary/information_architecture/index.md +++ b/files/ja/glossary/information_architecture/index.md @@ -3,6 +3,8 @@ title: Information architecture (情報アーキテクチャ) slug: Glossary/Information_architecture --- +{{GlossarySidebar}} + ウェブのデザインと開発に適用される情報アーキテクチャは、ウェブサイトの情報/コンテンツ/機能を整理し、情報とサービスを簡単に使用可能で見つけ出すことができる最高のユーザーエクスペリエンスを提供することです。 ## より詳しく知る diff --git a/files/ja/glossary/inheritance/index.md b/files/ja/glossary/inheritance/index.md index f803c3bfc7fc45..cb639afec30327 100644 --- a/files/ja/glossary/inheritance/index.md +++ b/files/ja/glossary/inheritance/index.md @@ -3,6 +3,8 @@ title: Inheritance (継承) slug: Glossary/Inheritance --- +{{GlossarySidebar}} + 継承は、{{glossary("OOP","オブジェクト指向プログラミング")}}の大きな特徴です。データ抽象化は、いくつかのレベルで実行できます。つまり、{{glossary("class","クラス")}}にスーパークラスとサブクラスを持たせることができます。 アプリ開発者は、スーパークラスの{{glossary("attribute","属性")}}と{{glossary("method","メソッド")}}を選択して、独自に保持して追加することで、とても柔軟にクラスを定義できます。言語によっては、クラスを複数の親から継承することができます(多重継承)。 diff --git a/files/ja/glossary/inline-level_content/index.md b/files/ja/glossary/inline-level_content/index.md index fa714e7d29729f..47b292035dbdda 100644 --- a/files/ja/glossary/inline-level_content/index.md +++ b/files/ja/glossary/inline-level_content/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: a46d4d15ea85b4bbb83df145228bc40f658868be --- +{{GlossarySidebar}} + CSS において、インラインレイアウトに関係するコンテンツは**インラインレベルコンテンツ**と呼ばれます。ほとんどのテキストシーケンス、置換要素、および生成されたコンテンツは、デフォルトでインラインレベルです。 インラインレイアウトでは、テキスト、[置換要素](/ja/docs/Web/CSS/Replaced_element)、その他のインラインボックスが混在したストリームを、行ボックスのスタックに断片化することでレイアウトされます。各行ボックスの中でインラインレベルのボックスは、書字方向に応じて互いに垂直または水平に整列されます。一般的には、テキストのベースラインによって整列されます。これは、CSSで変更することができます。 diff --git a/files/ja/glossary/input_method_editor/index.md b/files/ja/glossary/input_method_editor/index.md index a86b9b2f33043c..0b03d9857d8643 100644 --- a/files/ja/glossary/input_method_editor/index.md +++ b/files/ja/glossary/input_method_editor/index.md @@ -3,6 +3,8 @@ title: Input method editor (インプットメソッドエディター) slug: Glossary/Input_method_editor --- +{{GlossarySidebar}} + インプットメソッドエディター (IME) は、テキスト入力のための特殊なユーザーインターフェイスを提供するプログラムです。インプットメソッドエディターは多くの場面で使用されています。 - ラテンキーボードを使用した中国語、日本語、韓国語の入力 diff --git a/files/ja/glossary/instance/index.md b/files/ja/glossary/instance/index.md index 3f570b28d6767c..b15d597c967ed4 100644 --- a/files/ja/glossary/instance/index.md +++ b/files/ja/glossary/instance/index.md @@ -3,6 +3,8 @@ title: Instance (インスタンス) slug: Glossary/Instance --- +{{GlossarySidebar}} + {{glossary("constructor", "コンストラクター")}}によって作成された{{glossary("object","オブジェクト")}}は、そのコンストラクターのインスタンスになります。 ## 詳細情報 diff --git a/files/ja/glossary/internet/index.md b/files/ja/glossary/internet/index.md index 6e6dc4b9fcd220..e75f20ba7edb4a 100644 --- a/files/ja/glossary/internet/index.md +++ b/files/ja/glossary/internet/index.md @@ -3,6 +3,8 @@ title: Internet (インターネット) slug: Glossary/Internet --- +{{GlossarySidebar}} + インターネットは、インターネット・プロトコル群を使用するネットワークの世界的ネットワークです (最も重要な 2 つの {{glossary("protocol","プロトコル")}} から、 {{glossary("TCP")}}/{{glossary("IPv6","IP")}} とも呼ばれています)。 ## 関連情報 diff --git a/files/ja/glossary/intrinsic_size/index.md b/files/ja/glossary/intrinsic_size/index.md index 13c16a3c47eeb3..e067cee1183e99 100644 --- a/files/ja/glossary/intrinsic_size/index.md +++ b/files/ja/glossary/intrinsic_size/index.md @@ -3,6 +3,8 @@ title: Intrinsic size (内在サイズ) slug: Glossary/Intrinsic_Size --- +{{GlossarySidebar}} + CSS における要素の*内在サイズ* とは、外部要因が働いていない場合に、その内容に基づく大きさです。例えば、インライン要素は内在的にサイズ変更されます。 `width`、`height`、および垂直方向の余白とパディングは影響を与えませんが、水平方向の余白とパディングには影響を与えます。 内在サイズの計算方法は、 [CSS Intrinsic and Extrinsic Sizing Specification](https://www.w3.org/TR/css-sizing-3/#intrinsic-sizes) で定義されています。 diff --git a/files/ja/glossary/ip_address/index.md b/files/ja/glossary/ip_address/index.md index 002086d5d2881e..2a6b05a7a7f575 100644 --- a/files/ja/glossary/ip_address/index.md +++ b/files/ja/glossary/ip_address/index.md @@ -3,6 +3,8 @@ title: IP Address (IPアドレス) slug: Glossary/IP_Address --- +{{GlossarySidebar}} + IP アドレスはネットワークに接続された、インターネットプロトコル(IP) を使うすべての端末に割り当てられる番号です。 "IP アドレス" は IPv6 がもっと広がっていくまでは、典型的にはまだ 32-ビット IPv4 アドレスを参照します。 diff --git a/files/ja/glossary/ipv4/index.md b/files/ja/glossary/ipv4/index.md index 5706e5c598fe3f..72cbf7fbc83b48 100644 --- a/files/ja/glossary/ipv4/index.md +++ b/files/ja/glossary/ipv4/index.md @@ -3,6 +3,8 @@ title: IPv4 slug: Glossary/IPv4 --- +{{GlossarySidebar}} + IPv4 は、{{glossary("Internet","インターネット")}}の基礎となる通信{{Glossary("protocol","プロトコル")}}の第 4 のバージョンで、広範囲に展開された最初のバージョンです。 最初に 1981 年に公式化された IPv4 は、ARPAnet の最初の開発作業にそのルーツをたどります。IPv4 は、パケット交換リンクレイヤネットワーク(イーサネット)で使用されるコネクションレスプロトコルです。{{glossary("IPv6")}} は、IPv4 のセキュリティ上の問題とそのアドレスフィールドの限界のために徐々に IPv4 を置き換えています。(バージョン番号 5 は 1979 年に実験的なインターネットストリームプロトコルに割り当てられましたが、これは決して IPv5 と呼ばれていませんでした)。 diff --git a/files/ja/glossary/ipv6/index.md b/files/ja/glossary/ipv6/index.md index 2bb088a735d372..827c4547f1f778 100644 --- a/files/ja/glossary/ipv6/index.md +++ b/files/ja/glossary/ipv6/index.md @@ -3,6 +3,8 @@ title: IPv6 slug: Glossary/IPv6 --- +{{GlossarySidebar}} + **IPv6** は、{{glossary("Internet","インターネット")}} の基礎をなす現在のバージョンの通信 {{Glossary("protocol","プロトコル")}} です。IPv6 はより多くの {{Glossary("IP address","IP アドレス")}} を使えるなどの理由により、ゆっくりと {{Glossary("IPv4")}} を置き換えています。 ## 関連項目 diff --git a/files/ja/glossary/irc/index.md b/files/ja/glossary/irc/index.md index c3c34907672616..b397f8674d14d1 100644 --- a/files/ja/glossary/irc/index.md +++ b/files/ja/glossary/irc/index.md @@ -3,6 +3,8 @@ title: IRC slug: Glossary/IRC --- +{{GlossarySidebar}} + **IRC** (_Internet Relay Chat_) は、インターネット接続と IRC サーバーを介してメッセージを送受信する IRC クライアントを必要とする世界的なチャットシステムです。 1980 年代後半に Jarrko Oikarinen によって設計された IRC は、{{glossary("TCP")}} を使用し、オープンプロトコルです。 IRC サーバーは、多数の IRC チャネル(各自が独自の ID を持つ)の 1 つに接続されているすべての人にメッセージをブロードキャストします。 diff --git a/files/ja/glossary/iso/index.md b/files/ja/glossary/iso/index.md index 34dbebef292141..f450ddb7226216 100644 --- a/files/ja/glossary/iso/index.md +++ b/files/ja/glossary/iso/index.md @@ -3,6 +3,8 @@ title: ISO (国際標準化機構) slug: Glossary/ISO --- +{{GlossarySidebar}} + **ISO**(International Organization for Standardization、国際標準化機構)は、各主要産業の企業を調整する統一基準を開発する世界的な協会です。 ## より詳しく知る diff --git a/files/ja/glossary/isp/index.md b/files/ja/glossary/isp/index.md index 380dfee64063cc..4ccf582d977de8 100644 --- a/files/ja/glossary/isp/index.md +++ b/files/ja/glossary/isp/index.md @@ -3,6 +3,8 @@ title: ISP slug: Glossary/ISP --- +{{GlossarySidebar}} + ISP (Internet Service Provider, インターネットサービスプロバイダー) は、インターネット接続を提供する事業を行っています。また、メールやウェブホスティング、VoIP (IP 電話) などのサービスを提供していることもあります。これらは、(かつて主流の方式であった) 電話回線を使ったダイアルアップ接続や、ケーブルモデムまたは DSL (デジタルサービス回線) などの広帯域接続により提供されます。 ## さらに学ぶ diff --git a/files/ja/glossary/itu/index.md b/files/ja/glossary/itu/index.md index 05c105440369c0..78ea0ad837625e 100644 --- a/files/ja/glossary/itu/index.md +++ b/files/ja/glossary/itu/index.md @@ -3,6 +3,8 @@ title: ITU (国際電気通信連合) slug: Glossary/ITU --- +{{GlossarySidebar}} + ITU (International Telecommunication Union、国際電気通信連合) は、国際連合に認可された組織であり、電信、無線通信、電話、そしてインターネットなどの遠距離通信に関する標準やルールを制定します。 送信内容が必要な場所へ届くようにするためのルールの定義や、モールス信号で使用される「SOS」の警報信号の作成に始まり、テクノロジーを使用して情報や考えをやり取りする方法について、ITU は長い間重要な役割を果たしてきました。 diff --git a/files/ja/glossary/jank/index.md b/files/ja/glossary/jank/index.md index 847e8ecbaf8ab7..64f57a722ed5b4 100644 --- a/files/ja/glossary/jank/index.md +++ b/files/ja/glossary/jank/index.md @@ -3,4 +3,6 @@ title: Jank slug: Glossary/Jank --- +{{GlossarySidebar}} + **Jank** は、メインスレッドで長いタスクを実行したり、レンダリングをブロックしたり、バックグラウンドプロセスでプロセッサパワーを浪費したりすることによって、ユーザーインターフェイスの低速化を引き起こすことを指します。 diff --git a/files/ja/glossary/java/index.md b/files/ja/glossary/java/index.md index 728c25f7ffa4ba..5cf88d600ebabd 100644 --- a/files/ja/glossary/java/index.md +++ b/files/ja/glossary/java/index.md @@ -3,6 +3,8 @@ title: Java slug: Glossary/Java --- +{{GlossarySidebar}} + Java は、{{glossary("Compile", "コンパイラ言語")}}で、{{glossary("OOP", "オブジェクト指向")}}の高度にポータブルな{{Glossary("computer programming","プログラミング")}}言語です。 Java は静的型付けで、 C の構文に近い特性を持ちます。直ちに利用できる巨大なライブラリ、 Java Software Development Kit (SDK) と共に使用されます。 @@ -14,5 +16,3 @@ Java は静的型付けで、 C の構文に近い特性を持ちます。直ち ### 一般知識 - Wikipedia 上の [Java](https://ja.wikipedia.org/wiki/Java) - -{{QuickLinksWithSubpages("/ja/docs/Glossary")}} diff --git a/files/ja/glossary/javascript/index.md b/files/ja/glossary/javascript/index.md index 8f8347fc396deb..83ff965059f33e 100644 --- a/files/ja/glossary/javascript/index.md +++ b/files/ja/glossary/javascript/index.md @@ -3,6 +3,8 @@ title: JavaScript slug: Glossary/JavaScript --- +{{GlossarySidebar}} + ## 概要 JavaScript (または JS) は、主にウェブページの動的なクライアントサイドスクリプトとして使用されるプログラミング言語です。しかし、{{Glossary("Server","サーバー")}}サイドでも [Node.js](https://nodejs.org/) のようなランタイムを用いて、たびたび使用されています。 diff --git a/files/ja/glossary/jpeg/index.md b/files/ja/glossary/jpeg/index.md index a9c67dd2bfb1c8..e3181a9031ef55 100644 --- a/files/ja/glossary/jpeg/index.md +++ b/files/ja/glossary/jpeg/index.md @@ -3,6 +3,8 @@ title: JPEG slug: Glossary/JPEG --- +{{GlossarySidebar}} + **JPEG** (_Joint Photographic Experts Group_) とは、一般的に使われている、デジタル画像用の非可逆圧縮の方法です。 JPEG 圧縮は、連続したレイヤーで適用される色度サブサンプリング、離散コサイン変換と量子化、ランレングスデルタ&ハフマンエンコーディングの 3 つの圧縮技術で構成されています。色度サブサンプリングは、人間の視覚システムが色の違いに対する視力が輝度よりも低いことを利用して、彩度情報の段階をルーマ情報よりも低くすることを意味します。離散コサイン変換は、異なる周波数で振動するコサイン関数の和でデータポイントの有限列を表現します。 diff --git a/files/ja/glossary/json/index.md b/files/ja/glossary/json/index.md index 340c076f4e3033..26742d97767673 100644 --- a/files/ja/glossary/json/index.md +++ b/files/ja/glossary/json/index.md @@ -3,6 +3,8 @@ title: JSON slug: Glossary/JSON --- +{{GlossarySidebar}} + _JavaScript Object Notation_ (**JSON**) はデータ交換フォーマットです。厳密なサブセットではありませんが、JSON は {{Glossary("JavaScript")}} のサブセットに似ています。多くのプログラミング言語が JSON をサポートしていますが、JSON はウェブサイトやブラウザの拡張機能を含む JavaScript ベースのアプリケーションに特に便利です。 JSON は数値、真偽値、文字列、`null`、配列 (順序付けられた値のシーケンス)、およびこれらの値 (または他の配列やオブジェクト) で構成されるオブジェクト (文字列値マッピング) を表すことができます。 JSON は関数、正規表現、日付などのより複雑なデータ型はネイティブに表現できません。(Date オブジェクトはデフォルトで ISO 形式の日付を含む文字列にシリアライズされるため、情報は完全に失われません。) JSON で追加のデータ型を表す必要がある場合は、シリアライズされる時やデシリアライズされる前に値の変換を行ってください。 diff --git a/files/ja/glossary/key/index.md b/files/ja/glossary/key/index.md index 7ef3fe8ab02c1a..222ae312884018 100644 --- a/files/ja/glossary/key/index.md +++ b/files/ja/glossary/key/index.md @@ -3,6 +3,8 @@ title: Key (暗号鍵) slug: Glossary/Key --- +{{GlossarySidebar}} + 暗号鍵は、{{Glossary("cipher", "暗号技術")}}における{{Glossary("encryption", "暗号化")}}や{{Glossary("decryption", "復号")}}で使用される情報の断片です。暗号化されたメッセージは、たとえ{{Glossary("cryptosystem", "暗号システム")}}に関する鍵を除くすべての知識が公開されていたとしても、安全が確保されるでしょう。 {{Glossary("symmetric-key cryptography", "共通鍵暗号")}}においては、同じ鍵が暗号化と復号の両方に使用されます。{{Glossary("public-key cryptography", "公開鍵暗号")}}においては、*公開鍵*と*秘密鍵*と呼ばれる、一対の関連した鍵が存在します。公開鍵は自由に使用できますが、一方、秘密鍵は秘密に保たれます。公開鍵は、メッセージを対応する秘密鍵だけで復号できるように暗号化できます。逆もまた同様です。 diff --git a/files/ja/glossary/keyword/index.md b/files/ja/glossary/keyword/index.md index a2ae85ca6ba6d7..5565b72be66d84 100644 --- a/files/ja/glossary/keyword/index.md +++ b/files/ja/glossary/keyword/index.md @@ -3,6 +3,8 @@ title: Keyword (キーワード) slug: Glossary/Keyword --- +{{GlossarySidebar}} + **キーワード**とは、コンテンツを説明する単語やフレーズです。オンラインのキーワードは、検索エンジンのためのクエリや、ウェブサイトのコンテンツを識別するための言葉として使用されています。 検索エンジンを利用するとき、探しているウェブサイトや情報を識別するためのキーワードを使用し、検索エンジンはそのキーワードに関連するウェブページを検索結果として表示します。より正確な結果を得るためには、単なる" Mustang "を使うのではなく" Blue Mustang GTO "のようにもっと具体的なキーワードが必要です。また、ウェブページではウェブページを説明するキーワードとして head 要素内の meta 要素で使い、そのため検索エンジンは、よりよくウェブページを識別し整理することができます。 diff --git a/files/ja/glossary/khronos/index.md b/files/ja/glossary/khronos/index.md index 00cff6fe6c6232..1062f0b5728a81 100644 --- a/files/ja/glossary/khronos/index.md +++ b/files/ja/glossary/khronos/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: ed947b2c608428b62a60f07d09dc543f732dc09b --- +{{GlossarySidebar}} + **クロノス・グループ**は、業界トップレベルの企業 150 社以上が参加する、オープンかつ非営利のコンソーシアムです。3D グラフィックス、 拡張現実、バーチャルリアリティ、並列プログラミング、ビジョンアクセラレーション、機械学習のための高度かつロイヤリティフリーの標準規格を策定することを目的としています。 クロノス・グループは、{{Glossary("OpenGL")}} や {{domxref("WebGL API")}} などの標準を管理しています。 diff --git a/files/ja/glossary/latency/index.md b/files/ja/glossary/latency/index.md index 7c4d0b99b2318d..24e216e0ff68f3 100644 --- a/files/ja/glossary/latency/index.md +++ b/files/ja/glossary/latency/index.md @@ -3,6 +3,8 @@ title: Latency(レイテンシー) slug: Glossary/Latency --- +{{GlossarySidebar}} + **レイテンシー (遅延時間)** とは要求されたリソースが目的地に到達するまでにかかるネットワーク時間のことです。低レイテンシーとは良好な状態で、遅延時間がほとんどないか、またはまったくないことを意味します。高レイテンシーは悪い状態で、要求されたリソースが目的地に到達するまでに長い時間がかかることを意味します。 レイテンシーはあらゆるデータフローが要因となり得ますが、ネットワーク遅延 (データのパケットが送信元から送信先まで移動するのにかかる時間) とメディアコーデック遅延 (送信元のデータがエンコードまたはデコードされ、結果データが消費者に届くまでにかかる時間) が最も一般的な要因として説明されます。 diff --git a/files/ja/glossary/lazy_load/index.md b/files/ja/glossary/lazy_load/index.md index fcf00d7e1ab80f..94dbffccd42856 100644 --- a/files/ja/glossary/lazy_load/index.md +++ b/files/ja/glossary/lazy_load/index.md @@ -3,6 +3,8 @@ title: 遅延読み込み slug: Glossary/Lazy_load --- +{{GlossarySidebar}} + **遅延読み込み**は、ユーザーが必要とするまでデータ (例: 画像) の読み込みを遅延させる仕組みです。一般的には、ユーザーのスクロール操作によって対象が画面内に表示されるまで読み込みを遅延させます。開発者が正しく実装することにより、{{Glossary("Time_to_interactive", "Time to interactive (対話時間)")}} を含めページの動作開始に必要なデータを減らすことができます。これによりシームレスなユーザー体験を提供することができ、初期表示に関わるパフォーマンスの向上に役立ちます。 ## 関連情報 diff --git a/files/ja/glossary/lgpl/index.md b/files/ja/glossary/lgpl/index.md index 8c059b49c01b94..9fe5a624489af1 100644 --- a/files/ja/glossary/lgpl/index.md +++ b/files/ja/glossary/lgpl/index.md @@ -3,6 +3,8 @@ title: LGPL slug: Glossary/LGPL --- +{{GlossarySidebar}} + LGPL (GNU Lesser General Public License) は、フリーソフトウェア財団が発行したフリーソフトウェアライセンスです。 LGPL は、厳密に{{Glossary("copyleft","コピーレフト")}}された {{Glossary("GPL")}} に対して、より許容された選択肢を提供します。 GPL ライセンスプログラムを使用する派生作品は、同じ条件(自由に使用、共有、研究、変更)で公開する必要がありますが、LGPL では、派生プログラムの LGPL ライセンスコンポーネントが LGPL を引き続き使用することを要求しますが、プログラム全体ではありません。 LGPL は、通常、ライブラリ(`.dll`、`.so`、`.jar` など)などの共有コンポーネントをライセンスするために使用されます。 ## より詳しく知る diff --git a/files/ja/glossary/ligature/index.md b/files/ja/glossary/ligature/index.md index ac759de22e4ade..8ce25503527128 100644 --- a/files/ja/glossary/ligature/index.md +++ b/files/ja/glossary/ligature/index.md @@ -3,6 +3,8 @@ title: Ligature (合字) slug: Glossary/Ligature --- +{{GlossarySidebar}} + **合字**は、2 つの文字を 1 つの形に結合したものです。 たとえば、フランス語では "œ" は "oe" の合字です。 {{cssxref("font-variant-ligatures")}} を使用してウェブページで合字を実装できます。 diff --git a/files/ja/glossary/literal/index.md b/files/ja/glossary/literal/index.md index 8f1c2a6d7abca5..de2589ff24a64d 100644 --- a/files/ja/glossary/literal/index.md +++ b/files/ja/glossary/literal/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: 05d10f3e6eb1d5d8a8c5a236744c10249ade2e08 --- +{{GlossarySidebar}} + **リテラル**は JavaScript の値を表します。これらは(変数ではなく)固定値であり、スクリプト内に文字で提供されます。 - [配列リテラル](/ja/docs/Web/JavaScript/Guide/Grammar_and_types#配列リテラル) diff --git a/files/ja/glossary/local_scope/index.md b/files/ja/glossary/local_scope/index.md index 29889b9c850307..323d91f7cd0862 100644 --- a/files/ja/glossary/local_scope/index.md +++ b/files/ja/glossary/local_scope/index.md @@ -3,6 +3,8 @@ title: Local scope (ローカルスコープ) slug: Glossary/Local_scope --- +{{GlossarySidebar}} + ローカルスコープは {{glossary("variable","変数")}} をローカルにする変数の特性です(つまり、変数名は {{glossary("global scope", "グローバルスコープ")}} ではないスコープ内の {{glossary("value", "値")}} にのみ結び付けられます)。 ## 関連項目 diff --git a/files/ja/glossary/local_variable/index.md b/files/ja/glossary/local_variable/index.md index d1d38df6240fd6..c78581c6703440 100644 --- a/files/ja/glossary/local_variable/index.md +++ b/files/ja/glossary/local_variable/index.md @@ -3,6 +3,8 @@ title: Local variable (ローカル変数) slug: Glossary/Local_variable --- +{{GlossarySidebar}} + {{glossary("variable", "変数")}}のうち、その{{glossary("value","値")}}を指す名前が{{Glossary("local scope","ローカルスコープ")}}内にのみあるものです。 ## 例 diff --git a/files/ja/glossary/locale/index.md b/files/ja/glossary/locale/index.md index 149d422a340d78..b53aaf31b4c885 100644 --- a/files/ja/glossary/locale/index.md +++ b/files/ja/glossary/locale/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: 05d10f3e6eb1d5d8a8c5a236744c10249ade2e08 --- +{{GlossarySidebar}} + **ロケール**は、ユーザーインターフェイス用の言語別または国別の基本設定のセットです。 プログラムは、ロケール設定をホストシステムの言語から引き出します。とりわけ、ロケールは、指定された地域のプロトコルに従って、用紙サイズ、通貨、日付書式、および数値を表します。 diff --git a/files/ja/glossary/localization/index.md b/files/ja/glossary/localization/index.md index ba75e66fe5257c..adf5aedc9fab65 100644 --- a/files/ja/glossary/localization/index.md +++ b/files/ja/glossary/localization/index.md @@ -3,6 +3,8 @@ title: Localization (ローカライゼーション) slug: Glossary/Localization --- +{{GlossarySidebar}} + **ローカライゼーション**(ローカライズ)とは、ソフトウェアのユーザーインターフェイスを特定の文化に適合させるプロセスです。 考慮するべき共通点は以下の通りです。 diff --git a/files/ja/glossary/long_task/index.md b/files/ja/glossary/long_task/index.md index 3b23621562b670..09a5d1bf83e45a 100644 --- a/files/ja/glossary/long_task/index.md +++ b/files/ja/glossary/long_task/index.md @@ -3,6 +3,8 @@ title: Long task slug: Glossary/Long_task --- +{{GlossarySidebar}} + **long task** とは、完了するまでに 50 ミリ秒以上かかるタスクです。 [main UI thread](/ja/docs/Glossary/Main_thread) が 50 ミリ秒以上ビジーである中断のない期間です。一般的な例では、長時間実行されるイベントハンドラ、高価な[リフロー](/ja/docs/Glossary/Reflow)、その他の再レンダリングが含まれ、50 ミリ秒を超えるイベントループの異なるターン間でブラウザーが実行する作業が含まれます。 ## 関連項目 diff --git a/files/ja/glossary/loop/index.md b/files/ja/glossary/loop/index.md index aa46f8d2e3398a..b89e5de800c253 100644 --- a/files/ja/glossary/loop/index.md +++ b/files/ja/glossary/loop/index.md @@ -3,6 +3,8 @@ title: Loop (ループ) slug: Glossary/Loop --- +{{GlossarySidebar}} + ループは、{{Glossary("computer programming","コンピュータプログラミング")}}において、一定の条件に遭遇するまで継続的に繰り返される一連の命令です。例えば、データ項目を取得して加工しながら、カウンターが所定の値に達するなどいくつかの{{Glossary("conditional","条件")}}をチェックするというような処理です。 ## 例 diff --git a/files/ja/glossary/lossless_compression/index.md b/files/ja/glossary/lossless_compression/index.md index 0cdf296217cccf..30135fea1adc5f 100644 --- a/files/ja/glossary/lossless_compression/index.md +++ b/files/ja/glossary/lossless_compression/index.md @@ -3,6 +3,8 @@ title: Lossless compression (可逆圧縮) slug: Glossary/Lossless_compression --- +{{GlossarySidebar}} + **可逆圧縮** (Lossless compression) はデータ圧縮アルゴリズムの一種で、圧縮データから元のデータを完全に再構築することができるものです。可逆圧縮方法は可逆です。可逆圧縮の例としては、 {{glossary("GZIP")}}, {{glossary("Brotli")}}, WebP, {{glossary("PNG")}} などがあります。 一方、{{glossary("Lossy compression", "非可逆圧縮")}}は元のファイルから一部のデータを犠牲にすることで厳密ではない近似値を使用しており、元に戻すことができない圧縮方法です。 diff --git a/files/ja/glossary/ltr/index.md b/files/ja/glossary/ltr/index.md index 24fc5b70de3b45..b5a4709ebc1902 100644 --- a/files/ja/glossary/ltr/index.md +++ b/files/ja/glossary/ltr/index.md @@ -3,6 +3,8 @@ title: LTR (左書き) slug: Glossary/LTR --- +{{GlossarySidebar}} + **LTR** (**Left To Right**, 左書き) は、テキストが左から右に書かれることを示す{{Glossary("locale", "ロケール")}}プロパティです。例えば、 `en-US` ロケール (アメリカ英語) は左書きを指定します。西洋の言語の多くは、世界中の他の言語と同様に、 LTR で書かれます。 LTR とは逆に、 {{Glossary("RTL")}} (Right To Left, 右書き) はアラビア語 (`ar`) やヘブライ語 (`he`) など、他の一般的な語で使われます。 @@ -11,8 +13,6 @@ LTR とは逆に、 {{Glossary("RTL")}} (Right To Left, 右書き) はアラビ - [ローカリゼーションと国際化](/ja/docs/Web/Localization) - - - [MDN Web Docs 用語集](/ja/docs/Glossary) - {{Glossary("locale")}} diff --git a/files/ja/glossary/main_axis/index.md b/files/ja/glossary/main_axis/index.md index 1a70f352bef9b9..994f4ead66ece7 100644 --- a/files/ja/glossary/main_axis/index.md +++ b/files/ja/glossary/main_axis/index.md @@ -3,6 +3,8 @@ title: Main Axis (主軸) slug: Glossary/Main_Axis --- +{{GlossarySidebar}} + {{glossary("flexbox")}} における主軸は、{{cssxref("flex-direction")}} プロパティの設定方向によって定義されます。`flex-direction` が取り得る値は以下の 4 つです。 - `row` diff --git a/files/ja/glossary/main_thread/index.md b/files/ja/glossary/main_thread/index.md index 95a01607e4fb9e..e509865c49f261 100644 --- a/files/ja/glossary/main_thread/index.md +++ b/files/ja/glossary/main_thread/index.md @@ -3,6 +3,8 @@ title: Main thread (メインスレッド) slug: Glossary/Main_thread --- +{{GlossarySidebar}} + **メインスレッド**は、ブラウザーがユーザーのイベントや描画を処理するところです。既定では、ブラウザーは単一のスレッドを使用してページ内のすべての JavaScript を、レイアウト、再フロー、ガベージコレクションなどと同様に実行します。つまり、実行に時間がかかる JavaScript 関数がスレッドをブロックし、ページが反応しなくなり、使い勝手が悪くなります。 意識的に [Service worker](/ja/docs/Web/API/Service_Worker_API/Using_Service_Workers) などの [Web worker](/ja/docs/Web/API/Web_Workers_API/Using_web_workers) を使用しない限り、 JavaScript はメインスレッド上で実行されるので、イベント処理や描画の中で簡単にスクリプトが遅延を発生させます。メインスレッドで動作させる必要がある処理が少ないほど、メインスレッドがユーザーのイベントに応答したり、描画したりすることが増え、ユーザーへの反応が全般的に良くなります。 diff --git a/files/ja/glossary/markup/index.md b/files/ja/glossary/markup/index.md index a494594a451036..f58b77b08a5674 100644 --- a/files/ja/glossary/markup/index.md +++ b/files/ja/glossary/markup/index.md @@ -3,6 +3,8 @@ title: markup (マークアップ) slug: Glossary/Markup --- +{{GlossarySidebar}} + マークアップ言語は、テキストを定義し提示するために設計された言語です。 {{glossary("HTML")}} (HyperText Markup Language) は、マークアップ言語の一例です。 HTML ファイルなどのテキストファイル内で、要素はコンテンツのその部分の目的を説明する{{glossary("Tag","タグ")}}を使用して*マークアップ*されます。 diff --git a/files/ja/glossary/mathml/index.md b/files/ja/glossary/mathml/index.md index 9271b1306121ad..6eeb4fe642162b 100644 --- a/files/ja/glossary/mathml/index.md +++ b/files/ja/glossary/mathml/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: ed947b2c608428b62a60f07d09dc543f732dc09b --- +{{GlossarySidebar}} + **MathML** ({{glossary("XML")}} のアプリケーション) は、ウェブページにおいて数式を表現するためのオープンスタンダードです。 1998 年に、 W3C は{{glossary("browser","ブラウザー")}}で数式を表現するための MathML の最初の勧告を行いました。 MathML には科学コンテンツや音声合成などの他のアプリケーションもあります。 ## 関連情報 diff --git a/files/ja/glossary/metadata/index.md b/files/ja/glossary/metadata/index.md index 0d8fd7f32c1a2d..a41a8a66a08805 100644 --- a/files/ja/glossary/metadata/index.md +++ b/files/ja/glossary/metadata/index.md @@ -3,6 +3,8 @@ title: Metadata (メタデータ) slug: Glossary/Metadata --- +{{GlossarySidebar}} + **メタデータ**とは — 最もシンプルな定義では — データを記述するデータです。例えば {{glossary("HTML")}} 文書はデータですが、HTML には {{htmlelement("head")}} 要素の中に文書を記述するメタデータ(誰が書いたのかや要約など)も含んでいます。 ## 関連項目 diff --git a/files/ja/glossary/method/index.md b/files/ja/glossary/method/index.md index f0bc1986100ac9..4385120cbf342b 100644 --- a/files/ja/glossary/method/index.md +++ b/files/ja/glossary/method/index.md @@ -3,6 +3,8 @@ title: Method (メソッド) slug: Glossary/Method --- +{{GlossarySidebar}} + **メソッド**は{{glossary("object","オブジェクト")}}の{{glossary("property","プロパティ")}}である{{glossary("function", "関数")}}です。メソッドには 2 種類があります。オブジェクトインスタンスごとに内蔵されたタスクとして実行される*インスタンスメソッド*と、オブジェクトのコンストラクターで直接呼び出しを行うタスクである*{{Glossary("static method", "静的メソッド")}}*です。 > **メモ:** JavaScript では、関数自身はオブジェクトです。そういう意味では、メソッドは実際には関数への{{glossary("object reference", "オブジェクト参照")}}です。 diff --git a/files/ja/glossary/microsoft_edge/index.md b/files/ja/glossary/microsoft_edge/index.md index dac2d005e13510..be9fb51887aa32 100644 --- a/files/ja/glossary/microsoft_edge/index.md +++ b/files/ja/glossary/microsoft_edge/index.md @@ -3,6 +3,8 @@ title: Microsoft Edge slug: Glossary/Microsoft_Edge --- +{{GlossarySidebar}} + **Microsoft Edge** は、グラフィカルな無料の{{glossary("World Wide Web", "ウェブ")}}{{Glossary("browser", "ブラウザー")}}で、 Microsoft Windows に付属しており、マイクロソフトが 2014 年から開発しています。 Edge は、最初は Spartan として知られ、長い間使われた {{glossary("Microsoft Internet Explorer","Internet Explorer")}} を置き換えました。 1. 関連情報 diff --git a/files/ja/glossary/microsoft_internet_explorer/index.md b/files/ja/glossary/microsoft_internet_explorer/index.md index c89ef3bbe3a3c3..0462a936010b55 100644 --- a/files/ja/glossary/microsoft_internet_explorer/index.md +++ b/files/ja/glossary/microsoft_internet_explorer/index.md @@ -3,6 +3,8 @@ title: Microsoft Internet Explorer slug: Glossary/Microsoft_Internet_Explorer --- +{{GlossarySidebar}} + Internet Explorer (IE) は、レガシーエンタープライズ向けに Microsoft が管理している無料のグラフィカル{{glossary("browser","ブラウザー")}}です。{{glossary("Microsoft Edge")}} が現在、デフォルトの Windows ブラウザーです。 Microsoft は、1995 年に「Microsoft Plus!」と呼ばれるパッケージの一部として IE を Windows に初めて同梱しました。2002 年頃までに、Internet Explorer は世界で最も使用されていたブラウザーになりましたが、その後 Chrome、Firefox、Edge、Safari に押されています。 diff --git a/files/ja/glossary/middleware/index.md b/files/ja/glossary/middleware/index.md index a95950b2624830..fa5d7f40ba2bb0 100644 --- a/files/ja/glossary/middleware/index.md +++ b/files/ja/glossary/middleware/index.md @@ -3,6 +3,8 @@ title: Middleware (ミドルウェア) slug: Glossary/Middleware --- +{{GlossarySidebar}} + ミドルウェアとは、システムの各部分がデータを通信および管理できるようにする、あらゆるソフトウェアまたはサービスの(定義があやふやな)用語です。コンポーネントと入出力間の通信を処理するソフトウェアであるため、開発者はアプリケーションの特定の目的に集中できます。 サーバー側のウェブアプリケーションのフレームワークでは、この用語は、データベースアクセスなどのタスクを処理するために、フレームワークのリクエスト/レスポンス処理パイプラインに追加できる既成のソフトウェアコンポーネントを指すのに使用されることがよくあります。 diff --git a/files/ja/glossary/mime/index.md b/files/ja/glossary/mime/index.md index 0eeffddb593ab5..03bc44e097a734 100644 --- a/files/ja/glossary/mime/index.md +++ b/files/ja/glossary/mime/index.md @@ -3,6 +3,8 @@ title: mime slug: Glossary/MIME --- +{{GlossarySidebar}} + MIME(Multipurpose internet mail extensions、多目的インターネットメール拡張)は、例えば、音声、動画、画像のような、ASCII テキスト以外の形式の文書を記述するための規格です。 当初は電子メールの添付ファイルに使用されていましたが、文書の種類をどこでも定義するための事実上の標準となっています。 {{glossary("MIME type","MIMEタイプ")}}も参照してください。 diff --git a/files/ja/glossary/mime_type/index.md b/files/ja/glossary/mime_type/index.md index c77b59435183a7..70200823f68737 100644 --- a/files/ja/glossary/mime_type/index.md +++ b/files/ja/glossary/mime_type/index.md @@ -3,6 +3,8 @@ title: MIME type (MIMEタイプ) slug: Glossary/MIME_type --- +{{GlossarySidebar}} + **MIME タイプ** (現在は正しくは「メディアタイプ」と呼ばれますが、「コンテンツタイプ」と呼ばれることもあります) は、ファイルの種類を示し、ファイルと共に送信される文字列です (例えば、音声ファイルは `audio/ogg`、画像ファイルは `image/png` というようにラベル付けして、コンテンツ形式を記述します)。 Windows 上で従来行われていたファイル拡張子と同じ目的を果たします。この名前は、もともと電子メールで使用されていた {{glossary("mime","MIME")}} 規格に由来しています。 diff --git a/files/ja/glossary/minification/index.md b/files/ja/glossary/minification/index.md index 458ce4b038265f..390e1307491726 100644 --- a/files/ja/glossary/minification/index.md +++ b/files/ja/glossary/minification/index.md @@ -3,6 +3,8 @@ title: minification slug: Glossary/Minification --- +{{GlossarySidebar}} + **minification** とは、ブラウザーによるリソースの処理に影響を与えることなく、不要なデータや冗長なデータを削除する処理です。 minification には、コードコメント、空白、未使用コードの削除、変数名や関数名の短縮が含まれます。Minification はファイルサイズを削減することで、ウェブのパフォーマンスを向上させるために使用されます。一般的には、ビルド時に自動的に実行されます。 diff --git a/files/ja/glossary/mitm/index.md b/files/ja/glossary/mitm/index.md index 0a7162b97089cf..106c8747fac7a7 100644 --- a/files/ja/glossary/mitm/index.md +++ b/files/ja/glossary/mitm/index.md @@ -3,6 +3,8 @@ title: MitM (中間者攻撃) slug: Glossary/MitM --- +{{GlossarySidebar}} + **Man-in-the-middle attack**(MitM、中間者攻撃)は、2 つのシステム間の通信を傍受します。たとえば、Wi-Fi ルーターが侵害される可能性があります。 これを物理的な郵便と比較します。もしあなたがお互いに手紙を書いているなら、郵便配達員はあなたが郵送するそれぞれの手紙を傍受することができます。彼らはそれを開き、それを読んで、最終的にそれを修正してから、その手紙を再び包み、あなたが手紙を送ろうとした人にそれを送ります。元の受取人はあなたに手紙を郵送し、郵便配達員は再度手紙を開き、それを読んで、最終的にそれを修正し、それを再び包み、あなたにそれを与えるでしょう。コミュニケーションチャンネルの中間に人がいることはわかりません – 郵便配達員はあなたとあなたの受取人には見えません。 diff --git a/files/ja/glossary/mixin/index.md b/files/ja/glossary/mixin/index.md index 1b25d110389c95..be3b25040b4455 100644 --- a/files/ja/glossary/mixin/index.md +++ b/files/ja/glossary/mixin/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: ed947b2c608428b62a60f07d09dc543f732dc09b --- +{{GlossarySidebar}} + ミックスインは、その{{Glossary("method", "メソッド")}}や{{Glossary("property", "プロパティ")}}の一部またはすべてが実装されていない{{Glossary("class","クラス")}}または{{Glossary("interface","インターフェイス")}}であり、別のクラスまたはインターフェイスが欠落している実装を提供する必要があります。 新しいクラスまたはインターフェイスには、ミックスインのプロパティとメソッドと、それ自身で定義したプロパティとメソッドの両方が含まれます。ミックスインが実装しているか、ミックスインを実装しているインターフェイスまたはクラスが実装しているかにかかわらず、すべてのメソッドとプロパティは全く同じように使用できます。 diff --git a/files/ja/glossary/mobile_first/index.md b/files/ja/glossary/mobile_first/index.md index 2116a1c0c36055..952395693b2cad 100644 --- a/files/ja/glossary/mobile_first/index.md +++ b/files/ja/glossary/mobile_first/index.md @@ -3,4 +3,6 @@ title: Mobile First (モバイルファースト) slug: Glossary/Mobile_First --- +{{GlossarySidebar}} + **モバイルファースト**は、ある種の {{Glossary("progressive enhancement","プログレッシブエンハンスメント")}}で、ウェブ開発やウェブデザインにおいて、モバイル画面サイズのデザイン・開発をデスクトップ画面サイズのデザイン・開発より優先して注力するアプローチです。 モバイルファーストアプローチの根拠は、すべての画面サイズにおいて良いユーザー体験を提供することです — はじめに小さい画面でうまく動作するユーザー体験を作成して、その次にその上に画面サイズが増えるごとにもっと豊かなユーザー体験を与えていきます。 モバイルファーストアプローチは、デスクトップ画面サイズをデザインしてからその後に小さい画面サイズを追加する、古いアプローチと対照をなします。 diff --git a/files/ja/glossary/modem/index.md b/files/ja/glossary/modem/index.md index d3bbd974e83e32..2653433740d6b3 100644 --- a/files/ja/glossary/modem/index.md +++ b/files/ja/glossary/modem/index.md @@ -3,6 +3,8 @@ title: Modem (モデム) slug: Glossary/Modem --- +{{GlossarySidebar}} + モデム(modem、**mod**ulator-**dem**odulator、変調器-復調器)は、ネットワークを介してデータを送信するために、デジタル情報からアナログ信号への変換や、その逆の変換を行うデバイスです。 電話回線用の DSL モデム、短距離無線信号用の Wi-Fi モデム、携帯電話基地局用の 3G モデムなど、異なるネットワークでは異なる種類のモデムが使われます。 モデムはルーターとは異なりますが、多くの企業が{{Glossary("Router","ルーター")}}と組み合わせたモデムを販売しています。 diff --git a/files/ja/glossary/modularity/index.md b/files/ja/glossary/modularity/index.md index d463b214479e18..b223f08d72c78c 100644 --- a/files/ja/glossary/modularity/index.md +++ b/files/ja/glossary/modularity/index.md @@ -3,6 +3,8 @@ title: Modularity (モジュール性) slug: Glossary/Modularity --- +{{GlossarySidebar}} + モジュール性という用語は、システムのコンポーネントを分離して再結合できる程度を指しており、またソフトウェアパッケージを論理ユニットに分割することもあります。モジュラーシステムの利点は、部品を独立して考えることができることです。 ## 関連項目 diff --git a/files/ja/glossary/mozilla_firefox/index.md b/files/ja/glossary/mozilla_firefox/index.md index c2197e7f5b58af..749d9bb1f24a15 100644 --- a/files/ja/glossary/mozilla_firefox/index.md +++ b/files/ja/glossary/mozilla_firefox/index.md @@ -3,6 +3,8 @@ title: Mozilla Firefox slug: Glossary/Mozilla_Firefox --- +{{GlossarySidebar}} + **Mozilla Firefox** は、無償で利用できるオープンソースの{{Glossary("browser", "ブラウザー")}}で、開発は Mozilla Corporation が取りまとめています。Firefox は Windows と OS X、Linux、Android で動作します。 2004 年 11 月に初版がリリースされ、 Firefox はテーマとプラグイン、[アドオン](/ja/docs/Mozilla/Add-ons)を使用して完璧にカスタマイズできます。 Firefox はウェブページを表示 (レンダリング) するために {{glossary("Gecko")}} を使用し、現在とこれからの両方のウェブ標準を実装しています。 diff --git a/files/ja/glossary/mutable/index.md b/files/ja/glossary/mutable/index.md index 57eeb7188acfa9..395ec098316038 100644 --- a/files/ja/glossary/mutable/index.md +++ b/files/ja/glossary/mutable/index.md @@ -3,6 +3,8 @@ title: Mutable (ミュータブル) slug: Glossary/Mutable --- +{{GlossarySidebar}} + ミュータブルは、変更可能な変数の型です。{{glossary("JavaScript")}} では、{{Glossary("primitive", "プリミティブな値")}}ではない、{{Glossary("Object","オブジェクト")}}と{{Glossary("Array","配列")}}だけがミュータブルです。 (変数名が新しい値を指し示すようにすることはできますが、以前の値はまだメモリーに保持されていますので、ガベージコレクションが必要です。) diff --git a/files/ja/glossary/mvc/index.md b/files/ja/glossary/mvc/index.md index 11226272aa65af..3734274f8f7882 100644 --- a/files/ja/glossary/mvc/index.md +++ b/files/ja/glossary/mvc/index.md @@ -3,6 +3,8 @@ title: MVC slug: Glossary/MVC --- +{{GlossarySidebar}} + **MVC**(Model-View-Controller、モデル-ビュー-コントローラ)は、ソフトウェア設計のパターンです。 これは、ソフトウェアのビジネスロジックとディスプレイの間の分離を強調します。 この「関心の分離」は、より良い労働の分業と改善されたメンテナンスを提供します。 MVVM(Model-View-Viewmodel、モデル-ビュー-ビューモデル)、MVP(Model-View-Presenter、モデル-ビュー-プレゼンター)、MVW(Model-View-Whatever、モデル-ビュー-何でも)などの他のデザインパターンも MVC に基づいています。 MVC のソフトウェア設計パターンの 3 つの部分は、次のように記述できます。 diff --git a/files/ja/glossary/namespace/index.md b/files/ja/glossary/namespace/index.md index bf928642df7943..01a6bc27c02168 100644 --- a/files/ja/glossary/namespace/index.md +++ b/files/ja/glossary/namespace/index.md @@ -3,6 +3,8 @@ title: Namespace (名前空間) slug: Glossary/Namespace --- +{{GlossarySidebar}} + 名前空間はプログラム内でコンテキストを識別する、論理的なグループの名前です。同じコンテキスト内かつ同じスコープの範囲内では、識別子は実態を一意に指定しなくてはなりません。 OS のディレクトリーは名前空間です。それぞれのファイルやサブディレクトリーは一意の名前を持たなくてはなりませんが、1 つのファイルが違うタイミングで同じ名前を使用することがあるかもしれません。 diff --git a/files/ja/glossary/nan/index.md b/files/ja/glossary/nan/index.md index 854b8111a411a4..9cce8d54e4ebcf 100644 --- a/files/ja/glossary/nan/index.md +++ b/files/ja/glossary/nan/index.md @@ -3,6 +3,8 @@ title: NaN (非数) slug: Glossary/NaN --- +{{GlossarySidebar}} + 非数(英語:Not a Number)とは未定義な値か、特に浮動小数点数の計算の結果で、表すことができない数値({{Glossary("Type", "データ型")}})のことを言います。 例えば、無限、0で割り算された結果、未定義、負数の平方根 (浮動小数点数は実数ですが、これは虚数です) などは非数と言います。 diff --git a/files/ja/glossary/nat/index.md b/files/ja/glossary/nat/index.md index 1bfef449531345..ce9593d4a3da79 100644 --- a/files/ja/glossary/nat/index.md +++ b/files/ja/glossary/nat/index.md @@ -3,6 +3,8 @@ title: NAT slug: Glossary/NAT --- +{{GlossarySidebar}} + **NAT** (Network Address Translation: ネットワークアドレス変換) は、複数のコンピューターで IP アドレスを共有するための技術です。NAT は一意のアドレスをローカルネットワーク上のコンピューターへ割り当て、正しい場所へデータを届けるために、ネットワークトラフィックを調整します。 ## 詳細情報 diff --git a/files/ja/glossary/native/index.md b/files/ja/glossary/native/index.md index 901def8fe872c0..738881d49df339 100644 --- a/files/ja/glossary/native/index.md +++ b/files/ja/glossary/native/index.md @@ -3,6 +3,8 @@ title: Native slug: Glossary/Native --- +{{GlossarySidebar}} + *ネイティブ*アプリケーションは、ターゲットアーキテクチャを構成するハードウェア/ソフトウェア環境で実行するようにコンパイルされています。 ネイティブ Android アプリの例は、 Android ツールチェインを使用して Java で記述されたモバイルアプリケーションです。 diff --git a/files/ja/glossary/navigation_directive/index.md b/files/ja/glossary/navigation_directive/index.md index a450b3131a850e..d4bb94c33d5250 100644 --- a/files/ja/glossary/navigation_directive/index.md +++ b/files/ja/glossary/navigation_directive/index.md @@ -3,6 +3,8 @@ title: Navigation directive (ナビゲーションディレクティブ) slug: Glossary/Navigation_directive --- +{{GlossarySidebar}} + **{{Glossary("CSP")}} のナビゲーションディレクティブ**は {{HTTPHeader("Content-Security-Policy")}} ヘッダーで使用され、たとえば、ユーザーがどの場所に移動したり、フォームを送信したりすることができるかを管理します。 ナビゲーションディレクティブは {{CSP("default-src")}} ディレクティブで代替されません。 diff --git a/files/ja/glossary/netscape_navigator/index.md b/files/ja/glossary/netscape_navigator/index.md index 5a84ff114c27a0..1a103a4879b2e2 100644 --- a/files/ja/glossary/netscape_navigator/index.md +++ b/files/ja/glossary/netscape_navigator/index.md @@ -3,6 +3,8 @@ title: Netscape Navigator slug: Glossary/Netscape_Navigator --- +{{GlossarySidebar}} + Netscape Navigator または、単に Netscape は、1990 年代の主要な{{glossary("browser", "ブラウザー")}}でした。Netscape は Mosaic をベースにして作られており、開発チームは、Mosaic のコードを書いていたプログラマーである Marc Andreessen によって率いられていました。 Netscape のおかげで、{{glossary("World Wide Web","ウェブ")}}はテキストのみの表現に留まらず、よりグラフィカルになりました。多くのブラウジング機能は、Netscape が導入したことによって標準化していきました。Netscape は読み込み中にウェブページを表示したり、JavaScript によってフォームやインタラクティブなコンテンツを可能にしたり、セッション情報を Cookie に保存したりすることを可能としました。しかし、ネットスケープの技術的優位性と初期の高いシェアにもかかわらず、1990 年代後半には、{{glossary("Microsoft Internet Explorer", "Internet Explorer")}} によって急速に市場シェアを奪われました。 diff --git a/files/ja/glossary/network_throttling/index.md b/files/ja/glossary/network_throttling/index.md index 43af6850a04ff3..a1570dd12b8be5 100644 --- a/files/ja/glossary/network_throttling/index.md +++ b/files/ja/glossary/network_throttling/index.md @@ -3,6 +3,8 @@ title: Network throttling (ネットワークスロットリング) slug: Glossary/Network_throttling --- +{{GlossarySidebar}} + **ネットワークスロットリング**とは、インターネットの速度を意図的に低下させることです。ウェブパフォーマンスにおいて、ネットワークスロットリング、またはネットワーク状態のエミュレーションでは、サイトのターゲットユーザーの大部分が経験している低帯域の状態をエミュレートするために使用されます。 ユーザーがモバイルで経験するネットワーク状態を見落とさないようにすることが重要です。企業のオフィスビルの中で、高性能なコンピュータを使ってウェブアプリケーションを作成する開発者のインターネット速度は、一般的に非常に高速です。開発者、テクニカルライター、デザイナーであれば、このような経験があるでしょう。しかし、モバイルユーザーがウェブアプリケーションにアクセスする際のネットワーク速度は、旅行中やデータプランの適用範囲が狭い遠隔地では、インターネットに接続できたとしても非常に低速になる可能性があります。ネットワークスロットリングを使えば、開発者はユーザーの体験を再現することができます。ブラウザーのインスペクターなど、ほとんどのブラウザー開発ツールには、さまざまなネットワーク条件をエミュレートする機能があります。ネットワークスロットリングによってユーザーの体験をエミュレートすることで、ロードタイムの問題をより容易に特定し、修正することができます。 diff --git a/files/ja/glossary/nntp/index.md b/files/ja/glossary/nntp/index.md index d3988fbb59608f..0fadbf0de3e6fa 100644 --- a/files/ja/glossary/nntp/index.md +++ b/files/ja/glossary/nntp/index.md @@ -3,6 +3,8 @@ title: NNTP slug: Glossary/NNTP --- +{{GlossarySidebar}} + **NNTP** (Network News Transfer Protocol) は、{{Glossary("Usenet")}} のメッセージをクライアントからサーバー、またはサーバー間で転送するために使用される{{Glossary("protocol","プロトコル")}}です。 ## 関連項目 diff --git a/files/ja/glossary/node/dom/index.md b/files/ja/glossary/node/dom/index.md index 1740530fa6a98c..346ccaa225dbd6 100644 --- a/files/ja/glossary/node/dom/index.md +++ b/files/ja/glossary/node/dom/index.md @@ -3,6 +3,8 @@ title: Node (DOM) slug: Glossary/Node/DOM --- +{{GlossarySidebar}} + {{Glossary("DOM")}}としての node は、node tree 内の 1 点を指しています。node はドキュメント自身であり、Element(要素)やテキスト、コメント等の色々なものがあります。 ## 詳細 diff --git a/files/ja/glossary/node/index.md b/files/ja/glossary/node/index.md index 153178dfdaaa37..cf666e5d51b3db 100644 --- a/files/ja/glossary/node/index.md +++ b/files/ja/glossary/node/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: ada5fa5ef15eadd44b549ecf906423b4a2092f34 --- +{{GlossarySidebar}} + **node** という用語は文脈によっていくつかの意味を持ちます。下記の用語を指しているかもしれません。 {{GlossaryDisambiguation}} diff --git a/files/ja/glossary/node/networking/index.md b/files/ja/glossary/node/networking/index.md index 491dee0f06abb8..fa4c631b3753eb 100644 --- a/files/ja/glossary/node/networking/index.md +++ b/files/ja/glossary/node/networking/index.md @@ -3,6 +3,8 @@ title: Node (networking) slug: Glossary/Node/networking --- +{{GlossarySidebar}} + ネットワークでは、 **node** はネットワーク内の接続ポイントです。物理ネットワークでは通常、コンピューターやルーターなどのデバイスです。 ## 詳細情報 From c04d478c115ef01399c7aa72237a3ffd47aba5f8 Mon Sep 17 00:00:00 2001 From: Leonid Vinogradov Date: Mon, 20 Nov 2023 00:37:17 +0300 Subject: [PATCH 20/31] [ja] add sidebar to Glossary pages (part 4) --- files/ja/glossary/media/css/index.md | 2 ++ files/ja/glossary/media/index.md | 2 ++ files/ja/glossary/node.js/index.md | 4 ++-- files/ja/glossary/non-normative/index.md | 2 ++ files/ja/glossary/normative/index.md | 2 ++ files/ja/glossary/null/index.md | 2 ++ files/ja/glossary/nullish/index.md | 2 ++ files/ja/glossary/number/index.md | 2 ++ files/ja/glossary/object/index.md | 2 ++ files/ja/glossary/object_reference/index.md | 2 ++ files/ja/glossary/oop/index.md | 2 ++ files/ja/glossary/opengl/index.md | 2 ++ files/ja/glossary/openssl/index.md | 2 ++ files/ja/glossary/opera_browser/index.md | 2 ++ files/ja/glossary/operand/index.md | 2 ++ files/ja/glossary/operator/index.md | 2 ++ files/ja/glossary/origin/index.md | 2 ++ files/ja/glossary/ota/index.md | 2 ++ files/ja/glossary/owasp/index.md | 2 ++ files/ja/glossary/p2p/index.md | 4 ++-- files/ja/glossary/packet/index.md | 2 ++ files/ja/glossary/page_load_time/index.md | 2 ++ files/ja/glossary/parameter/index.md | 2 ++ files/ja/glossary/parent_object/index.md | 2 ++ files/ja/glossary/parse/index.md | 2 ++ files/ja/glossary/parser/index.md | 2 ++ files/ja/glossary/payload_body/index.md | 2 ++ files/ja/glossary/pdf/index.md | 2 ++ files/ja/glossary/perceived_performance/index.md | 2 ++ files/ja/glossary/percent-encoding/index.md | 2 ++ files/ja/glossary/php/index.md | 2 ++ files/ja/glossary/pixel/index.md | 2 ++ files/ja/glossary/plaintext/index.md | 2 ++ files/ja/glossary/plugin/index.md | 2 ++ files/ja/glossary/png/index.md | 2 ++ files/ja/glossary/polyfill/index.md | 2 ++ files/ja/glossary/polymorphism/index.md | 2 ++ files/ja/glossary/pop/index.md | 2 ++ files/ja/glossary/port/index.md | 2 ++ files/ja/glossary/prefetch/index.md | 2 ++ files/ja/glossary/preflight_request/index.md | 2 ++ files/ja/glossary/prerender/index.md | 2 ++ files/ja/glossary/presto/index.md | 2 ++ files/ja/glossary/primitive/index.md | 2 ++ files/ja/glossary/privileged/index.md | 2 ++ files/ja/glossary/privileged_code/index.md | 2 ++ files/ja/glossary/progressive_enhancement/index.md | 2 ++ files/ja/glossary/progressive_web_apps/index.md | 2 ++ files/ja/glossary/promise/index.md | 2 ++ files/ja/glossary/property/css/index.md | 2 ++ files/ja/glossary/property/index.md | 2 ++ files/ja/glossary/property/javascript/index.md | 2 ++ files/ja/glossary/protocol/index.md | 2 ++ files/ja/glossary/prototype-based_programming/index.md | 2 ++ files/ja/glossary/prototype/index.md | 2 ++ files/ja/glossary/proxy_server/index.md | 2 ++ files/ja/glossary/pseudo-class/index.md | 2 ++ files/ja/glossary/pseudo-element/index.md | 2 ++ files/ja/glossary/pseudocode/index.md | 2 ++ files/ja/glossary/public-key_cryptography/index.md | 2 ++ files/ja/glossary/python/index.md | 2 ++ files/ja/glossary/quality_values/index.md | 2 ++ files/ja/glossary/quaternion/index.md | 2 ++ files/ja/glossary/quic/index.md | 2 ++ files/ja/glossary/rail/index.md | 2 ++ files/ja/glossary/raster_image/index.md | 2 ++ files/ja/glossary/recursion/index.md | 2 ++ files/ja/glossary/reflow/index.md | 2 ++ files/ja/glossary/regular_expression/index.md | 2 ++ files/ja/glossary/rendering_engine/index.md | 2 ++ files/ja/glossary/repo/index.md | 2 +- files/ja/glossary/reporting_directive/index.md | 2 ++ files/ja/glossary/representation_header/index.md | 2 ++ files/ja/glossary/request_header/index.md | 2 ++ files/ja/glossary/response_header/index.md | 2 ++ files/ja/glossary/responsive_web_design/index.md | 2 ++ files/ja/glossary/rest/index.md | 2 ++ files/ja/glossary/rgb/index.md | 2 ++ files/ja/glossary/rng/index.md | 5 ++--- files/ja/glossary/robots.txt/index.md | 2 ++ files/ja/glossary/round_trip_time/index.md | 2 ++ files/ja/glossary/routers/index.md | 2 ++ files/ja/glossary/rss/index.md | 2 ++ files/ja/glossary/rtf/index.md | 2 ++ files/ja/glossary/rtl/index.md | 2 ++ files/ja/glossary/rtsp/index.md | 2 ++ files/ja/glossary/ruby/index.md | 2 ++ files/ja/glossary/safe/http/index.md | 2 ++ files/ja/glossary/safe/index.md | 2 ++ files/ja/glossary/same-origin_policy/index.md | 2 ++ files/ja/glossary/scm/index.md | 2 ++ files/ja/glossary/scope/index.md | 2 ++ files/ja/glossary/screen_reader/index.md | 2 ++ files/ja/glossary/script-supporting_element/index.md | 2 ++ files/ja/glossary/scroll_container/index.md | 2 ++ files/ja/glossary/search_engine/index.md | 2 ++ files/ja/glossary/secure_context/index.md | 2 ++ files/ja/glossary/self-executing_anonymous_function/index.md | 2 ++ files/ja/glossary/semantics/index.md | 2 ++ 99 files changed, 197 insertions(+), 8 deletions(-) diff --git a/files/ja/glossary/media/css/index.md b/files/ja/glossary/media/css/index.md index 94637bbc543d51..ade929fa227414 100644 --- a/files/ja/glossary/media/css/index.md +++ b/files/ja/glossary/media/css/index.md @@ -3,6 +3,8 @@ title: Media (CSS) slug: Glossary/Media/CSS --- +{{GlossarySidebar}} + {{Glossary("CSS")}} (Cascading Style Sheets) の文脈において、**_メディア_**という用語は{{Glossary("rendering engine", "レンダリングエンジン")}}によって描画される文書の出力先を参照します。これはふつうは端末の画面ですが、プリンターや読み上げ装置、点字ディスプレイ、あるいはそのほかの装置の可能性もあります。 CSS には、閲覧者の端末のメディアの**種類** (画面や印刷など) やメディアの**能力** (幅、解像度、その他の値など) に応じて、文書のスタイルを微調整したり、異なるスタイルを提供したりすることができる機能がいくつかあります。 diff --git a/files/ja/glossary/media/index.md b/files/ja/glossary/media/index.md index 9dfa2bc8da6675..bd7a9b2d7c6dc9 100644 --- a/files/ja/glossary/media/index.md +++ b/files/ja/glossary/media/index.md @@ -3,6 +3,8 @@ title: Media slug: Glossary/Media --- +{{GlossarySidebar}} + **メディア**という用語は、ウェブについて話すときに複数の意味で使われます。これは文脈によって異なる意味を取ります。 {{GlossaryDisambiguation}} diff --git a/files/ja/glossary/node.js/index.md b/files/ja/glossary/node.js/index.md index 45ba8580ff958c..bfb8cb1b18a3fc 100644 --- a/files/ja/glossary/node.js/index.md +++ b/files/ja/glossary/node.js/index.md @@ -3,6 +3,8 @@ title: Node.js slug: Glossary/Node.js --- +{{GlossarySidebar}} + Node.js は、クロスプラットフォームの {{Glossary("JavaScript")}} 実行環境であり、サーバー側アプリケーションやネットワークアプリケーションを JavaScript で構築することができます。 ## 詳細情報 @@ -16,5 +18,3 @@ Node.js は、クロスプラットフォームの {{Glossary("JavaScript")}} - [API 文書](https://nodejs.org/api/) - [チュートリアル](https://nodejs.org/ja/docs/guides/) - -{{QuickLinksWithSubpages("/ja/docs/Glossary")}} diff --git a/files/ja/glossary/non-normative/index.md b/files/ja/glossary/non-normative/index.md index 2846f6b5abdda2..2b1802734ea12b 100644 --- a/files/ja/glossary/non-normative/index.md +++ b/files/ja/glossary/non-normative/index.md @@ -3,6 +3,8 @@ title: non-normative slug: Glossary/Non-normative --- +{{GlossarySidebar}} + ソフトウェア {{Glossary("specification", "specifications")}} には、 _non-normative_ または _informative_ としてマークされた情報が含まれていることがよくあります。これは、読者が仕様をよりよく理解したり、例を示したりするのを助ける目的で提供されていることを意味している、もしくはベストプラクティスであり原則として従う必要はありません。従わなければならない仕様の公式部分を含むセクションは、多くの場合 {{Glossary("normative", "normative")}} とマークされています。 ## 関連項目 diff --git a/files/ja/glossary/normative/index.md b/files/ja/glossary/normative/index.md index 8676002a563cfc..7994d24535774f 100644 --- a/files/ja/glossary/normative/index.md +++ b/files/ja/glossary/normative/index.md @@ -3,6 +3,8 @@ title: Normative slug: Glossary/Normative --- +{{GlossarySidebar}} + Normative とは、ソフトウェア {{Glossary("specification", "specifications")}} で一般的に使用される単語であり、標準化されており、規則に従う必要があるセクションを示します。 仕様には _{{Glossary("non-normative")}}_ または、 _informative_ としてマークされたセクションが含まれる場合もあります。これは読者が仕様をよりよく理解できるようにするため、または例やベストプラクティスを紹介する為として提供されているセクションです。原則として従う必要はありません。 ## 関連項目 diff --git a/files/ja/glossary/null/index.md b/files/ja/glossary/null/index.md index 061ed8c2c5ee1d..997c615e3ce7f3 100644 --- a/files/ja/glossary/null/index.md +++ b/files/ja/glossary/null/index.md @@ -3,6 +3,8 @@ title: "Null" slug: Glossary/Null --- +{{GlossarySidebar}} + コンピュータサイエンス分野において、一般的に **`null`** という値は、存在しないまたは無効な{{glossary("object","オブジェクト")}}やアドレスへのポインター参照を表します。 null による参照が持つ意味は、言語実装によって様々です。 {{Glossary("JavaScript")}} では、 `null` は動作がプリミティブらしく見えるので、{{Glossary("Primitive", "プリミティブ値")}}の一つであるとされています。 diff --git a/files/ja/glossary/nullish/index.md b/files/ja/glossary/nullish/index.md index 0492caf6df1688..3b62cba49d9610 100644 --- a/files/ja/glossary/nullish/index.md +++ b/files/ja/glossary/nullish/index.md @@ -3,4 +3,6 @@ title: Nullish value slug: Glossary/Nullish --- +{{GlossarySidebar}} + [JavaScript](/ja/docs/Glossary/JavaScript) では Nullish value は {{JSxRef("null")}} または {{JSxRef("undefined")}} のいずれかの値です。Nullish values は常に [falsy](/ja/docs/Glossary/Falsy) です。 diff --git a/files/ja/glossary/number/index.md b/files/ja/glossary/number/index.md index 6547d53e23f3b7..45e3900904e245 100644 --- a/files/ja/glossary/number/index.md +++ b/files/ja/glossary/number/index.md @@ -3,6 +3,8 @@ title: Number slug: Glossary/Number --- +{{GlossarySidebar}} + {{Glossary("JavaScript")}} において、 **Number** は [倍精度64ビット浮動小数点形式 (IEEE 754)](https://ja.wikipedia.org/wiki/倍精度浮動小数点数) を持つ数値データ型です。その他のプログラミング言語では、それ以外の数値型もあります。たとえば、 Integer、Float、Double、Bignum などです。 ## 詳細情報 diff --git a/files/ja/glossary/object/index.md b/files/ja/glossary/object/index.md index 93a9983a840f54..28dd5ca4e0b276 100644 --- a/files/ja/glossary/object/index.md +++ b/files/ja/glossary/object/index.md @@ -3,6 +3,8 @@ title: Object (オブジェクト) slug: Glossary/Object --- +{{GlossarySidebar}} + [オブジェクト](/ja/docs/Web/JavaScript/Reference/Global_Objects/Object)はデータとそのデータをやり取りするための命令が入ったデータ構造です。オブジェクトはしばしば現実世界の事物を参照する事があります。例えば、レーシングゲームでは `car` や `map` オブジェクトと言った具合です。{{glossary("OOP","オブジェクト指向プログラミング")}}言語の例としては、{{glossary("JavaScript")}}、Java、C++、Python、そして Ruby などが挙げられます。 ## 詳細情報 diff --git a/files/ja/glossary/object_reference/index.md b/files/ja/glossary/object_reference/index.md index 0f55a75ed55a37..9a0bbca066a7c3 100644 --- a/files/ja/glossary/object_reference/index.md +++ b/files/ja/glossary/object_reference/index.md @@ -3,6 +3,8 @@ title: Object reference (オブジェクト参照) slug: Glossary/Object_reference --- +{{GlossarySidebar}} + **{{glossary("object", "オブジェクト")}}**へのリンクです。オブジェクト参照はまさにリンクされたオブジェクトのように使うことができます。 オブジェクト参照の概念は、同じオブジェクトを複数の**{{glossary("property","プロパティ")}}**に割り当てると明確になります。割り当てらてた各プロパティは、コピーしたオブジェクトを保持するのではなく、同じオブジェクトにリンクしたオブジェクト参照を保持します。これにより、オブジェクトが変更された時、オブジェクトを参照する全てのプロパティに変更が反映されます。 diff --git a/files/ja/glossary/oop/index.md b/files/ja/glossary/oop/index.md index 01f6081efcda69..cde1a9d5d4a199 100644 --- a/files/ja/glossary/oop/index.md +++ b/files/ja/glossary/oop/index.md @@ -3,6 +3,8 @@ title: OOP (オブジェクト指向プログラミング) slug: Glossary/OOP --- +{{GlossarySidebar}} + **OOP** (Object-Oriented Programming、オブジェクト指向プログラミングの略) はデータを **{{glossary("object","オブジェクト")}}** 内にカプセル化して、その構成部品ではなくてオブジェクト自体が操作される、プログラミングアプローチです。 {{glossary("JavaScript")}} はとてもオブジェクト指向です。これは **プロトタイプ**ベースのモデル ([クラスベースの反対](/ja/docs/Web/JavaScript/Guide/Details_of_the_Object_Model#Class-based_vs._prototype-based_languages)) に従っています。 diff --git a/files/ja/glossary/opengl/index.md b/files/ja/glossary/opengl/index.md index 22516ee7c5069c..191a385f72975e 100644 --- a/files/ja/glossary/opengl/index.md +++ b/files/ja/glossary/opengl/index.md @@ -3,6 +3,8 @@ title: OpenGL slug: Glossary/OpenGL --- +{{GlossarySidebar}} + **OpenGL** [(**Open Graphics Library**)](http://en.wikipedia.org/wiki/OpenGL#cite_note-3)は言語横断的な、2D と 3D ベクターグラフィックス用のマルチプラットフォーム i のアプリケーションプログラミングインターフェイス (API) です。この API は、ハードウェアで加速したレンダリングを得るため、画像プロセッサー (GPU) と相互作用させて使うことが典型的です。 ## さらに詳しく diff --git a/files/ja/glossary/openssl/index.md b/files/ja/glossary/openssl/index.md index 89b5baed0d679c..5f87ed6ac3f3ab 100644 --- a/files/ja/glossary/openssl/index.md +++ b/files/ja/glossary/openssl/index.md @@ -3,6 +3,8 @@ title: OpenSSL slug: Glossary/OpenSSL --- +{{GlossarySidebar}} + OpenSSL は、{{glossary("SSL")}} と {{glossary("TLS")}} のオープンソースの実装です。 ## もっと学ぶ diff --git a/files/ja/glossary/opera_browser/index.md b/files/ja/glossary/opera_browser/index.md index 5d616376b1b0fb..d9c3a7bf92cf7d 100644 --- a/files/ja/glossary/opera_browser/index.md +++ b/files/ja/glossary/opera_browser/index.md @@ -3,6 +3,8 @@ title: Opera Browser slug: Glossary/Opera_Browser --- +{{GlossarySidebar}} + **Opera** は、5 番目に多用されるウェブ{{glossary("browser","ブラウザー")}}であり、1996 年に公式リリースされた当初は Windows のみで動作していました。Opera は、2013 年からレイアウトエンジンとして {{glossary("Blink")}} を使用しています (以前は、{{glossary("Presto")}} でした)。Opera には、モバイルやタブレット端末バージョンもあります。 ## 詳細情報 diff --git a/files/ja/glossary/operand/index.md b/files/ja/glossary/operand/index.md index 0e21ed861a6e3f..827a881180034a 100644 --- a/files/ja/glossary/operand/index.md +++ b/files/ja/glossary/operand/index.md @@ -3,6 +3,8 @@ title: Operand (オペランド) slug: Glossary/Operand --- +{{GlossarySidebar}} + **オペランド**は{{glossary("operator", "演算子")}}で操作されるデータを表す命令の一部です。例えば、2 つの数字を加算する時、数字はオペランドで "+" が演算子です。 ## 詳細情報 diff --git a/files/ja/glossary/operator/index.md b/files/ja/glossary/operator/index.md index dbec0f90aad080..33dcac17e750ed 100644 --- a/files/ja/glossary/operator/index.md +++ b/files/ja/glossary/operator/index.md @@ -3,6 +3,8 @@ title: Operator (演算子) slug: Glossary/Operator --- +{{GlossarySidebar}} + 記号や英数字によって構成された**予約語**で、内蔵の機能を実行します。例えば、 JavaScript では加算演算子("+")は複数の数値を加算したり文字列を結合したりします。「否定」演算子("!")は式を否定し、例えば、 `true` を表す式では `false` を返します。 ## 詳細情報 diff --git a/files/ja/glossary/origin/index.md b/files/ja/glossary/origin/index.md index c66c7f4316a86b..2af3ed69a38e02 100644 --- a/files/ja/glossary/origin/index.md +++ b/files/ja/glossary/origin/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: cd76750e9e68ebdf8bf1ddc0630406d95eddc502 --- +{{GlossarySidebar}} + ウェブコンテンツの**オリジン** (Origin) は、ウェブコンテンツにアクセスするために使われる {{Glossary("URL")}} の _スキーム_ (プロトコル)、 _ホスト_ (ドメイン)、 _ポート番号_ によって定義されます。スキーム、ホスト、ポート番号がすべて一致した場合のみ、 2 つのオブジェクトは同じオリジンであると言えます。 操作によっては同じオリジンのコンテンツに限定されており、この制約は {{Glossary("CORS")}} を使用して緩和することができます。 diff --git a/files/ja/glossary/ota/index.md b/files/ja/glossary/ota/index.md index ec0131e3c3bf2c..10b3ab6c8c0ef7 100644 --- a/files/ja/glossary/ota/index.md +++ b/files/ja/glossary/ota/index.md @@ -3,6 +3,8 @@ title: OTA slug: Glossary/OTA --- +{{GlossarySidebar}} + _Over The Air_ (**OTA**) とは、無線接続されたデバイス上のソフトウェアを中央サーバーから自動更新することを指します。特定の更新セットを受信する全てのデバイスの所有者は同じ "チャネル" 上にあり、各デバイスは多くの場合、複数のチャネルにアクセスできます (例えば、本番またはエンジニアリングビルド)。 ## 関連項目 diff --git a/files/ja/glossary/owasp/index.md b/files/ja/glossary/owasp/index.md index 88d9e9c5c4b44a..9c2bd7e93d3b91 100644 --- a/files/ja/glossary/owasp/index.md +++ b/files/ja/glossary/owasp/index.md @@ -3,6 +3,8 @@ title: OWASP slug: Glossary/OWASP --- +{{GlossarySidebar}} + **OWASP** (Open Web Application Security Project: オープンウェブアプリケーションセキュリティプロジェクト) は、特にウェブ上で、無償ソフトウェアのセキュリティのために活動する非営利団体や国際的なネットワークを持つ団体です。 ## 詳細情報 diff --git a/files/ja/glossary/p2p/index.md b/files/ja/glossary/p2p/index.md index acf65a189445ec..fc8f0893f18946 100644 --- a/files/ja/glossary/p2p/index.md +++ b/files/ja/glossary/p2p/index.md @@ -3,6 +3,8 @@ title: P2P slug: Glossary/P2P --- +{{GlossarySidebar}} + P2P (ピア・ツー・ピア)はすべての参加しているノード(_ピア_)が同等の特権を持ち、負荷を共有する、コンピュータネットワークアーキテクチャです。P2P は、複数の*クライアント*ノードがサービスの中心となる*サーバー*に接続するクライアント・サーバーネットワークアーキテクチャとは異なります。 P2P はよくブロックチェーンアプリケーションで見られます。 ## 理解を深める @@ -10,5 +12,3 @@ P2P (ピア・ツー・ピア)はすべての参加しているノード(_ピ ### 一般知識 - Wikipedia 上の記事「[P2P](https://ja.wikipedia.org/wiki/Peer_to_Peer)」 - -{{QuickLinksWithSubpages("/ja/docs/Glossary")}} diff --git a/files/ja/glossary/packet/index.md b/files/ja/glossary/packet/index.md index 1722b0980b328f..f16a5e9d38f6fb 100644 --- a/files/ja/glossary/packet/index.md +++ b/files/ja/glossary/packet/index.md @@ -3,6 +3,8 @@ title: パケット slug: Glossary/Packet --- +{{GlossarySidebar}} + パケット、またはネットワークパケットはは、ネットワーク上で送られる整形されたデータの塊です。パケットはユーザーデータと制御情報を含みます。ユーザーデータは*ペイロード*として知られています。制御情報はペイロードを送るための制御情報です。この制御情報は、送信元と送信先のネットワークアドレス、順序情報、エラー検知コードで構成されており、通常パケットのヘッダーとフッターで見られます。 ## パケットに含まれるもの diff --git a/files/ja/glossary/page_load_time/index.md b/files/ja/glossary/page_load_time/index.md index eca9dd729081c9..93135382ee4b47 100644 --- a/files/ja/glossary/page_load_time/index.md +++ b/files/ja/glossary/page_load_time/index.md @@ -3,6 +3,8 @@ title: ページ読み込み時間 slug: Glossary/Page_load_time --- +{{GlossarySidebar}} + **ページ読み込み時間**とはページの読み込みにかかる時間のことであり、[ナビゲーション開始時](/ja/docs/Web/API/PerformanceTiming/navigationStart)から[ロードイベント開始時](/ja/docs/Web/API/PerformanceTiming/loadEventStart)までをもって測定されます。 ```js diff --git a/files/ja/glossary/parameter/index.md b/files/ja/glossary/parameter/index.md index e3e9641c278398..b02dd7c8ea2ffe 100644 --- a/files/ja/glossary/parameter/index.md +++ b/files/ja/glossary/parameter/index.md @@ -3,6 +3,8 @@ title: Parameter (パラメーター) slug: Glossary/Parameter --- +{{GlossarySidebar}} + パラメーターは{{Glossary("function", "関数")}}に渡される名前付きの変数です。パラメーター変数は関数に{{Glossary("argument","引数")}}をインポートするのに使われます。 *パラメーター*と*引数*の違いに注意してください: diff --git a/files/ja/glossary/parent_object/index.md b/files/ja/glossary/parent_object/index.md index 1859edf4e026cf..084dafc9c0cc17 100644 --- a/files/ja/glossary/parent_object/index.md +++ b/files/ja/glossary/parent_object/index.md @@ -3,6 +3,8 @@ title: Parent object (親オブジェクト) slug: Glossary/Parent_object --- +{{GlossarySidebar}} + 指定された {{glossary("property", "プロパティ")}} や {{glossary("method", "メソッド")}} が所属している {{glossary("object", "オブジェクト")}}。 ## 関連項目 diff --git a/files/ja/glossary/parse/index.md b/files/ja/glossary/parse/index.md index dcc297920aa704..7aaf6242a10a31 100644 --- a/files/ja/glossary/parse/index.md +++ b/files/ja/glossary/parse/index.md @@ -3,6 +3,8 @@ title: Parse (解析) slug: Glossary/Parse --- +{{GlossarySidebar}} + 解析(Parsing)とは、プログラムを解析し、例えばブラウザー内の {{glossary("JavaScript")}} エンジンといった実行環境で、実際に実行できる内部形式に変換することを意味します。 [ブラウザーは HTML を解析](/ja/docs/Web/Guide/HTML/HTML5/HTML5_Parser)して {{glossary("DOM")}} ツリーに変換します。HTML の解析処理は[トークン化](/ja/docs/Web/API/DOMTokenList)とツリーの構築を含みます。HTML トークンは、属性の名前や値と同じように、開始タグと終了タグを含みます。文書が適切に構造化されていれば、その解析処理は単純で速くなります。パーサーはトークン化された入力内容を解析してドキュメントに変換し、ドキュメントツリーを作り上げます。 diff --git a/files/ja/glossary/parser/index.md b/files/ja/glossary/parser/index.md index 800d240752c1d6..fb2f69224bd734 100644 --- a/files/ja/glossary/parser/index.md +++ b/files/ja/glossary/parser/index.md @@ -3,6 +3,8 @@ title: Parser (パーサー) slug: Glossary/Parser --- +{{GlossarySidebar}} + **パーサー**は、ソースコードファイルを{{glossary("parse","解析")}}するコンパイラまたはインタプリタのモジュールです。 より一般的に言えば、テキストを解析して内容を別の表現に変換するソフトウェアです。 diff --git a/files/ja/glossary/payload_body/index.md b/files/ja/glossary/payload_body/index.md index a540d385c75316..c9671efca78f69 100644 --- a/files/ja/glossary/payload_body/index.md +++ b/files/ja/glossary/payload_body/index.md @@ -3,6 +3,8 @@ title: Payload body slug: Glossary/Payload_body --- +{{GlossarySidebar}} + HTTP メッセージの*ペイロード本文*は、HTTP メッセージ本文があれば、その送信時に送られるデータの {{HTTPHeader("Transfer-Encoding","Transfer-Encoding")}} が適用される前の*情報* ("ペイロード") 部分です。 Transfer-Encoding が使用されない限り、 _ペイロード本文_ と _メッセージ本文_ は同じものです。 例えば、このレスポンスではメッセージ本文は "Mozilla Developer Network" というペイロード本文を持っているだけです。 diff --git a/files/ja/glossary/pdf/index.md b/files/ja/glossary/pdf/index.md index 7b6fb06358c8c1..fcc102b1622fcc 100644 --- a/files/ja/glossary/pdf/index.md +++ b/files/ja/glossary/pdf/index.md @@ -3,6 +3,8 @@ title: PDF slug: Glossary/PDF --- +{{GlossarySidebar}} + **PDF** (Portable Document Format) は、特定のソフトウェア実装、ハードウェアプラットフォーム、オペレーティングシステムに依存せずにドキュメントを共有するためのファイル形式です。PDF は、印刷文書のデジタル画像を提供し、印刷したとき同じ外観を保ちます。 ## 詳細情報 diff --git a/files/ja/glossary/perceived_performance/index.md b/files/ja/glossary/perceived_performance/index.md index c288f5b3a458e1..8f8e787a1de81c 100644 --- a/files/ja/glossary/perceived_performance/index.md +++ b/files/ja/glossary/perceived_performance/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: 4bd65a01204446af2254bb8864bd22ad87bc86b0 --- +{{GlossarySidebar}} + **知覚的パフォーマンス**は、ウェブサイトがユーザーにとってどれだけ速く、レスポンスよく、信頼できるものと感じるかの尺度です。サイトのパフォーマンスに対する認識は、実際の読み込み時間やレスポンス時間よりもユーザー体験に大きな影響を与える可能性があります。 ## 関連情報 diff --git a/files/ja/glossary/percent-encoding/index.md b/files/ja/glossary/percent-encoding/index.md index 7ec88f547f3e0a..4facccdfe079b5 100644 --- a/files/ja/glossary/percent-encoding/index.md +++ b/files/ja/glossary/percent-encoding/index.md @@ -3,6 +3,8 @@ title: Percent-encoding (パーセントエンコーディング) slug: Glossary/Percent-encoding --- +{{GlossarySidebar}} + パーセントエンコーディング(Percent-encoding)は、{{Glossary("URL")}} のコンテキストで特定の意味を持つ 8 ビット文字をエンコードするメカニズムです。URL エンコードとも呼ばれます。エンコードは置換で構成されます。`'%'` の後に、置換文字の ASCII 値の 16 進表現が続きます。 エンコードが必要な特殊文字は、`':'`, `'/'`, `'?'`, `'#'`, `'['`, `']'`, `'@'`, `'!'`, `'$'`, `'&'`, `"'"`, `'('`, `')'`, `'*'`, `'+'`, `','`, `';'`, `'='`、および `'%'` 自体です。他の文字もエンコードできますが、エンコードする必要はありません。 diff --git a/files/ja/glossary/php/index.md b/files/ja/glossary/php/index.md index fee5fa9a615303..c260efee56fa55 100644 --- a/files/ja/glossary/php/index.md +++ b/files/ja/glossary/php/index.md @@ -3,6 +3,8 @@ title: PHP slug: Glossary/PHP --- +{{GlossarySidebar}} + PHP (再帰的な頭文字語で PHP: Hypertext Preprocessor) はオープンソースのサーバー側スクリプト言語で、 HTML に組み込んで、ウェブアプリや動的なウェブサイトを構築することができます。 ## 例 diff --git a/files/ja/glossary/pixel/index.md b/files/ja/glossary/pixel/index.md index 9f7e412d4f11a6..648cf77f80d036 100644 --- a/files/ja/glossary/pixel/index.md +++ b/files/ja/glossary/pixel/index.md @@ -3,6 +3,8 @@ title: Pixel (ピクセル) slug: Glossary/Pixel --- +{{GlossarySidebar}} + ピクセルは、コンピュータ画面のようなグラフィカルな表示の最小構成要素です。 画面解像度は、ピクセル単位で表されます。 例: "800 x 600" ピクセル解像度とは、幅 800 ピクセル、高さ 600 ピクセルを表示できることを意味します。 diff --git a/files/ja/glossary/plaintext/index.md b/files/ja/glossary/plaintext/index.md index d7d48275492c12..5d8e940890f172 100644 --- a/files/ja/glossary/plaintext/index.md +++ b/files/ja/glossary/plaintext/index.md @@ -3,6 +3,8 @@ title: Plaintext (平文) slug: Glossary/Plaintext --- +{{GlossarySidebar}} + [平文](https://ja.wikipedia.org/wiki/平文)(ひらぶん)とは、{{Glossary("encryption","暗号化")}} {{Glossary("algorithm","アルゴリズム")}}への入力として使用されている情報、または{{glossary("decryption", "復号")}}された{{Glossary("ciphertext","暗号文")}}のことです。 頻繁に使用される用語である[クリアテキスト](https://ja.wikipedia.org/wiki/クリアテキスト)は、暗号化されておらず、追加の処理を行わずに人間やコンピュータが読むことができるテキスト文書、画像などの情報を意味します。 diff --git a/files/ja/glossary/plugin/index.md b/files/ja/glossary/plugin/index.md index 15599f19f693fc..705e7b85969809 100644 --- a/files/ja/glossary/plugin/index.md +++ b/files/ja/glossary/plugin/index.md @@ -3,6 +3,8 @@ title: Plugin (プラグイン) slug: Glossary/Plugin --- +{{GlossarySidebar}} + ブラウザープラグインとは、ブラウザーがネイティブに対応できないコンテンツを扱うために、ユーザーがインストールすることができるソフトウェアコンポーネントのことです。ブラウザープラグインは通常、 [NPAPI](https://en.wikipedia.org/wiki/NPAPI) (Netscape Plugin Application Programming Interface) アーキテクチャを使用して記述されています。 最も有名で広く使われていたプラグインは Adobe Flash Player で、これによりブラウザーで {{Glossary("Adobe Flash")}} コンテンツを実行できるようになりました。 diff --git a/files/ja/glossary/png/index.md b/files/ja/glossary/png/index.md index 9e2476ea08c6b1..b0354ab5d6b31d 100644 --- a/files/ja/glossary/png/index.md +++ b/files/ja/glossary/png/index.md @@ -3,6 +3,8 @@ title: PNG slug: Glossary/PNG --- +{{GlossarySidebar}} + **PNG** (_Portable Network Graphics_) は、可逆データ圧縮をサポートする画像ファイル形式です。 ## 関連項目 diff --git a/files/ja/glossary/polyfill/index.md b/files/ja/glossary/polyfill/index.md index 560651aa4dc034..da930dbda09caf 100644 --- a/files/ja/glossary/polyfill/index.md +++ b/files/ja/glossary/polyfill/index.md @@ -3,6 +3,8 @@ title: Polyfill (ポリフィル) slug: Glossary/Polyfill --- +{{GlossarySidebar}} + ポリフィルとは、最近の機能をサポートしていない古いブラウザーで、その機能を使えるようにするためのコードです。大抵はウェブ上の JavaScript です。 例えば、ポリフィルを使用して、独自の IE フィルターを使用して IE7 の {{cssxref("text-shadow")}} の機能を模倣したり、 JavaScript を使用して rem の単位やメディアクエリーを模倣して、適切なスタイル付けを動的に調整したり、その他の必要な機能を提供したりすることができます。 diff --git a/files/ja/glossary/polymorphism/index.md b/files/ja/glossary/polymorphism/index.md index 5b2fa32b60f490..ebe9eb0eaf3b55 100644 --- a/files/ja/glossary/polymorphism/index.md +++ b/files/ja/glossary/polymorphism/index.md @@ -3,6 +3,8 @@ title: Polymorphism (多態性) slug: Glossary/Polymorphism --- +{{GlossarySidebar}} + Polymorphism (多態性)とは複数のデータ型を 1 つのインターフェイスにまとめた表現です。 例えば、整数型、浮動小数点型、倍精度浮動小数点型は暗黙的な多態性を持ちます:データ型の違いにもかからず、その3つは足し算、引き算、掛け算、などができます。 diff --git a/files/ja/glossary/pop/index.md b/files/ja/glossary/pop/index.md index bb6fa482d62d57..0ca4ed5f4e9921 100644 --- a/files/ja/glossary/pop/index.md +++ b/files/ja/glossary/pop/index.md @@ -3,6 +3,8 @@ title: POP3 slug: Glossary/POP --- +{{GlossarySidebar}} + **POP3** (Post Office Protocol) は {{glossary("TCP")}} 接続を使用して、メールサーバーから電子メールを取得する非常に一般的な{{glossary("protocol","プロトコル")}}です。 POP3 はもっと新しいプロトコルである {{Glossary("IMAP4")}} とは異なり、フォルダー管理に対応していません。複雑な構造となるため、実装が困難です。 メールクライアントは通常、サーバーからすべてのメッセージを受信し、すべてのメッセージを削除します。 しかし、POP3 はサーバーにメッセージのコピーを残すことができます。現在、ほぼすべてのメールサーバーとクライアントは POP3 に対応しています。 diff --git a/files/ja/glossary/port/index.md b/files/ja/glossary/port/index.md index c71d7f71873491..aa2082c4462af3 100644 --- a/files/ja/glossary/port/index.md +++ b/files/ja/glossary/port/index.md @@ -3,6 +3,8 @@ title: Port (ポート) slug: Glossary/Port --- +{{GlossarySidebar}} + **ポート**とは、{{Glossary("IP address","IP アドレス")}}を持ち、ネットワークに接続されているコンピューターの通信上のエンドポイントです。ポートは数字で指定され、特に 1024 より小さい (1023 以下の) ポート番号は特定の{{Glossary("protocol","プロトコル")}}にデフォルトで関連付けられています。 例えば、{{Glossary("HTTP")}}プロトコルのデフォルトポートは 80 番、HTTPS プロトコルのデフォルトポートは 443 番であり、{{Glossary("HTTP")}} サーバはこれらのポートへのリクエストを待ち受けます。インターネットプロトコルは、{{Glossary("SMTP")}} (25 番)、{{Glossary("POP3")}} (110 番)、{{Glossary("IMAP")}} (143 番)、{{Glossary("IRC")}} (194 番) など、それぞれデフォルトのポートが割り当てられています。 diff --git a/files/ja/glossary/prefetch/index.md b/files/ja/glossary/prefetch/index.md index 095acb6fdd1015..748242e8f88185 100644 --- a/files/ja/glossary/prefetch/index.md +++ b/files/ja/glossary/prefetch/index.md @@ -3,6 +3,8 @@ title: プリフェッチ slug: Glossary/Prefetch --- +{{GlossarySidebar}} + プリフェッチは、コンテンツが要求される可能性が高いことを前提にして、ユーザーが要求したときにコンテンツを即座にロードできるようにします。コンテンツはユーザーが明示的にリクエストすることなくダウンロードされ、将来の使用を想定してキャッシュされます。 ### DNS プリフェッチ diff --git a/files/ja/glossary/preflight_request/index.md b/files/ja/glossary/preflight_request/index.md index 701a46651c474e..9dc6c7f357bd0f 100644 --- a/files/ja/glossary/preflight_request/index.md +++ b/files/ja/glossary/preflight_request/index.md @@ -3,6 +3,8 @@ title: Preflight request (プリフライトリクエスト) slug: Glossary/Preflight_request --- +{{GlossarySidebar}} + CORS のプリフライトリクエストは {{Glossary("CORS")}} のリクエストの一つであり、サーバーが CORS プロトコルを理解していて準備がされていることを、特定のメソッドとヘッダーを使用してチェックします。 これは {{HTTPMethod("OPTIONS")}} リクエストであり、 {{HTTPHeader("Access-Control-Request-Method")}},{{HTTPHeader("Access-Control-Request-Headers")}}, {{HTTPHeader("Origin")}} の 3 つの HTTP リクエストヘッダー使用します。 diff --git a/files/ja/glossary/prerender/index.md b/files/ja/glossary/prerender/index.md index 995d4744048614..4bef6f607af2d9 100644 --- a/files/ja/glossary/prerender/index.md +++ b/files/ja/glossary/prerender/index.md @@ -3,6 +3,8 @@ title: Prerender slug: Glossary/Prerender --- +{{GlossarySidebar}} + プリレンダリングを使用すると、コンテンツは[先読み](/ja/docs/Glossary/Prefetch)され、ブラウザーによってバックグラウンドでレンダリングされます。これは、コンテンツが非表示の別のタブにレンダリングされた場合と同じです。ユーザーがプリレンダリングされたコンテンツに移動すると、現在のコンテンツがすぐにプリレンダリングされたコンテンツに置き換えられます。 ``` diff --git a/files/ja/glossary/presto/index.md b/files/ja/glossary/presto/index.md index 66910e6634f18e..4e8f78deb50937 100644 --- a/files/ja/glossary/presto/index.md +++ b/files/ja/glossary/presto/index.md @@ -3,6 +3,8 @@ title: Presto slug: Glossary/Presto --- +{{GlossarySidebar}} + Presto は、バージョン 15 までの {{Glossary("Opera browser")}} を強化する為に使用された独自のブラウザーレイアウトエンジンでした。それ以降の Opera browser は、 {{Glossary('Blink')}} レイアウトエンジンを使用する Chromium をベースにしています。 ## 関連項目 diff --git a/files/ja/glossary/primitive/index.md b/files/ja/glossary/primitive/index.md index 55c0f96a59459e..780b59d17ec83c 100644 --- a/files/ja/glossary/primitive/index.md +++ b/files/ja/glossary/primitive/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: 72e6429af2f0ad138223623fb2c86087a008d4dd --- +{{GlossarySidebar}} + {{Glossary("JavaScript")}} において、**プリミティブ** (primitive、プリミティブ値、プリミティブデータ型) は{{Glossary("object","オブジェクト")}}でなく、{{glossary("method","メソッド")}}を持たないデータのことです。 7 種類のプリミティブデータ型があります。 - {{Glossary("string","文字列")}} diff --git a/files/ja/glossary/privileged/index.md b/files/ja/glossary/privileged/index.md index 8d420079a6b79e..5e862a3c267e74 100644 --- a/files/ja/glossary/privileged/index.md +++ b/files/ja/glossary/privileged/index.md @@ -3,6 +3,8 @@ title: Privileged slug: Glossary/Privileged --- +{{GlossarySidebar}} + ユーザーは、システムに対する追加の権限が付与されている場合、または通常のユーザーと比較してより高い優先度レベルのコンテンツへの最終的なアクセス権が付与されている場合に、**特権がある**と言われます。 ## 関連項目 diff --git a/files/ja/glossary/privileged_code/index.md b/files/ja/glossary/privileged_code/index.md index 039f85c3fa3e63..78a4cf4ca3c4d8 100644 --- a/files/ja/glossary/privileged_code/index.md +++ b/files/ja/glossary/privileged_code/index.md @@ -3,6 +3,8 @@ title: privileged code slug: Glossary/Privileged_code --- +{{GlossarySidebar}} + **Privileged code** - 拡張機能の Javascript コード。例えば、コンテンツスクリプトのコード。 **Non-privileged** - Web ページ上の Javascript 。 diff --git a/files/ja/glossary/progressive_enhancement/index.md b/files/ja/glossary/progressive_enhancement/index.md index 3bdd0d02aad250..00106401bccccc 100644 --- a/files/ja/glossary/progressive_enhancement/index.md +++ b/files/ja/glossary/progressive_enhancement/index.md @@ -3,6 +3,8 @@ title: Progressive Enhancement (プログレッシブエンハンスメント) slug: Glossary/Progressive_Enhancement --- +{{GlossarySidebar}} + **プログレッシブエンハンスメント** (Progressive enhancement) とは、可能な限り多くのユーザーに不可欠なコンテンツと機能のベースラインを提供することを中心とした設計哲学であり、必要なすべてのコードを実行できる最新のブラウザーのユーザーに限り、最高の体験を提供します。 プログレッシブエンハンスメントの「プログレッシブ」とは、古いブラウザーや機能の限られた端末のユーザーには、よりシンプルでありながら良い使い勝手を実現し、同時に新しいブラウザーや機能が豊富な端末のユーザーには、より魅力的で充実したものへ**使い勝手を進化させる**設計であることを意味しているのです。 diff --git a/files/ja/glossary/progressive_web_apps/index.md b/files/ja/glossary/progressive_web_apps/index.md index f73da8e386ae9c..4eeee13f7e6470 100644 --- a/files/ja/glossary/progressive_web_apps/index.md +++ b/files/ja/glossary/progressive_web_apps/index.md @@ -3,6 +3,8 @@ title: "Progressive web apps\_(プログレッシブウェブアプリ)" slug: Glossary/Progressive_web_apps --- +{{GlossarySidebar}} + プログレッシブウェブアプリは、ウェブアプリ開発の現代的な姿を表す用語です。これには検索エンジンによる見つけやすさ、{{Glossary("URL")}} を使用したリンク、複数の形式要素で動作することなど、ウェブのあらゆる優れた部分を活用した標準的なウェブサイト/アプリを利用し、最新の API ([Service Workers](/ja/docs/Web/API/Service_Worker_API) や [Push](/ja/docs/Web/API/Push_API) など) やネイティブアプリに由来するさまざまな利点をより一般的にもたらす機能を提供すること含みます。 これらの機能は、インストール可能で、オフラインで動作し、簡単に同期できてユーザーがサーバーに簡単に再接続できます。 diff --git a/files/ja/glossary/promise/index.md b/files/ja/glossary/promise/index.md index 7d573a238fa575..1964da4a157175 100644 --- a/files/ja/glossary/promise/index.md +++ b/files/ja/glossary/promise/index.md @@ -3,6 +3,8 @@ title: Promise slug: Glossary/Promise --- +{{GlossarySidebar}} + **{{jsxref("Promise")}}** は、ある {{Glossary("function", "関数")}} が返す、呼び出された時点でまだ完了していない処理の結果をあらわす {{Glossary("object", "オブジェクト")}} です。その名のとおり、関数が `Promise` オブジェクトを経由して、最終的に何らかの結果を返すことを*約束*(Promise は約束の意味)するわけです。 {{Glossary("asynchronous", "非同期に")}} 処理をおこなう関数が処理を完了したとき、`Promise` オブジェクトに設置された **resolution** ハンドラ(または **fulfillment** ハンドラ、**completion** ハンドラ) が呼ばれて、呼び出し元の関数は処理の完了を知ることができます。 diff --git a/files/ja/glossary/property/css/index.md b/files/ja/glossary/property/css/index.md index 4db81a59000d35..3ae53c9651d54d 100644 --- a/files/ja/glossary/property/css/index.md +++ b/files/ja/glossary/property/css/index.md @@ -3,6 +3,8 @@ title: Property (プロパティ) (CSS) slug: Glossary/Property/CSS --- +{{GlossarySidebar}} + **CSS のプロパティ**は、関連付けられた値によりブラウザーがどのように要素を表示するかを定義する特性です。 以下に CSS のルールの例を示します: diff --git a/files/ja/glossary/property/index.md b/files/ja/glossary/property/index.md index ebb83b30523eeb..480a28462021ef 100644 --- a/files/ja/glossary/property/index.md +++ b/files/ja/glossary/property/index.md @@ -3,6 +3,8 @@ title: Property (プロパティ) slug: Glossary/Property --- +{{GlossarySidebar}} + **プロパティ**という用語はコンテキストに応じて幾つかの意味を持ちます。以下を参照してください: {{GlossaryDisambiguation}} diff --git a/files/ja/glossary/property/javascript/index.md b/files/ja/glossary/property/javascript/index.md index 1e2ac7b59287de..876401734e812d 100644 --- a/files/ja/glossary/property/javascript/index.md +++ b/files/ja/glossary/property/javascript/index.md @@ -3,6 +3,8 @@ title: Property (プロパティ) (JavaScript) slug: Glossary/Property/JavaScript --- +{{GlossarySidebar}} + **JavaScript プロパティ**は、多くの場合データ構造と関連付けられた属性を記述する、オブジェクトの特性です。 プロパティは 2 種類あります。 diff --git a/files/ja/glossary/protocol/index.md b/files/ja/glossary/protocol/index.md index 019919ccbdaa95..c6419be0549c04 100644 --- a/files/ja/glossary/protocol/index.md +++ b/files/ja/glossary/protocol/index.md @@ -3,6 +3,8 @@ title: Protocol (プロトコル) slug: Glossary/Protocol --- +{{GlossarySidebar}} + **プロトコル**は、コンピューター内またはコンピューター間でデータを交換する方法を定義したルールの体系です。機器間の通信では、交換されるデータの形式に機器が対応している必要があります。形式を定義する一連のルールがプロトコルと呼ばれています。 ## 理解を深める diff --git a/files/ja/glossary/prototype-based_programming/index.md b/files/ja/glossary/prototype-based_programming/index.md index 98c0d2d9224791..2074cddca6a967 100644 --- a/files/ja/glossary/prototype-based_programming/index.md +++ b/files/ja/glossary/prototype-based_programming/index.md @@ -3,6 +3,8 @@ title: プロトタイプベース slug: Glossary/Prototype-based_programming --- +{{GlossarySidebar}} + **プロトタイプベース**は、{{Glossary('OOP', 'オブジェクト指向プログラミング')}}のひとつで、{{Glossary('Class', 'クラス')}}を明示的に定義するのではなく、別のクラスのインスタンスや、あまり見かけませんが、空のオブジェクトにプロパティやメソッドを追加するという手法をとっています。 簡単に言えば、この手法は{{Glossary('Class', 'クラス')}}をはじめに定義することなしに{{Glossary('Object', 'オブジェクト')}}を生成することを可能にします。 diff --git a/files/ja/glossary/prototype/index.md b/files/ja/glossary/prototype/index.md index 2bcf914b36f22d..a6c7cc35f6f853 100644 --- a/files/ja/glossary/prototype/index.md +++ b/files/ja/glossary/prototype/index.md @@ -3,6 +3,8 @@ title: Prototype slug: Glossary/Prototype --- +{{GlossarySidebar}} + プロトタイプは、開発ライフサイクルの早い段階でアプリケーションや製品の外観と動作を表現する型です。 [継承とプロトタイプチェーン](/ja/docs/Web/JavaScript/Inheritance_and_the_prototype_chain) をご覧ください。 diff --git a/files/ja/glossary/proxy_server/index.md b/files/ja/glossary/proxy_server/index.md index 480a734f13c824..8056c1c4628bb1 100644 --- a/files/ja/glossary/proxy_server/index.md +++ b/files/ja/glossary/proxy_server/index.md @@ -3,6 +3,8 @@ title: Proxy server (プロキシサーバー) slug: Glossary/Proxy_server --- +{{GlossarySidebar}} + **プロキシサーバー**は、インターネットのさまざまなネットワークを介してナビゲートするときに使用される中間プログラムまたはコンピュータです。それらは World Wide Web 上のコンテンツへのアクセスを容易にします。プロキシはリクエストに介入し、レスポンスを返します。(例えば、キャッシュの場合) リクエストを転送することができ、それを変更することができます (例えば、2 つのネットワーク間の境界でヘッダを変更する)。 プロキシは、ユーザーのローカルコンピューター上、またはユーザーのコンピューターとインターネット上の宛先サーバーの間のどこにでも置くことができます。 一般に、プロキシサーバーには 2 つの主要な種類があります。 diff --git a/files/ja/glossary/pseudo-class/index.md b/files/ja/glossary/pseudo-class/index.md index ee926c24ae9948..5e8819de834246 100644 --- a/files/ja/glossary/pseudo-class/index.md +++ b/files/ja/glossary/pseudo-class/index.md @@ -3,6 +3,8 @@ title: Pseudo-class slug: Glossary/Pseudo-class --- +{{GlossarySidebar}} + CSS では**擬似クラス**セレクターを使うことで、ドキュメントツリーからの情報ではなく、その状態によって、対象の要素を指定することができます。例えば、セレクター `a`{{ cssxref(":visited") }} は、ユーザーがすでに訪問したリンクだけに、スタイルを適用することができます。 ## 関連項目 diff --git a/files/ja/glossary/pseudo-element/index.md b/files/ja/glossary/pseudo-element/index.md index 863c41f846cefb..2b026609a0724a 100644 --- a/files/ja/glossary/pseudo-element/index.md +++ b/files/ja/glossary/pseudo-element/index.md @@ -3,6 +3,8 @@ title: Pseudo-element slug: Glossary/Pseudo-element --- +{{GlossarySidebar}} + CSS では**擬似要素**セレクターを使うことで、選択すべき特定の HTML 要素がない状況でも、ドキュメントのコンテンツの一部に、スタイルを適用できます。例えば、各段落の最初の文字を、それぞれの要素の中に置いていくのではなく、`p`{{ Cssxref("::first-letter") }} で、それらのすべてに、スタイルを指定することができます。 ## 関連項目 diff --git a/files/ja/glossary/pseudocode/index.md b/files/ja/glossary/pseudocode/index.md index 59b8b1f5d1835a..1c4a2fbe5495fa 100644 --- a/files/ja/glossary/pseudocode/index.md +++ b/files/ja/glossary/pseudocode/index.md @@ -3,6 +3,8 @@ title: Pseudocode (擬似コード) slug: Glossary/Pseudocode --- +{{GlossarySidebar}} + 擬似コードは人間に対し、コード構文がどのようにはたらいているかを示す、あるいはコード設計のある項目の意図を表現するために広く用いられる、コードのような構文を意味します。実際にコードとして実行しようとしても、**うまく動作しない**でしょう。 ## 関連情報 diff --git a/files/ja/glossary/public-key_cryptography/index.md b/files/ja/glossary/public-key_cryptography/index.md index 9b0e610125f850..857b934d8340ef 100644 --- a/files/ja/glossary/public-key_cryptography/index.md +++ b/files/ja/glossary/public-key_cryptography/index.md @@ -3,6 +3,8 @@ title: Public-key cryptography (公開鍵暗号) slug: Glossary/Public-key_cryptography --- +{{GlossarySidebar}} + 公開鍵暗号 — または*非対称暗号* — は、対となる鍵による暗号システムです。一方の鍵によって行われた変換は、もう一方の鍵によってしか元に戻せません。一方の鍵 (_秘密鍵_) は秘匿しておき、もう一方の鍵は公開します。 デジタル署名で使用する場合、署名の生成に秘密鍵が使用され、検証に公開鍵が使用されます。つまり、誰でも署名を検証することができますが、対応する秘密鍵の所有者のみが署名を生成することができます。 diff --git a/files/ja/glossary/python/index.md b/files/ja/glossary/python/index.md index 4231327bf16cfa..7cc83e5ad161cd 100644 --- a/files/ja/glossary/python/index.md +++ b/files/ja/glossary/python/index.md @@ -3,6 +3,8 @@ title: Python slug: Glossary/Python --- +{{GlossarySidebar}} + **Python**は、一般目的の高水準プログラミング言語です。複数のパラダイムを採用しており、手続型、オブジェクト指向、いくらか関数型プログラミングの構造に対応しています。 Python は、 ABC と呼ばれている別な言語の後継として、 Guido van Rossum によって 1985 年から 1990 年の間に開発され、現在ではウェブ開発、他のアプリケーションのスクリプト言語、実際のアプリケーション構築など、広い分野で使用されています。 diff --git a/files/ja/glossary/quality_values/index.md b/files/ja/glossary/quality_values/index.md index 748cc7d704a775..e044931f8a397b 100644 --- a/files/ja/glossary/quality_values/index.md +++ b/files/ja/glossary/quality_values/index.md @@ -3,6 +3,8 @@ title: Quality values slug: Glossary/Quality_values --- +{{GlossarySidebar}} + **品質値**、もしくは q 値と q ファクターは、値の優先順位をコンマ区切りのリストで記述するために使用されます。これはいくつかの [HTTP ヘッダー](/ja/docs/Web/HTTP/Headers)と HTML で許される特別な構文です。 値の重要性はサフィックス `';q='` の直後に `0` と `1` の間の値が含まれ、最大 3 つの 10 進数で最高の優先度を示します。存在しない場合、デフォルト値は `1` です。 ## 例 diff --git a/files/ja/glossary/quaternion/index.md b/files/ja/glossary/quaternion/index.md index 2a24948729bb44..cc4e3d84dbcd19 100644 --- a/files/ja/glossary/quaternion/index.md +++ b/files/ja/glossary/quaternion/index.md @@ -3,6 +3,8 @@ title: Quaternion (四元数) slug: Glossary/Quaternion --- +{{GlossarySidebar}} + **四元数**は、2 つの 3D ベクトルの商であり、3D グラフィックや加速度計ベースのセンサーで、方位や回転のデータを表現するために使用されます。 数学的な四元数はこれよりも複雑ですが、例えば [WebGL](/ja/docs/Glossary/WebGL) や [WebXR](/ja/docs/Web/API/WebXR_Device_API) を使用して回転を表現するための**単位四元数** (または**回転四元数**) は、3D ポイントと同じ構文を使用して表されます。そのため、{{domxref("DOMPoint")}} (または {{domxref("DOMPointReadOnly")}}) という型を使って四元数を格納します。 diff --git a/files/ja/glossary/quic/index.md b/files/ja/glossary/quic/index.md index f0ead8dbe009bb..12bbcc33aaee04 100644 --- a/files/ja/glossary/quic/index.md +++ b/files/ja/glossary/quic/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: 4bd65a01204446af2254bb8864bd22ad87bc86b0 --- +{{GlossarySidebar}} + **QUIC** は、UDP で実装された多重化トランスポートプロトコルです。HTTP/3 のトランスポート層として {{Glossary("TCP")}} の代わりに使用されます。 QUIC は、HTTP 接続のセットアップの迅速化と遅延の低減を提供するために設計されました。具体的には、以下の通りです。 diff --git a/files/ja/glossary/rail/index.md b/files/ja/glossary/rail/index.md index 0162506e1cf00e..9c5388ee43b317 100644 --- a/files/ja/glossary/rail/index.md +++ b/files/ja/glossary/rail/index.md @@ -3,6 +3,8 @@ title: RAIL slug: Glossary/RAIL --- +{{GlossarySidebar}} + **RAIL** とは、**Response, Animation, Idle, Load** の頭文字をとったもので、2015 年に Google Chrome チームが発案した、ブラウザー内のユーザーエクスペリエンスとパフォーマンスにフォーカスしたパフォーマンスモデルです。RAIL におけるパフォーマンスとは、"特定のデバイスでサイトを高速化させることではなく、ユーザーを幸せにすること"です。インタラクションには、ページロード、アイドル状態、入力への応答、スクロールとアニメーションの 4 つのステージがあります。各項目については、以下に頭文字順に解説します。 - **Response** diff --git a/files/ja/glossary/raster_image/index.md b/files/ja/glossary/raster_image/index.md index 995b828090596d..09ae23443e836f 100644 --- a/files/ja/glossary/raster_image/index.md +++ b/files/ja/glossary/raster_image/index.md @@ -3,6 +3,8 @@ title: ラスターイメージ (Raster Image) slug: Glossary/Raster_image --- +{{GlossarySidebar}} + **_ラスター画像_** (raster Image) とは、ピクセルのグリッドとして定義されている画像です。ビットマップ (bitmaps) としても参照されます。[JPEG](/ja/docs/Glossary/jpeg)、[PNG](/ja/docs/Glossary/PNG)、[GIF](/ja/docs/Glossary/gif)、[ICO]() は、ウェブでよく使われるラスター画像の形式です。 普通ではラスター画像のファイルは 1 つの解像度のみ含まれていますが favicon でよく使用される ICO、CUR フォーマットと [CSS カーソル画像](/ja/docs/Web/CSS/cursor)には複数のサイズが含まれている場合があります。 diff --git a/files/ja/glossary/recursion/index.md b/files/ja/glossary/recursion/index.md index bfd06d0fe6193e..a17b0f8b00ed7a 100644 --- a/files/ja/glossary/recursion/index.md +++ b/files/ja/glossary/recursion/index.md @@ -3,6 +3,8 @@ title: Recursion (再帰) slug: Glossary/Recursion --- +{{GlossarySidebar}} + 関数が自分自身を呼び出す動作、再帰は問題がより小さな小問題から成っている場合に解決するのに使われます。再帰関数は、ベースケース (再帰終了) と再帰ケース (再帰再開) の 2 種類の入力を受け取る可能性があります。 ## 例 diff --git a/files/ja/glossary/reflow/index.md b/files/ja/glossary/reflow/index.md index ac25d5e261971d..f592450132e210 100644 --- a/files/ja/glossary/reflow/index.md +++ b/files/ja/glossary/reflow/index.md @@ -3,6 +3,8 @@ title: Reflow slug: Glossary/Reflow --- +{{GlossarySidebar}} + インタラクティブサイトでの更新後など、 {{glossary("browser")}} が Web ページの一部または全てを再度処理して描画する必要がある場合、**リフロー** が発生します。 ## 関連項目 diff --git a/files/ja/glossary/regular_expression/index.md b/files/ja/glossary/regular_expression/index.md index 6f752cabc716c4..5d2dade45ee9e7 100644 --- a/files/ja/glossary/regular_expression/index.md +++ b/files/ja/glossary/regular_expression/index.md @@ -3,6 +3,8 @@ title: Regular expression (正規表現) slug: Glossary/Regular_expression --- +{{GlossarySidebar}} + **正規表現** (または _regex_) は、検索でどの文字の連続が出てくるのかを決めるルールです。 正規表現はさまざまな言語で実装されてますが、一番有名な実装は Perl による実装です。それは  PCRE (_Perl Compatible Regular Expression_) といわれる独自の実装エコシステムを生み出しました。ウェブ上では、{{glossary("JavaScript")}} は {{jsxref("RegExp")}} オブジェクトを介して別の正規表現の実装を提供します。 diff --git a/files/ja/glossary/rendering_engine/index.md b/files/ja/glossary/rendering_engine/index.md index 1159b2264c4569..f55bae782e3e24 100644 --- a/files/ja/glossary/rendering_engine/index.md +++ b/files/ja/glossary/rendering_engine/index.md @@ -3,6 +3,8 @@ title: Rendering engine (レンダリングエンジン) slug: Glossary/Rendering_engine --- +{{GlossarySidebar}} + **レンダリングエンジン**は画面にテキストと画像を描画するソフトウェアです。このエンジンは構造化文書 (たいてい {{glossary("HTML")}}) を描画して、所与のスタイル定義 (たいてい {{glossary("CSS")}} にて与えられる) に基づいて整形します。レイアウトエンジンの例としては、 {{glossary("Blink")}}, {{glossary("Gecko")}}, EdgeHTML, {{glossary("WebKit")}} があります。 ## 詳細情報 diff --git a/files/ja/glossary/repo/index.md b/files/ja/glossary/repo/index.md index 0539f32ba71be5..0d4545080a3718 100644 --- a/files/ja/glossary/repo/index.md +++ b/files/ja/glossary/repo/index.md @@ -3,7 +3,7 @@ title: Repo (リポジトリ) slug: Glossary/Repo --- -{{QuickLinksWithSubpages("/ja/docs/Glossary")}} +{{GlossarySidebar}} {{Glossary("Git")}}、{{Glossary("SVN")}}のようなバージョン管理システムでは、リポジトリ(repo)とはアプリケーションのソースコードと、さまざまなメタデータが一緒にホスティングされる場所です。 diff --git a/files/ja/glossary/reporting_directive/index.md b/files/ja/glossary/reporting_directive/index.md index 86a1b943aa8065..0de32dce0612f6 100644 --- a/files/ja/glossary/reporting_directive/index.md +++ b/files/ja/glossary/reporting_directive/index.md @@ -3,6 +3,8 @@ title: Reporting directive (報告ディレクティブ) slug: Glossary/Reporting_directive --- +{{GlossarySidebar}} + **{{Glossary("CSP")}} の報告ディレクティブ**は {{HTTPHeader("Content-Security-Policy")}} ヘッダーで使用され、 CSP 違反の報告過程を制御します。 完全な一覧については[報告ディレクティブ](/ja/docs/Web/HTTP/Headers/Content-Security-Policy#reporting_directives)を参照してください。 diff --git a/files/ja/glossary/representation_header/index.md b/files/ja/glossary/representation_header/index.md index c22d61739ea522..6589000501acd7 100644 --- a/files/ja/glossary/representation_header/index.md +++ b/files/ja/glossary/representation_header/index.md @@ -3,6 +3,8 @@ title: Representation header (表現ヘッダー) slug: Glossary/Representation_header --- +{{GlossarySidebar}} + **表現ヘッダー** (representation header) は {{glossary("HTTP_header", "HTTP ヘッダー")}}のうち、 HTTP メッセージの本文で送られる特定の*表現*を説明するものです。 表現とは、特定のリソースをさまざまな形で表現したものです。 diff --git a/files/ja/glossary/request_header/index.md b/files/ja/glossary/request_header/index.md index 97dd78ea85d054..d38a15919de573 100644 --- a/files/ja/glossary/request_header/index.md +++ b/files/ja/glossary/request_header/index.md @@ -3,6 +3,8 @@ title: Request header (リクエストヘッダー) slug: Glossary/Request_header --- +{{GlossarySidebar}} + **リクエストヘッダー**は、 HTTP リクエストで使用される {{glossary("header", "HTTP ヘッダー")}}であり、メッセージの内容には関連しないものです。 {{HTTPHeader("Accept")}}, {{HTTPHeader("Accept-Language", "Accept-*")}}, {{HTTPHeader("If-Modified-Since", "If-*")}} などのリクエストヘッダーは、条件付きリクエストを行うことができます。他の {{HTTPHeader("Cookie")}}, {{HTTPHeader("User-Agent")}}, {{HTTPHeader("Referer")}} などはサーバーが回答を作成するための文脈を明確にします。 リクエストに現れるすべてのヘッダーが*リクエストヘッダー*であるとは限りません。例えば、 {{HTTPMethod("POST")}} リクエストの中に現れる {{HTTPHeader("Content-Length")}} は、実際にはリクエストメッセージの本文の長さを表す{{glossary("entity header", "エンティティヘッダー")}}です。しかし、これらのエンティティヘッダーもそのような場面ではリクエストヘッダーと呼ばれることがよくあります。 diff --git a/files/ja/glossary/response_header/index.md b/files/ja/glossary/response_header/index.md index f36f7d3454f047..d2ea29f1c7cd23 100644 --- a/files/ja/glossary/response_header/index.md +++ b/files/ja/glossary/response_header/index.md @@ -3,6 +3,8 @@ title: Response header (レスポンスヘッダー) slug: Glossary/Response_header --- +{{GlossarySidebar}} + **レスポンスヘッダー**は、 HTTP レスポンスで使用できる {{glossary("header", "HTTP ヘッダー")}}で、メッセージの内容には関連しないものです。 {{HTTPHeader("Age")}}, {{HTTPHeader("Location")}}, {{HTTPHeader("Server")}} のようなレスポンスヘッダーは、レスポンスのものより詳細な文脈を提供するために使用されます。 レスポンスに現れるすべてのヘッダーが仕様書で*レスポンスヘッダー*に分類されている訳ではありません。例えば {{HTTPHeader("Content-Length")}} ヘッダーは*表現メタデータヘッダー*であり、レスポンスメッセージの本文の長さを表します (そして、古いバージョンの仕様書では{{glossary("entity header", "エンティティヘッダー")}}でした)。しかし、これらのエンティティヘッダーもそのような場面ではレスポンスヘッダーと呼ばれることがよくあります。 diff --git a/files/ja/glossary/responsive_web_design/index.md b/files/ja/glossary/responsive_web_design/index.md index 43025fd233e408..7ad9a956755a93 100644 --- a/files/ja/glossary/responsive_web_design/index.md +++ b/files/ja/glossary/responsive_web_design/index.md @@ -3,6 +3,8 @@ title: Responsive web design (レスポンシブウェブデザイン) slug: Glossary/Responsive_web_design --- +{{GlossarySidebar}} + _レスポンシブウェブデザイン_ (**RWD**) とはサイトの見た目と挙動を、デスクトップからモバイルまで全てのパーソナルコンピューティングデバイスにとって、最適化することに焦点を当てたウェブ開発の概念です。 ## 詳細情報 diff --git a/files/ja/glossary/rest/index.md b/files/ja/glossary/rest/index.md index f736f80b16af39..e234a3f0656c5a 100644 --- a/files/ja/glossary/rest/index.md +++ b/files/ja/glossary/rest/index.md @@ -3,6 +3,8 @@ title: REST slug: Glossary/REST --- +{{GlossarySidebar}} + **REST** (Representational State Transfer) は、効率的で信頼性が高く、スケーラブルな分散システムを実現するためのソフトウェアアーキテクチャ設計上の一連の制約条件のことです。 REST の基本的な考え方は、リソース、たとえば文書が、よく認識され、言語にとらわれず、確実に標準化されたクライアント/サーバーのやりとりで転送するというものです。サービスがこれらの制約に準拠している場合、 RESTful とみなされます。 diff --git a/files/ja/glossary/rgb/index.md b/files/ja/glossary/rgb/index.md index 4b408bc41ffd46..797a381d873942 100644 --- a/files/ja/glossary/rgb/index.md +++ b/files/ja/glossary/rgb/index.md @@ -3,6 +3,8 @@ title: RGB slug: Glossary/RGB --- +{{GlossarySidebar}} + RGB は、赤、緑、青という 3 つの基本要素(またはチャネル)を混ぜ合わせることで表現されるカラーモデルです。各色は、最終的な色を決定する際、赤、緑、青それぞれの強度を示す 3 つの数字のシーケンス (通常は 0.0〜1.0、または 0〜255) で表されます。 There are many ways to describe the RGB components of a color. In {{Glossary("CSS")}} they can be represented as a single 24-bit integer in hexadecimal notation (for example, `#add8e6` is light blue), or in functional notation as three separate 8-bit integers (for example, rgb(46, 139, 87) is sea green). In {{Glossary("OpenGL")}}, {{Glossary("WebGL")}}, and {{Glossary("GLSL")}} the red-green-blue components are fractions (floating-point numbers between 0.0 and 1.0), although in the actual color buffer they are typically stored as 8-bit integers. Graphically, a color can be represented as a point in a three-dimensional grid or cube, where each dimension (or axis) corresponds to a different channel. diff --git a/files/ja/glossary/rng/index.md b/files/ja/glossary/rng/index.md index bd6607181b5919..9189787c4419a7 100644 --- a/files/ja/glossary/rng/index.md +++ b/files/ja/glossary/rng/index.md @@ -3,6 +3,8 @@ title: Random Number Generator (乱数発生器) slug: Glossary/RNG --- +{{GlossarySidebar}} + **PRNG** (擬似乱数発生器) は、複雑で、予測できないように見えるパターンの数字を出力するためのアルゴリズムです。真の乱数 (放射性線源など) はまったく予測できないのに対し、すべてのアルゴリズムは予測可能なので、 PRNG は、開始パラメーターや*シード*が同じときには同じ数値を返します。 疑似乱数はゲームなど、様々な応用分野で使用されています。 @@ -21,9 +23,6 @@ slug: Glossary/RNG - Wikipedia の[擬似乱数](https://ja.wikipedia.org/wiki/擬似乱数) - JavaScript の組み込み PRNG 関数である {{jsxref("Math.random()")}}。これは暗号学的に安全な PRNG ではありません。 - {{domxref("Crypto.getRandomValues()")}}: 暗号学的に安全な数値を提供するためのものです。 - - - - {{domxref("RandomSource")}} - {{jsxref("Math.random()")}} - {{domxref("Crypto.getRandomValues()")}} diff --git a/files/ja/glossary/robots.txt/index.md b/files/ja/glossary/robots.txt/index.md index ed78c2693f355e..2798df8f6c3f96 100644 --- a/files/ja/glossary/robots.txt/index.md +++ b/files/ja/glossary/robots.txt/index.md @@ -3,6 +3,8 @@ title: Robots.txt slug: Glossary/Robots.txt --- +{{GlossarySidebar}} + Robots.txt は通常、ウェブサイトのルートに配置されているファイルです。このファイルは、{{Glossary("crawler", "クローラー")}} からウェブサイトへのアクセスを許可するか、禁止するかを決定します。 例えば、サイト管理者はクローラーが特定のフォルダー(とそこに含まれるすべてのファイル)にアクセスしたり、特定ファイルをクロールするのを禁止でき、通常はこれらのファイルが他の検索エンジンによってインデックスされることを防ぐために使われます。 diff --git a/files/ja/glossary/round_trip_time/index.md b/files/ja/glossary/round_trip_time/index.md index 20f2abb08351cd..3e52419abfb171 100644 --- a/files/ja/glossary/round_trip_time/index.md +++ b/files/ja/glossary/round_trip_time/index.md @@ -3,6 +3,8 @@ title: Round Trip Time (ラウンドトリップタイム) slug: Glossary/Round_Trip_Time --- +{{GlossarySidebar}} + **ラウンドトリップタイム (RTT)** とは、データパケットが宛先に送信されるのにかかる時間と、そのパケットの確認応答が発信元で受信されるのにかかる時間の長さです。ネットワークとサーバー間の RTT は、`ping` コマンドを使用して計測できます。 ```bash diff --git a/files/ja/glossary/routers/index.md b/files/ja/glossary/routers/index.md index 83605a7fc9bec6..5b6891497c45b4 100644 --- a/files/ja/glossary/routers/index.md +++ b/files/ja/glossary/routers/index.md @@ -3,6 +3,8 @@ title: Router (ルーター) slug: Glossary/Routers --- +{{GlossarySidebar}} + ウェブでは**ルーター**には 3 つの定義があります。 1. ネットワーク層において、ルーターはデータ{{Glossary('Packet','パケット')}}の方向を決めるネットワーク機器です。これらは、ユーザーがインターネットに接続できるように小売店で販売されています。 diff --git a/files/ja/glossary/rss/index.md b/files/ja/glossary/rss/index.md index 6e16349478c54f..8f59f3c4fa9b6c 100644 --- a/files/ja/glossary/rss/index.md +++ b/files/ja/glossary/rss/index.md @@ -3,6 +3,8 @@ title: RSS slug: Glossary/RSS --- +{{GlossarySidebar}} + **RSS** (Really Simple Syndication) は、サイトの更新情報を配信するためにデザインされた XML ドキュメント形式です。RSS を購読すると、ウェブサイトはフィードと呼ばれる RSS ドキュメントで更新情報を RSS リーダーに送信するため、購読者はお気に入りのウェブサイトをすべて手動でチェックする必要がなくなります。 ## 詳細情報 diff --git a/files/ja/glossary/rtf/index.md b/files/ja/glossary/rtf/index.md index 4209dbdc8a5c09..ad89a66c3f6a5b 100644 --- a/files/ja/glossary/rtf/index.md +++ b/files/ja/glossary/rtf/index.md @@ -3,6 +3,8 @@ title: RTF slug: Glossary/RTF --- +{{GlossarySidebar}} + RTF (リッチテキストフォーマット) は書式設定 (例:太字、イタリック) をサポートしたプレーンテキストベースのファイルフォーマットです。 1980 年代に Microsoft Word チームの 3 人のプログラマーが RTF を作り、Microsoft が 2008 年まで開発していました。開発が終了した現在でも多くの文書処理プログラムが RTF を読み書きできます。 diff --git a/files/ja/glossary/rtl/index.md b/files/ja/glossary/rtl/index.md index 19c69cf932f650..90e00468a82136 100644 --- a/files/ja/glossary/rtl/index.md +++ b/files/ja/glossary/rtl/index.md @@ -3,6 +3,8 @@ title: RTL (右書き) slug: Glossary/RTL --- +{{GlossarySidebar}} + **RTL** (**Right To Left**, 右書き) は、テキストが右から左へ書かれることを示す {{Glossary("locale")}} プロパティです。例えば、`he` ロケール (ヘブライ語) は右書きを定義します。アラビア語 (`ar`) も右書きで書かれる有名な言語です。 RTL とは対照的に、LTR (Left To Right, 左書き) は、英語 (`en`, `en-US`, `en-GB`, など)、スペイン語 (`es`)、フランス語 (`fr`) などの他の言語で使用されます。 diff --git a/files/ja/glossary/rtsp/index.md b/files/ja/glossary/rtsp/index.md index 4bc111bd760399..858e4e2601f776 100644 --- a/files/ja/glossary/rtsp/index.md +++ b/files/ja/glossary/rtsp/index.md @@ -3,6 +3,8 @@ title: "RTSP: Real-time streaming protocol" slug: Glossary/RTSP --- +{{GlossarySidebar}} + Real-time streaming protocol (RTSP) はネットワークプロトコルの一つで、{{glossary("server", "サーバー")}}と{{glossary("client", "クライアント")}}の間でどのようにメディアのストリーミングが行われるかを制御するものです。基本的に、 RTSP は動画をストリーミングするときに \[一時停止]/\[再生] をクリックしたときに何が起こるかを記述するためのプロトコルです。コンピューターがリモコンであり、ストリーミングサーバーがテレビであった場合、 RTSP はテレビに作用するリモコンの操作の方法を記述します。 ## より詳しく知る diff --git a/files/ja/glossary/ruby/index.md b/files/ja/glossary/ruby/index.md index a5d4f3d20e7c9a..d4dfc6fdba1960 100644 --- a/files/ja/glossary/ruby/index.md +++ b/files/ja/glossary/ruby/index.md @@ -3,6 +3,8 @@ title: Ruby slug: Glossary/Ruby --- +{{GlossarySidebar}} + **Ruby** はオープンソースのプログラミング言語です。{{glossary("world wide web","Web")}} コンテキストでは、Ruby はウェブサイト/アプリを生産するための _Ruby On Rails_ (ROR) フレームワークと一緒にサーバー・サイドでよく使用されます。 ルビはまた、HTML で東アジアのテキストを強調して発音情報を与える方法でもあります; {{HTMLElement("ruby")}} 要素を見てください。 diff --git a/files/ja/glossary/safe/http/index.md b/files/ja/glossary/safe/http/index.md index ce1d19f5001bd7..44cef9a097c232 100644 --- a/files/ja/glossary/safe/http/index.md +++ b/files/ja/glossary/safe/http/index.md @@ -3,6 +3,8 @@ title: Safe (安全) (HTTP メソッド) slug: Glossary/Safe/HTTP --- +{{GlossarySidebar}} + HTTP メソッドが**安全**であるとは、その HTTP メソッドがサーバーの状態を変更しないということです。言い換えれば、読み取り専用操作につながる場合、メソッドは安全です。一般的な HTTP メソッドのうちでは {{HTTPMethod("GET")}}, {{HTTPMethod("HEAD")}}, {{HTTPMethod("OPTIONS")}} が安全です。安全な HTTP メソッドはすべて{{glossary("idempotent", "べき等")}}でもあります。しかし、すべてのべき等なメソッドが安全とは限りません。例えば、 {{HTTPMethod("PUT")}} や {{HTTPMethod("DELETE")}} はべき等ですが、安全ではありません。 安全なメソッドは、意味の上では読み取り専用ですが、実際にはサーバーは状態を変更することもあります。例えば、サーバーはログを記録したり、統計情報を保存したりできます。ここで重要なことは、安全なメソッドを呼び出すことによって、クライアント自体はサーバー変更を要求していないため、サーバーに不必要な負荷や責務をかけないことです。ブラウザーは、サーバーに何らかの害を及ぼすことを心配することなく安全なメソッドを呼び出すことができます。これにより、リスクなしで先読みなどの操作を実行できます。また、ウェブクローラーも、安全なメソッドの呼び出しに依拠しています。 diff --git a/files/ja/glossary/safe/index.md b/files/ja/glossary/safe/index.md index c21fe0fe090f80..4b0991f51a6942 100644 --- a/files/ja/glossary/safe/index.md +++ b/files/ja/glossary/safe/index.md @@ -3,6 +3,8 @@ title: Safe (安全) slug: Glossary/Safe --- +{{GlossarySidebar}} + **安全**という用語は、文脈によって意味が異なることがあります。以下の可能性があります。 {{GlossaryDisambiguation}} diff --git a/files/ja/glossary/same-origin_policy/index.md b/files/ja/glossary/same-origin_policy/index.md index 2411b02b503583..a7420ba2a3afea 100644 --- a/files/ja/glossary/same-origin_policy/index.md +++ b/files/ja/glossary/same-origin_policy/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: 4bd65a01204446af2254bb8864bd22ad87bc86b0 --- +{{GlossarySidebar}} + **[同一オリジンポリシー](/ja/docs/Web/Security/Same-origin_policy)**は、重要なセキュリティの仕組みであり、ある{{Glossary("origin", "オリジン")}}から読み込まれた文書やスクリプトが、どのように他のオリジンからのリソースと対話することができるかを制限するものです。 悪意ある行動を起こしかねないリソースを分離し、攻撃の可能性を縮小するのに役立ちます。 diff --git a/files/ja/glossary/scm/index.md b/files/ja/glossary/scm/index.md index 7cb8d76444d1bb..2a39f598a3f810 100644 --- a/files/ja/glossary/scm/index.md +++ b/files/ja/glossary/scm/index.md @@ -3,6 +3,8 @@ title: SCM slug: Glossary/SCM --- +{{GlossarySidebar}} + SCM (Source Control Management) は、ソースコードを管理するための仕組みです。一般には、プログラムソースファイルのバージョン管理を行うソフトウェアの総称です。SCM は、ソースコードを誰がどのように変更を行ったかの履歴を保存しているため、プログラマーは有用な部分を消してしまう心配をすることなく、プログラムソースファイルを追加、変更、削除できます。 代表的な SCM として、CVS、SVN、GIT があります。 diff --git a/files/ja/glossary/scope/index.md b/files/ja/glossary/scope/index.md index b1f603f7688fd1..a2878d549adc38 100644 --- a/files/ja/glossary/scope/index.md +++ b/files/ja/glossary/scope/index.md @@ -3,6 +3,8 @@ title: Scope (スコープ) slug: Glossary/Scope --- +{{GlossarySidebar}} + 実行の現在のコンテキスト。{{glossary("value","値")}} と**式**が「見える」、または参照できる文脈。**{{glossary("variable","変数")}}**や他の式が "現在のスコープ内にない" 場合、使用できません。スコープを階層構造で階層化して、子スコープから親スコープにアクセスできるようにすることもできますが、その逆はできません。 **{{glossary("function", "関数")}}**は {{glossary("JavaScript")}} の**クロージャ**として機能し、すなわちスコープを作成して、 (例えば) 関数内で排他的に定義された変数に、関数の外側からや他の関数の中からアクセスできないようになります。たとえば、以下は無効です。 diff --git a/files/ja/glossary/screen_reader/index.md b/files/ja/glossary/screen_reader/index.md index 0341e7e34b5b0b..55f8c136596788 100644 --- a/files/ja/glossary/screen_reader/index.md +++ b/files/ja/glossary/screen_reader/index.md @@ -3,6 +3,8 @@ title: Screen reader (スクリーンリーダー) slug: Glossary/Screen_reader --- +{{GlossarySidebar}} + スクリーンリーダーは、画面に表示された内容を視覚以外の方法で伝えるソフトウェアアプリケーションのことです。通常はテキストを音声に変換しますが、点字や音声アイコンに変換することもあります。スクリーンリーダーは、目の不自由な方には欠かせませんし、視覚障碍者や読み書きのできない方、学習障碍のある方にも役立ちます。ブラウザーの拡張機能を利用したスクリーンリーダーもありますが、ほとんどのスクリーンリーダーは、ブラウザーだけでなく、すべてのユーザーのアプリケーションに対してシステム全体で動作します。 ウェブアクセシビリティに関しては、ほとんどのユーザーエージェントがアクセシビリティオブジェクトモデルを提供し、スクリーンリーダーは、さまざまなオペレーティングシステムの機能を使用し、フック技術を使用して専用のアクセシビリティ API と対話します。 diff --git a/files/ja/glossary/script-supporting_element/index.md b/files/ja/glossary/script-supporting_element/index.md index 6e83158f1ab717..877f4ff81181fb 100644 --- a/files/ja/glossary/script-supporting_element/index.md +++ b/files/ja/glossary/script-supporting_element/index.md @@ -3,6 +3,8 @@ title: Script-supporting element (スクリプト対応要素) slug: Glossary/Script-supporting_element --- +{{GlossarySidebar}} + {{Glossary("HTML")}} 文書において、**スクリプト対応要素**はページの表示やレイアウトに直接貢献しない要素です。その代わり、スクリプト自体やスクリプトからのみ使用される情報を持っています。これらの要素は重要な場合もありますが、ページのスクリプトが正確に作用しなければ表示されているページに影響しません。 スクリプト対応要素は {{HTMLElement("script")}} 及び {{HTMLElement("template")}} の 2 つしかありません。 diff --git a/files/ja/glossary/scroll_container/index.md b/files/ja/glossary/scroll_container/index.md index 71393237cbe091..2f1785070960b6 100644 --- a/files/ja/glossary/scroll_container/index.md +++ b/files/ja/glossary/scroll_container/index.md @@ -3,6 +3,8 @@ title: Scroll container (スクロールコンテナー) slug: Glossary/Scroll_container --- +{{GlossarySidebar}} + **スクロールコンテナー** (scroll container) は、コンテナーに `overflow: scroll` を適用するか、 `overflow: auto` であふれるほどの量のコンテンツがあるときに生成されます。 スクロールコンテナーによって、ユーザーは領域をあふれて表示から切り取られ非表示になる部分をスクロールさせることができます。スクロールコンテナーの見える部分は、{{glossary("Scrollport", "スクロールポート")}}と呼ばれます。 diff --git a/files/ja/glossary/search_engine/index.md b/files/ja/glossary/search_engine/index.md index bc65d2152a273e..f7cbad0aa4b5c8 100644 --- a/files/ja/glossary/search_engine/index.md +++ b/files/ja/glossary/search_engine/index.md @@ -3,6 +3,8 @@ title: Search engine (検索エンジン) slug: Glossary/Search_engine --- +{{GlossarySidebar}} + 検索エンジンは {{Glossary("World Wide Web")}} から情報を集めて、特定の情報を探しているユーザーに表示するソフトウェアです。 検索エンジンは下記のプロセスを実行します: diff --git a/files/ja/glossary/secure_context/index.md b/files/ja/glossary/secure_context/index.md index 3e427bbbbc75d8..9dfa42b7918cd5 100644 --- a/files/ja/glossary/secure_context/index.md +++ b/files/ja/glossary/secure_context/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: ed947b2c608428b62a60f07d09dc543f732dc09b --- +{{GlossarySidebar}} + **安全なコンテキスト**とは、認証と機密性の一定の最低基準を満たした `Window` や `Worker` のことです。多くの Web API や機能は、安全なコンテキストでのみアクセス可能です。これにより、悪意のあるコードによって悪用される可能性を減らすことができます。 詳細については、[開発者向けのウェブ技術 > ウェブセキュリティ> 安全なコンテキスト](/ja/docs/Web/Security/Secure_Contexts)を参照してください。 diff --git a/files/ja/glossary/self-executing_anonymous_function/index.md b/files/ja/glossary/self-executing_anonymous_function/index.md index f152518a9523d4..06b68dadcdfc3e 100644 --- a/files/ja/glossary/self-executing_anonymous_function/index.md +++ b/files/ja/glossary/self-executing_anonymous_function/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: ed947b2c608428b62a60f07d09dc543f732dc09b --- +{{GlossarySidebar}} + 定義されるときに、すぐに実行される {{glossary("JavaScript")}} の{{glossary("function", "関数")}}です。{{glossary("IIFE")}} (即時実行関数式) と呼ばれることもあります。 詳細は、上記でリンクしている IIFE の用語集のページを参照してください。 diff --git a/files/ja/glossary/semantics/index.md b/files/ja/glossary/semantics/index.md index 39baf5aa7828a5..340498e950b966 100644 --- a/files/ja/glossary/semantics/index.md +++ b/files/ja/glossary/semantics/index.md @@ -3,6 +3,8 @@ title: Semantics (セマンティクス) slug: Glossary/Semantics --- +{{GlossarySidebar}} + プログラミングでは、**セマンティクス**とは、コードの断片の*意味*を指します。たとえば、「JavaScript でその行を実行すると、どのような効果があるのか?」、「その HTML 要素には、どのような目的や役割があるのか?」 (「どのように見えるのか?」ではなく)。 ## JavaScript でのセマンティクス From c6b60ddb154007db49938c347d3751b78bbc7c66 Mon Sep 17 00:00:00 2001 From: Leonid Vinogradov Date: Mon, 20 Nov 2023 00:41:08 +0300 Subject: [PATCH 21/31] [ja] add sidebar to Glossary pages (part 6) --- files/ja/glossary/index.md | 9 +++------ files/ja/glossary/webextensions/index.md | 2 ++ files/ja/glossary/webgl/index.md | 2 ++ files/ja/glossary/webidl/index.md | 2 ++ files/ja/glossary/webkit/index.md | 2 ++ files/ja/glossary/webm/index.md | 2 ++ files/ja/glossary/webp/index.md | 2 ++ files/ja/glossary/webrtc/index.md | 2 ++ files/ja/glossary/websockets/index.md | 2 ++ files/ja/glossary/webvtt/index.md | 2 ++ files/ja/glossary/whatwg/index.md | 2 ++ files/ja/glossary/whitespace/index.md | 2 ++ files/ja/glossary/windowproxy/index.md | 2 ++ files/ja/glossary/world_wide_web/index.md | 2 ++ files/ja/glossary/wrapper/index.md | 2 ++ files/ja/glossary/xforms/index.md | 2 ++ files/ja/glossary/xhtml/index.md | 2 ++ files/ja/glossary/xinclude/index.md | 2 ++ files/ja/glossary/xlink/index.md | 2 ++ files/ja/glossary/xml/index.md | 2 ++ files/ja/glossary/xmlhttprequest/index.md | 2 ++ files/ja/glossary/xpath/index.md | 2 ++ files/ja/glossary/xquery/index.md | 2 ++ files/ja/glossary/xslt/index.md | 2 ++ 24 files changed, 49 insertions(+), 6 deletions(-) diff --git a/files/ja/glossary/index.md b/files/ja/glossary/index.md index e2834c039ccf95..58e066197a266d 100644 --- a/files/ja/glossary/index.md +++ b/files/ja/glossary/index.md @@ -1,8 +1,11 @@ --- title: "MDN Web Docs 用語集: ウェブ関連用語の定義" +short-title: MDN Web Docs 用語集 slug: Glossary --- +{{GlossarySidebar}} + ウェブ技術には、ドキュメントやコーディングで使用される専門用語や略語の膨大なリストがあります。この用語集では、ウェブの理解と構築に役立つ用語や略語の定義を掲載しています。 サイドバーから用語集を選択することができます。 @@ -10,9 +13,3 @@ slug: Glossary > **メモ:** この用語集は、現在も進行中です。[新しい項目を書いたり](/ja/docs/MDN/Contribute/Howto/Write_a_new_entry_in_the_Glossary)、既存のものをより良くすることで改善に協力することができます。 > **メモ:** 日本語訳注: 英語版に存在する用語を訳す場合、ページタイトルを「Array (配列)」のように、英語の後に日本語を併記するようにしてください (タイトルを翻訳する場合)。 - - diff --git a/files/ja/glossary/webextensions/index.md b/files/ja/glossary/webextensions/index.md index 82671101e5b5d7..d0e92d0134c710 100644 --- a/files/ja/glossary/webextensions/index.md +++ b/files/ja/glossary/webextensions/index.md @@ -3,6 +3,8 @@ title: WebExtensions slug: Glossary/WebExtensions --- +{{GlossarySidebar}} + WebExtensions は Firefox でブラウザー拡張機能を開発するためのクロスブラウザーシステムです。このシステムには API が提供され、これはかなりにわたって様々なブラウザー、例えば Mozilla Firefox, Google Chrome, Opera Browser, Microsoft Edge をサポートします。 ## 関連項目 diff --git a/files/ja/glossary/webgl/index.md b/files/ja/glossary/webgl/index.md index 9d182c1bdc54ef..c3adc63d6847a2 100644 --- a/files/ja/glossary/webgl/index.md +++ b/files/ja/glossary/webgl/index.md @@ -3,6 +3,8 @@ title: WebGL slug: Glossary/WebGL --- +{{GlossarySidebar}} + **WebGL** (_Web グラフィックライブラリー_) は、インタラクティブな 2D/3D グラフィックを描画する {{Glossary("JavaScript")}} {{Glossary("API")}} です。 [Khronos グループ](https://www.khronos.org/) が WebGL をメンテナンスしていて、これは {{Glossary("OpenGL")}} ES 2.0 を元にしています。 diff --git a/files/ja/glossary/webidl/index.md b/files/ja/glossary/webidl/index.md index 309dbc5135d961..1c0b9ec5dad39d 100644 --- a/files/ja/glossary/webidl/index.md +++ b/files/ja/glossary/webidl/index.md @@ -3,6 +3,8 @@ title: WebIDL slug: Glossary/WebIDL --- +{{GlossarySidebar}} + **WebIDL** は、ウェブアプリケーションプログラミングインターフェイス ({{Glossary("API")}}) を構成する{{Glossary("type", "データ型")}}、{{Glossary("interface", "インターフェイス")}}、{{Glossary("method", "メソッド")}}、{{Glossary("property", "プロパティ")}}、およびその他のコンポーネントを記述するために使用されるインターフェイス記述言語です。これは、特定のプログラミング言語に依存しないやや定式化された構文を使用しているため、API のコンポーネントを JavaScript 互換の構造にマップすることが可能な一方で、各 API を構築するために使用される基礎となるコードは、どの言語であっても最適に記述できます。 WebIDL はウェブのほぼすべての API {{Glossary("specification", "仕様")}}で使用されており、その標準的な形式および構文のため、ウェブブラウザーを作成するプログラマーは、どのように API を実装するコードを書くかにかかわらず、ブラウザーが相互に互換性があることを容易に確認できます。 diff --git a/files/ja/glossary/webkit/index.md b/files/ja/glossary/webkit/index.md index 86aee24c678c53..91618e295a660d 100644 --- a/files/ja/glossary/webkit/index.md +++ b/files/ja/glossary/webkit/index.md @@ -3,6 +3,8 @@ title: WebKit slug: Glossary/WebKit --- +{{GlossarySidebar}} + _WebKit_ はマークアップを基に適切にフォーマットされたウェブページを表示するためのフレームワークの 1 つです。{{Glossary("Apple Safari")}}、そして多くのモバイル向けブラウザーも、Webkit によって動いています (Webkit は移植性もカスタマイズ性も高いからです)。 Webkit は KDE の KHTML と KJS ライブラリー群のフォークの 1 つとして始まりましたが、これまで多くの個人や企業が貢献してきました (その中には、KDE、Apple、Google、Nokia も含まれています)。 diff --git a/files/ja/glossary/webm/index.md b/files/ja/glossary/webm/index.md index 5d52f6644aea34..b9f53452486682 100644 --- a/files/ja/glossary/webm/index.md +++ b/files/ja/glossary/webm/index.md @@ -3,6 +3,8 @@ title: WebM slug: Glossary/WebM --- +{{GlossarySidebar}} + **WebM** はロイヤリティフリーでオープンな動画フォーマットです。Mozilla Firefox でも標準でサポートされています。 ## 詳細情報 diff --git a/files/ja/glossary/webp/index.md b/files/ja/glossary/webp/index.md index 35ae005c1d04ef..06b033348e1589 100644 --- a/files/ja/glossary/webp/index.md +++ b/files/ja/glossary/webp/index.md @@ -3,6 +3,8 @@ title: WebP slug: Glossary/WebP --- +{{GlossarySidebar}} + **WebP** は Google の開発した画像圧縮フォーマットです。可逆圧縮と不可逆圧縮の両方に対応しています。 ## 関連項目 diff --git a/files/ja/glossary/webrtc/index.md b/files/ja/glossary/webrtc/index.md index d13f05d6e48ec7..f07b2bdd1755cc 100644 --- a/files/ja/glossary/webrtc/index.md +++ b/files/ja/glossary/webrtc/index.md @@ -3,6 +3,8 @@ title: WebRTC slug: Glossary/WebRTC --- +{{GlossarySidebar}} + **WebRTC** (_Web Real-Time Communication_)はビデオチャット、音声通話、P2P ファイル共有を行うウェブアプリで使われる API です。 WebRTC は主に以下の要素で構成されています: diff --git a/files/ja/glossary/websockets/index.md b/files/ja/glossary/websockets/index.md index 27cbab6909bada..b02a8090db1df8 100644 --- a/files/ja/glossary/websockets/index.md +++ b/files/ja/glossary/websockets/index.md @@ -3,6 +3,8 @@ title: WebSockets slug: Glossary/WebSockets --- +{{GlossarySidebar}} + _WebSocket_ は、{{Glossary("Server", "サーバー")}}とクライアント間の永続的な {{Glossary("TCP")}} 接続を可能にする{{Glossary("protocol", "プロトコル")}}で、任意のタイミングでデータをやり取りできます。 どのクライアント、サーバーアプリケーションでも WebSocket を使用できますが、主にウェプ{{Glossary("Browser", "ブラウザー")}}とウェブサーバーで使用できます。 WebSocket を通じて、サーバーはクライアントのリクエストなしにデータを渡せるため、動的なコンテンツ更新が可能です。 diff --git a/files/ja/glossary/webvtt/index.md b/files/ja/glossary/webvtt/index.md index e9a9e68bfa94e3..0cb2390eb38280 100644 --- a/files/ja/glossary/webvtt/index.md +++ b/files/ja/glossary/webvtt/index.md @@ -3,6 +3,8 @@ title: WebVTT slug: Glossary/WebVTT --- +{{GlossarySidebar}} + WebVTT (Web Video Text Tracks) は HTML {{HTMLElement("track")}} 要素とともに文字データのマークアップを行うファイルフォーマットを策定する {{Glossary("W3C")}} 規格です。 WebVTT ファイルでは、動画の字幕やサブタイトル・動画の説明テキスト・コンテンツナビゲーション用チャプターなどが、音声や動画の再生時間に合わせたメタデータとして表現されています。 diff --git a/files/ja/glossary/whatwg/index.md b/files/ja/glossary/whatwg/index.md index a5e57d72021201..fb7fa21ba574f8 100644 --- a/files/ja/glossary/whatwg/index.md +++ b/files/ja/glossary/whatwg/index.md @@ -3,6 +3,8 @@ title: WHATWG slug: Glossary/WHATWG --- +{{GlossarySidebar}} + WHATWG (_Web Hypertext Application Technology Working Group_) は[ウェブ標準の保守や開発](https://spec.whatwg.org/)を行うためのコミュニティで、 {{Glossary("DOM")}}, Fetch, {{Glossary("HTML")}} などを扱っています。 Apple、Mozilla、Opera の従業員たちによって 2004 年に設立されました。 ## 詳細情報 diff --git a/files/ja/glossary/whitespace/index.md b/files/ja/glossary/whitespace/index.md index 20b77753f636f8..f5fec45773ed77 100644 --- a/files/ja/glossary/whitespace/index.md +++ b/files/ja/glossary/whitespace/index.md @@ -3,6 +3,8 @@ title: Whitespace (ホワイトスペース) slug: Glossary/Whitespace --- +{{GlossarySidebar}} + **ホワイトスペース**は他の文字の中で水平または垂直の空間を表すために使用される一連の{{Glossary("Character", "文字")}}です。{{Glossary("HTML")}}, {{Glossary("CSS")}}, {{Glossary("JavaScript")}}, その他のコンピューター言語でトークンを区切るためによく使用されます。ホワイトスペース文字とその使い方は言語によって様々です。 ## HTML での使い方 diff --git a/files/ja/glossary/windowproxy/index.md b/files/ja/glossary/windowproxy/index.md index ff6f96a7b3d828..bc975440514889 100644 --- a/files/ja/glossary/windowproxy/index.md +++ b/files/ja/glossary/windowproxy/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: ed947b2c608428b62a60f07d09dc543f732dc09b --- +{{GlossarySidebar}} + **`WindowProxy`** オブジェクトは [`Window`](/ja/docs/Web/API/Window) オブジェクトのラッパーです。すべての[閲覧コンテキスト](/ja/docs/Glossary/Browsing_context)に `WindowProxy` オブジェクトが存在します。`WindowProxy` オブジェクトに対して実行される操作は、その `WindowProxy` オブジェクトが現在ラップしている `Window` オブジェクトにそのまま反映されます。したがって、`WindowProxy` オブジェクトとのやり取りは、 `Window` オブジェクトと直接やり取りするのとほとんど同じ意味になります。閲覧コンテキストが移動するとき、その `WindowProxy` がラップする `Window` オブジェクトが変更されます。 ## 関連情報 diff --git a/files/ja/glossary/world_wide_web/index.md b/files/ja/glossary/world_wide_web/index.md index bbb2a0f592a874..3f5c9c25fdc91c 100644 --- a/files/ja/glossary/world_wide_web/index.md +++ b/files/ja/glossary/world_wide_web/index.md @@ -3,6 +3,8 @@ title: World Wide Web slug: Glossary/World_Wide_Web --- +{{GlossarySidebar}} + _World Wide Web_ は、一般に **WWW**, **W3**, もしくは **ウェブ** と呼ばれ、{{Glossary("Internet", "インターネット")}} を通じて公開されたウェブページが相互に接続されたシステムのことです。ウェブはインターネットと同義ではありません。ウェブは、インターネット上に構築された多くのアプリケーションの中の一つなのです。 ティム・バーナーズ=リー卿は、World Wide Web として知られることとなったアーキテクチャを提唱しました。彼は、1990 年に世界初のウェブ {{Glossary("Server","サーバー")}} とウェブ {{Glossary("Browser","ブラウザー")}}、そしてウェブページを CERN 物理学研究所の自身のコンピューター上に構築しました。1991 年に、彼は alt.hypertext ニュースグループで自身の成果を公表しました。ウェブが世界で初めて公になった瞬間でした。 diff --git a/files/ja/glossary/wrapper/index.md b/files/ja/glossary/wrapper/index.md index e5a84b4a11be7d..084f866494f994 100644 --- a/files/ja/glossary/wrapper/index.md +++ b/files/ja/glossary/wrapper/index.md @@ -3,6 +3,8 @@ title: Wrapper (ラッパー) slug: Glossary/Wrapper --- +{{GlossarySidebar}} + JavaScript のようなプログラミング言語において、ラッパー (wrapper) は 1 つ以上の他の関数を呼び出すための関数であり、時には純粋に利便性のために、時にはプロセス中でまったく異なるタスクに合わせるために使用されます。 例えば、AWS の SDK ライブラリはラッパーの例になります。 diff --git a/files/ja/glossary/xforms/index.md b/files/ja/glossary/xforms/index.md index a82e42c1ae9d71..f87eee52fc1a36 100644 --- a/files/ja/glossary/xforms/index.md +++ b/files/ja/glossary/xforms/index.md @@ -3,6 +3,8 @@ title: XForms slug: Glossary/XForms --- +{{GlossarySidebar}} + **XForms** はウェブフォームを構築し、フォームのデータを {{glossary("XML")}} 形式で処理するための慣例です。 > **メモ:** もう主要なブラウザーは XForms に対応していません。 — 代わりに [HTML5 フォーム](/ja/docs/Learn/Forms)を使うことをお勧めします。 diff --git a/files/ja/glossary/xhtml/index.md b/files/ja/glossary/xhtml/index.md index b3df9e469a45b7..b20b9230a82c3c 100644 --- a/files/ja/glossary/xhtml/index.md +++ b/files/ja/glossary/xhtml/index.md @@ -3,6 +3,8 @@ title: XHTML slug: Glossary/XHTML --- +{{GlossarySidebar}} + **XHTML** は、 HTML 文書のうち {{Glossary("XML")}} の構文規則に適合して書かれたものを指すために歴史的に使用されてきた用語です。 ## 詳細情報 diff --git a/files/ja/glossary/xinclude/index.md b/files/ja/glossary/xinclude/index.md index 8319a643ce699f..7e0967edef060a 100644 --- a/files/ja/glossary/xinclude/index.md +++ b/files/ja/glossary/xinclude/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: f4f8e2f18ccf19a0bee59e1fe78753e276b98232 --- +{{GlossarySidebar}} + XInclude は、文書に他の文書または他の文書の一部を含められるようにする、包含タグを定めた W3C 勧告です。他の XML ファイルやテキストファイルからコンテンツを取り込むことができます。 主要なブラウザーは、XInclude の仕組みを標準ではサポートしていません。 diff --git a/files/ja/glossary/xlink/index.md b/files/ja/glossary/xlink/index.md index a91fc44a86cb78..fafa2f43343164 100644 --- a/files/ja/glossary/xlink/index.md +++ b/files/ja/glossary/xlink/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: 4a9f9d2e9c1811ce3519a7061e906db9200a5e97 --- +{{GlossarySidebar}} + XLink は W3C の標準規格で、 XML と、 XML または他の文書との間のリンクを記述するために使用されます。その動作の一部は、どのように処理するかが実装に委ねられています。 単純な XLinks は Firefox で(少なくとも SVG と MathML では)「対応」されていますが、プレーンな XML 文書を XLinks で読み込んで、XML ツリーの関連ポイントをクリックしようとしても、リンクとしては機能しません。 diff --git a/files/ja/glossary/xml/index.md b/files/ja/glossary/xml/index.md index cd46902b5a7d23..d047588130d5dc 100644 --- a/files/ja/glossary/xml/index.md +++ b/files/ja/glossary/xml/index.md @@ -3,6 +3,8 @@ title: XML slug: Glossary/XML --- +{{GlossarySidebar}} + eXtensible Markup Language (XML) は W3C によって規定された汎用マークアップ言語です。情報技術 (IT) 産業では、データ記述言語として多くの XML を基にした言語を使用しています。 XML タグは HTML タグに似ていますが、XML はユーザーが独自のタグを定義することができるため、はるかに柔軟です。このようにして XML はメタ言語のように振る舞う――すなわち {{Glossary("RSS")}} のような他の言語を定義することができるのです。それに加えて、HTML はプレゼンテーション言語であるのに対し、XML はデータ記述言語です。つまり、XML には ウェブだけにとどまらないとても広い応用範囲があるということを意味します。例として、ウェブサービスは XML をリクエストとレスポンスの交換に使用することができます。 diff --git a/files/ja/glossary/xmlhttprequest/index.md b/files/ja/glossary/xmlhttprequest/index.md index 6d3933b3c345c5..06b885cd783ec0 100644 --- a/files/ja/glossary/xmlhttprequest/index.md +++ b/files/ja/glossary/xmlhttprequest/index.md @@ -3,6 +3,8 @@ title: XHR (XMLHttpRequest) slug: Glossary/XMLHttpRequest --- +{{GlossarySidebar}} + {{domxref("XMLHttpRequest")}} (XHR) とは {{Glossary("AJAX")}} リクエストを作成する {{Glossary("JavaScript")}} {{Glossary("API")}} です。これは{{Glossary("browser", "ブラウザー")}} と{{Glossary("server", "サーバー")}} との間のネットワークリクエストの送信を可能にするメソッドです。. ## 詳しく学習する diff --git a/files/ja/glossary/xpath/index.md b/files/ja/glossary/xpath/index.md index 480f6bf91eda5e..e7cd4b8e4628fa 100644 --- a/files/ja/glossary/xpath/index.md +++ b/files/ja/glossary/xpath/index.md @@ -3,6 +3,8 @@ title: XPath slug: Glossary/XPath --- +{{GlossarySidebar}} + **XPath** とは{{glossary("XML")}} ドキュメント内のセクションやコンテンツにアクセスできる問い合わせ言語です。 ## 関連項目 diff --git a/files/ja/glossary/xquery/index.md b/files/ja/glossary/xquery/index.md index 97ea3d9d4e7a93..cf05c774bd16eb 100644 --- a/files/ja/glossary/xquery/index.md +++ b/files/ja/glossary/xquery/index.md @@ -3,6 +3,8 @@ title: XQuery slug: Glossary/XQuery --- +{{GlossarySidebar}} + **XQuery** は {{glossary("XML")}} データベースでデータを更新、検索、計算するためのコンピューター言語です。 ## より詳しく学ぶ diff --git a/files/ja/glossary/xslt/index.md b/files/ja/glossary/xslt/index.md index d49a96a64ede8e..9ab75138fa917b 100644 --- a/files/ja/glossary/xslt/index.md +++ b/files/ja/glossary/xslt/index.md @@ -5,6 +5,8 @@ l10n: sourceCommit: ba6c97a742adb97092d5b20804bf9c462f3b84f3 --- +{{GlossarySidebar}} + _eXtensible Stylesheet Language Transformations_ (**XSLT**) は、{{Glossary("XML")}} 文書を他の XML 文書に変換するために使用される宣言的言語であり、{{Glossary("HTML")}}、{{Glossary("PDF")}}、プレーンテキストなどが含まれます。 XSLT には XML 入力、または XQuery および XPath データモデルに変換可能な任意のフォーマットを受け入れる独自のプロセッサーがあります。XSLT プロセッサは XML ドキュメントと XSLT スタイルシートに基づいて新しいドキュメントを作成し、プロセス内の元のファイルに変更を加えません。 From 44b6e5d01ec061268b14c24d59a233d5280bf2db Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Mon, 20 Nov 2023 03:27:15 +0900 Subject: [PATCH 22/31] =?UTF-8?q?2023/04/08=20=E6=99=82=E7=82=B9=E3=81=AE?= =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?= =?UTF-8?q?=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/range/collapsed/index.md | 5 ++++- files/ja/web/api/range/commonancestorcontainer/index.md | 7 +++++-- files/ja/web/api/range/endcontainer/index.md | 5 ++++- files/ja/web/api/range/endoffset/index.md | 5 ++++- files/ja/web/api/range/startcontainer/index.md | 5 ++++- files/ja/web/api/range/startoffset/index.md | 5 ++++- 6 files changed, 25 insertions(+), 7 deletions(-) diff --git a/files/ja/web/api/range/collapsed/index.md b/files/ja/web/api/range/collapsed/index.md index f43e9e67d35f56..cb9f196d53ee4f 100644 --- a/files/ja/web/api/range/collapsed/index.md +++ b/files/ja/web/api/range/collapsed/index.md @@ -1,6 +1,9 @@ --- -title: Range.collapsed +title: "Range: collapsed プロパティ" +short-title: collapsed slug: Web/API/Range/collapsed +l10n: + sourceCommit: c58e8c1dd6ecbcb63894c7dd17fb9495b9511b4e --- {{ APIRef("DOM") }} diff --git a/files/ja/web/api/range/commonancestorcontainer/index.md b/files/ja/web/api/range/commonancestorcontainer/index.md index 89fda63e67e1e8..517d66e26c7253 100644 --- a/files/ja/web/api/range/commonancestorcontainer/index.md +++ b/files/ja/web/api/range/commonancestorcontainer/index.md @@ -1,6 +1,9 @@ --- -title: Range.commonAncestorContainer +title: "Range: commonAncestorContainer プロパティ" +short-title: commonAncestorContainer slug: Web/API/Range/commonAncestorContainer +l10n: + sourceCommit: c58e8c1dd6ecbcb63894c7dd17fb9495b9511b4e --- {{ApiRef("DOM")}} @@ -17,7 +20,7 @@ slug: Web/API/Range/commonAncestorContainer ## 例 -この例では、リスト上の {{domxref("Document/pointerup_event", "pointerup")}} イベントを取り扱うためイベントリスナーを作ります。このリスナーは選択したテキストの共通の祖先を取得して、それらを強調するアニメーションを起動します。 +この例では、リスト上の {{domxref("Element/pointerup_event", "pointerup")}} イベントを取り扱うためイベントリスナーを作ります。このリスナーは選択したテキストの共通の祖先を取得して、それらを強調するアニメーションを起動します。 ### HTML diff --git a/files/ja/web/api/range/endcontainer/index.md b/files/ja/web/api/range/endcontainer/index.md index 082e4f56ee1519..6ac666304dcb53 100644 --- a/files/ja/web/api/range/endcontainer/index.md +++ b/files/ja/web/api/range/endcontainer/index.md @@ -1,6 +1,9 @@ --- -title: Range.endContainer +title: "Range: endContainer プロパティ" +short-title: endContainer slug: Web/API/Range/endContainer +l10n: + sourceCommit: c58e8c1dd6ecbcb63894c7dd17fb9495b9511b4e --- {{ApiRef("DOM")}} diff --git a/files/ja/web/api/range/endoffset/index.md b/files/ja/web/api/range/endoffset/index.md index 7ecc6255d28809..6304c6de05470e 100644 --- a/files/ja/web/api/range/endoffset/index.md +++ b/files/ja/web/api/range/endoffset/index.md @@ -1,6 +1,9 @@ --- -title: Range.endOffset +title: "Range: endOffset プロパティ" +short-title: endOffset slug: Web/API/Range/endOffset +l10n: + sourceCommit: c58e8c1dd6ecbcb63894c7dd17fb9495b9511b4e --- {{ApiRef("DOM")}} diff --git a/files/ja/web/api/range/startcontainer/index.md b/files/ja/web/api/range/startcontainer/index.md index f23747ff11e07e..b443a109c4c55d 100644 --- a/files/ja/web/api/range/startcontainer/index.md +++ b/files/ja/web/api/range/startcontainer/index.md @@ -1,6 +1,9 @@ --- -title: Range.startContainer +title: "Range: startContainer プロパティ" +short-title: startContainer slug: Web/API/Range/startContainer +l10n: + sourceCommit: c58e8c1dd6ecbcb63894c7dd17fb9495b9511b4e --- {{ApiRef("DOM")}} diff --git a/files/ja/web/api/range/startoffset/index.md b/files/ja/web/api/range/startoffset/index.md index addc322f8d3af9..37d6453d3f158e 100644 --- a/files/ja/web/api/range/startoffset/index.md +++ b/files/ja/web/api/range/startoffset/index.md @@ -1,6 +1,9 @@ --- -title: Range.startOffset +title: "Range: startOffset プロパティ" +short-title: startOffset slug: Web/API/Range/startOffset +l10n: + sourceCommit: c58e8c1dd6ecbcb63894c7dd17fb9495b9511b4e --- {{ApiRef("DOM")}} From 9deff2baf0d6095ad68a4890470d3e1764c05c21 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Tue, 21 Nov 2023 00:33:12 +0900 Subject: [PATCH 23/31] =?UTF-8?q?2023/04/08=20=E6=99=82=E7=82=B9=E3=81=AE?= =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?= =?UTF-8?q?=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 --- files/ja/web/api/range/clonecontents/index.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/files/ja/web/api/range/clonecontents/index.md b/files/ja/web/api/range/clonecontents/index.md index 470275f2075a98..df041f44f634bc 100644 --- a/files/ja/web/api/range/clonecontents/index.md +++ b/files/ja/web/api/range/clonecontents/index.md @@ -1,6 +1,9 @@ --- -title: Range.cloneContents() +title: "Range: cloneContents() メソッド" +short-title: cloneContents() slug: Web/API/Range/cloneContents +l10n: + sourceCommit: c58e8c1dd6ecbcb63894c7dd17fb9495b9511b4e --- {{ APIRef("DOM") }} @@ -13,8 +16,8 @@ slug: Web/API/Range/cloneContents ## 構文 -```js -cloneContents(); +```js-nolint +cloneContents() ``` ### 引数 From 21cd3835dca7acf88ca638ed09e9d42394ebae6b Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Tue, 21 Nov 2023 00:51:13 +0900 Subject: [PATCH 24/31] =?UTF-8?q?2023/04/08=20=E6=99=82=E7=82=B9=E3=81=AE?= =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?= =?UTF-8?q?=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 --- files/ja/web/api/range/clonerange/index.md | 47 ++++++++++++++++++++++ 1 file changed, 47 insertions(+) create mode 100644 files/ja/web/api/range/clonerange/index.md diff --git a/files/ja/web/api/range/clonerange/index.md b/files/ja/web/api/range/clonerange/index.md new file mode 100644 index 00000000000000..f20152cb0bb90e --- /dev/null +++ b/files/ja/web/api/range/clonerange/index.md @@ -0,0 +1,47 @@ +--- +title: "Range: cloneRange() メソッド" +short-title: cloneRange() +slug: Web/API/Range/cloneRange +l10n: + sourceCommit: c58e8c1dd6ecbcb63894c7dd17fb9495b9511b4e +--- + +{{ APIRef("DOM") }} + +**`Range.cloneRange()`** メソッドは、複製された {{domxref("Range")}} と同じ境界点を持つ {{domxref("Range")}} オブジェクトを返します。 + +返されるクローンは参照ではなく値でコピーされるので、どちらの {{domxref("Range")}} を変更しても、もう一方に影響はありません。 + +## 構文 + +```js-nolint +cloneRange() +``` + +### 引数 + +なし。 + +### 返値 + +{{domxref("Range")}} オブジェクトです。 + +## 例 + +```js +range = document.createRange(); +range.selectNode(document.getElementsByTagName("div").item(0)); +clone = range.cloneRange(); +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [DOM インターフェイス索引](/ja/docs/Web/API/Document_Object_Model) From ed9f267b005a623f99f1601924ce481677f72ce8 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Tue, 21 Nov 2023 00:55:07 +0900 Subject: [PATCH 25/31] =?UTF-8?q?2023/04/08=20=E6=99=82=E7=82=B9=E3=81=AE?= =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?= =?UTF-8?q?=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 --- files/ja/web/api/range/collapse/index.md | 51 ++++++++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 files/ja/web/api/range/collapse/index.md diff --git a/files/ja/web/api/range/collapse/index.md b/files/ja/web/api/range/collapse/index.md new file mode 100644 index 00000000000000..82313b475e086a --- /dev/null +++ b/files/ja/web/api/range/collapse/index.md @@ -0,0 +1,51 @@ +--- +title: "Range: collapse() メソッド" +short-title: collapse() +slug: Web/API/Range/collapse +l10n: + sourceCommit: c58e8c1dd6ecbcb63894c7dd17fb9495b9511b4e +--- + +{{APIRef("DOM")}} + +**`Range.collapse()`** メソッドは、 {{domxref("Range")}} を境界点の一つに折りたたみます。 + +折りたたまれた {{domxref("Range")}} は空で、コンテンツを含まず、 DOM ツリーの単一の点を指定します。 {{domxref("Range")}} が既に折りたたまれているかどうかを調べるには、 {{domxref("Range.collapsed")}} プロパティを参照してください。 + +## 構文 + +```js-nolint +collapse() +collapse(toStart) +``` + +### 引数 + +- `toStart` {{optional_inline}} + - : 論理値です。 `true` の場合は {{domxref("Range")}} を先頭側に、`false` の場合は末尾側に折りたたみます。省略すると既定で `false` {{experimental_inline}} となります。 + +### 返値 + +なし ({{jsxref("undefined")}})。 + +## 例 + +```js +const range = document.createRange(); + +const referenceNode = document.getElementsByTagName("div").item(0); +range.selectNode(referenceNode); +range.collapse(true); +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [DOM インターフェイス索引](/ja/docs/Web/API/Document_Object_Model) From 8c9bb68a0f94bb4bcd9e2acccac93fedd81df2c3 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Tue, 21 Nov 2023 01:09:16 +0900 Subject: [PATCH 26/31] =?UTF-8?q?2023/04/08=20=E6=99=82=E7=82=B9=E3=81=AE?= =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?= =?UTF-8?q?=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 --- .../api/range/compareboundarypoints/index.md | 62 +++++++++++++++++++ 1 file changed, 62 insertions(+) create mode 100644 files/ja/web/api/range/compareboundarypoints/index.md diff --git a/files/ja/web/api/range/compareboundarypoints/index.md b/files/ja/web/api/range/compareboundarypoints/index.md new file mode 100644 index 00000000000000..874c716a3292bd --- /dev/null +++ b/files/ja/web/api/range/compareboundarypoints/index.md @@ -0,0 +1,62 @@ +--- +title: "Range: compareBoundaryPoints() メソッド" +short-title: compareBoundaryPoints() +slug: Web/API/Range/compareBoundaryPoints +l10n: + sourceCommit: c58e8c1dd6ecbcb63894c7dd17fb9495b9511b4e +--- + +{{ApiRef("DOM")}} + +**`Range.compareBoundaryPoints()`** メソッドは、 {{domxref("Range")}} の境界点を別の範囲のものと比較します。 + +## 構文 + +```js-nolint +compareBoundaryPoints(how, sourceRange) +``` + +### 引数 + +- `how` + + - : 定数で、比較メソッドを説明します。 + + - `Range.END_TO_END` は _sourceRange_ の終わりの境界点と `Range` の終わりの境界点を比較します。 + - `Range.END_TO_START` は _sourceRange_ の終わりの境界点と `Range` の始まりの境界点を比較します。 + - `Range.START_TO_END` は _sourceRange_ の始まりの境界点と `Range` の終わりの境界点を比較します。 + - `Range.START_TO_START` は _sourceRange_ の始まりの境界点と `Range` の始まりの境界点を比較します。 + +- `sourceRange` + - : 範囲との境界点を比較するための {{domxref("Range")}} です。 + +### 返値 + +`-1`, `0`, `1` のいずれかの数値で、 {{domxref("Range")}} の対応する境界点が _sourceRange_ の対応する境界点より前か、等しいか、後かを示します。 + +### 例外 + +- `NotSupportedError` {{domxref("DOMException")}} + - : `how` 引数の値が無効な場合に発生します。 + +## 例 + +```js +const range = document.createRange(); +range.selectNode(document.querySelector("div")); +const sourceRange = document.createRange(); +sourceRange.selectNode(document.getElementsByTagName("div")[1]); +const compare = range.compareBoundaryPoints(Range.START_TO_END, sourceRange); +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [DOM インターフェイス索引](/ja/docs/Web/API/Document_Object_Model) From 470081c10b4cba225bda953c96b661a7897ecbbd Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Tue, 21 Nov 2023 01:21:56 +0900 Subject: [PATCH 27/31] =?UTF-8?q?2023/04/08=20=E6=99=82=E7=82=B9=E3=81=AE?= =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?= =?UTF-8?q?=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 --- files/ja/web/api/range/comparenode/index.md | 86 +++++++++++++++++++++ 1 file changed, 86 insertions(+) create mode 100644 files/ja/web/api/range/comparenode/index.md diff --git a/files/ja/web/api/range/comparenode/index.md b/files/ja/web/api/range/comparenode/index.md new file mode 100644 index 00000000000000..babdba7ef9e378 --- /dev/null +++ b/files/ja/web/api/range/comparenode/index.md @@ -0,0 +1,86 @@ +--- +title: "Range: compareNode() メソッド" +short-title: compareNode() +slug: Web/API/Range/compareNode +l10n: + sourceCommit: c58e8c1dd6ecbcb63894c7dd17fb9495b9511b4e +--- + +{{APIRef("DOM")}}{{deprecated_header}}{{Non-standard_Header}} + +**`Range.compareNode()`** は {{DOMxRef("Node")}} の位置を示す定数を返します。 + +取りうる値は以下の通りです。 + +- `NODE_BEFORE` (`0`) + - : Node はこの Range より前に始まる +- `NODE_AFTER` (`1`) + - : Node はこの Range より後に終わる +- `NODE_BEFORE_AND_AFTER` (`2`) + - : Node はこの Range より前に始まり、後に終わる +- `NODE_INSIDE` (`3`) + - : Node はこの Range より後に始まり、前に終わる。すなわち、ノードは完全にこの Range に選択されている。 + +> **警告:** このメソッドは [Gecko 1.9](/ja/docs/Mozilla/Firefox/Releases/3) から[削除され](/ja/docs/Mozilla/Firefox/Releases/3/Site_compatibility)、唯一実装していた Firefox の将来のバージョンでは存在しません。使用可能な限り早く {{DOMxRef("Range.compareBoundaryPoints()")}} に切り替えるべきです。 + +以下の関数が置き換えの関数として使用できます。 + +```js +function rangeCompareNode(range, node) { + const nodeRange = node.ownerDocument.createRange(); + try { + nodeRange.selectNode(node); + } catch (e) { + nodeRange.selectNodeContents(node); + } + const nodeIsBefore = + range.compareBoundaryPoints(Range.START_TO_START, nodeRange) === 1; + const nodeIsAfter = + range.compareBoundaryPoints(Range.END_TO_END, nodeRange) === -1; + + if (nodeIsBefore && !nodeIsAfter) return 0; + if (!nodeIsBefore && nodeIsAfter) return 1; + if (nodeIsBefore && nodeIsAfter) return 2; + + return 3; +} +``` + +## 構文 + +```js-nolint +compareNode(referenceNode) +``` + +### 引数 + +- `referenceNode` + - : この `Range` と比較する {{DOMxRef("Node")}} です。 + +### 返値 + +{{DOMxRef("Node")}} の位置を示す定数。 + +## 例 + +```js +range = document.createRange(); +range.selectNode(document.getElementsByTagName("div").item(0)); +returnValue = range.compareNode(document.getElementsByTagName("p").item(0)); +``` + +## メモ + +このメソッドは廃止されました。W3C DOM {{DOMxRef("Range.compareBoundaryPoints()")}} メソッドを使用しましょう。 + +## 仕様書 + +このメソッドは標準ではないため、どの仕様にも属しません。 + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [DOM インターフェイス索引](/ja/docs/Web/API/Document_Object_Model) From 8dcabb4543041a987ae099096d5aa5d2d789e8bc Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Tue, 21 Nov 2023 08:19:58 +0900 Subject: [PATCH 28/31] =?UTF-8?q?2023/04/08=20=E6=99=82=E7=82=B9=E3=81=AE?= =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?= =?UTF-8?q?=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 --- files/ja/web/api/range/comparepoint/index.md | 50 ++++++++++++++++++++ 1 file changed, 50 insertions(+) create mode 100644 files/ja/web/api/range/comparepoint/index.md diff --git a/files/ja/web/api/range/comparepoint/index.md b/files/ja/web/api/range/comparepoint/index.md new file mode 100644 index 00000000000000..cdbbf615c34806 --- /dev/null +++ b/files/ja/web/api/range/comparepoint/index.md @@ -0,0 +1,50 @@ +--- +title: "Range: comparePoint() メソッド" +short-title: comparePoint() +slug: Web/API/Range/comparePoint +l10n: + sourceCommit: c58e8c1dd6ecbcb63894c7dd17fb9495b9511b4e +--- + +{{ApiRef("DOM")}} + +**`Range.comparePoint()`** メソッドは、 `-1`、`0`、`1` を返します。それぞれ、 `referenceNode` が {{domxref("Range")}} の前か、同じか、後かを返します。 + +参照ノードが {{domxref("Text")}}、{{domxref("Comment")}}、{{domxref("CDATASection")}}型の {{domxref("Node")}} の場合、 offset は参照ノードの先頭からの文字数です。他の {{domxref("Node")}} 型の場合、 offset は参照ノードの先頭からの子ノードの数です。 + +## 構文 + +```js-nolint +comparePoint(referenceNode, offset) +``` + +### 引数 + +- `referenceNode` + - : {{domxref("Range")}} と比較する {{domxref("Node")}} です。 +- `offset` + - : 0 以上の整数で、 _referenceNode_ 内のオフセットを表します。 + +### 返値 + +Returns `-1`, `0`, or `1`. + +## 例 + +```js +range = document.createRange(); +range.selectNode(document.getElementsByTagName("div").item(0)); +returnValue = range.comparePoint(document.getElementsByTagName("p").item(0), 1); +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [DOM インターフェイス索引](/ja/docs/Web/API/Document_Object_Model) From b0d3cc3f8a23550c4b2402f952fab0b0e824f173 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Tue, 21 Nov 2023 08:33:04 +0900 Subject: [PATCH 29/31] =?UTF-8?q?2023/04/08=20=E6=99=82=E7=82=B9=E3=81=AE?= =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?= =?UTF-8?q?=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 --- .../range/createcontextualfragment/index.md | 50 +++++++++++++++++++ 1 file changed, 50 insertions(+) create mode 100644 files/ja/web/api/range/createcontextualfragment/index.md diff --git a/files/ja/web/api/range/createcontextualfragment/index.md b/files/ja/web/api/range/createcontextualfragment/index.md new file mode 100644 index 00000000000000..a38d7357e0819a --- /dev/null +++ b/files/ja/web/api/range/createcontextualfragment/index.md @@ -0,0 +1,50 @@ +--- +title: "Range: createContextualFragment() メソッド" +short-title: createContextualFragment() +slug: Web/API/Range/createContextualFragment +l10n: + sourceCommit: c58e8c1dd6ecbcb63894c7dd17fb9495b9511b4e +--- + +{{ApiRef("DOM")}} + +**`Range.createContextualFragment()`** メソッドは、範囲の先頭ノード(選択されたノードの親)をコンテキストノードとして、 HTML フラグメント構文解析アルゴリズムまたは XML フラグメント構文解析アルゴリズムを呼び出して {{domxref("DocumentFragment")}} を返します。 HTML フラグメント解釈アルゴリズムは、範囲が HTMLness ビットが設定された `Document` に属している場合に使用します。 HTML では、コンテキストノードが `html` である場合、歴史的な理由から、フラグメント解釈アルゴリズムは `body` をコンテキストとして呼び出されます。 + +## 構文 + +```js-nolint +createContextualFragment(tagString) +``` + +### 引数 + +- `tagString` + - : 文書フラグメントに変換するテキストとタグを格納するテキストです。 + +### 返値 + +{{domxref("DocumentFragment")}} オブジェクトです。 + +## 例 + +```js +const tagString = "
I am a div node
"; +const range = document.createRange(); + +// 文書内の最初の div の親をコンテキストノードにします。 +range.selectNode(document.getElementsByTagName("div").item(0)); +const documentFragment = range.createContextualFragment(tagString); +document.body.appendChild(documentFragment); +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [DOM インターフェイス索引](/ja/docs/Web/API/Document_Object_Model) From c05b6639b117af376047a128c3749d12f0d1b61b Mon Sep 17 00:00:00 2001 From: A1lo Date: Fri, 24 Nov 2023 22:29:01 +0800 Subject: [PATCH 30/31] zh-cn: update the translation of Navigator.mediaDevices (#17089) Co-authored-by: Jason Ren <40999116+jasonren0403@users.noreply.github.com> --- .../web/api/navigator/mediadevices/index.md | 20 +++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) diff --git a/files/zh-cn/web/api/navigator/mediadevices/index.md b/files/zh-cn/web/api/navigator/mediadevices/index.md index ee00d303c26525..484d855459ee67 100644 --- a/files/zh-cn/web/api/navigator/mediadevices/index.md +++ b/files/zh-cn/web/api/navigator/mediadevices/index.md @@ -1,19 +1,23 @@ --- -title: Navigator.mediaDevices +title: Navigator:mediaDevices 属性 slug: Web/API/Navigator/mediaDevices +l10n: + sourceCommit: ef75c1741b450c2331204be5563ee964ad5f4c48 --- -{{APIRef("Media Capture and Streams")}}mediaDevices 是 Navigator 只读属性,返回一个 {{domxref("MediaDevices")}} 对象,该对象可提供对相机和麦克风等媒体输入设备的连接访问,也包括屏幕共享。 +{{APIRef("Media Capture and Streams")}}{{securecontext_header}} + +**`Navigator.mediaDevices`** 只读属性返回一个 {{domxref("MediaDevices")}} 对象,该对象可提供对相机和麦克风等媒体输入设备以及屏幕共享的连接访问。 ## 语法 -```plain -var mediaDevices = navigator.mediaDevices; +```js-nolint +navigator.mediaDevices ``` ### 返回值 -{{domxref("MediaDevices")}} 是一个单例对象。通常,你只需直接使用此对象的成员,例如通过调用{{domxref("navigator.mediaDevices.getUserMedia()")}}。 +{{domxref("MediaDevices")}} 单例对象。通常,你只需直接使用此对象的成员,例如调用 {{domxref("navigator.mediaDevices.getUserMedia()")}}。 ## 规范 @@ -23,7 +27,7 @@ var mediaDevices = navigator.mediaDevices; {{Compat}} -## 参考阅读 +## 参见 -- [Media Capture and Streams API](/zh-CN/docs/Web/API/Media_Streams_API): The entry point to the documentation about the entire media stream API. -- [WebRTC API](/zh-CN/docs/Web/API/WebRTC_API): Documentation about the WebRTC API, which is closely related. +- [媒体捕捉与媒体流 API](/zh-CN/docs/Web/API/Media_Capture_and_Streams_API):有关整个媒体捕捉与媒体流 API 的文档的入口点。 +- [WebRTC API](/zh-CN/docs/Web/API/WebRTC_API):与之密切相关的 WebRTC API 的相关文档。 From 0ec0abbae1bc830a3323b98a7a89072189523622 Mon Sep 17 00:00:00 2001 From: A1lo Date: Fri, 24 Nov 2023 22:33:30 +0800 Subject: [PATCH 31/31] zh-cn: init the translation of API ref sidebars (#16512) --- .../write_an_api_reference/sidebars/index.md | 95 +++++++++++++++++++ 1 file changed, 95 insertions(+) create mode 100644 files/zh-cn/mdn/writing_guidelines/howto/write_an_api_reference/sidebars/index.md diff --git a/files/zh-cn/mdn/writing_guidelines/howto/write_an_api_reference/sidebars/index.md b/files/zh-cn/mdn/writing_guidelines/howto/write_an_api_reference/sidebars/index.md new file mode 100644 index 00000000000000..ec0c9b6ae91e9d --- /dev/null +++ b/files/zh-cn/mdn/writing_guidelines/howto/write_an_api_reference/sidebars/index.md @@ -0,0 +1,95 @@ +--- +title: API 参考侧边栏 +slug: MDN/Writing_guidelines/Howto/Write_an_API_reference/Sidebars +l10n: + sourceCommit: fc7310a85a8e6d5c0677dfaffba9b8fbbadc94a9 +--- + +{{MDNSidebar}} + +你可以在 API 参考页面上包含一个自定义侧边栏,以便它显示与该 API 相关的接口、教程和其他资源的链接。本文介绍了如何实现。 + +## 创建侧边栏 + +你需要完成以下三个步骤来创建你的 API 侧边栏: + +1. 创建你的 API 参考页面。 +2. 将你的特定 API 的条目添加到 [`GroupData.json`](https://github.com/mdn/content/blob/main/files/jsondata/GroupData.json) 文件中。 +3. 使用 [`APIRef`](https://github.com/mdn/yari/blob/main/kumascript/macros/APIRef.ejs) 宏将侧边栏插入到你想要显示它的每个页面中。 + +让我们依次介绍这三个步骤。本文中我们将以 [Fetch API](/zh-CN/docs/Web/API/Fetch_API) 为示例。 + +### 向 GroupData.json 添加条目 + +`GroupData.json` 文件包含与 API 参考侧边栏中应显示的链接相关的所有数据。在 `APIRef` 宏被调用时,需要将一个 API 名称作为参数传递给它,然后它会在 `GroupData.json` 中查找该名称,构建一个适当的侧边栏,并将其插入到页面中。 + +要在 `GroupData.json` 中添加条目,你需要: + +1. 确保你有一个 [GitHub](https://github.com/) 账户。 +2. 复刻(fork)MDN 内容(content)仓库,再创建一个新的分支来包含你的更改,并将仓库克隆到本地。 +3. 在开始工作前,签出(checkout)你的新分支,并在完成工作后确保你将更改推送到该分支。 +4. 创建拉取请求(pull request),以便 MDN 团队可以审查你的工作,并在必要时提出更改。 + +`GroupData.json` 文件可以在 `files/jsondata/` 目录中找到。查看该文件,你会看到一个巨大的 JSON 结构,其中每个 API 都有自己的成员。名称为 API 名称,值为一个对象,其中包含定义要创建的侧边栏链接的几个子成员。 + +例如,查看 MDN 上的 [Fetch API](/zh-CN/docs/Web/API/Fetch_API) 页面。在 `GroupData.json` 中对应的条目如下所示: + +```json +"Fetch API": { + "overview": [ "Fetch API"], + "interfaces": [ "Headers", + "Request", + "Response", + "FetchController", + "FetchObserver", + "FetchSignal", + "ObserverCallback" ], + "methods": [ "fetch()" ], + "properties": [], + "events": [] +}, +``` + +如你所见,我们将“Fetch API”作为名称,其对象值中包含了许多子成员。 + +#### GroupData 条目中包含的子成员 + +此部分列出了你可以在 `GroupData` 条目中包含的所有子成员。 + +注意,列在列出的子成员中的大部分值都等同于链接文本,以及附加到主 API 索引页面(`https://developer.mozilla.org//docs/Web/API`)的末尾的别名(slug)以创建显示的链接的最终 URL。因此,例如,“Response”将创建如下链接: + +```html +
  • Response
  • +``` + +这也有些例外。例如,“guides”子成员包含指向与指南/教程相关的 URL。在这种情况下,URL 将附加到 MDN 文档根路径(`https://developer.mozilla.org/`)的末尾,因而允许包含 MDN 上任何位置的文章。 + +以下是可用的成员。这些都是可选的,但强烈建议你不要省略它们,而是包含空数组。 + +1. `"overview"`——该值是一个数组,如果有的话,请在其中包含 API 概述页面的别名(slug)。“Fetch API”会创建如下链接:[https://developer.mozilla.org/zh-CN/docs/Web/API/Fetch_API](/zh-CN/docs/Web/API/Fetch_API)。 +2. `"interfaces"`——该值是一个数组,你应该在其中列出组成该 API 的所有接口。“Response”会创建如下链接:[https://developer.mozilla.org/zh-CN/docs/Web/API/Response](/zh-CN/docs/Web/API/Response)。 +3. `"methods"`——该值是一个数组,其中应包含由规范添加的与其他 API 相关的接口的任何方法,例如在 {{domxref("Navigator")}} 或 {{domxref("Window")}} 上创建的实例化方法。如果有大量的方法,你可能需要考虑只列出最受欢迎的方法,或者将它们放在列表的前面。“fetch()”会创建如下链接:[https://developer.mozilla.org/zh-CN/docs/Web/API/fetch](/zh-CN/docs/Web/API/fetch)。请*不要*列出属于同一 API 拥有的接口的成员方法。 +4. `"properties"`——该值是一个数组,其中应包含与 API 相关的所有属性。这可以包括 API 规范中定义的接口的成员属性,以及 API 在其他接口上定义的属性。如果有大量的属性,你可能需要考虑只列出最受欢迎的属性,或者将它们放在列表的前面。“Headers.append”会创建如下链接:[https://developer.mozilla.org/zh-CN/docs/Web/API/Headers/append](/zh-CN/docs/Web/API/Headers/append)。 +5. `"events"`——该值是一个数组,其中应包含属于 API 而定义它的接口又*不*属于该 API 的事件的*标题*(属于 API 的接口(`interfaces`)中的事件会被默认记录)。如果有大量的事件,你可能需要考虑只列出最受欢迎的事件,或者将它们放在列表的前面。例如,`"Document: selectionchange"` 属于 [Selection API](/zh-CN/docs/Web/API/Selection_API),但 `Document` 并不属于,所以我们将该事件添加到数组中,[Selection API](/zh-CN/docs/Web/API/Selection_API) 主题会链接到该事件。 +6. `"guides"`——该值是一个字符串数组,其中的每一个都是涉及解释如何使用该 API 的指南的主题。这些字符串包含了指南 URL 在语言路径之后的部分:即,指南 URL 的 `/docs/...` 部分。例如,要链接到位于 `https://developer.mozilla.org/zh-CN/docs/Web/API/Fetch_API/Using_Fetch` 的主题“使用 Fetch”,指南数组中需要包含“/docs/Web/API/Fetch_API/Using_Fetch”。 +7. `"dictionaries"`——该值是一个字符串数组,其中列出了 API 的所有字典。通常,只有被多个属性或方法使用的字典才应该在此列出,除非它们具有特殊意义或可能需要从多个页面引用。“CryptoKeyPair”会创建如下链接:[https://developer.mozilla.org/zh-CN/docs/Web/API/CryptoKeyPair](/zh-CN/docs/Web/API/CryptoKeyPair)。 + > **备注:** MDN 正在逐步停止单独记录字典。在可能的情况下,这里现在描述的是使用了它们的对象。 +8. `"types"`——该值是一个数组,其中包含 API 定义的 typedef 和枚举类型。你可以选择只列出那些特别重要的或被多个页面所引用的类型,以便保持列表的简洁。 + > **备注:** MDN 正在逐步停止单独记录 typedef。在可能的情况下,这里现在描述的是使用了它们的值。 +9. `"callbacks"`——该值是一个数组,其中包含 API 定义的所有回调类型的列表。你可能会发现即使是在包含回调类型的 API 上,也根本不需要使用这个组别,因为它们通常不适合单独记录。 + +## 侧边栏使用的标签 + +一些子成员是根据页面标签自动发现的。在顶级 API 下的页面在每次渲染侧边栏时都会被抓取,然后会自动创建方法(“Method”标签)、属性(“Property”标签)和构造函数(“Constructor”标签)的条目。 + +子成员会根据标签自动添加警告图标:为实验性(“Experimental”标签)、非标准(“Non Standard”或“Non-standard”标签)或已弃用(“Deprecated”标签)的子成员添加特定的图标。 + +有关基于标签的处理的更多信息,请参阅 [APIRef 源代码](https://github.com/mdn/yari/blob/main/kumascript/macros/APIRef.ejs)。 + +## 插入侧边栏 + +在你将 API 条目添加到 `GroupData.json` 中,并将其作为拉取请求提交且更改已被主仓库接受后,你可以使用 [`APIRef`](https://github.com/mdn/yari/blob/main/kumascript/macros/APIRef.ejs) 宏(该宏以你在 GroupData 中为 API 使用的名称作为参数),将其包含在 API 参考页面中。例如,通过以下内容为 [WebVR API](/zh-CN/docs/Web/API/WebVR_API) 添加侧边栏: + +```plain +\{{APIRef("WebVR API")}} +```