diff --git a/files/zh-cn/web/api/element/scrollleft/index.md b/files/zh-cn/web/api/element/scrollleft/index.md index f3d1964cddc9ac..866400d03ad757 100644 --- a/files/zh-cn/web/api/element/scrollleft/index.md +++ b/files/zh-cn/web/api/element/scrollleft/index.md @@ -12,19 +12,7 @@ slug: Web/API/Element/scrollLeft > [!WARNING] > 在使用显示比例缩放的系统上，`scrollLeft` 可能会是一个小数。 -## 语法 - -``` -//获取滚动条到元素左边的距离 -var sLeft = element.scrollLeft; -``` - -`sLeft`是一个整数，代表元素滚动条距离元素左边多少像素。 - -``` -//设置滚动条滚动了多少像素 -element.scrollLeft = 10; -``` +## 值 `scrollLeft` 可以是任意整数，然而： diff --git a/files/zh-cn/web/api/mediarecorder/dataavailable_event/index.md b/files/zh-cn/web/api/mediarecorder/dataavailable_event/index.md index e045fe0168159c..1b931c6f4e2971 100644 --- a/files/zh-cn/web/api/mediarecorder/dataavailable_event/index.md +++ b/files/zh-cn/web/api/mediarecorder/dataavailable_event/index.md @@ -19,33 +19,33 @@ slug: Web/API/MediaRecorder/dataavailable_event ## 语法 -``` -MediaRecorder.ondataavailable = function(event) { ... } -MediaRecorder.addEventListener('dataavailable', function(event) { ... }) -``` +在类似 {{domxref("EventTarget.addEventListener", "addEventListener()")}} 这样的方法中使用事件名称，或设置事件处理器属性。 -## 示例 +```js +addEventListener("dataavailable", (event) => {}); +ondataavailable = (event) => {}; ``` -... - var chunks = []; - mediaRecorder.onstop = function(e) { - console.log("data available after MediaRecorder.stop() called."); +## 示例 + +```js +const chunks = []; - var audio = document.createElement('audio'); - audio.controls = true; - var blob = new Blob(chunks, { 'type' : 'audio/ogg; codecs=opus' }); - var audioURL = window.URL.createObjectURL(blob); - audio.src = audioURL; - console.log("录像停止"); - } +mediaRecorder.onstop = (e) => { + console.log("数据将在调用 MediaRecorder.stop() 后可用。"); - mediaRecorder.ondataavailable = function(e) { - chunks.push(e.data); - } + const audio = document.createElement("audio"); + audio.controls = true; + const blob = new Blob(chunks, { type: mediaRecorder.mimeType }); + const audioURL = window.URL.createObjectURL(blob); + audio.src = audioURL; + console.log("录制停止"); +}; -... +mediaRecorder.ondataavailable = (e) => { + chunks.push(e.data); +}; ``` ## 规范 diff --git a/files/zh-cn/web/api/mediarecorder/mediarecorder/index.md b/files/zh-cn/web/api/mediarecorder/mediarecorder/index.md index 0cbf8855353b76..342552a1340942 100644 --- a/files/zh-cn/web/api/mediarecorder/mediarecorder/index.md +++ b/files/zh-cn/web/api/mediarecorder/mediarecorder/index.md @@ -9,8 +9,9 @@ slug: Web/API/MediaRecorder/MediaRecorder ## 语法 -``` -var mediaRecorder = new MediaRecorder(stream[, options]); +```js-nolint +new MediaRecorder(stream) +new MediaRecorder(stream, options) ``` ### 参数 diff --git a/files/zh-cn/web/api/mediastreamtrack/getconstraints/index.md b/files/zh-cn/web/api/mediastreamtrack/getconstraints/index.md index f6882b1a4c9ccb..14cfbb79e0b09a 100644 --- a/files/zh-cn/web/api/mediastreamtrack/getconstraints/index.md +++ b/files/zh-cn/web/api/mediastreamtrack/getconstraints/index.md @@ -9,10 +9,10 @@ slug: Web/API/MediaStreamTrack/getConstraints 约束条件可以用来确保媒体符合你喜欢的某些指导方针。例如，你可能更喜欢高清视频，但要求帧率略低，以帮助保持足够低的数据速率而不会使网络负担过重。约束还可以指定理想和/或可接受的尺寸或尺寸范围。有关如何使用可约束属性的详细信息[，](/zh-CN/docs/Web/API/Media_Streams_API/Constraints)请参阅[能力，约束和设置](/zh-CN/docs/Web/API/Media_Streams_API/Constraints)。 -## 句法 +## 语法 -``` -var constraints = MediaStreamTrack.getConstraints(); +```js-nolint +getConstraints() ``` ### 参数 diff --git a/files/zh-cn/web/api/mouseevent/altkey/index.md b/files/zh-cn/web/api/mouseevent/altkey/index.md index c7d285f9e6089e..528b33e490bf6b 100644 --- a/files/zh-cn/web/api/mouseevent/altkey/index.md +++ b/files/zh-cn/web/api/mouseevent/altkey/index.md @@ -7,12 +7,6 @@ slug: Web/API/MouseEvent/altKey **`MouseEvent.altKey`** 只读属性是一个{{jsxref("Boolean")}}变量。当事件触发时，如果alt 被按下，则返回 true，否则返回 false。 -## 语法 - -``` -var altKeyPressed = instanceOfMouseEvent.altKey -``` - ## 示例 ```js diff --git a/files/zh-cn/web/api/mouseevent/initmouseevent/index.md b/files/zh-cn/web/api/mouseevent/initmouseevent/index.md index a57c347b25fe95..c89855fc35a6ba 100644 --- a/files/zh-cn/web/api/mouseevent/initmouseevent/index.md +++ b/files/zh-cn/web/api/mouseevent/initmouseevent/index.md @@ -15,14 +15,14 @@ slug: Web/API/MouseEvent/initMouseEvent ## 语法 -``` -event.initMouseEvent(type, canBubble, cancelable, view, +```js-nolint +initMouseEvent(type, canBubble, cancelable, view, detail, screenX, screenY, clientX, clientY, ctrlKey, altKey, shiftKey, metaKey, - button, relatedTarget); + button, relatedTarget) ``` -### 形参 +### 参数 - _`type`_ - : 设置事件类型{{domxref("Event.type", "type")}} 的字符串，包含以下几种鼠标事件：`click`，`mousedown`，`mouseup`，`mouseover`，`mousemove`，`mouseout`。 diff --git a/files/zh-cn/web/api/mouseevent/metakey/index.md b/files/zh-cn/web/api/mouseevent/metakey/index.md index 3a7e222d64fd02..d95d80535dcf3e 100644 --- a/files/zh-cn/web/api/mouseevent/metakey/index.md +++ b/files/zh-cn/web/api/mouseevent/metakey/index.md @@ -10,13 +10,7 @@ slug: Web/API/MouseEvent/metaKey > [!NOTE] > 在 MAC 键盘上，表示 Command 键（⌘），在 Windows 键盘上，表示 Windows 键（⊞）。 -## 语法 - -``` -var metaKeyPressed = instanceOfMouseEvent.metaKey -``` - -### 返回值 +## 值 一个布尔值。 diff --git a/files/zh-cn/web/api/mouseevent/mouseevent/index.md b/files/zh-cn/web/api/mouseevent/mouseevent/index.md index dd255711c6ad9c..3553919d80587a 100644 --- a/files/zh-cn/web/api/mouseevent/mouseevent/index.md +++ b/files/zh-cn/web/api/mouseevent/mouseevent/index.md @@ -9,11 +9,12 @@ slug: Web/API/MouseEvent/MouseEvent ## 语法 -``` - event = new MouseEvent(typeArg, mouseEventInit); +```js-nolint +new MouseEvent(type) +new MouseEvent(type, options) ``` -### 形参 +### 参数 - _typeArg_ - : {{domxref("DOMString")}} 格式的事件名称。 diff --git a/files/zh-cn/web/api/mouseevent/relatedtarget/index.md b/files/zh-cn/web/api/mouseevent/relatedtarget/index.md index d3f832716bd6e9..cb36fbac0773f7 100644 --- a/files/zh-cn/web/api/mouseevent/relatedtarget/index.md +++ b/files/zh-cn/web/api/mouseevent/relatedtarget/index.md @@ -19,13 +19,7 @@ slug: Web/API/MouseEvent/relatedTarget 如果事件没有次要目标，`relatedTarget` 将返回 `null`. -## 语法 - -``` -var target = instanceOfMouseEvent.relatedTarget -``` - -### 返回值 +## 值 {{domxref("EventTarget")}} 对象或者 `null`. diff --git a/files/zh-cn/web/api/mousescrollevent/index.md b/files/zh-cn/web/api/mousescrollevent/index.md index 526c43a2817396..8e6197dd297bf6 100644 --- a/files/zh-cn/web/api/mousescrollevent/index.md +++ b/files/zh-cn/web/api/mousescrollevent/index.md @@ -11,7 +11,7 @@ slug: Web/API/MouseScrollEvent ## 方法概述 -``` +```webidl void initMouseScrollEvent( in DOMString typeArg, in boolean canBubbleArg, diff --git a/files/zh-cn/web/api/mutationobserver/disconnect/index.md b/files/zh-cn/web/api/mutationobserver/disconnect/index.md index 33d9935cfa05f7..bca6c94cc583dd 100644 --- a/files/zh-cn/web/api/mutationobserver/disconnect/index.md +++ b/files/zh-cn/web/api/mutationobserver/disconnect/index.md @@ -9,8 +9,8 @@ slug: Web/API/MutationObserver/disconnect ## 语法 -``` -mutationObserver.disconnect() +```js-nolint +disconnect() ``` ### 参数 diff --git a/files/zh-cn/web/api/mutationobserver/takerecords/index.md b/files/zh-cn/web/api/mutationobserver/takerecords/index.md index 717b8536931068..8761d90ce4deae 100644 --- a/files/zh-cn/web/api/mutationobserver/takerecords/index.md +++ b/files/zh-cn/web/api/mutationobserver/takerecords/index.md @@ -9,8 +9,8 @@ slug: Web/API/MutationObserver/takeRecords ## 语法 -``` -mutationRecords = mutationObserver.takeRecords() +```js-nolint +takeRecords() ``` ### 参数 diff --git a/files/zh-cn/web/api/navigator/getusermedia/index.md b/files/zh-cn/web/api/navigator/getusermedia/index.md index b8bfb6d44f899d..123cae929efa66 100644 --- a/files/zh-cn/web/api/navigator/getusermedia/index.md +++ b/files/zh-cn/web/api/navigator/getusermedia/index.md @@ -12,8 +12,8 @@ slug: Web/API/Navigator/getUserMedia ## 语法 -``` -navigator.getUserMedia ( constraints, successCallback, errorCallback ); +```js-nolint +getUserMedia(constraints, successCallback, errorCallback) ``` ### 参数 @@ -78,7 +78,7 @@ if (navigator.getUserMedia) { 在一个可以安装的 app（比如，Firefox OS app）中使用 getUserMedia()，你需要在你的 manifest 文件中指定一个或者多个以下条目： -``` +```json "permissions": { "audio-capture": { "description": "Required to capture audio using getUserMedia()" diff --git a/files/zh-cn/web/api/node/appendchild/index.md b/files/zh-cn/web/api/node/appendchild/index.md index 815427b29e312a..b2e62e981aa0d0 100644 --- a/files/zh-cn/web/api/node/appendchild/index.md +++ b/files/zh-cn/web/api/node/appendchild/index.md @@ -15,8 +15,8 @@ slug: Web/API/Node/appendChild ## 语法 -``` -element.appendChild(aChild) +```js-nolint +appendChild(aChild) ``` ### 参数 diff --git a/files/zh-cn/web/api/node/clonenode/index.md b/files/zh-cn/web/api/node/clonenode/index.md index 0e800deea05e1e..e6302aaa108442 100644 --- a/files/zh-cn/web/api/node/clonenode/index.md +++ b/files/zh-cn/web/api/node/clonenode/index.md @@ -9,8 +9,9 @@ slug: Web/API/Node/cloneNode ## 语法 -``` -var dupNode = node.cloneNode(deep); +```js-nolint +cloneNode() +cloneNode(deep) ``` - `node` diff --git a/files/zh-cn/web/api/node/comparedocumentposition/index.md b/files/zh-cn/web/api/node/comparedocumentposition/index.md index e0971bfc88cb88..8bceff24424e0d 100644 --- a/files/zh-cn/web/api/node/comparedocumentposition/index.md +++ b/files/zh-cn/web/api/node/comparedocumentposition/index.md @@ -20,8 +20,8 @@ slug: Web/API/Node/compareDocumentPosition ## 语法 -``` -compareMask = node.compareDocumentPosition( otherNode ) +```js-nolint +compareDocumentPosition(otherNode) ``` ### 参数 diff --git a/files/zh-cn/web/api/node/haschildnodes/index.md b/files/zh-cn/web/api/node/haschildnodes/index.md index 31552e3686557a..65d4969ead2e35 100644 --- a/files/zh-cn/web/api/node/haschildnodes/index.md +++ b/files/zh-cn/web/api/node/haschildnodes/index.md @@ -5,17 +5,15 @@ slug: Web/API/Node/hasChildNodes {{ApiRef}} -### 概述 - **hasChildNodes**方法返回一个[布尔值](/zh-CN/docs/JavaScript/Reference/Global_Objects/Boolean),表明当前[节点](/zh-CN/docs/DOM/Node)是否包含有[子节点](/zh-CN/docs/DOM/Node.childNodes). ## 语法 -``` -element.hasChildNodes() +```js-nolint +hasChildNodes() ``` -## 例子 +## 示例 下面的例子演示了：如果 id 为 foo 的这个元素有子节点，则从 dom 树中删除它的第一个子节点。 diff --git a/files/zh-cn/web/api/node/nodename/index.md b/files/zh-cn/web/api/node/nodename/index.md index fa5e4fd637d733..06920c1253a00b 100644 --- a/files/zh-cn/web/api/node/nodename/index.md +++ b/files/zh-cn/web/api/node/nodename/index.md @@ -7,15 +7,6 @@ slug: Web/API/Node/nodeName 返回当前节点的节点名称 -## 语法 - -``` -var str = node.nodeName; -``` - -- `str` 是一个存储了当前节点的节点名称的字符串。 -- `nodeName 是一个只读属性`. - ## 附注 下表列出了所有类型的节点的`nodeName`属性的值。 diff --git a/files/zh-cn/web/api/node/textcontent/index.md b/files/zh-cn/web/api/node/textcontent/index.md index a5506012f97c68..3ec11cda4e6642 100644 --- a/files/zh-cn/web/api/node/textcontent/index.md +++ b/files/zh-cn/web/api/node/textcontent/index.md @@ -9,14 +9,7 @@ slug: Web/API/Node/textContent > **备注：** `textContent` 和 {{domxref("HTMLElement.innerText")}} 容易混淆，但这两个属性在[重要方面有不同之处](/zh-CN/docs/Web/API/Node/textContent#与_innerText_的区别) 。 -## 语法 - -``` -let text = someNode.textContent; -someOtherNode.textContent = string; -``` - -### 返回值 +## 值 一个字符串或 `null`. diff --git a/files/zh-cn/web/api/nodelist/entries/index.md b/files/zh-cn/web/api/nodelist/entries/index.md index 38fb47443b18c7..e6240600e68001 100644 --- a/files/zh-cn/web/api/nodelist/entries/index.md +++ b/files/zh-cn/web/api/nodelist/entries/index.md @@ -9,15 +9,15 @@ slug: Web/API/NodeList/entries ## 语法 -``` -list.entries(); +```js-nolint +entries() ``` ### 返回值 返回一个 {{jsxref("Iteration_protocols","iterator")}}. -## 例子 +## 示例 ```js var node = document.createElement("div"); @@ -38,7 +38,7 @@ for (var entry of list.entries()) { 结果如下： -``` +```plain Array [ 0,

] Array [ 1, #text "hey" ] Array [ 2, ] @@ -48,7 +48,7 @@ Array [ 2, ] {{Compat}} -## 相关链接 +## 参见 - {{domxref("Node")}} - {{domxref("NodeList")}} diff --git a/files/zh-cn/web/api/nodelist/foreach/index.md b/files/zh-cn/web/api/nodelist/foreach/index.md index cc01794628972a..171f2baecaa7c4 100644 --- a/files/zh-cn/web/api/nodelist/foreach/index.md +++ b/files/zh-cn/web/api/nodelist/foreach/index.md @@ -9,8 +9,9 @@ slug: Web/API/NodeList/forEach ## 语法 -``` -someNodeList.forEach(callback[, thisArg]); +```js-nolint +forEach(callback) +forEach(callback, thisArg) ``` ### 参数 @@ -54,7 +55,7 @@ list.forEach(function (currentValue, currentIndex, listObj) { 上述代码会产生以下结果： -``` +```plain [object HTMLParagraphElement], 0, myThisArg [object Text], 1, myThisArg [object HTMLSpanElement], 2, myThisArg diff --git a/files/zh-cn/web/api/nodelist/keys/index.md b/files/zh-cn/web/api/nodelist/keys/index.md index 691eff2b3cc1e3..9a236d9fa23a74 100644 --- a/files/zh-cn/web/api/nodelist/keys/index.md +++ b/files/zh-cn/web/api/nodelist/keys/index.md @@ -9,15 +9,15 @@ slug: Web/API/NodeList/keys ## 语法 -``` -nodeList.keys(); +```js-nolint +keys() ``` ### 返回值 返回 {{jsxref("Iteration_protocols","iterator")}}. -## 例子 +## 示例 ```js var node = document.createElement("div"); @@ -39,7 +39,7 @@ for (var key of list.keys()) { 结果是： -``` +```plain 0 1 2 @@ -49,7 +49,7 @@ for (var key of list.keys()) { {{Compat}} -## 相关链接 +## 参见 - {{domxref("Node")}} - {{domxref("NodeList")}} diff --git a/files/zh-cn/web/api/oscillatornode/setperiodicwave/index.md b/files/zh-cn/web/api/oscillatornode/setperiodicwave/index.md index a75e51a7b186ac..a54bf3b7c9f8a2 100644 --- a/files/zh-cn/web/api/oscillatornode/setperiodicwave/index.md +++ b/files/zh-cn/web/api/oscillatornode/setperiodicwave/index.md @@ -12,8 +12,8 @@ slug: Web/API/OscillatorNode/setPeriodicWave ## 语法 -``` -OscillatorNode.setPeriodicWave(wave); +```js-nolint +setPeriodicWave(wave) ``` ### 参数 diff --git a/files/zh-cn/web/api/path2d/addpath/index.md b/files/zh-cn/web/api/path2d/addpath/index.md index e970d224db610c..d92eff9947da87 100644 --- a/files/zh-cn/web/api/path2d/addpath/index.md +++ b/files/zh-cn/web/api/path2d/addpath/index.md @@ -9,8 +9,9 @@ slug: Web/API/Path2D/addPath ## 语法 -``` -void path.addPath(path [, transform]); +```js-nolint +addPath(path) +addPath(path, transform) ``` ### 参数 diff --git a/files/zh-cn/web/api/path2d/path2d/index.md b/files/zh-cn/web/api/path2d/path2d/index.md index c1e35de1f603d8..15d2ba48e2d16f 100644 --- a/files/zh-cn/web/api/path2d/path2d/index.md +++ b/files/zh-cn/web/api/path2d/path2d/index.md @@ -9,10 +9,10 @@ slug: Web/API/Path2D/Path2D ## 语法 -``` -new Path2D(); -new Path2D(path); -new Path2D(d); +```js-nolint +new Path2D() +new Path2D(path) +new Path2D(d) ``` ### 参数 diff --git a/files/zh-cn/web/api/performance/clearmarks/index.md b/files/zh-cn/web/api/performance/clearmarks/index.md index 6ccfa17ff87776..99fcbc11a44097 100644 --- a/files/zh-cn/web/api/performance/clearmarks/index.md +++ b/files/zh-cn/web/api/performance/clearmarks/index.md @@ -9,9 +9,9 @@ slug: Web/API/Performance/clearMarks ## 语法 -``` -performance.clearMarks(); -performance.clearMarks(name); +```js-nolint +clearMarks() +clearMarks(name) ``` ### 参数 @@ -23,7 +23,7 @@ performance.clearMarks(name); 无 -## 例子 +## 示例 下面的例子演示 `clearMarks()` 的两种用法。 diff --git a/files/zh-cn/web/api/performance/clearmeasures/index.md b/files/zh-cn/web/api/performance/clearmeasures/index.md index 97f9ee79a74142..ab1e64596bdc2d 100644 --- a/files/zh-cn/web/api/performance/clearmeasures/index.md +++ b/files/zh-cn/web/api/performance/clearmeasures/index.md @@ -11,9 +11,9 @@ slug: Web/API/Performance/clearMeasures ## 语法 -``` -performance.clearMeasures(); -performance.clearMeasures(name); +```js-nolint +clearMeasures() +clearMeasures(name) ``` ### 参数 @@ -25,7 +25,7 @@ performance.clearMeasures(name); 无 -## 例子 +## 示例 下面的两个例子演示了 `clearMeasures()` 的用法。 diff --git a/files/zh-cn/web/api/performance/getentries/index.md b/files/zh-cn/web/api/performance/getentries/index.md index f6140c35405fbd..ac192c556e897c 100644 --- a/files/zh-cn/web/api/performance/getentries/index.md +++ b/files/zh-cn/web/api/performance/getentries/index.md @@ -13,15 +13,8 @@ slug: Web/API/Performance/getEntries 取全部： -``` -entries = window.performance.getEntries(); -entries = window.performance.getEntries(PerformanceEntryFilterOptions); -``` - -取特定： - -``` -entries = performance.getEntries({name: "entry_name", entryType: "mark"}); +```js-nolint +getEntries() ``` ### 参数 @@ -39,7 +32,7 @@ entries = performance.getEntries({name: "entry_name", entryType: "mark"}); - entries - : 一个由符合 filter 条件的{{domxref("PerformanceEntry")}} 对象构成的数组 . 数组成员按 PerformanceEntry.{{domxref("PerformanceEntry.startTime","startTime")}}时间顺序排列 . 如果没有符合 filter 条件的对象，那么返回空数组。如果不带任何参数，返回全部 entries. -## Example +## 示例 ```js function use_PerformanceEntry_methods() { diff --git a/files/zh-cn/web/api/performance/mark/index.md b/files/zh-cn/web/api/performance/mark/index.md index a2a4cac80b28e1..37dd228cc3ec37 100644 --- a/files/zh-cn/web/api/performance/mark/index.md +++ b/files/zh-cn/web/api/performance/mark/index.md @@ -20,8 +20,9 @@ slug: Web/API/Performance/mark ## 语法 -``` -performance.mark(name); +```js-nolint +mark(name) +mark(name, markOptions) ``` ### 参数 diff --git a/files/zh-cn/web/api/performance/measure/index.md b/files/zh-cn/web/api/performance/measure/index.md index 381f93afcc3e0f..aa41d1dc85b685 100644 --- a/files/zh-cn/web/api/performance/measure/index.md +++ b/files/zh-cn/web/api/performance/measure/index.md @@ -20,8 +20,12 @@ The `measure's` {{domxref("PerformanceEntry","performance entry")}} will have th ## 语法 -``` -performance.measure(name, startMark, endMark); +```js-nolint +measure(measureName) +measure(measureName, startMark) +measure(measureName, startMark, endMark) +measure(measureName, measureOptions) +measure(measureName, measureOptions, endMark) ``` ### 参数 diff --git a/files/zh-cn/web/api/performance/now/index.md b/files/zh-cn/web/api/performance/now/index.md index a4e7f4f9e7dbd7..ec476f3cfc5aa6 100644 --- a/files/zh-cn/web/api/performance/now/index.md +++ b/files/zh-cn/web/api/performance/now/index.md @@ -21,8 +21,8 @@ slug: Web/API/Performance/now ## 语法 -``` -const t = window.performance.now(); +```js-nolint +now() ``` ## 示例 @@ -43,7 +43,7 @@ console.log("doSomething 函数执行了" + (t1 - t0) + "毫秒。"); 为了提供对定时攻击和指纹的保护，performance.now() 的精度可能会根据浏览器的设置而被舍弃。 在 Firefox 中，privacy.reduceTimerPrecision 偏好是默认启用的，默认值为 1ms。 -``` +```js // 降低时间精度 (1ms) 在 Firefox 60 performance.now(); // 8781416 @@ -51,7 +51,6 @@ performance.now(); // 8782206 // ... - // 降低时间精度 当 `privacy.resistFingerprinting` 启用 performance.now(); // 8865400 @@ -64,7 +63,7 @@ performance.now(); 从 Firefox 79 开始，如果你使用{{HTTPHeader("Cross-Origin-Opener-Policy")}}和{{HTTPHeader("Cross-Origin-Embedder-Policy")}}头来跨源隔离你的文档，就可以使用高分辨率定时器。 -``` +```http Cross-Origin-Opener-Policy: same-origin Cross-Origin-Embedder-Policy: require-corp ``` @@ -79,6 +78,6 @@ Cross-Origin-Embedder-Policy: require-corp {{Compat}} -## 相关链接 +## 参见 - [When milliseconds are not enough: performance.now()](http://updates.html5rocks.com/2012/08/When-milliseconds-are-not-enough-performance-now) from HTML5 Rocks diff --git a/files/zh-cn/web/api/performance/timing/index.md b/files/zh-cn/web/api/performance/timing/index.md index 8adc50bf97f826..db23dac8362d25 100644 --- a/files/zh-cn/web/api/performance/timing/index.md +++ b/files/zh-cn/web/api/performance/timing/index.md @@ -10,12 +10,6 @@ slug: Web/API/Performance/timing **`Performance.timing`** 只读属性返回一个 {{domxref("PerformanceTiming")}} 对象，这个对象包括了页面相关的性能信息。 -## 语法 - -``` -timingInfo = performance.timing; -``` - ## 规范 因为 [Navigation Timing 规范](https://w3c.github.io/navigation-timing/#obsolete)已被弃用，此特性不再有望成为标准。请使用 {{domxref("PerformanceNavigationTiming")}} 接口代替。 @@ -24,6 +18,6 @@ timingInfo = performance.timing; {{Compat}} -## 相关 +## 参见 - {{domxref("Performance")}} 接口。 diff --git a/files/zh-cn/web/api/performance/tojson/index.md b/files/zh-cn/web/api/performance/tojson/index.md index dff9184ce9615e..9dfc37a36ae132 100644 --- a/files/zh-cn/web/api/performance/tojson/index.md +++ b/files/zh-cn/web/api/performance/tojson/index.md @@ -3,24 +3,26 @@ title: Performance.toJSON() slug: Web/API/Performance/toJSON --- -{{APIRef("High Resolution Timing")}}{{domxref("Performance")}} 的 **`toJSON() 方法是一个标准的串行器：它返回一个由 performance 对象各个属性组成的 JSON`** +{{APIRef("Performance API")}} -## Syntax +{{domxref("Performance")}} 接口的 **`toJSON()`** 方法是一个标准的 {{Glossary("Serialization","序列化器")}}，它返回 {{domxref("Performance")}} 对象的 JSON 表示。 -``` -myPerf = performance.toJSON() +## 语法 + +```js-nolint +toJSON() ``` -### Arguments +### 参数 -无 +无。 -### Return value +### 返回值 - myPerf - : {{domxref("Performance")}} 对象序列化之后转化成的 JSON 对象。 -## Example +## 示例 ```js var js; @@ -28,10 +30,10 @@ js = window.performance.toJSON(); console.log("json = " + JSON.stringify(js)); ``` -## Specifications +## 规范 {{Specifications}} -## Browser compatibility +## 浏览器兼容性 {{Compat}} diff --git a/files/zh-cn/web/api/performance_api/navigation_timing/index.md b/files/zh-cn/web/api/performance_api/navigation_timing/index.md index ca96ee20ed9afa..506de5d12c3277 100644 --- a/files/zh-cn/web/api/performance_api/navigation_timing/index.md +++ b/files/zh-cn/web/api/performance_api/navigation_timing/index.md @@ -31,7 +31,7 @@ slug: Web/API/Performance_API/Navigation_timing 以下示例显示了如何测量感知加载时间： -``` +```js function onLoad() { var now = new Date().getTime(); var page_load_time = now - performance.timing.navigationStart; @@ -82,13 +82,13 @@ Navigation Timing API 可以用于收集客户端性能数据，然后通过 XHR 计算页面加载所需的总时长： -``` +```js var perfData = window.performance.timing; var pageLoadTime = perfData.loadEventEnd - perfData.navigationStart; ``` 计算请求返回时长： -``` +```js var connectTime = perfData.responseEnd - perfData.requestStart; ``` diff --git a/files/zh-cn/web/api/pushmanager/subscribe/index.md b/files/zh-cn/web/api/pushmanager/subscribe/index.md index b1f6bb85ee329d..b6796c3670516c 100644 --- a/files/zh-cn/web/api/pushmanager/subscribe/index.md +++ b/files/zh-cn/web/api/pushmanager/subscribe/index.md @@ -11,8 +11,8 @@ slug: Web/API/PushManager/subscribe ## 语法 -``` -PushManager.subscribe(options).then(function(pushSubscription) { ... } ); +```js-nolint +subscribe(options) ``` ### 参数 @@ -30,26 +30,28 @@ PushManager.subscribe(options).then(function(pushSubscription) { ... } ); ## 示例 -``` -this.onpush = function(event) { +```js +this.onpush = function (event) { console.log(event.data); // 这里可以向 IndexDB 写入数据，向任何打开的窗口发送数据以及显示通知等 -} +}; -navigator.serviceWorker.register('serviceworker.js').then( - function(serviceWorkerRegistration) { +navigator.serviceWorker + .register("serviceworker.js") + .then(function (serviceWorkerRegistration) { var options = { userVisibleOnly: true, - applicationServerKey: applicationServerKey + applicationServerKey: applicationServerKey, }; serviceWorkerRegistration.pushManager.subscribe(options).then( - function(pushSubscription) { + function (pushSubscription) { console.log(pushSubscription.endpoint); // 应用服务器所需的推送订阅详情现在可用，并且可以通过如 XMLHttpRequest 的方式发送 - }, function(error) { + }, + function (error) { // 开发过程中将错误打印到控制台通常很有帮助。同样，生产环境下将错误信息发送至应用服务器后台也一样。 console.log(error); - } + }, ); }); ``` diff --git a/files/zh-cn/web/api/range/collapse/index.md b/files/zh-cn/web/api/range/collapse/index.md index b6b29d16ac5690..909b24b6e0edc5 100644 --- a/files/zh-cn/web/api/range/collapse/index.md +++ b/files/zh-cn/web/api/range/collapse/index.md @@ -13,8 +13,9 @@ slug: Web/API/Range/collapse ## 语法 -``` -range.collapse(toStart); +```js-nolint +collapse() +collapse(toStart) ``` ### 参数 @@ -22,7 +23,7 @@ range.collapse(toStart); - _toStart_ {{optional_inline}} - : 一个布尔值： `true` 折叠到 {{domxref("Range")}} 的 start 节点，`false` 折叠到 end 节点。如果省略，则默认为 false {{experimental_inline}}`.` -## 例子 +## 示例 ```js var range = document.createRange(); diff --git a/files/zh-cn/web/api/range/range/index.md b/files/zh-cn/web/api/range/range/index.md index 9cf237ab1c5b6f..122f46d1654dcf 100644 --- a/files/zh-cn/web/api/range/range/index.md +++ b/files/zh-cn/web/api/range/range/index.md @@ -9,8 +9,8 @@ slug: Web/API/Range/Range ## 语法 -``` -range = new Range() +```js-nolint +new Range() ``` ## 示例 diff --git a/files/zh-cn/web/api/range/selectnode/index.md b/files/zh-cn/web/api/range/selectnode/index.md index 330349fe253b91..02e7d24f3aeafb 100644 --- a/files/zh-cn/web/api/range/selectnode/index.md +++ b/files/zh-cn/web/api/range/selectnode/index.md @@ -9,8 +9,8 @@ slug: Web/API/Range/selectNode ## 语法 -``` -range.selectNode(referenceNode); +```js-nolint +selectNode(referenceNode) ``` ### 参数 diff --git a/files/zh-cn/web/api/range/selectnodecontents/index.md b/files/zh-cn/web/api/range/selectnodecontents/index.md index dda3437337fa2d..48fc32abb48c91 100644 --- a/files/zh-cn/web/api/range/selectnodecontents/index.md +++ b/files/zh-cn/web/api/range/selectnodecontents/index.md @@ -1,64 +1,70 @@ --- -title: Range.selectNodeContents() +title: Range：selectNodeContents() 方法 slug: Web/API/Range/selectNodeContents +l10n: + sourceCommit: c58e8c1dd6ecbcb63894c7dd17fb9495b9511b4e --- {{ApiRef("DOM")}} -**`Range.selectNodeContents()`** 方法用于设置 {{ domxref("Range") }}，使其包含一个 {{ domxref("Node") }} 的内容。 +**`Range.selectNodeContents()`** 方法用于设置 {{domxref("Range")}}，使其包含一个 {{ domxref("Node") }} 的内容。 -{{ domxref("Range") }} 的起始和结束节点的父节点即为引用节点。 `startOffset` 为 0, `endOffset` 则是引用节点包含的字符数或子节点个数。 +`Range` 的开始和结束节点的父节点（`Node`）即为引用节点。`startOffset` 为 0，`endOffset` 则是引用节点包含的字符数或子节点个数。 ## 语法 -``` -range.selectNodeContents(referenceNode); +```js-nolint +selectNodeContents(referenceNode) ``` ### 参数 -- _referenceNode_ - - : 此 {{ domxref("Node") }} 中的内容被包含在 {{ domxref("Range") }} 中。 +- `referenceNode` + - : 此{{domxref("Node", "节点", "", 1)}}中的内容会被 {{domxref("Range")}} 选中。 + +### 返回值 + +无（{{jsxref("undefined")}}）。 ## 示例 ```js -range = document.createRange(); -referenceNode = document.getElementsByTagName("div")[0]; +const range = document.createRange(); +const referenceNode = document.querySelector("div"); range.selectNodeContents(referenceNode); ``` -### 实时样例 +### 实时示例 -这个例子让用户使用按钮选择或取消选择一个段落。{{domxref("Document.createRange()")}}、 `Range.selectNodeContents()` 和 {{domxref("Selection.addRange()")}} 用于选择内容。{{domxref("Window.getSelection()")}} 和 {{domxref("Selection.removeAllRanges()")}} 用于取消选择。 +这个例子让用户使用按钮选择或取消选择一个段落。{{domxref("Document.createRange()")}}、`Range.selectNodeContents()` 和 {{domxref("Selection.addRange()")}} 用于选择内容。{{domxref("Window.getSelection()")}} 和 {{domxref("Selection.removeAllRanges()")}} 用于取消选择。 #### HTML -``` -

Use the buttons below to select or deselect the contents of this paragraph.

- - +```html +

使用下面的按钮选择或取消选择本段的内容。

+ + ``` #### JavaScript -``` -const p = document.getElementById('p'); -const selectButton = document.getElementById('select-button'); -const deselectButton = document.getElementById('deselect-button'); +```js +const p = document.getElementById("p"); +const selectButton = document.getElementById("select-button"); +const deselectButton = document.getElementById("deselect-button"); -selectButton.addEventListener('click', e => { - // Clear any current selection +selectButton.addEventListener("click", (e) => { + // 清除当前的任何选择 const selection = window.getSelection(); selection.removeAllRanges(); - // Select paragraph + // 选择段落 const range = document.createRange(); range.selectNodeContents(p); selection.addRange(range); }); -deselectButton.addEventListener('click', e => { +deselectButton.addEventListener("click", (e) => { const selection = window.getSelection(); selection.removeAllRanges(); }); @@ -66,7 +72,7 @@ deselectButton.addEventListener('click', e => { #### 结果 -{{EmbedLiveSample("实时样例")}} +{{EmbedLiveSample("实时示例")}} ## 规范 @@ -78,4 +84,4 @@ deselectButton.addEventListener('click', e => { ## 参见 -- [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/request/headers/index.md b/files/zh-cn/web/api/request/headers/index.md index f3082ffc7609f5..92d978eb27b5cb 100644 --- a/files/zh-cn/web/api/request/headers/index.md +++ b/files/zh-cn/web/api/request/headers/index.md @@ -7,17 +7,11 @@ slug: Web/API/Request/headers {{domxref("Request")}}接口的只读属性 **`headers`** 包含与当前请求关联的{{domxref("Headers")}}对象。 -## 语法 - -``` -var myHeaders = request.headers; -``` - -### 值 +## 值 一个 {{domxref("Headers")}} 对象。 -## 例子 +## 示例 在下面的代码段中，我们使用 {{domxref("Request.Request()")}} 构造函数（为获取与脚本处于同一目录的图片文件）创建新请求，然后将请求 headers 保存到变量中： @@ -52,7 +46,7 @@ myContentType = myRequest.headers.get("Content-Type"); // returns 'image/jpeg' {{Compat}} -## See also +## 参见 - [ServiceWorker API](/zh-CN/docs/Web/API/ServiceWorker_API) - [HTTP access control (CORS)](/zh-CN/docs/Web/HTTP/Access_control_CORS) diff --git a/files/zh-cn/web/api/request/request/index.md b/files/zh-cn/web/api/request/request/index.md index ea36bf4e3876cb..55d2575a79aea5 100644 --- a/files/zh-cn/web/api/request/request/index.md +++ b/files/zh-cn/web/api/request/request/index.md @@ -9,8 +9,9 @@ slug: Web/API/Request/Request ## 语法 -``` -var myRequest = new Request(input[, init]); +```js-nolint +new Request(input) +new Request(input, options) ``` ### 参数 diff --git a/files/zh-cn/web/api/response/error_static/index.md b/files/zh-cn/web/api/response/error_static/index.md index c72f18890c4353..3b27fc456a24d1 100644 --- a/files/zh-cn/web/api/response/error_static/index.md +++ b/files/zh-cn/web/api/response/error_static/index.md @@ -15,8 +15,8 @@ slug: Web/API/Response/error_static ## 语法 -``` -error() +```js-nolint +Response.error() ``` ### 参数 diff --git a/files/zh-cn/web/api/response/formdata/index.md b/files/zh-cn/web/api/response/formdata/index.md index 51bc974e2abe1e..b1b0f6c017e3c3 100644 --- a/files/zh-cn/web/api/response/formdata/index.md +++ b/files/zh-cn/web/api/response/formdata/index.md @@ -12,11 +12,8 @@ slug: Web/API/Response/formData ## 语法 -``` -response.formData() -.then(function(formdata) { - // do something with your formdata -}); +```js-nolint +formData() ``` ### 参数 @@ -27,7 +24,7 @@ response.formData() 生成 {{domxref("FormData")}}对象的{{domxref("Promise")}} 对象。 -## 样例 +## 示例 待定。 @@ -35,11 +32,11 @@ response.formData() {{Specifications}} -## Browser compatibility +## 浏览器兼容性 {{Compat}} -## See also +## 参见 - [ServiceWorker API](/zh-CN/docs/Web/API/ServiceWorker_API) - [HTTP access control (CORS)](/zh-CN/docs/Web/HTTP/Access_control_CORS) diff --git a/files/zh-cn/web/api/response/redirect_static/index.md b/files/zh-cn/web/api/response/redirect_static/index.md index db71b87a47c0e6..1d73e71cc342b9 100644 --- a/files/zh-cn/web/api/response/redirect_static/index.md +++ b/files/zh-cn/web/api/response/redirect_static/index.md @@ -12,8 +12,9 @@ slug: Web/API/Response/redirect_static ## 语法 -``` -var response = Response.redirect(url, status); +```js-nolint +Response.redirect(url) +Response.redirect(url, status) ``` ### 参数 diff --git a/files/zh-cn/web/api/response/redirected/index.md b/files/zh-cn/web/api/response/redirected/index.md index 187f02c7d82923..ee33977f2a3b97 100644 --- a/files/zh-cn/web/api/response/redirected/index.md +++ b/files/zh-cn/web/api/response/redirected/index.md @@ -10,13 +10,7 @@ slug: Web/API/Response/redirected > [!NOTE] > 依赖 **`redirected`** 过滤重定向很容易导致虚假的重定向阻止你的内容像预期一样生效。因此，当调用 {{domxref("GlobalFetch.fetch", "fetch()")}} 时你应该进行过滤操作。详见下面 [禁用重定向](#禁用重定向) 的例子。 -## 语法 - -``` -var isRedirected = Response.redirected; -``` - -### 返回值 +## 值 一个布尔值 ({{domxref("Boolean")}}), 如果响应来自重定向的请求，那么将返回 `true`. diff --git a/files/zh-cn/web/api/rtcpeerconnection/createoffer/index.md b/files/zh-cn/web/api/rtcpeerconnection/createoffer/index.md index d5e6b658bd8352..a2fb3a6fc8da55 100644 --- a/files/zh-cn/web/api/rtcpeerconnection/createoffer/index.md +++ b/files/zh-cn/web/api/rtcpeerconnection/createoffer/index.md @@ -5,15 +5,17 @@ slug: Web/API/RTCPeerConnection/createOffer {{APIRef("WebRTC")}}{{domxref("RTCPeerConnection")}}接口的 createOffer() 方法启动创建一个{{Glossary("SDP")}} offer，目的是启动一个新的 WebRTC 去连接远程端点。SDP offer 包含有关已附加到 WebRTC 会话，浏览器支持的编解码器和选项的所有{{domxref("MediaStreamTrack")}}s 信息，以及{{Glossary("ICE")}} 代理，目的是通过信令信道发送给潜在远程端点，以请求连接或更新现有连接的配置。返回值是一个{{domxref("Promise")}}，创建 offer 后，将使用包含新创建的要约的{{domxref("RTCSessionDescription")}}对象来解析该返回值。 -## Syntax +## 语法 -``` -aPromise = myPeerConnection.createOffer([options]); +```js-nolint +createOffer() +createOffer(options) -myPeerConnection.createOffer(successCallback, failureCallback, [options]) {{deprecated_inline}} +createOffer(successCallback, failureCallback) // 已弃用 +createOffer(successCallback, failureCallback, options) // 已弃用 ``` -### Parameters +### 参数 - 选项 {{optional_inline}} - : [`RTCOfferOptions`](#RTCOfferOptions_dictionary) 词典提供要约所要求的选项。 diff --git a/files/zh-cn/web/api/rtcpeerconnection/currentlocaldescription/index.md b/files/zh-cn/web/api/rtcpeerconnection/currentlocaldescription/index.md index 805b3ffb2dcf07..c36c0124d3d401 100644 --- a/files/zh-cn/web/api/rtcpeerconnection/currentlocaldescription/index.md +++ b/files/zh-cn/web/api/rtcpeerconnection/currentlocaldescription/index.md @@ -12,13 +12,7 @@ slug: Web/API/RTCPeerConnection/currentLocalDescription > [!NOTE] > 与 {{domxref("RTCPeerConnection.localDescription")}} 不同，这个值代表了当前连接的本地端的事实当前状态； `localDescription` 也许指明了一个当前正在切换中的连接的 description。 -## 语法 - -``` -sessionDescription = RTCPeerConnection.currentLocalDescription; -``` - -### 返回值 +## 值 连接本地端的当前 description 描述，如果成功设置了一个。否则返回 null。 diff --git a/files/zh-cn/web/api/rtcpeerconnection/peeridentity/index.md b/files/zh-cn/web/api/rtcpeerconnection/peeridentity/index.md index e6b8d02a562bf7..8aa9dcb1875b27 100644 --- a/files/zh-cn/web/api/rtcpeerconnection/peeridentity/index.md +++ b/files/zh-cn/web/api/rtcpeerconnection/peeridentity/index.md @@ -7,48 +7,42 @@ slug: Web/API/RTCPeerConnection/peerIdentity 只读属性 {{domxref("RTCPeerConnection")}} **`peerIdentity`** ，返回{{jsxref("Promise")}} 对象，成功时返回 {{domxref("RTCIdentityAssertion")}} ，该结构 {{domxref("DOMString")}} 标识了远端的 ID。这个身份标识在连接过程中将不会改变（直到连接结束）. -## 语法 +## 值 -``` - var identity = rtcPeerConnection.peerIdentity; -``` - -### Value - -A JavaScript {{jsxref("Promise")}} which resolves to an {{domxref("RTCIdentityAssertion")}} that describes the remote peer's identity. +一个 JavaScript {{jsxref("Promise")}}，会被兑现为描述远程对等方身份的 {{domxref("RTCIdentityAssertion")}}。 当验证远程的身份 ID 出错时，promise 将返回拒绝。如果目标节点身份不存在，`peerIdentity` 将被设为 一个 promise 对象，并重启验证过程（一个断言）, 直到成功或者不再想继续。 > **备注：** {{domxref("RTCPeerConnection.setRemoteDescription", "setRemoteDescription()")}} 返回的 promise 将不会成功返回，除非目标节点身份信息可用。如不可用，则`setRemoteDescription()` 将被拒绝。若无目标节点 ID，就不不需要等`setRemoteDescription()` 这个返回验证成功了。 -## 举个栗子 +## 示例 -In this example, a function, `getIdentityAssertion()`, is created which asynchronously waits for the peer's identity to be verified, then returns the identity to the caller. If an error occurs and the promise is rejected, this logs the error to the console and returns `null` to the caller. +本示例创建了一个 `getIdentityAssertion()` 函数，该函数异步等待对等方的身份得到验证，然后将其身份返回给调用者。如果发生错误且 promise 被拒绝，则将错误记录到控制台并将 `null` 返回给调用者。 -``` +```js let pc = new RTCPeerConnection(); -/* ... */ +// … async function getIdentityAssertion(pc) { try { const identity = await pc.peerIdentity; return identity; - } catch(err) { - console.log("Error identifying remote peer: ", err); + } catch (err) { + console.log("验证远程对等方的身份时出现错误：", err); return null; } } ``` -## Specifications +## 规范 {{Specifications}} -## Browser compatibility +## 浏览器兼容性 {{Compat}} -## See also +## 参见 - [WebRTC API](/zh-CN/docs/Web/API/WebRTC_API) diff --git a/files/zh-cn/web/api/rtctrackevent/rtctrackevent/index.md b/files/zh-cn/web/api/rtctrackevent/rtctrackevent/index.md index 3d263e88fd1135..6d5fd58b9eb4c2 100644 --- a/files/zh-cn/web/api/rtctrackevent/rtctrackevent/index.md +++ b/files/zh-cn/web/api/rtctrackevent/rtctrackevent/index.md @@ -11,7 +11,7 @@ slug: Web/API/RTCTrackEvent/RTCTrackEvent ## 语法 -``` +```js-nolint new RTCTrackEvent(type, options) ``` diff --git a/files/zh-cn/web/api/selection/extend/index.md b/files/zh-cn/web/api/selection/extend/index.md index d2107cf3acaa38..71772ca5a2534f 100644 --- a/files/zh-cn/web/api/selection/extend/index.md +++ b/files/zh-cn/web/api/selection/extend/index.md @@ -9,8 +9,9 @@ slug: Web/API/Selection/extend ## 语法 -``` -sel.extend(node, offset) +```js-nolint +extend(node) +extend(node, offset) ``` ### 参数 @@ -28,6 +29,6 @@ sel.extend(node, offset) {{Compat}} -## 相关链接 +## 参见 -- {{domxref("Selection")}}, 此方法所属接口。 +- 此方法所属的接口：{{domxref("Selection")}}。 diff --git a/files/zh-cn/web/api/selection/modify/index.md b/files/zh-cn/web/api/selection/modify/index.md index 0aaa17c0a09c80..51bd93e942ca62 100644 --- a/files/zh-cn/web/api/selection/modify/index.md +++ b/files/zh-cn/web/api/selection/modify/index.md @@ -9,8 +9,8 @@ slug: Web/API/Selection/modify ## 语法 -``` -sel.modify(alter, direction, granularity) +```js-nolint +modify(alter, direction, granularity) ``` ### 参数 @@ -28,11 +28,11 @@ sel.modify(alter, direction, granularity) > [!NOTE] > 从 Gecko 5.0 开始，不管是不是浏览器的默认行为，`"word"` 颗粒度不再包括单词后面的空格。这让这个行为变得更加稳定，这也和之前的 Webkit 保持一致，然而不幸的是他们最近修改了这个默认行为。 -## 例子 +## 示例 使当前选区往语言书写方向扩大一个单词（word）的选择范围 -``` +```js var selection = window.getSelection(); selection.modify("extend", "forward", "word"); ``` @@ -45,6 +45,6 @@ _无。_ {{Compat}} -## 相关链接 +## 参见 -- {{domxref("Selection")}}，本方法所属的接口。 +- 此方法所属的接口：{{domxref("Selection")}}。 diff --git a/files/zh-cn/web/api/selection/selectallchildren/index.md b/files/zh-cn/web/api/selection/selectallchildren/index.md index 8864148dafde88..63a36ccfab9f0f 100644 --- a/files/zh-cn/web/api/selection/selectallchildren/index.md +++ b/files/zh-cn/web/api/selection/selectallchildren/index.md @@ -9,8 +9,8 @@ Selection.selectAllChildren() 把指定元素的所有子元素设为选中区 ## 语法 -``` -sel.selectAllChildren(parentNode) +```js-nolint +selectAllChildren(parentNode) ``` ### 参数 @@ -18,12 +18,12 @@ sel.selectAllChildren(parentNode) - _`parentNode`_ - : 所有 parentNode 元素的子元素会被设为选中区域，parentNode 本身除外。 -## 举例 +## 示例 -``` +```js footer = document.getElementById("footer"); window.getSelection().selectAllChildren(footer); -/* Everything inside the footer is now selected * +/* Everything inside the footer is now selected */ ``` ## 规范 @@ -34,6 +34,6 @@ window.getSelection().selectAllChildren(footer); {{Compat}} -## 相关链接 +## 参见 -- {{domxref("Selection")}}, 此方法所属接口。 +- 此方法所属的接口：{{domxref("Selection")}}。 diff --git a/files/zh-cn/web/api/selection/setbaseandextent/index.md b/files/zh-cn/web/api/selection/setbaseandextent/index.md index f5532f0bb1ed9e..8f6796c500d370 100644 --- a/files/zh-cn/web/api/selection/setbaseandextent/index.md +++ b/files/zh-cn/web/api/selection/setbaseandextent/index.md @@ -9,8 +9,8 @@ slug: Web/API/Selection/setBaseAndExtent ## 语法 -``` -sel.setBaseAndExtent(anchorNode,anchorOffset,focusNode,focusOffset) +```js-nolint +setBaseAndExtent(anchorNode, anchorOffset, focusNode, focusOffset) ``` ### 参数 diff --git a/files/zh-cn/web/api/serviceworkerregistration/pushmanager/index.md b/files/zh-cn/web/api/serviceworkerregistration/pushmanager/index.md index 8ff4ce9d8221e8..cf9ff0bbfe2081 100644 --- a/files/zh-cn/web/api/serviceworkerregistration/pushmanager/index.md +++ b/files/zh-cn/web/api/serviceworkerregistration/pushmanager/index.md @@ -7,13 +7,7 @@ slug: Web/API/ServiceWorkerRegistration/pushManager {{domxref("ServiceWorkerRegistration")}} 接口的 **`pushManager`** 属性返回用于管理推送订阅的 {{domxref("PushManager")}} 接口的引用。包括支持订阅，获取活动订阅和访问推送权限状态。 -## 语法 - -``` -myPushManager = ServiceWorker.pushManager -``` - -### 值 +## 值 一个 {{domxref("PushManager")}} 对象。 diff --git a/files/zh-cn/web/api/serviceworkerregistration/update/index.md b/files/zh-cn/web/api/serviceworkerregistration/update/index.md index ac541ec949739c..d2b9e15057d159 100644 --- a/files/zh-cn/web/api/serviceworkerregistration/update/index.md +++ b/files/zh-cn/web/api/serviceworkerregistration/update/index.md @@ -12,13 +12,13 @@ slug: Web/API/ServiceWorkerRegistration/update ## 语法 -``` -ServiceWorkerRegistration.update(); +```js-nolint +update() ``` ### 参数 -None. +无。 ### 返回 diff --git a/files/zh-cn/web/api/settimeout/index.md b/files/zh-cn/web/api/settimeout/index.md index 3f975a1d526a2b..ffe5da1850c84f 100644 --- a/files/zh-cn/web/api/settimeout/index.md +++ b/files/zh-cn/web/api/settimeout/index.md @@ -307,7 +307,7 @@ console.log("setTimeout 之后"); 会在控制台输出： -``` +```plain setTimeout 之后 foo 被调用 ``` diff --git a/files/zh-cn/web/api/storageevent/index.md b/files/zh-cn/web/api/storageevent/index.md index b5757515c07d72..9a672db38e9f97 100644 --- a/files/zh-cn/web/api/storageevent/index.md +++ b/files/zh-cn/web/api/storageevent/index.md @@ -11,27 +11,14 @@ slug: Web/API/StorageEvent {{InheritanceDiagram}} -> [!NOTE] -> 尽管这个事件已经早在 Gecko 2.0 时就已存在，但是并不符合规范。老的事件模型直到 `nsIDOMStorageEventObsolete` 确定才被表现出来。 +## 构造函数 -## 方法描述 +- {{domxref("StorageEvent.StorageEvent()", "StorageEvent()")}} + - : 返回新构造的 `StorageEvent` 对象。 -``` -void initStorageEvent( - in DOMString typeArg, - in boolean canBubbleArg, - in boolean cancelableArg, - in DOMString keyArg, - in DOMString oldValueArg, - in DOMString newValueArg, - in DOMString urlArg, - in nsIDOMStorage storageAreaArg -); -``` +## 实例属性 -## 属性 - -_除了下面列出的属性以外，`StorageEvent` 还继承了父接口 {{domxref("Event")}} 的属性。_ +_除了下面列出的属性以外，此接口还继承了其父接口 {{domxref("Event")}} 的属性。_ - {{domxref("StorageEvent.key", "key")}} {{ReadOnlyInline}} - : 被修改的键名。当被 `clear()` 方法清除后该属性值为 [`null`](/zh-CN/docs/Web/JavaScript/Reference/Operators/null)。 @@ -44,50 +31,21 @@ _除了下面列出的属性以外，`StorageEvent` 还继承了父接口 {{domx - {{domxref("StorageEvent.url", "url")}} {{ReadOnlyInline}} - : `key` 发生改变的对象所在文档的 URL 地址。 -## 方法 - -### initStorageEvent() - -类似 DOM 中的初始化事件，即初始化新创建的 Storage 对象的属性。 - -``` -void initStorageEvent( - in DOMString typeArg, - in boolean canBubbleArg, - in boolean cancelableArg, - in DOMString keyArg, - in DOMString oldValueArg, - in DOMString newValueArg, - in DOMString urlArg, - in nsIDOMStorage storageAreaArg -); -``` - -- 参数： - - `typeArg` - - - : 事件名 - -- `canBubbleArg` - - : 布尔值，代表是否可以通过 dom 冒泡 -- `cancelableArg` - - : 布尔值，代表是否可以注销事件 -- `keyArg` - - : 事件结果时被改变的值对应的属性名称 -- `oldValueArg` - - : 旧值 -- `newValueArg` - - : 新值 -- `urlArg` - - : 事件初始化时页面的 url -- `storageAreaArg` - - : 发生在哪个 storage 对象上 +## 实例方法 + +_除了下面列出的方法以外，此接口还继承了其父接口 {{domxref("Event")}} 的方法。_ + +- {{domxref("StorageEvent.initStorageEvent", "initStorageEvent()")}} {{deprecated_inline}} + - : 以类似于 DOM 事件接口中名称相似的 {{domxref("Event.initEvent", "initEvent()")}} 方法的方式初始化事件。请改用构造函数。 ## 规范 {{Specifications}} -## 参阅 +## 浏览器兼容性 + +{{Compat}} + +## 参见 -- [Specification](http://dev.w3.org/html5/webstorage/#the-storage-event) +- {{domxref("Web Storage API", "Web 存储 API", "", "nocode")}} diff --git a/files/zh-cn/web/api/svggraphicselement/getbbox/index.md b/files/zh-cn/web/api/svggraphicselement/getbbox/index.md index da70a56b30034e..3eed567c4f0a10 100644 --- a/files/zh-cn/web/api/svggraphicselement/getbbox/index.md +++ b/files/zh-cn/web/api/svggraphicselement/getbbox/index.md @@ -11,17 +11,18 @@ Note: `getBBox` must return the actual bounding box at the time the method was c > **备注：** `getBBox` returns different values than getBoundingClientRect, as the latter returns value relative to the viewport -## Syntax +## 语法 -``` -let bboxRect = object.getBBox(); +```js-nolint +getBBox() +getBBox(options) ``` -### Return value +### 返回值 The returned value is a [SVGRect](/zh-CN/docs/Web/API/SVGRect) object, which defines the bounding box. This value is irrespective of any transformation attribute applied to it or the parent elements. -## Example +## 示例 ### HTML @@ -60,10 +61,10 @@ rectBoundingClientRect.setAttribute("width", boundingClientRectGroup.width); rectBoundingClientRect.setAttribute("height", boundingClientRectGroup.height); ``` -## Specifications +## 规范 {{Specifications}} -## See also +## 参见 - [getBBox in SVG Primer](https://www.w3.org/Graphics/SVG/IG/resources/svgprimer.html#getBBox) diff --git a/files/zh-cn/web/api/text/splittext/index.md b/files/zh-cn/web/api/text/splittext/index.md index eb60671857487f..4cbd91de15765e 100644 --- a/files/zh-cn/web/api/text/splittext/index.md +++ b/files/zh-cn/web/api/text/splittext/index.md @@ -13,7 +13,7 @@ slug: Web/API/Text/splitText ## 语法 -``` +```js-nolint newNode = textNode.splitText(offset) ``` diff --git a/files/zh-cn/web/api/textmetrics/width/index.md b/files/zh-cn/web/api/textmetrics/width/index.md index 5782bd6bea6689..842afbceb126f6 100644 --- a/files/zh-cn/web/api/textmetrics/width/index.md +++ b/files/zh-cn/web/api/textmetrics/width/index.md @@ -7,12 +7,6 @@ slug: Web/API/TextMetrics/width 只读的 **`TextMetrics.width`** 属性，包含文本先前的宽度（行内盒子的宽度），使用 CSS 像素计算。 -## 语法 - -``` -readonly metrics.width; -``` - ## 示例 事先给定 {{HTMLElement("canvas")}} 元素： diff --git a/files/zh-cn/web/api/touch/touch/index.md b/files/zh-cn/web/api/touch/touch/index.md index 3016abe20c451d..dcaf015bed2547 100644 --- a/files/zh-cn/web/api/touch/touch/index.md +++ b/files/zh-cn/web/api/touch/touch/index.md @@ -7,13 +7,13 @@ slug: Web/API/Touch/Touch **`Touch()`** 构造器创建一个新的 {{domxref("Touch")}} 对象。 -## Syntax +## 语法 -``` - touch = new Touch(touchInit); +```js-nolint +new Touch(options) ``` -### Arguments +### 参数 - _touchInit_ @@ -32,14 +32,14 @@ slug: Web/API/Touch/Touch - `"rotationAngle"`, 可选，默认为 0，为浮点数类型。表示由 radiusX 和 radiusY 决定的椭圆在顺时针方向相对其中心偏转的角度。这个值介于 0 到 90 度之间。如果由 radiusX 和 radiusY 决定的椭圆是一个标准圆形，则 rotationAngle 没有任何效用。用户设备可能用 0 表示这种标准圆形的情况，或者用其他符合要求范围的值来表示（比如，用户设备可能用上一次的触摸事件 rotationAngle 值，来避免突然变动）。 - `"force"`,可选，默认为 0，为浮点数类型。表示触摸体对触摸面的压力值。范围为从 0 到 1:0 表示压力为零，1 表示设备能承受的最大压力敏感值。对压力的敏感值变动范围根据不同环境变动比较大。 -## Specifications +## 规范 {{Specifications}} -## Browser compatibility +## 浏览器兼容性 {{Compat}} -## See also +## 参见 -- {{domxref("TouchEvent")}}, the interface of the objects it constructs. +- 其构造的对象的接口：{{domxref("TouchEvent")}}。 diff --git a/files/zh-cn/web/api/touch_events/index.md b/files/zh-cn/web/api/touch_events/index.md index c651973a2acb28..58489b7bdb9bc6 100644 --- a/files/zh-cn/web/api/touch_events/index.md +++ b/files/zh-cn/web/api/touch_events/index.md @@ -257,9 +257,9 @@ function ongoingTouchIndexById(idToFind) { #### 显示后台操作记录 -``` +```js function log(msg) { - const p = document.getElementById('log'); + const p = document.getElementById("log"); p.innerHTML = msg + "\n" + p.innerHTML; } ``` diff --git a/files/zh-cn/web/api/touch_events/using_touch_events/index.md b/files/zh-cn/web/api/touch_events/using_touch_events/index.md index fbf58948177f7e..818de30916266c 100644 --- a/files/zh-cn/web/api/touch_events/using_touch_events/index.md +++ b/files/zh-cn/web/api/touch_events/using_touch_events/index.md @@ -48,40 +48,52 @@ slug: Web/API/Touch_events/Using_Touch_Events 对每一个触摸事件类型注册一个事件处理器。 -``` +```js // Register touch event handlers -someElement.addEventListener('touchstart', process_touchstart, false); -someElement.addEventListener('touchmove', process_touchmove, false); -someElement.addEventListener('touchcancel', process_touchcancel, false); -someElement.addEventListener('touchend', process_touchend, false); +someElement.addEventListener("touchstart", process_touchstart, false); +someElement.addEventListener("touchmove", process_touchmove, false); +someElement.addEventListener("touchcancel", process_touchcancel, false); +someElement.addEventListener("touchend", process_touchend, false); ``` 在事件处理程序中处理事件，实现应用程序的手势语义。 -``` +```js // touchstart handler function process_touchstart(ev) { // Use the event's data to call out to the appropriate gesture handlers switch (ev.touches.length) { - case 1: handle_one_touch(ev); break; - case 2: handle_two_touches(ev); break; - case 3: handle_three_touches(ev); break; - default: gesture_not_supported(ev); break; + case 1: + handle_one_touch(ev); + break; + case 2: + handle_two_touches(ev); + break; + case 3: + handle_three_touches(ev); + break; + default: + gesture_not_supported(ev); + break; } } ``` 访问触摸点的属性。 -``` +```js // Create touchstart handler -someElement.addEventListener('touchstart', function(ev) { - // Iterate through the touch points that were activiated - // for this element and process each event 'target' - for (var i=0; i < ev.targetTouches.length; i++) { - process_target(ev.targetTouches[i].target); - } -}, false); +someElement.addEventListener( + "touchstart", + function (ev) { + // Iterate through the touch points that were activiated + // for this element and process each event 'target' + for (var i = 0; i < ev.targetTouches.length; i++) { + process_target(ev.targetTouches[i].target); + } + }, + false, +); ``` 阻止游览器产生模拟鼠标事件。 diff --git a/files/zh-cn/web/api/videoplaybackquality/totalvideoframes/index.md b/files/zh-cn/web/api/videoplaybackquality/totalvideoframes/index.md index ca4e55b1cd54f2..5631bc396f95d5 100644 --- a/files/zh-cn/web/api/videoplaybackquality/totalvideoframes/index.md +++ b/files/zh-cn/web/api/videoplaybackquality/totalvideoframes/index.md @@ -5,21 +5,13 @@ slug: Web/API/VideoPlaybackQuality/totalVideoFrames {{APIRef("HTML DOM")}} -``` -videoPlaybackQuality 的totalVideoFrames 属性为一个只读属性，用于表述已经被加载的媒体资源中已经被渲染播放或者被废弃的视频帧总数 -``` - -## Syntax - -``` -value = videoPlaybackQuality.totalVideoFrames; -``` +{{domxref("VideoPlaybackQuality")}} 接口的 **`totalVideoFrames`** 只读属性返回自媒体加载以来已经显示或丢弃的视频帧总数。 -### Value +## 值 video 容器**已经被加载的媒体资源中已经被渲染播放或者被废弃的视频帧总数，本质上讲，这个总数是指没有发生播放异常问题下的数目。** -## Example +## 示例 下面的例子想要表述的是通过已经丢弃（丢帧）或者播放异常的帧数总和占 totalVideoFrames 的比例超过 10%，则触发一个例如名为 lostFramesThresholdExceeded 的回调函数以反应我们当前视频资源丢帧已经播放异常的程度，从而帮助业务进行调整 @@ -36,18 +28,16 @@ if ( } ``` -``` 触发回调函数后，我们可以使用一些算法来尝试切换到需要较少带宽，码率低的，较低分辨率视频，以避免丢帧。 -``` -## Specifications +## 规范 {{Specifications}} -## Browser compatibility +## 浏览器兼容性 {{Compat}} -## See also +## 参见 - The {{domxref("HTMLVideoElement.getVideoPlaybackQuality()")}} method for constructing and returning this interface. diff --git a/files/zh-cn/web/api/web_audio_api/web_audio_spatialization_basics/index.md b/files/zh-cn/web/api/web_audio_api/web_audio_spatialization_basics/index.md index 969467734a15b1..0b5432f7a03552 100644 --- a/files/zh-cn/web/api/web_audio_api/web_audio_spatialization_basics/index.md +++ b/files/zh-cn/web/api/web_audio_api/web_audio_spatialization_basics/index.md @@ -107,7 +107,7 @@ const refDistance = 1; 然后就是 roll-off 因子 ([`rolloffFactor`](/zh-CN/docs/Web/API/PannerNode/rolloffFactor)) — 描述随着 panner 远离收听者，音量减小的速度有多快。默认值为 1；让我们使其大一些以放大我们的动作。 -``` +```js const rollOff = 10; ``` diff --git a/files/zh-cn/web/api/webgl2renderingcontext/uniform/index.md b/files/zh-cn/web/api/webgl2renderingcontext/uniform/index.md index a32ec04c84a055..1a5139f3472262 100644 --- a/files/zh-cn/web/api/webgl2renderingcontext/uniform/index.md +++ b/files/zh-cn/web/api/webgl2renderingcontext/uniform/index.md @@ -12,23 +12,59 @@ slug: Web/API/WebGL2RenderingContext/uniform ## 语法 -``` -void gl.uniform1ui(location, v0); -void gl.uniform2ui(location, v0, v1); -void gl.uniform3ui(location, v0, v1, v2); -void gl.uniform4ui(location, v0, v1, v2, v3); -void gl.uniform1fv(location, data, optional srcOffset, optional srcLength); -void gl.uniform2fv(location, data, optional srcOffset, optional srcLength); -void gl.uniform3fv(location, data, optional srcOffset, optional srcLength); -void gl.uniform4fv(location, data, optional srcOffset, optional srcLength); -void gl.uniform1iv(location, data, optional srcOffset, optional srcLength); -void gl.uniform2iv(location, data, optional srcOffset, optional srcLength); -void gl.uniform3iv(location, data, optional srcOffset, optional srcLength); -void gl.uniform4iv(location, data, optional srcOffset, optional srcLength); -void gl.uniform1uiv(location, data, optional srcOffset, optional srcLength); -void gl.uniform2uiv(location, data, optional srcOffset, optional srcLength); -void gl.uniform3uiv(location, data, optional srcOffset, optional srcLength); -void gl.uniform4uiv(location, data, optional srcOffset, optional srcLength); +```js-nolint +uniform1ui(location, v0) +uniform2ui(location, v0, v1) +uniform3ui(location, v0, v1, v2) +uniform4ui(location, v0, v1, v2, v3) + +uniform1fv(location, data) +uniform1fv(location, data, srcOffset) +uniform1fv(location, data, srcOffset, srcLength) + +uniform2fv(location, data) +uniform2fv(location, data, srcOffset) +uniform2fv(location, data, srcOffset, srcLength) + +uniform3fv(location, data) +uniform3fv(location, data, srcOffset) +uniform3fv(location, data, srcOffset, srcLength) + +uniform4fv(location, data) +uniform4fv(location, data, srcOffset) +uniform4fv(location, data, srcOffset, srcLength) + +uniform1iv(location, data) +uniform1iv(location, data, srcOffset) +uniform1iv(location, data, srcOffset, srcLength) + +uniform2iv(location, data) +uniform2iv(location, data, srcOffset) +uniform2iv(location, data, srcOffset, srcLength) + +uniform3iv(location, data) +uniform3iv(location, data, srcOffset) +uniform3iv(location, data, srcOffset, srcLength) + +uniform4iv(location, data) +uniform4iv(location, data, srcOffset) +uniform4iv(location, data, srcOffset, srcLength) + +uniform1uiv(location, data) +uniform1uiv(location, data, srcOffset) +uniform1uiv(location, data, srcOffset, srcLength) + +uniform2uiv(location, data) +uniform2uiv(location, data, srcOffset) +uniform2uiv(location, data, srcOffset, srcLength) + +uniform3uiv(location, data) +uniform3uiv(location, data, srcOffset) +uniform3uiv(location, data, srcOffset, srcLength) + +uniform4uiv(location, data) +uniform4uiv(location, data, srcOffset) +uniform4uiv(location, data, srcOffset, srcLength) ``` ### 参数 diff --git a/files/zh-cn/web/api/webgl2renderingcontext/uniformmatrix/index.md b/files/zh-cn/web/api/webgl2renderingcontext/uniformmatrix/index.md index 055adfbec379dc..995e0111a4c846 100644 --- a/files/zh-cn/web/api/webgl2renderingcontext/uniformmatrix/index.md +++ b/files/zh-cn/web/api/webgl2renderingcontext/uniformmatrix/index.md @@ -12,16 +12,42 @@ slug: Web/API/WebGL2RenderingContext/uniformMatrix ## 语法 -``` -void gl.uniformMatrix2fv(location, transpose, data, optional srcOffset, optional srcLength); -void gl.uniformMatrix3x2fv(location, transpose, data, optional srcOffset, optional srcLength); -void gl.uniformMatrix4x2fv(location, transpose, data, optional srcOffset, optional srcLength); -void gl.uniformMatrix2x3fv(location, transpose, data, optional srcOffset, optional srcLength); -void gl.uniformMatrix3fv(location, transpose, data, optional srcOffset, optional srcLength); -void gl.uniformMatrix4x3fv(location, transpose, data, optional srcOffset, optional srcLength); -void gl.uniformMatrix2x4fv(location, transpose, data, optional srcOffset, optional srcLength); -void gl.uniformMatrix3x4fv(location, transpose, data, optional srcOffset, optional srcLength); -void gl.uniformMatrix4fv(location, transpose, data, optional srcOffset, optional srcLength); +```js-nolint +uniformMatrix2fv(location, transpose, data) +uniformMatrix2fv(location, transpose, data, srcOffset) +uniformMatrix2fv(location, transpose, data, srcOffset, srcLength) + +uniformMatrix3x2fv(location, transpose, data) +uniformMatrix3x2fv(location, transpose, data, srcOffset) +uniformMatrix3x2fv(location, transpose, data, srcOffset, srcLength) + +uniformMatrix4x2fv(location, transpose, data) +uniformMatrix4x2fv(location, transpose, data, srcOffset) +uniformMatrix4x2fv(location, transpose, data, srcOffset, srcLength) + +uniformMatrix2x3fv(location, transpose, data) +uniformMatrix2x3fv(location, transpose, data, srcOffset) +uniformMatrix2x3fv(location, transpose, data, srcOffset, srcLength) + +uniformMatrix3fv(location, transpose, data) +uniformMatrix3fv(location, transpose, data, srcOffset) +uniformMatrix3fv(location, transpose, data, srcOffset, srcLength) + +uniformMatrix4x3fv(location, transpose, data) +uniformMatrix4x3fv(location, transpose, data, srcOffset) +uniformMatrix4x3fv(location, transpose, data, srcOffset, srcLength) + +uniformMatrix2x4fv(location, transpose, data) +uniformMatrix2x4fv(location, transpose, data, srcOffset) +uniformMatrix2x4fv(location, transpose, data, srcOffset, srcLength) + +uniformMatrix3x4fv(location, transpose, data) +uniformMatrix3x4fv(location, transpose, data, srcOffset) +uniformMatrix3x4fv(location, transpose, data, srcOffset, srcLength) + +uniformMatrix4fv(location, transpose, data) +uniformMatrix4fv(location, transpose, data, srcOffset) +uniformMatrix4fv(location, transpose, data, srcOffset, srcLength) ``` ### 参数 diff --git a/files/zh-cn/web/api/webgl_api/matrix_math_for_the_web/index.md b/files/zh-cn/web/api/webgl_api/matrix_math_for_the_web/index.md index bb7dca2949bb0e..343b961e6e33d3 100644 --- a/files/zh-cn/web/api/webgl_api/matrix_math_for_the_web/index.md +++ b/files/zh-cn/web/api/webgl_api/matrix_math_for_the_web/index.md @@ -284,8 +284,8 @@ function rotateAroundZAxis(a) { 另一个需要记住的点是在 WebGL 和 CSS3 中的矩阵相乘需要和变换发生的顺序相反。例如，缩放对象到 80%，向下移动 200 像素，然后绕原点旋转 90 度在伪代码中应该像下面这样。 -``` - transformation = rotate * translate * scale +```plain +transformation = rotate * translate * scale ``` ### 组合多种变换 diff --git a/files/zh-cn/web/api/webglrenderingcontext/getparameter/index.md b/files/zh-cn/web/api/webglrenderingcontext/getparameter/index.md index 72b6978110d774..3e8999d0acf369 100644 --- a/files/zh-cn/web/api/webglrenderingcontext/getparameter/index.md +++ b/files/zh-cn/web/api/webglrenderingcontext/getparameter/index.md @@ -9,8 +9,8 @@ slug: Web/API/WebGLRenderingContext/getParameter ## 语法 -``` -any gl.getParameter(pname); +```js-nolint +getParameter(pname) ``` ### 参数 diff --git a/files/zh-cn/web/api/webglrenderingcontext/getshaderparameter/index.md b/files/zh-cn/web/api/webglrenderingcontext/getshaderparameter/index.md index a25445d0cbdda5..3bf83a38675658 100644 --- a/files/zh-cn/web/api/webglrenderingcontext/getshaderparameter/index.md +++ b/files/zh-cn/web/api/webglrenderingcontext/getshaderparameter/index.md @@ -9,8 +9,8 @@ slug: Web/API/WebGLRenderingContext/getShaderParameter ## 语法 -``` -any gl.getShaderParameter(shader, pname); +```js-nolint +getShaderParameter(shader, pname) ``` ### 参数 diff --git a/files/zh-cn/web/api/webglrenderingcontext/gettexparameter/index.md b/files/zh-cn/web/api/webglrenderingcontext/gettexparameter/index.md index 5c241d354e03fc..cbc2f0dddc15b3 100644 --- a/files/zh-cn/web/api/webglrenderingcontext/gettexparameter/index.md +++ b/files/zh-cn/web/api/webglrenderingcontext/gettexparameter/index.md @@ -9,8 +9,8 @@ slug: Web/API/WebGLRenderingContext/getTexParameter ## 语法 -``` -any gl.getTexParameter(target, pname); +```js-nolint +getTexParameter(target, pname) ``` ### 参数 diff --git a/files/zh-cn/web/api/webglrenderingcontext/getuniform/index.md b/files/zh-cn/web/api/webglrenderingcontext/getuniform/index.md index 49b263b7ed57f2..60269603c0e987 100644 --- a/files/zh-cn/web/api/webglrenderingcontext/getuniform/index.md +++ b/files/zh-cn/web/api/webglrenderingcontext/getuniform/index.md @@ -7,8 +7,8 @@ slug: Web/API/WebGLRenderingContext/getUniform ## 语法 -``` -any gl.getUniform(program, location); +```js-nolint +getUniform(program, location) ``` ### 参数 diff --git a/files/zh-cn/web/api/webglrenderingcontext/pixelstorei/index.md b/files/zh-cn/web/api/webglrenderingcontext/pixelstorei/index.md index 7aa5b4537490d5..19a326d8d31d5d 100644 --- a/files/zh-cn/web/api/webglrenderingcontext/pixelstorei/index.md +++ b/files/zh-cn/web/api/webglrenderingcontext/pixelstorei/index.md @@ -9,8 +9,8 @@ slug: Web/API/WebGLRenderingContext/pixelStorei ## 语法 -``` -void gl.pixelStorei(pname, param); +```js-nolint +pixelStorei(pname, param) ``` ### 参数 diff --git a/files/zh-cn/web/api/webglrenderingcontext/teximage2d/index.md b/files/zh-cn/web/api/webglrenderingcontext/teximage2d/index.md index bdf28114101911..25bd96dafee6d2 100644 --- a/files/zh-cn/web/api/webglrenderingcontext/teximage2d/index.md +++ b/files/zh-cn/web/api/webglrenderingcontext/teximage2d/index.md @@ -9,23 +9,16 @@ slug: Web/API/WebGLRenderingContext/texImage2D ## 语法 -``` -// WebGL1: -void gl.texImage2D(target, level, internalformat, width, height, border, format, type, ArrayBufferView? pixels); -void gl.texImage2D(target, level, internalformat, format, type, ImageData? pixels); -void gl.texImage2D(target, level, internalformat, format, type, HTMLImageElement? pixels); -void gl.texImage2D(target, level, internalformat, format, type, HTMLCanvasElement? pixels); -void gl.texImage2D(target, level, internalformat, format, type, HTMLVideoElement? pixels); -void gl.texImage2D(target, level, internalformat, format, type, ImageBitmap? pixels); - -// WebGL2: -void gl.texImage2D(target, level, internalformat, width, height, border, format, type, GLintptr offset); -void gl.texImage2D(target, level, internalformat, width, height, border, format, type, HTMLCanvasElement source); -void gl.texImage2D(target, level, internalformat, width, height, border, format, type, HTMLImageElement source); -void gl.texImage2D(target, level, internalformat, width, height, border, format, type, HTMLVideoElement source); -void gl.texImage2D(target, level, internalformat, width, height, border, format, type, ImageBitmap source); -void gl.texImage2D(target, level, internalformat, width, height, border, format, type, ImageData source); -void gl.texImage2D(target, level, internalformat, width, height, border, format, type, ArrayBufferView srcData, srcOffset); +```js-nolint +// WebGL1 +texImage2D(target, level, internalformat, width, height, border, format, type, pixels) +texImage2D(target, level, internalformat, format, type, pixels) + + +// WebGL2 +texImage2D(target, level, internalformat, width, height, border, format, type, offset) +texImage2D(target, level, internalformat, width, height, border, format, type, source) +texImage2D(target, level, internalformat, width, height, border, format, type, srcData, srcOffset) ``` ### 参数 diff --git a/files/zh-cn/web/api/webglrenderingcontext/texparameter/index.md b/files/zh-cn/web/api/webglrenderingcontext/texparameter/index.md index 57fbd91d296977..4b216c5b2a035a 100644 --- a/files/zh-cn/web/api/webglrenderingcontext/texparameter/index.md +++ b/files/zh-cn/web/api/webglrenderingcontext/texparameter/index.md @@ -9,9 +9,9 @@ slug: Web/API/WebGLRenderingContext/texParameter ## 语法 -``` -void gl.texParameterf(GLenum target, GLenum pname, GLfloat param); -void gl.texParameteri(GLenum target, GLenum pname, GLint param); +```js-nolint +texParameterf(target, pname, param) +texParameteri(target, pname, param) ``` ### 参数 diff --git a/files/zh-cn/web/api/webglrenderingcontext/uniform/index.md b/files/zh-cn/web/api/webglrenderingcontext/uniform/index.md index 6d3924adbc2591..a0453409b8f5cc 100644 --- a/files/zh-cn/web/api/webglrenderingcontext/uniform/index.md +++ b/files/zh-cn/web/api/webglrenderingcontext/uniform/index.md @@ -12,26 +12,26 @@ slug: Web/API/WebGLRenderingContext/uniform ## 语法 -``` -void gl.uniform1f(location, v0); -void gl.uniform1fv(location, value); -void gl.uniform1i(location, v0); -void gl.uniform1iv(location, value); - -void gl.uniform2f(location, v0, v1); -void gl.uniform2fv(location, value); -void gl.uniform2i(location, v0, v1); -void gl.uniform2iv(location, value); - -void gl.uniform3f(location, v0, v1, v2); -void gl.uniform3fv(location, value); -void gl.uniform3i(location, v0, v1, v2); -void gl.uniform3iv(location, value); - -void gl.uniform4f(location, v0, v1, v2, v3); -void gl.uniform4fv(location, value); -void gl.uniform4i(location, v0, v1, v2, v3); -void gl.uniform4iv(location, value); +```js-nolint +uniform1f(location, v0) +uniform1fv(location, value) +uniform1i(location, v0) +uniform1iv(location, value) + +uniform2f(location, v0, v1) +uniform2fv(location, value) +uniform2i(location, v0, v1) +uniform2iv(location, value) + +uniform3f(location, v0, v1, v2) +uniform3fv(location, value) +uniform3i(location, v0, v1, v2) +uniform3iv(location, value) + +uniform4f(location, v0, v1, v2, v3) +uniform4fv(location, value) +uniform4i(location, v0, v1, v2, v3) +uniform4iv(location, value) ``` ### 参数 diff --git a/files/zh-cn/web/api/webglrenderingcontext/vertexattribpointer/index.md b/files/zh-cn/web/api/webglrenderingcontext/vertexattribpointer/index.md index da10485b3c43f0..318bcb3f5cbd66 100644 --- a/files/zh-cn/web/api/webglrenderingcontext/vertexattribpointer/index.md +++ b/files/zh-cn/web/api/webglrenderingcontext/vertexattribpointer/index.md @@ -10,13 +10,13 @@ The **`WebGLRenderingContext.vertexAttribPointer()`** method of the [WebGL API]( WebGL API 的 **`WebGLRenderingContext.vertexAttribPointer()`** 方法绑定当前缓冲区范围到`gl.ARRAY_BUFFER`,成为当前顶点缓冲区对象的通用顶点属性并指定它的布局 (缓冲区对象中的偏移量)。 -## Syntax +## 语法 -``` -void gl.vertexAttribPointer(index, size, type, normalized, stride, offset); +```js-nolint +vertexAttribPointer(index, size, type, normalized, stride, offset) ``` -### Parameters +### 参数 - `index` - : A {{domxref("GLuint")}} specifying the index of the vertex attribute that is to be modified. diff --git a/files/zh-cn/web/api/webrtc_api/signaling_and_video_calling/index.md b/files/zh-cn/web/api/webrtc_api/signaling_and_video_calling/index.md index ab3f1b2e1aaf01..e3ce3fc1250ec4 100644 --- a/files/zh-cn/web/api/webrtc_api/signaling_and_video_calling/index.md +++ b/files/zh-cn/web/api/webrtc_api/signaling_and_video_calling/index.md @@ -199,7 +199,7 @@ function sendToServer(msg) { 处理 `"userlist"` 消息的代码会调用 `handleUserlistMsg()`。在这里，我们在聊天面板左侧显示的用户列表中为每个连接的用户设置处理程序。此方法接收一个消息对象，其 `users` 属性是一个字符串数组，指定每个连接用户的用户名。 -``` +```js function handleUserlistMsg(msg) { var i; var listElem = document.querySelector(".userlistbox"); @@ -208,7 +208,7 @@ function handleUserlistMsg(msg) { listElem.removeChild(listElem.firstChild); } - msg.users.forEach(function(username) { + msg.users.forEach(function (username) { var item = document.createElement("li"); item.appendChild(document.createTextNode(username)); item.addEventListener("click", invite, false); @@ -314,22 +314,25 @@ function handleGetUserMediaError(e) { 调用方和被调用方都使用 `createPeerConnection()` 函数来构造它们的 {{domxref("RTCPeerConnection")}} 对象及其各自的 WebRTC 连接端。当调用者试图启动调用时，由 `invite()` 调用；当被调用者从调用者接收到要约消息时，由`handleVideoOfferMsg()` 调用。 -``` +```js function createPeerConnection() { myPeerConnection = new RTCPeerConnection({ - iceServers: [ // Information about ICE servers - Use your own! - { - urls: "stun:stun.stunprotocol.org" - } - ] + iceServers: [ + // Information about ICE servers - Use your own! + { + urls: "stun:stun.stunprotocol.org", + }, + ], }); myPeerConnection.onicecandidate = handleICECandidateEvent; myPeerConnection.ontrack = handleTrackEvent; myPeerConnection.onnegotiationneeded = handleNegotiationNeededEvent; myPeerConnection.onremovetrack = handleRemoveTrackEvent; - myPeerConnection.oniceconnectionstatechange = handleICEConnectionStateChangeEvent; - myPeerConnection.onicegatheringstatechange = handleICEGatheringStateChangeEvent; + myPeerConnection.oniceconnectionstatechange = + handleICEConnectionStateChangeEvent; + myPeerConnection.onicegatheringstatechange = + handleICEGatheringStateChangeEvent; myPeerConnection.onsignalingstatechange = handleSignalingStateChangeEvent; } ``` @@ -413,7 +416,7 @@ function handleNegotiationNeededEvent() { 当请求到达时，调用被调用方的 `handleVideoOfferMsg()` 函数时会收到`"video-offer"` 消息。这个函数需要做两件事。首先，它需要创建自己的 {{domxref("RTCPeerConnection")}} 并添加包含麦克风和网络摄像头的音频和视频的磁道。其次，它需要对收到的请求进行处理，构建并返回应答。 -``` +```js function handleVideoOfferMsg(msg) { var localStream = null; @@ -422,32 +425,36 @@ function handleVideoOfferMsg(msg) { var desc = new RTCSessionDescription(msg.sdp); - myPeerConnection.setRemoteDescription(desc).then(function () { - return navigator.mediaDevices.getUserMedia(mediaConstraints); - }) - .then(function(stream) { - localStream = stream; - document.getElementById("local_video").srcObject = localStream; - - localStream.getTracks().forEach(track => myPeerConnection.addTrack(track, localStream)); - }) - .then(function() { - return myPeerConnection.createAnswer(); - }) - .then(function(answer) { - return myPeerConnection.setLocalDescription(answer); - }) - .then(function() { - var msg = { - name: myUsername, - target: targetUsername, - type: "video-answer", - sdp: myPeerConnection.localDescription - }; + myPeerConnection + .setRemoteDescription(desc) + .then(function () { + return navigator.mediaDevices.getUserMedia(mediaConstraints); + }) + .then(function (stream) { + localStream = stream; + document.getElementById("local_video").srcObject = localStream; + + localStream + .getTracks() + .forEach((track) => myPeerConnection.addTrack(track, localStream)); + }) + .then(function () { + return myPeerConnection.createAnswer(); + }) + .then(function (answer) { + return myPeerConnection.setLocalDescription(answer); + }) + .then(function () { + var msg = { + name: myUsername, + target: targetUsername, + type: "video-answer", + sdp: myPeerConnection.localDescription, + }; - sendToServer(msg); - }) - .catch(handleGetUserMediaError); + sendToServer(msg); + }) + .catch(handleGetUserMediaError); } ``` @@ -535,7 +542,7 @@ function handleAddStreamEvent(event) { 当远程对等方通过调用{{domxref("RTCPeerConnection.removeTrack()")}}.从连接中删除磁道时，你的代码将接收事件 {{domxref("MediaStream/removetrack_event", "removetrack")}} 事件。`"removetrack"` 的处理程序是： -``` +```js function handleRemoveTrackEvent(event) { var stream = document.getElementById("received_video").srcObject; var trackList = stream.getTracks(); diff --git a/files/zh-cn/web/api/websocket/close/index.md b/files/zh-cn/web/api/websocket/close/index.md index 46bd2ce77edabe..af5d94444797d0 100644 --- a/files/zh-cn/web/api/websocket/close/index.md +++ b/files/zh-cn/web/api/websocket/close/index.md @@ -9,8 +9,10 @@ slug: Web/API/WebSocket/close ## 语法 -``` -WebSocket.close(); +```js-nolint +close() +close(code) +close(code, reason) ``` ### 参数 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 e978de9ea282cc..71d8438ad17e2f 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 @@ -29,7 +29,7 @@ WebSocket 服务器在这里被解释得非常底层。WebSocket 服务器通常 即使你正在构建服务器，客户端仍然必须启动 WebSocket 握手过程。所以你必须知道如何解释客户的请求。客户端将发送一个相当标准的 HTTP 请求，看起来像这样（HTTP 版本必须是 1.1 或更高，方法必须是`GET`）： -``` +```http GET /chat HTTP/1.1 Host: example.com:8000 Upgrade: websocket @@ -54,7 +54,7 @@ Sec-WebSocket-Version: 13 当**服务器**收到握手请求时，它应该发回一个特殊的响应，表明协议将从 HTTP 变为 WebSocket。看起来像这样（记住每个请求头以 `\r\n`结尾，并在最后一个之后放置一个额外的 `\r\n`）： -``` +```http HTTP/1.1 101 Switching Protocols Upgrade: websocket Connection: Upgrade @@ -83,7 +83,7 @@ Sec-WebSocket-Accept: s3pPLMBiTxaQ9kYGzzhZRbK+xOo= 每个数据帧（从客户端到服务器，反之亦然）遵循相同的格式： -``` +```bash Frame format: 0 1 2 3 @@ -126,10 +126,10 @@ FIN 位告诉我们这是不是系列的最后一条消息。如果是 0，那 如果设置了掩码位 (对于客户机到服务器的消息应该是这样)，则读取接下来的 4 个字节 (32 位);这是掩蔽键。一旦有效负载长度和掩蔽键被解码，你就可以继续从套接字读取字节数。让我们调用已编码的数据和密钥掩码。要获得解码，可以通过编码的八位元 (字节，即文本数据的字符) 和 XOR 八位元 (i 模 4) 掩码的第四个八位元进行循环。在伪代码中 (恰好是有效的 JavaScript): -``` +```js var DECODED = ""; for (var i = 0; i < ENCODED.length; i++) { - DECODED[i] = ENCODED[i] ^ MASK[i % 4]; + DECODED[i] = ENCODED[i] ^ MASK[i % 4]; } ``` @@ -141,7 +141,7 @@ FIN 和操作码字段一起工作，以发送分裂为独立帧的消息。这 回想一下，操作码告诉了帧应该做什么。如果是 0x1，有效载荷就是文本。如果是 0x2，有效载荷就是二进制数据。但是，如果是 0x0，则该帧是一个延续帧。这意味着服务器应该将帧的有效负载连接到从该客户机接收到的最后一个帧。下面是一个粗略的示意图，其中服务器对发送文本消息的客户机做出反应。第一个消息在单个帧中发送，而第二个消息跨三个帧发送。FIN 和操作码的详细信息只显示给客户： -``` +```plain Client: FIN=1, opcode=0x1, msg="hello" Server: (process complete message immediately) Hi. Client: FIN=0, opcode=0x1, msg="and a" @@ -195,7 +195,7 @@ WebSocket 子协议就是像这样的东西。它们不作任何假设实现， 如果客户端需要指定子协议，需要发送如下消息头**作为握手信息的一部分**： -``` +```http GET /chat HTTP/1.1 ... Sec-WebSocket-Protocol: soap, wamp @@ -203,7 +203,7 @@ Sec-WebSocket-Protocol: soap, wamp 等价于： -``` +```http ... Sec-WebSocket-Protocol: soap Sec-WebSocket-Protocol: wamp @@ -211,7 +211,7 @@ Sec-WebSocket-Protocol: wamp 现在，服务端需要选择一个客户端建议且服务端支持的子协议。如果有多于一个的话使用客户端发送的第一个。如果我们的服务端可以支持`soap`和`wamp`，则在握手回复时，它会发送： -``` +```http Sec-WebSocket-Protocol: soap ``` diff --git a/files/zh-cn/web/api/webvr_api/using_the_webvr_api/index.md b/files/zh-cn/web/api/webvr_api/using_the_webvr_api/index.md index 98dcfd1019a71d..6d93633418e637 100644 --- a/files/zh-cn/web/api/webvr_api/using_the_webvr_api/index.md +++ b/files/zh-cn/web/api/webvr_api/using_the_webvr_api/index.md @@ -205,7 +205,7 @@ if (posState.hasOrientation) { Next, we use a similar process to update the scene according to the HMD's orientation — check that valid orientation data is available using {{domxref("VRPositionState.hasOrientation")}}, display orientation data in the UI for informational purposes, and then set the `xOrient`, `yOrient`, and `zOrient` values relative to the orientation information stored in {{domxref("VRPositionState.orientation")}}. -``` +```js timePara.textContent = 'Timestamp: ' + Math.floor(posState.timeStamp); } ``` @@ -237,8 +237,8 @@ We then {{domxref("CanvasRenderingContext2D.beginPath","begin a path")}}, {{domx Note that the `rect()` has to be drawn starting from minus a quarter of the width and minus half the height, because of the translation applied earlier. -``` - ctx.clip(); +```js +ctx.clip(); ``` Now we {{domxref("CanvasRenderingContext2D.clip","clip()")}} the canvas. Because we called this just after the `rect()` was drawn, anything else that we do on the canvas will be constrained inside the `rect()`, with any overflow hidden until a `restore()` call is made (see later on.) This ensures that the whole left eye view will remain separate from the right eye view. diff --git a/files/zh-cn/web/api/window/getcomputedstyle/index.md b/files/zh-cn/web/api/window/getcomputedstyle/index.md index f7e34027578da7..bba7126aa45cd8 100644 --- a/files/zh-cn/web/api/window/getcomputedstyle/index.md +++ b/files/zh-cn/web/api/window/getcomputedstyle/index.md @@ -11,8 +11,9 @@ slug: Web/API/Window/getComputedStyle ## 语法 -``` -let style = window.getComputedStyle(element, [pseudoElt]); +```js-nolint +getComputedStyle(element) +getComputedStyle(element, pseudoElt) ``` - element diff --git a/files/zh-cn/web/api/window/getselection/index.md b/files/zh-cn/web/api/window/getselection/index.md index 7c8db071995d75..fd162b5d11f43b 100644 --- a/files/zh-cn/web/api/window/getselection/index.md +++ b/files/zh-cn/web/api/window/getselection/index.md @@ -9,8 +9,8 @@ slug: Web/API/Window/getSelection ## 语法 -``` -const selection = window.getSelection() ; +```js-nolint +getSelection() ``` - `selection` 是一个 {{domxref("Selection")}} 对象。如果想要将 `selection` 转换为字符串，可通过连接一个空字符串（""）或使用 {{jsxref("String.toString()")}} 方法。 diff --git a/files/zh-cn/web/api/window/indexeddb/index.md b/files/zh-cn/web/api/window/indexeddb/index.md index 87ac52a28c97dd..0b58e65be68e3e 100644 --- a/files/zh-cn/web/api/window/indexeddb/index.md +++ b/files/zh-cn/web/api/window/indexeddb/index.md @@ -7,12 +7,6 @@ slug: Web/API/Window/indexedDB **`indexedDB`** 是 `WindowOrWorkerGlobalScope` 的一个只读属性，它集成了为应用程序提供异步访问索引数据库的功能的机制。 -## 语法 - -``` -var IDBFactory = self.indexedDB; -``` - ## 值 一个 {{domxref("IDBFactory")}} 对象。 diff --git a/files/zh-cn/web/api/window/innerheight/index.md b/files/zh-cn/web/api/window/innerheight/index.md index b26aece287160e..8046b1c8b197f5 100644 --- a/files/zh-cn/web/api/window/innerheight/index.md +++ b/files/zh-cn/web/api/window/innerheight/index.md @@ -9,13 +9,7 @@ slug: Web/API/Window/innerHeight 浏览器窗口的视口（viewport）高度（以像素为单位）；如果有水平滚动条，也包括滚动条高度。 -## 语法 - -``` -var intViewportHeight = window.innerHeight; -``` - -### 值 +## 值 `intViewportHeight` 为浏览器窗口的视口的高度。 diff --git a/files/zh-cn/web/api/window/matchmedia/index.md b/files/zh-cn/web/api/window/matchmedia/index.md index 670c7322b9e978..6bd2bfed9a2a21 100644 --- a/files/zh-cn/web/api/window/matchmedia/index.md +++ b/files/zh-cn/web/api/window/matchmedia/index.md @@ -9,8 +9,8 @@ slug: Web/API/Window/matchMedia ## 语法 -``` -mqList = window.matchMedia(mediaQueryString) +```js-nolint +matchMedia(mediaQueryString) ``` ### 参数 @@ -36,8 +36,8 @@ mqList = window.matchMedia(mediaQueryString) ### JavaScript -``` -let mql = window.matchMedia('(max-width: 600px)'); +```js +let mql = window.matchMedia("(max-width: 600px)"); document.querySelector(".mq-value").innerText = mql.matches; ``` diff --git a/files/zh-cn/web/api/window/mozinnerscreenx/index.md b/files/zh-cn/web/api/window/mozinnerscreenx/index.md index 9a657ad90ff57a..c2f69c2b1130f3 100644 --- a/files/zh-cn/web/api/window/mozinnerscreenx/index.md +++ b/files/zh-cn/web/api/window/mozinnerscreenx/index.md @@ -12,12 +12,6 @@ slug: Web/API/Window/mozInnerScreenX > [!NOTE] > 该坐标以 CSS 像素报告显示，而不是硬件像素。这意味着它可以受缩放级别的影响; 要计算物理屏幕像素的实际数量，需要使用 [`nsIDOMWindowUtils.screenPixelsPerCSSPixel`](/zh-CN/docs/XPCOM_Interface_Reference/nsIDOMWindowUtils) 属性。 -## 语法 - -``` -screenX = window.mozInnerScreenX; -``` - ## 值 - _screenX_ 存储的是 `window.mozInnerScreenX` 的属性值。 diff --git a/files/zh-cn/web/api/window/mozinnerscreeny/index.md b/files/zh-cn/web/api/window/mozinnerscreeny/index.md index 253daf14596c59..2d2650a936bb76 100644 --- a/files/zh-cn/web/api/window/mozinnerscreeny/index.md +++ b/files/zh-cn/web/api/window/mozinnerscreeny/index.md @@ -3,19 +3,12 @@ title: Window.mozInnerScreenY slug: Web/API/Window/mozInnerScreenY --- -{{APIRef}} - -## 概要 +{{APIRef}}{{Non-standard_Header}} 在屏幕坐标下获取窗口视口左上角的 Y 坐标 -> **备注：**该坐标是以 CSS 像素报告显示的，而不是以硬件像素。这意味着它可以受缩放级别的影响; 要计算物理屏幕像素的实际数量，需要使用[`nsIDOMWindowUtils.screenPixelsPerCSSPixel`](/zh-CN/docs/XPCOM_Interface_Reference/nsIDOMWindowUtils) 属性 - -## 语法 - -``` -screenY = window.mozInnerScreenY; -``` +> [!NOTE] +> 该坐标是以 CSS 像素（而不是以硬件像素）报告的。 ## 值 @@ -26,7 +19,6 @@ screenY = window.mozInnerScreenY; 不属于任何 W3C 规范或标准 -## 相关链接 +## 参见 - {{domxref("window.mozInnerScreenX")}} -- [`nsIDOMWindowUtils.screenPixelsPerCSSPixel`](/zh-CN/docs/XPCOM_Interface_Reference/nsIDOMWindowUtils) diff --git a/files/zh-cn/web/api/window/requestfilesystem/index.md b/files/zh-cn/web/api/window/requestfilesystem/index.md index 5d3e2499ed8628..8102e7434b77c3 100644 --- a/files/zh-cn/web/api/window/requestfilesystem/index.md +++ b/files/zh-cn/web/api/window/requestfilesystem/index.md @@ -3,19 +3,18 @@ title: Window.requestFileSystem() slug: Web/API/Window/requestFileSystem --- -{{APIRef("File System API")}} +{{APIRef("HTML DOM")}}{{Deprecated_Header}}{{non-standard_header}} 这个非标准 {{domxref("Window")}} **`requestFileSystem()`** 方法是谷歌浏览器内核用来让 web 站点或 app 获得通过沙箱访问文件系统 . 它返回 {{domxref("FileSystem")}} 然后就可以和 [file system APIs](/zh-CN/docs/Web/API/File_and_Directory_Entries_API) 一起使用了 -> [!WARNING] -> 甚至相比较如 File 和 Directory Entries API, `requestFileSystem()` 更不规范; 只有 Chrome 支持它，所有其他浏览器已经决定不支持它了。它甚至已经从规范建议单中移除了。因此*不要使用这个方法* +> [!NOTE] +> 在所有实现该方法的浏览器中，其都带有 `webkit` 前缀。 ## 语法 -> **备注：** `在所有支持它的浏览器中这个方法都有 webkit 前缀` (实际上也仅有谷歌浏览器支持). - -``` -window.requestFileSystem(type, size, successCallback[, errorCallback]); +```js-nolint +requestFileSystem(type, size, successCallback) +requestFileSystem(type, size, successCallback, errorCallback) ``` ### 参数 diff --git a/files/zh-cn/web/api/window/screentop/index.md b/files/zh-cn/web/api/window/screentop/index.md index 8e994e2bdfb95c..7fb66aad2cf91c 100644 --- a/files/zh-cn/web/api/window/screentop/index.md +++ b/files/zh-cn/web/api/window/screentop/index.md @@ -9,13 +9,7 @@ slug: Web/API/Window/screenTop > **备注：** `screenTop` is an alias of the older {{domxref("Window.screenY")}} property. `screenTop` was originally supported only in IE but was introduced everywhere due to popularity. -## 语法 - -``` -topWindowPos = window.screenTop -``` - -### 返回值 +## 值 A number equal to the number of CSS pixels from the top edge of the browser viewport to the top edge of the screen. diff --git a/files/zh-cn/web/api/window/scroll/index.md b/files/zh-cn/web/api/window/scroll/index.md index 8f096864f5a8d4..3d51190fc0edda 100644 --- a/files/zh-cn/web/api/window/scroll/index.md +++ b/files/zh-cn/web/api/window/scroll/index.md @@ -5,15 +5,13 @@ slug: Web/API/Window/scroll {{APIRef}} -## 概述 - 滚动窗口至文档中的特定位置。 ## 语法 -``` -window.scroll(x-coord, y-coord) -window.scroll(options) +```js-nolint +scroll(x-coord, y-coord) +scroll(options) ``` ### 参数 diff --git a/files/zh-cn/web/api/window/scrollx/index.md b/files/zh-cn/web/api/window/scrollx/index.md index ef475ca24ef56c..9083a103ff4e73 100644 --- a/files/zh-cn/web/api/window/scrollx/index.md +++ b/files/zh-cn/web/api/window/scrollx/index.md @@ -5,20 +5,8 @@ slug: Web/API/Window/scrollX {{ APIRef() }} -## 概述 - 返回文档/页面水平方向滚动的像素值。 -## 语法 - -``` -var x = window.scrollX; -``` - -### 参数 - -- x 为该文档从左侧开始滚动的像素值。 - ## 示例 ```js @@ -30,31 +18,16 @@ if (window.scrollX > 400) { ## 备注 -`pageXOffset` 属性是 `scrollX` 属性的别名： +`pageXOffset` 属性是 `scrollX` 属性的别名。这意味这如果你没有为其中的任一属性重新赋值，`window.pageXOffset == window.scrollX` 总为真。 -``` -window.pageXOffset == window.scrollX; // 总是 true -``` +## 规范 -为了跨浏览器兼容性，请使用 `window.pageXOffset` 代替 `window.scrollX`。另外，旧版本的 IE（<9）两个属性都不支持，必须通过其他的非标准属性来解决此问题。完整的兼容性代码如下： +{{Specifications}} -```js -var x = - window.pageXOffset !== undefined - ? window.pageXOffset - : (document.documentElement || document.body.parentNode || document.body) - .scrollLeft; -var y = - window.pageYOffset !== undefined - ? window.pageYOffset - : (document.documentElement || document.body.parentNode || document.body) - .scrollTop; -``` - -## 规范 +## 浏览器兼容性 -- CSSOM View Module: [window.scrollX](http://dev.w3.org/csswg/cssom-view/#widl-Window-scrollX) (Editor's Draft) +{{Compat}} -## 相关链接 +## 参见 -- {{domxref("window.scrollY")}} +- {{domxref("Window.scrollY")}} diff --git a/files/zh-cn/web/api/xmlhttprequest/readystatechange_event/index.md b/files/zh-cn/web/api/xmlhttprequest/readystatechange_event/index.md index 597820ce5eee12..7604aca3b63b1e 100644 --- a/files/zh-cn/web/api/xmlhttprequest/readystatechange_event/index.md +++ b/files/zh-cn/web/api/xmlhttprequest/readystatechange_event/index.md @@ -14,8 +14,12 @@ slug: Web/API/XMLHttpRequest/readystatechange_event ## 语法 -``` -XMLHttpRequest.onreadystatechange = callback; +在类似 {{domxref("EventTarget.addEventListener", "addEventListener()")}} 这样的方法中使用事件名称，或设置事件处理器属性。 + +```js +addEventListener("readystatechange", (event) => {}); + +onreadystatechange = (event) => {}; ``` ### 取值 diff --git a/files/zh-cn/web/api/xmlhttprequest/responsexml/index.md b/files/zh-cn/web/api/xmlhttprequest/responsexml/index.md index 5025e604fcd9c3..4c3c75df1f18af 100644 --- a/files/zh-cn/web/api/xmlhttprequest/responsexml/index.md +++ b/files/zh-cn/web/api/xmlhttprequest/responsexml/index.md @@ -11,13 +11,7 @@ slug: Web/API/XMLHttpRequest/responseXML 如果服务器没有明确指出 {{HTTPHeader("Content-Type")}} 头是 `"text/xml"` 还是 `"application/xml"`, 你可以使用{{domxref("XMLHttpRequest.overrideMimeType()")}} 强制 `XMLHttpRequest` 解析为 XML。 -## 语法 - -``` -var data = XMLHttpRequest.responseXML; -``` - -### 值 +## 值 {{domxref("Document")}} 中包含从 {{domxref("XMLHttpRequest")}} 中收到的 HTML 节点或解析后的 XML 节点，也可能是在没有收到任何数据或数据类型错误的情况下返回的 null。 diff --git a/files/zh-cn/web/api/xmlhttprequest/send/index.md b/files/zh-cn/web/api/xmlhttprequest/send/index.md index e77affc2b1b7df..cbf1969a0cd4e0 100644 --- a/files/zh-cn/web/api/xmlhttprequest/send/index.md +++ b/files/zh-cn/web/api/xmlhttprequest/send/index.md @@ -14,8 +14,9 @@ slug: Web/API/XMLHttpRequest/send ## 语法 -``` -XMLHttpRequest.send(body) +```js-nolint +send() +send(body) ``` ### 参数 @@ -59,12 +60,12 @@ XMLHttpRequest.send(FormData data); ## 案例：GET -``` +```js var xhr = new XMLHttpRequest(); -xhr.open('GET', '/server', true); +xhr.open("GET", "/server", true); xhr.onload = function () { - // 请求结束后，在此处写处理代码 + // 请求结束后，在此处写处理代码 }; xhr.send(null); @@ -76,15 +77,15 @@ xhr.send(null); ## 案例：POST -``` +```js var xhr = new XMLHttpRequest(); -xhr.open("POST", '/server', true); +xhr.open("POST", "/server", true); //发送合适的请求头信息 xhr.setRequestHeader("Content-type", "application/x-www-form-urlencoded"); xhr.onload = function () { - // 请求结束后，在此处写处理代码 + // 请求结束后，在此处写处理代码 }; xhr.send("foo=bar&lorem=ipsum"); // xhr.send('string'); diff --git a/files/zh-cn/web/api/xmlhttprequest_api/synchronous_and_asynchronous_requests/index.md b/files/zh-cn/web/api/xmlhttprequest_api/synchronous_and_asynchronous_requests/index.md index f6b5abcab7f58e..6a7c677100cf08 100644 --- a/files/zh-cn/web/api/xmlhttprequest_api/synchronous_and_asynchronous_requests/index.md +++ b/files/zh-cn/web/api/xmlhttprequest_api/synchronous_and_asynchronous_requests/index.md @@ -186,7 +186,7 @@ if (request.status === 200) { **`myFile.txt`** ( [`XMLHttpRequest`](/zh-CN/DOM/XMLHttpRequest)对象同步请求的文件): -``` +```plain Hello World!! ``` diff --git a/files/zh-cn/web/css/_colon_active/index.md b/files/zh-cn/web/css/_colon_active/index.md index 91cd9674da9f8c..64988a1173ee13 100644 --- a/files/zh-cn/web/css/_colon_active/index.md +++ b/files/zh-cn/web/css/_colon_active/index.md @@ -23,8 +23,10 @@ a:active { ## 语法 -``` -:active +```css +:active { + /* ... */ +} ``` ## 示例 diff --git a/files/zh-cn/web/css/_colon_has/index.md b/files/zh-cn/web/css/_colon_has/index.md index 1198863f89ad7a..82ebf30cf58d9d 100644 --- a/files/zh-cn/web/css/_colon_has/index.md +++ b/files/zh-cn/web/css/_colon_has/index.md @@ -20,8 +20,10 @@ h1:has(+ p) { ## 语法 -``` -:has( ) +```css-nolint +:has() { + /* ... */ +} ``` 相对选择器列表参数是[可容错](/zh-CN/docs/Web/CSS/Selector_list#可容错选择器列表)的。通常在 CSS 中，选择器列表中的某个选择器无效时，那么整个列表则被视为无效。当 `:has()` 选择器列表中的一个选择器无法解析时，不正确或不受支持的选择器将被忽略，而其他的则将被正常使用。 diff --git a/files/zh-cn/web/css/_colon_host_function/index.md b/files/zh-cn/web/css/_colon_host_function/index.md index e5cceac2f083d1..5ce188c1b91fd6 100644 --- a/files/zh-cn/web/css/_colon_host_function/index.md +++ b/files/zh-cn/web/css/_colon_host_function/index.md @@ -21,8 +21,10 @@ slug: Web/CSS/:host_function ## 语法 -``` -:host( ) +```css-nolint +:host() { + /* ... */ +} ``` ## 示例 diff --git a/files/zh-cn/web/css/_colon_right/index.md b/files/zh-cn/web/css/_colon_right/index.md index 702fb17e1e665d..c3f099d91e980b 100644 --- a/files/zh-cn/web/css/_colon_right/index.md +++ b/files/zh-cn/web/css/_colon_right/index.md @@ -24,9 +24,9 @@ slug: Web/CSS/:right ## 语法 -``` -@page:right{ - margin: * *; +```css +:right { + /* ... */ } ```