From 37045a47ec338675857b1b260e1ea2bbf083c006 Mon Sep 17 00:00:00 2001 From: Jason Lam Date: Tue, 28 Nov 2023 20:55:16 +0800 Subject: [PATCH 1/6] [zh-cn]: add the translation of ArrayBuffer.transfer() (#17108) Co-authored-by: A1lo --- .../arraybuffer/transfer/index.md | 121 ++++++++++++++++++ 1 file changed, 121 insertions(+) create mode 100644 files/zh-cn/web/javascript/reference/global_objects/arraybuffer/transfer/index.md diff --git a/files/zh-cn/web/javascript/reference/global_objects/arraybuffer/transfer/index.md b/files/zh-cn/web/javascript/reference/global_objects/arraybuffer/transfer/index.md new file mode 100644 index 00000000000000..5b4059f469217b --- /dev/null +++ b/files/zh-cn/web/javascript/reference/global_objects/arraybuffer/transfer/index.md @@ -0,0 +1,121 @@ +--- +title: ArrayBuffer.prototype.transfer() +slug: Web/JavaScript/Reference/Global_Objects/ArrayBuffer/transfer +l10n: + sourceCommit: fb236a32b20d1985b35b1c0c25ce99f2a0e0d5fe +--- + +{{JSRef}} {{SeeCompatTable}} + +{{jsxref("ArrayBuffer")}} 实例的 **`transfer()`** 方法创建一个内容与该缓冲区相同的新 `ArrayBuffer` 实例，然后将当前缓冲区分离。 + +## 语法 + +```js-nolint +transfer() +transfer(newByteLength) +``` + +### 参数 + +- `newByteLength` {{optional_inline}} + - : 新的 `ArrayBuffer` 的 {{jsxref("ArrayBuffer/byteLength", "byteLength")}}。默认为当前 `ArrayBuffer` 的 `byteLength`。 + - 如果 `newByteLength` 小于当前 `ArrayBuffer` 的 `byteLength`，“溢出”的字节将被丢弃。 + - 如果 `newByteLength` 大于当前 `ArrayBuffer` 的 `byteLength`，剩下的的字节将用零填充。 + - 如果当前的 `ArrayBuffer` 是可调整大小的，`newByteLength` 一定不能大于其 {{jsxref("ArrayBuffer/maxByteLength", "maxByteLength")}}。 + +### 返回值 + +一个新的 {{jsxref("ArrayBuffer")}} 对象。其内容被初始化为当前 `ArrayBuffer` 的内容，如果有额外的字节。则填充为零。当且仅当当前 `ArrayBuffer` 是可调整大小的，新 `ArrayBuffer` 才是可调整大小的，在这种情况下，其 {{jsxref("ArrayBuffer/maxByteLength", "maxByteLength")}} 和当前 `ArrayBuffer` 的相同。当前 `ArrayBuffer` 将被分离。 + +### 异常 + +- {{jsxref("RangeError")}} + - : 如果当前 `ArrayBuffer` 是可调整大小的并且 `newByteLength` 大于当前 `ArrayBuffer` 的 {{jsxref("ArrayBuffer/maxByteLength", "maxByteLength")}}，则抛出此错误。 +- {{jsxref("TypeError")}} + - : 如果当前 `ArrayBuffer` 已经分离，则抛出此错误。 + +## 描述 + +`transfer()` 方法执行与[结构化克隆算法](/zh-CN/docs/Web/API/Web_Workers_API/Structured_clone_algorithm)相同的操作。它将当前 `ArrayBuffer` 的字节复制到一个新的 `ArrayBuffer` 对象中，然后分离当前 `ArrayBuffer` 对象。有关更多信息，请参阅[传输 ArrayBuffer](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer#传输_arraybuffer)。 + +`transfer()` 保留了当前 `ArrayBuffer` 的大小可调整性。如果你希望新的 `ArrayBuffer` 不可调整大小，请使用 {{jsxref("ArrayBuffer/transferToFixedLength", "transferToFixedLength()")}} 代替。没有办法通过传输使长度固定的缓冲区变为可调整大小的缓冲区。 + +`transfer()` 是非常高效的，因为（引擎）实现可能以零拷贝移动或 `realloc`——没有实际数据的复制——来实现此方法。 + +## 示例 + +### 传输一个 ArrayBuffer + +```js +// 创建一个 ArrayBuffer 并写入一些字节 +const buffer = new ArrayBuffer(8); +const view = new Uint8Array(buffer); +view[1] = 2; +view[7] = 4; + +// 将缓冲区复制到另一个相同大小的缓冲区 +const buffer2 = buffer.transfer(); +console.log(buffer.detached); // true +console.log(buffer2.byteLength); // 8 +const view2 = new Uint8Array(buffer2); +console.log(view2[1]); // 2 +console.log(view2[7]); // 4 + +// 将缓冲区复制到一个更小的缓冲区 +const buffer3 = buffer2.transfer(4); +console.log(buffer3.byteLength); // 4 +const view3 = new Uint8Array(buffer3); +console.log(view3[1]); // 2 +console.log(view3[7]); // undefined + +// 将缓冲区复制到一个更大的缓冲区 +const buffer4 = buffer3.transfer(8); +console.log(buffer4.byteLength); // 8 +const view4 = new Uint8Array(buffer4); +console.log(view4[1]); // 2 +console.log(view4[7]); // 0 + +// 已经分离，抛出 TypeError +buffer.transfer(); // TypeError: Cannot perform ArrayBuffer.prototype.transfer on a detached ArrayBuffer +``` + +### 传输一个可调整大小的 ArrayBuffer + +```js +const buffer = new ArrayBuffer(8, { maxByteLength: 16 }); +const view = new Uint8Array(buffer); +view[1] = 2; +view[7] = 4; + +// 将缓冲区复制到一个更小的缓冲区 +const buffer2 = buffer.transfer(4); +console.log(buffer2.byteLength); // 4 +console.log(buffer2.maxByteLength); // 16 +const view2 = new Uint8Array(buffer2); +console.log(view2[1]); // 2 +console.log(view2[7]); // undefined +buffer2.resize(8); +console.log(view2[7]); // 0 + +// 将缓冲区复制到一个大小在 maxByteLength 內但更大的缓冲区 +const buffer3 = buffer2.transfer(12); +console.log(buffer3.byteLength); // 12 + +// 将缓冲区复制到一个大小超过 maxByteLength 的更大的缓冲区 +buffer3.transfer(20); // RangeError: Invalid array buffer length +``` + +## 规范 + +{{Specifications}} + +## 浏览器兼容性 + +{{Compat}} + +## 参见 + +- {{jsxref("ArrayBuffer")}} +- {{jsxref("ArrayBuffer.prototype.detached")}} +- {{jsxref("ArrayBuffer.prototype.transferToFixedLength()")}} From b41d5e007f0f9fb60beaabf0d1682c52a42c4168 Mon Sep 17 00:00:00 2001 From: Jason Ren <40999116+jasonren0403@users.noreply.github.com> Date: Tue, 28 Nov 2023 23:45:39 +0800 Subject: [PATCH 2/6] [zh-cn]: update selectstart event of node (#17160) --- .../web/api/node/selectstart_event/index.md | 48 +++++++++++-------- 1 file changed, 28 insertions(+), 20 deletions(-) diff --git a/files/zh-cn/web/api/node/selectstart_event/index.md b/files/zh-cn/web/api/node/selectstart_event/index.md index e927ce686c8a65..d87b84b9138152 100644 --- a/files/zh-cn/web/api/node/selectstart_event/index.md +++ b/files/zh-cn/web/api/node/selectstart_event/index.md @@ -1,35 +1,43 @@ --- -title: selectstart +title: Node：selectstart 事件 slug: Web/API/Node/selectstart_event +l10n: + sourceCommit: 312081aabba3885b35a81107b3c2fc53428896c5 --- -[Selection API](/zh-CN/docs/Web/API/Selection_API) 的 **`selectstart`** 事件在用户开始一个新的选择时候触发。 +{{APIRef}} -如果事件被取消，选择将不被触发。 +[Selection API](/zh-CN/docs/Web/API/Selection) 的 **`selectstart`** 事件在用户进行一个新的选择时触发。 -| Bubbles | Yes | -| -------------- | ----------------------- | -| Cancelable | Yes | -| Target objects | {{domxref("Document")}} | -| Interface | {{domxref("Event")}} | +如果事件被取消，所选取内容将不会改变。 -## 例子 +## 语法 + +在类似于 {{domxref("EventTarget.addEventListener", "addEventListener()")}} 这样的方法中使用事件名称，或设置事件处理器属性。 ```js -document.addEventListener( - "selectstart", - function () { - console.log("Selection started"); - }, - false, -); +addEventListener("selectstart", (event) => {}); + +onselectstart = (event) => {}; ``` -## 继承 +## 事件类型 + +通用的 {{domxref("Event")}}。 -`selectstart` 事件实现{{domxref("Event")}} 接口。你可以使用此界面上定义的属性和方法。 +## 示例 -{{InheritanceDiagram('','','', 'Event')}} +```js +// addEventListener 版本 +document.addEventListener("selectstart", () => { + console.log("已开始选择"); +}); + +// onselectstart 版本 +document.onselectstart = () => { + console.log("已开始选择"); +}; +``` ## 规范 @@ -41,4 +49,4 @@ document.addEventListener( ## 参见 -- {{domxref("GlobalEventHandlers.onselectstart")}} +- {{domxref("Document/selectionchange_event", "selectionchange")}} From ea39a4e4286e59e48a1c11227a0143a7970a7944 Mon Sep 17 00:00:00 2001 From: Jason Ren <40999116+jasonren0403@users.noreply.github.com> Date: Tue, 28 Nov 2023 23:46:22 +0800 Subject: [PATCH 3/6] [zh-cn]: update scroll event of document (#17159) Co-authored-by: A1lo --- .../web/api/document/scroll_event/index.md | 76 ++++++++----------- 1 file changed, 33 insertions(+), 43 deletions(-) diff --git a/files/zh-cn/web/api/document/scroll_event/index.md b/files/zh-cn/web/api/document/scroll_event/index.md index 506300847917f7..5c06c21a89ec2c 100644 --- a/files/zh-cn/web/api/document/scroll_event/index.md +++ b/files/zh-cn/web/api/document/scroll_event/index.md @@ -1,60 +1,50 @@ --- -title: "Document: scroll event" +title: Document：scroll 事件 slug: Web/API/Document/scroll_event +l10n: + sourceCommit: 41a8b9c9832359d445d136b6d7a8a28737badc6b --- -文档视图或者一个元素在滚动时，会触发元素的 **`scroll`** 事件。 - - - - - - - - - - - - - - - - - - - - - -
BubblesYes
CancelableNo
Interface{{DOMxRef("Event")}}
Event handler property - {{DOMxRef("GlobalEventHandlers.onscroll", "onscroll")}} -
- -> **备注：** 在 iOS UIWebViews 中，滚动进行时不会触发 `scroll` 事件；只有当滚动结束后事件才会被触发。参见 [Bootstrap issue #16202](https://github.com/twbs/bootstrap/issues/16202)。Safari 和 WKWebViews 则没有这个问题。 +{{APIRef}} + +当文档视图滚动后，**`scroll`** 事件就会触发。要检测滚动何时结束，请参阅 {{domxref("Document/scrollend_event", "Document：scrollend 事件", "", "1")}}。关于元素滚动，请参见 {{domxref("Element/scroll_event", "Element：scroll 事件", "", "1")}}。 + +## 语法 + +在类似于 {{domxref("EventTarget.addEventListener", "addEventListener()")}} 这样的方法中使用事件名称，或设置事件处理器属性。 + +```js +addEventListener("scroll", (event) => {}); + +onscroll = (event) => {}; +``` + +## 事件类型 + +通用的 {{domxref("Event")}}。 ## 示例 -### Scroll 事件节流 +### Scroll 事件限流 -由于 `scroll` 事件可被高频触发，事件处理程序不应该执行高性能消耗的操作，如 DOM 操作。而更推荐的做法是使用 {{DOMxRef("Window.requestAnimationFrame()", "requestAnimationFrame()")}}、{{DOMxRef("setTimeout()")}} 或 {{DOMxRef("CustomEvent")}} 给事件节流，如下所述。 +由于 `scroll` 事件可被高频触发，事件处理器不应该执行高性能消耗的操作，如 DOM 操作。而更推荐的做法是使用 {{DOMxRef("Window.requestAnimationFrame()", "requestAnimationFrame()")}}、{{DOMxRef("setTimeout()")}} 或 {{DOMxRef("CustomEvent")}} 给事件限流，如下所述。 -然而需要注意的是，输入事件和动画帧常常以差不多的频率被触发，因此以下优化常常不必要。这个例子使用 `requestAnimationFrame` 优化 `scroll` 事件。 +然而需要注意的是，输入事件和动画帧的触发速度大致相同，因此通常不需要下述优化。此示例使用 `requestAnimationFrame` 优化 `scroll` 事件。 ```js -// 参见：http://www.html5rocks.com/en/tutorials/speed/animations/ - -let last_known_scroll_position = 0; +let lastKnownScrollPosition = 0; let ticking = false; -function doSomething(scroll_pos) { - // 根据滚动位置做的事 +function doSomething(scrollPos) { + // 利用滚动位置完成一些事情 } -window.addEventListener("scroll", function (e) { - last_known_scroll_position = window.scrollY; +document.addEventListener("scroll", (event) => { + lastKnownScrollPosition = window.scrollY; if (!ticking) { - window.requestAnimationFrame(function () { - doSomething(last_known_scroll_position); + window.requestAnimationFrame(() => { + doSomething(lastKnownScrollPosition); ticking = false; }); @@ -63,8 +53,6 @@ window.addEventListener("scroll", function (e) { }); ``` -在 [`resize`](/zh-CN/docs/Web/API/Document/defaultView/resize_event) 事件页面中查看更多类似的例子。 - ## 规范 {{Specifications}} @@ -75,4 +63,6 @@ window.addEventListener("scroll", function (e) { ## 参见 -- [Element: `scroll` event](/zh-CN/docs/Web/API/Element/scroll_event) +- [Document：`scrollend` 事件](/zh-CN/docs/Web/API/Document/scrollend_event) +- [Element：`scroll` 事件](/zh-CN/docs/Web/API/Element/scroll_event) +- [Element：`scrollend` 事件](/zh-CN/docs/Web/API/Element/scrollend_event) From 11009c29a0ad2cbebf5b66c99d68d91deff52a97 Mon Sep 17 00:00:00 2001 From: SphinxKnight Date: Tue, 28 Nov 2023 17:58:05 +0100 Subject: [PATCH 4/6] `fr` - Glossary - Initial translation for F entries (#16969) Initial translation - Glossary - F --- files/fr/glossary/fallback_alignment/index.md | 24 ++++++++++++ .../fetch_metadata_request_header/index.md | 38 +++++++++++++++++++ files/fr/glossary/fingerprinting/index.md | 26 +++++++++++++ files/fr/glossary/first_input_delay/index.md | 19 ++++++++++ files/fr/glossary/first_interactive/index.md | 18 +++++++++ 5 files changed, 125 insertions(+) create mode 100644 files/fr/glossary/fallback_alignment/index.md create mode 100644 files/fr/glossary/fetch_metadata_request_header/index.md create mode 100644 files/fr/glossary/fingerprinting/index.md create mode 100644 files/fr/glossary/first_input_delay/index.md create mode 100644 files/fr/glossary/first_interactive/index.md diff --git a/files/fr/glossary/fallback_alignment/index.md b/files/fr/glossary/fallback_alignment/index.md new file mode 100644 index 00000000000000..9702e18f47ee69 --- /dev/null +++ b/files/fr/glossary/fallback_alignment/index.md @@ -0,0 +1,24 @@ +--- +title: Alignement de recours +slug: Glossary/Fallback_Alignment +l10n: + sourceCommit: 35bb8cea8badfbc1b3fffbd0ade2699893dc8fe1 +--- + +{{GlossarySidebar}} + +Dans [le module CSS sur l'alignement des boîtes](/fr/docs/Web/CSS/CSS_box_alignment), un alignement de recours (fallback alignement) est indiqué afin de traiter les cas où l'alignement demandé ne peut être respecté. Par exemple, si on indique `justify-content: space-between`, il doit y avoir plus d'un [sujet d'alignement](/fr/docs/Glossary/Alignment_Subject). Si ce n'est pas le cas, c'est l'alignement de recours qui est utilisé. Cet alignement diffère selon la méthode d'alignement voulue, comme suit : + +| Alignement souhaité | Alignement de recours | +| ------------------- | --------------------- | +| `first baseline` | `start` | +| `last baseline` | `safe end` | +| `baseline` | `start` | +| `space-between` | `flex-start` | +| `space-around` | `center` | +| `space-evenly` | `center` | +| `stretch` | `flex-start` | + +## Voir aussi + +- [La section de MDN sur le module de spécification CSS sur l'alignement des boîtes](/fr/docs/Web/CSS/CSS_box_alignment) diff --git a/files/fr/glossary/fetch_metadata_request_header/index.md b/files/fr/glossary/fetch_metadata_request_header/index.md new file mode 100644 index 00000000000000..962aad8152e5c3 --- /dev/null +++ b/files/fr/glossary/fetch_metadata_request_header/index.md @@ -0,0 +1,38 @@ +--- +title: En-tête de métadonnées de requête de récupération +slug: Glossary/Fetch_metadata_request_header +l10n: + sourceCommit: 35bb8cea8badfbc1b3fffbd0ade2699893dc8fe1 +--- + +{{GlossarySidebar}} + +Un **en-tête de métadonnées de requête de récupération** (fetch metadata request header en anglais) est un [en-tête de requête HTTP](/fr/docs/Glossary/Request_header) qui fournit des informations supplémentaires sur le contexte d'origine de la requête. Cela permet au serveur de décider si une requête doit être autorisée selon son emplacement d'origine et la façon dont la ressource sera utilisée. + +Grâce à ces informations, un serveur peut implémenter [une politique d'isolation des ressources](/fr/docs/Glossary/Resource_isolation_policy), pour limiter l'accès aux seules ressources partageables pour les sites externes, lorsque l'usage correspondant est respecté. Cette approche permet de réduire les risques des vulnérabilités entre sites différents, comme [CSRF](/fr/docs/Glossary/CSRF), Cross-site Script Inclusion (XSSI), les attaques temporelles, et les fuites d'information entre origines. + +Ces en-têtes ont le préfixe `Sec-`, et sont donc des [noms d'en-tête interdits](/fr/docs/Glossary/Forbidden_header_name), qui ne peuvent pas être modifié depuis du code JavaScript. + +Les en-têtes de métadonnées de requête de récupération sont : + +- [`Sec-Fetch-Site`](/fr/docs/Web/HTTP/Headers/Sec-Fetch-Site) +- [`Sec-Fetch-Mode`](/fr/docs/Web/HTTP/Headers/Sec-Fetch-Mode) +- [`Sec-Fetch-User`](/fr/docs/Web/HTTP/Headers/Sec-Fetch-User) +- [`Sec-Fetch-Dest`](/fr/docs/Web/HTTP/Headers/Sec-Fetch-Dest) + +Quant aux en-têtes de requêtes qui suivent, ils ne font pas _strictement_ partie des en-têtes de métadonnées de requête de récupération (au sens où ils ne font pas partie de la même spécification), mais fournissent également des informations sur la façon dont une ressource sera utilisée. Un serveur pourra utiliser les en-têtes suivants pour modifier son comportement de mise en cache ou les informations qui seront renvoyées : + +- [`Sec-Purpose`](/fr/docs/Web/HTTP/Headers/Sec-Purpose){{Experimental_Inline}} +- [`Service-Worker-Navigation-Preload`](/fr/docs/Web/HTTP/Headers/Service-Worker-Navigation-Preload) + +## Voir aussi + +- [Protéger vos ressources des attaques web avec les en-têtes de métadonnées de requête (en anglais)](https://web.dev/articles/fetch-metadata) +- [Bac à sable pour les en-têtes de métadonnées de requête (en anglais)](https://secmetadata.appspot.com/) +- [Liste des en-têtes HTTP](/fr/docs/Web/HTTP/Headers) +- [En-têtes HTTP > En-têtes de métadonnées de requête](/fr/docs/Web/HTTP/Headers#en-têtes_de_requêtes_de_métadonnées) +- [Entrées du glossaire](/fr/docs/Glossary) + - [En-tête de représentation](/fr/docs/Glossary/Representation_header) + - [En-tête HTTP](/fr/docs/Glossary/HTTP_header) + - [En-tête de réponse](/fr/docs/Glossary/Response_header) + - [En-tête de requête](/fr/docs/Glossary/Request_header) diff --git a/files/fr/glossary/fingerprinting/index.md b/files/fr/glossary/fingerprinting/index.md new file mode 100644 index 00000000000000..f6055382e142d7 --- /dev/null +++ b/files/fr/glossary/fingerprinting/index.md @@ -0,0 +1,26 @@ +--- +title: Empreinte digitale numérique +slug: Glossary/Fingerprinting +l10n: + sourceCommit: 35bb8cea8badfbc1b3fffbd0ade2699893dc8fe1 +--- + +{{GlossarySidebar}} + +Une **empreinte digitale numérique** est parfois construite par des sites web pour identifier un navigateur donné (et par extension, une personne donnée), en collectant et assemblant des caractéristiques particulières du navigateur et système d'exploitation sous-jacent. Parmi les éléments constituants une empreinte digitale numérique, on pourra par exemple trouver : + +- La version du navigateur +- Le fuseau horaire et la langue préférée +- L'ensemble des codecs audio et vidéo disponibles sur le système +- Les polices installées sur le système +- L'état des paramètres du navigateur +- La taille d'affichage et la résolution de l'ordinateur + +Un site web peut récupérer de telles informations en exécutant du JavaScript et du CSS sur l'appareil. L'assemblage des différentes données permet souvent de créer une empreinte unique pour un navigateur, qui peut être utilisée pour pister les personnes sur le Web. + +Les standards web sont conçus pour minimiser ce type de collecte d'information, et les navigateurs ajoutent généralement d'autres protections. + +## Voir aussi + +- [Cover Your Tracks](https://coveryourtracks.eff.org) : un outil pour afficher les données qu'un site web peut utiliser pour construire une empreinte digitale numérique. +- [Réduire les risques de construction d'une empreinte digitale dans les spécifications web](https://www.w3.org/TR/fingerprinting-guidance/) : un ensemble de bonnes pratiques à l'attention des autrices et auteurs de spécification web pour empêcher les constructions de telles empreintes. diff --git a/files/fr/glossary/first_input_delay/index.md b/files/fr/glossary/first_input_delay/index.md new file mode 100644 index 00000000000000..5b14fe2912fed7 --- /dev/null +++ b/files/fr/glossary/first_input_delay/index.md @@ -0,0 +1,19 @@ +--- +title: First input delay +slug: Glossary/First_input_delay +l10n: + sourceCommit: 35bb8cea8badfbc1b3fffbd0ade2699893dc8fe1 +--- + +{{GlossarySidebar}} + +La métrique **first input delay** (FID) (qu'on pourrait traduire en « délai à la première saisie ») correspond à la durée entre la première interaction d'une personne avec le site web (que ce soit un clic sur un lien, un appui sur un bouton, ou l'utilisation d'un contrôle implémenté en JavaScript) et le moment où le navigateur est effectivement capable de réagir à cette interaction. + +Le défilement et le zoom ne sont pas comptabilisés parmi ces premières interactions. + +Le temps entre le moment où le contenu est affiché sur la page et le moment où l'ensemble des fonctionnalités sont réactives pour les humains varie souvent selon la taille et la complexité du JavaScript qui doit être téléchargé, analysé, puis exécuté sur le fil d'exécution principal, et selon les performances de l'appareil sous-jacent. Plus le délai sera important, plus l'expérience de navigation sera dégradée. Réduire le temps d'initialisation du site et éliminer [les tâches longues](/fr/docs/Web/API/PerformanceLongTaskTiming) peut aider à améliorer cette métrique. + +## Voir aussi + +- [`requestIdleCallback()`](/fr/docs/Web/API/Window/requestIdleCallback) +- [Chargement fainéant (lazy loading)](/fr/docs/Web/Performance/Lazy_loading) diff --git a/files/fr/glossary/first_interactive/index.md b/files/fr/glossary/first_interactive/index.md new file mode 100644 index 00000000000000..7da2f06740890d --- /dev/null +++ b/files/fr/glossary/first_interactive/index.md @@ -0,0 +1,18 @@ +--- +title: First interactive +slug: Glossary/First_interactive +l10n: + sourceCommit: 35bb8cea8badfbc1b3fffbd0ade2699893dc8fe1 +--- + +{{GlossarySidebar}} + +La métrique **first interactive** (voir aussi [premier cycle processeur disponible](/fr/docs/Glossary/First_CPU_idle)), est une métrique de performance web non standard qui mesure le moment où la fenêtre du navigateur est suffisamment disponible (peu sollicitée) pour gérer les entrées de l'utilisatrice ou de l'utilisateur. + +Ce seuil d'interactivité minimale est défini lorsque certains éléments d'interface de la page, pas nécessairement tous, ont été chargés, sont interactifs et, en moyenne, répondent aux interactions dans un délai raisonnable. + +## Voir aussi + +- Les métriques qui remplacent désormais first interactive : + - [La métrique Time to interactive sur le glossaire MDN](/fr/docs/Glossary/Time_to_interactive) + - [La métrique Total blocking time (en anglais) sur la documentation Google de Lighthouse](https://developer.chrome.com/docs/lighthouse/performance/lighthouse-total-blocking-time/) From eafc28b00daaf8e6bf1d55abd049b50cf6a052fd Mon Sep 17 00:00:00 2001 From: Vick Vasquez Date: Tue, 28 Nov 2023 12:30:11 -0600 Subject: [PATCH 5/6] es: create page getscreendetails (#17100) * es: create page getscreendetails * fix: whitespace * fix: based on suggestions on code review --- .../web/api/window/getscreendetails/index.md | 65 +++++++++++++++++++ 1 file changed, 65 insertions(+) create mode 100644 files/es/web/api/window/getscreendetails/index.md diff --git a/files/es/web/api/window/getscreendetails/index.md b/files/es/web/api/window/getscreendetails/index.md new file mode 100644 index 00000000000000..d624f96fb2739a --- /dev/null +++ b/files/es/web/api/window/getscreendetails/index.md @@ -0,0 +1,65 @@ +--- +title: "Window: método getScreenDetails()" +slug: Web/API/Window/getScreenDetails +l10n: + sourceCommit: e089abbca14964a8ce945135d954cbfd098fd6f7 +--- + +{{APIRef("Window Management API")}}{{SeeCompatTable}}{{securecontext_header}} + +El método **`getScreenDetails()`** de la interfaz {{domxref("Window")}} devuelve una {{jsxref("Promise", "Promesa")}} que cumple con la instancia del objeto {{domxref("ScreenDetails")}} representando los detalles de todas las pantallas disponibles del dispositivo del usuario. + +## Sintaxis + +```js-nolint +getScreenDetails() +``` + +### Parametros + +Ninguno. + +### Valor devuelto + +Una {{jsxref("Promise", "Promesa")}} que cumple con la instancia de un objeto {{domxref("ScreenDetails")}}. + +### Excepciones + +- `NotAllowedError` {{domxref("DOMException")}} + - : Se produce si se establece una [Politica de permisos](/es/docs/Web/HTTP/Permissions_Policy) de {{httpheader("Permissions-Policy/window-management", "administración de ventanas")}} que bloquea el uso del [API de administracion de ventanas](/es/docs/Web/API/Window_Management_API), o si el usuario ha negado explícitamente la solicitud de permiso del navegador para utilizar la API. + +## Ejemplos + +Cuando `getScreenDetails()` es invocado se le pedirá permiso al usuario para administrar ventanas en todas sus pantallas (el estado de este permiso se puede verificar usando {{domxref("Permissions.query()")}} para consultar `window-management`). Cuando se concede el permiso, el objeto {{domxref("ScreenDetails")}} resultante contiene todos los detalles de todas las pantallas disponibles para el sistema del usuario. + +El siguiente ejemplo abre una ventana de tamaño completo en cada pantalla disponible. + +```js +const screenDetails = await window.getScreenDetails(); + +// Abre una ventana de tamaño completo en cada pantalla disponible. +for (const screen of screenDetails.screens) { + window.open( + "https://example.com", + "_blank", + `left=${screen.availLeft}, + top=${screen.availTop}, + width=${screen.availWidth}, + height=${screen.availHeight}`, + ); +} +``` + +> **Nota:** Consulta [Entorno de aprendizaje de multiples ventanas](https://mdn.github.io/dom-examples/window-management-api/) para un ejemplo completo (consulta también el [codigo fuente](https://github.com/mdn/dom-examples/tree/main/window-management-api)). + +## Especificaciones + +{{Specifications}} + +## Compatibilidad con navegadores + +{{Compat}} + +## Véase también + +- [API de administración de ventanas](/es/docs/Web/API/Window_Management_API) From 86062e6cb18c305d644a8a100a7b3eaf4c71ac3d Mon Sep 17 00:00:00 2001 From: Leonid Vinogradov Date: Tue, 28 Nov 2023 21:31:27 +0300 Subject: [PATCH 6/6] [es] remove obsolete `orphaned/Web/HTML/Element/applet` (#17120) * [es] remove obsolete orphaned/Web/HTML/Element/applet * [es] remove all 'applet' HTML element occurrences * [es] remove all 'applet' HTML element occurrences --- files/es/_redirects.txt | 4 - files/es/_wikihistory.json | 4 - .../orphaned/web/html/element/applet/index.md | 229 ------------------ files/es/web/html/attributes/index.md | 14 +- files/es/web/html/element/index.md | 1 - files/es/web/html/element/object/index.md | 1 - .../headers/content-security-policy/index.md | 4 +- 7 files changed, 4 insertions(+), 253 deletions(-) delete mode 100644 files/es/orphaned/web/html/element/applet/index.md diff --git a/files/es/_redirects.txt b/files/es/_redirects.txt index 1b76c07bcaec0e..3238ca6407594c 100644 --- a/files/es/_redirects.txt +++ b/files/es/_redirects.txt @@ -695,7 +695,6 @@ /es/docs/HTML/Elemento/abbr /es/docs/Web/HTML/Element/abbr /es/docs/HTML/Elemento/acronym /es/docs/Web/HTML/Element/acronym /es/docs/HTML/Elemento/address /es/docs/Web/HTML/Element/address -/es/docs/HTML/Elemento/applet /es/docs/orphaned/Web/HTML/Element/applet /es/docs/HTML/Elemento/area /es/docs/Web/HTML/Element/area /es/docs/HTML/Elemento/article /es/docs/Web/HTML/Element/article /es/docs/HTML/Elemento/aside /es/docs/Web/HTML/Element/aside @@ -790,7 +789,6 @@ /es/docs/HTML:Elemento:abbr /es/docs/Web/HTML/Element/abbr /es/docs/HTML:Elemento:acronym /es/docs/Web/HTML/Element/acronym /es/docs/HTML:Elemento:address /es/docs/Web/HTML/Element/address -/es/docs/HTML:Elemento:applet /es/docs/orphaned/Web/HTML/Element/applet /es/docs/HTML:Elemento:area /es/docs/Web/HTML/Element/area /es/docs/HTML:Elemento:b /es/docs/Web/HTML/Element/b /es/docs/HTML:Elemento:base /es/docs/Web/HTML/Element/base @@ -2013,7 +2011,6 @@ /es/docs/Web/HTML/Canvas /es/docs/Web/API/Canvas_API /es/docs/Web/HTML/Canvas/A_basic_ray-caster /es/docs/orphaned/Web/API/Canvas_API/A_basic_ray-caster /es/docs/Web/HTML/Consejos_para_la_creación_de_páginas_HTML_de_carga_rápida /es/docs/Learn/HTML/Howto/Author_fast-loading_HTML_pages -/es/docs/Web/HTML/Element/applet /es/docs/orphaned/Web/HTML/Element/applet /es/docs/Web/HTML/Element/basefont /es/docs/conflicting/Web/CSS/CSS_Fonts /es/docs/Web/HTML/Element/bgsound /es/docs/Web/HTML/Element/audio /es/docs/Web/HTML/Element/blink /es/docs/orphaned/Web/HTML/Element/blink @@ -2027,7 +2024,6 @@ /es/docs/Web/HTML/Elemento/abbr /es/docs/Web/HTML/Element/abbr /es/docs/Web/HTML/Elemento/acronym /es/docs/Web/HTML/Element/acronym /es/docs/Web/HTML/Elemento/address /es/docs/Web/HTML/Element/address -/es/docs/Web/HTML/Elemento/applet /es/docs/orphaned/Web/HTML/Element/applet /es/docs/Web/HTML/Elemento/area /es/docs/Web/HTML/Element/area /es/docs/Web/HTML/Elemento/article /es/docs/Web/HTML/Element/article /es/docs/Web/HTML/Elemento/aside /es/docs/Web/HTML/Element/aside diff --git a/files/es/_wikihistory.json b/files/es/_wikihistory.json index 842ecd34327124..ad244b8ca86f2d 100644 --- a/files/es/_wikihistory.json +++ b/files/es/_wikihistory.json @@ -15299,10 +15299,6 @@ "jesanchez" ] }, - "orphaned/Web/HTML/Element/applet": { - "modified": "2019-03-23T23:42:26.076Z", - "contributors": ["Sebastianz", "teoli", "Jorolo"] - }, "orphaned/Web/HTML/Element/blink": { "modified": "2019-10-10T16:37:40.291Z", "contributors": ["teoli", "jcr4"] diff --git a/files/es/orphaned/web/html/element/applet/index.md b/files/es/orphaned/web/html/element/applet/index.md deleted file mode 100644 index 624885a5f24d58..00000000000000 --- a/files/es/orphaned/web/html/element/applet/index.md +++ /dev/null @@ -1,229 +0,0 @@ ---- -title: applet -slug: orphaned/Web/HTML/Element/applet -original_slug: Web/HTML/Element/applet ---- - -### Definición - -- Permite añadir un applet Java en un documento HTML. Es un elemento [Desaprobado](/es/HTML/Elemento/Tipos_de_elementos#Desaprobado) En su lugar debe usarse el elemento [object](/es/HTML/Elemento/object), su uso solo es válido declarando el dtd transicional. - - : **Sus etiquetas son**: \ y \ (ambas obligatorias) - - **Crea una caja**: [en linea](/es/HTML/Elemento/Tipos_de_elementos#en_linea). - - **Está definido como**: [Elemento especial](/es/HTML/Elemento/Tipos_de_elementos#Especiales). [Desaprobado](/es/HTML/Elemento/Tipos_de_elementos#Desaprobado) - - **Puede contener** cero o más elementos param o del tipo 'en flujo'. - -#### Atributos - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
atributovalordescripción
Genericos
titleTextoImplícitoTítulo consultivo del elemento.
styleReglas de estilo CSSImplícitoInformación de estilo en línea.
idUn 'nombre'ImplícitoIdentificador único a nivel de documento.
classLista de clases CSSimplícitoIdentificador a nivel de documento.
dirUno de los siguientes: "ltr" o "rtl"ImplícitoDirección del texto.
langCódigo de idiomaImplícitoInformación sobre el idioma.
- Eventos: - onclick, ondblclick, onmousedown, onmouseup, onmouseover, - onmousemove, onmouseout, onkeypress, onkeydown, onkeyup. -
Específicos
No tiene
De transición
declare(declare)ImplícitoInformación sobre el idioma.
classidUna direcciónImplícitoIdentifica una implementación.
codebaseUna direcciónImplícitoURI base para classid, datos, archivo.
dataUna direcciónImplícitoReferencia a los datos del objeto.
typeTipo MIMEImplícitoTipo de contenido de los datos.
codetypeTipo MIMEImplícitoTipo de contenido del código.
archiveDireccionesImplícitoLista de URIs separados por espacios.
standbyTextoImplícitoMensaje a mostrar durente la carga.
heightTamañoImplícitoEspecificar nueva altura.
widthTamañoImplícitoEspecificar nueva anchura.
usemapUna direcciónImplícitoUsar mapa de imágenes en el cliente.
nameCDATAImplícitoEnviar como parte de un formulario.
tabindexNúmeroImplícitoPosición en el orden de tabulación.
align - Uno de los siguientes: "top", "middle", "bottom", "left", "right". - ImplícitoAlineación vertical u horizontal.
borderPíxelesImplícitoGrosor del borde del vínculo.
hspacePíxelesImplícitoespacio horizontal.
vspacePíxelesImplícitoEspacio vertical.
%reserved;Reservado para posibles usos futuros.
atributovalordescripción
- -### Ejemplos - -``` - Ejemplo con applet: - - - - - - Lo mismo pero usando el elemento object: - - - - -``` - -### Comentarios - -El contenido de applet actúa como información alternativa para agentes de usuario que no soporten este elemento o que estén configurados para no soportar applets. En cualquier otro caso los agentes de usuario deben ignorar el contenido. - -### Referencia - -- El elemento [**applet** en la especificación](http://html.conclase.net/w3c/html401-es/struct/objects.html#edef-APPLET) de html 4.01 - -secciones futuras: == Soporte de los navegadores == == Valores por defecto y visualización en Firefox == diff --git a/files/es/web/html/attributes/index.md b/files/es/web/html/attributes/index.md index 26bc8016061c96..19edcb7098cd4a 100644 --- a/files/es/web/html/attributes/index.md +++ b/files/es/web/html/attributes/index.md @@ -38,12 +38,12 @@ Los elementos en HTML tienen **atributos**; estos son valores adicionales que co align - {{ HTMLElement("applet") }}, {{ HTMLElement("caption") }}, {{ HTMLElement("col") }}, {{ HTMLElement("colgroup") }}, {{ HTMLElement("hr") }}, {{ HTMLElement("iframe") }}, {{ HTMLElement("img") }}, {{ HTMLElement("table") }}, {{ HTMLElement("tbody") }}, {{ HTMLElement("td") }}, {{ HTMLElement("tfoot") }} , {{ HTMLElement("th") }}, {{ HTMLElement("thead") }}, {{ HTMLElement("tr") }} + {{ HTMLElement("caption") }}, {{ HTMLElement("col") }}, {{ HTMLElement("colgroup") }}, {{ HTMLElement("hr") }}, {{ HTMLElement("iframe") }}, {{ HTMLElement("img") }}, {{ HTMLElement("table") }}, {{ HTMLElement("tbody") }}, {{ HTMLElement("td") }}, {{ HTMLElement("tfoot") }} , {{ HTMLElement("th") }}, {{ HTMLElement("thead") }}, {{ HTMLElement("tr") }} Especifica el alineamiento horizontal del elemento. alt - {{ HTMLElement("applet") }}, {{ HTMLElement("area") }}, {{ HTMLElement("img") }}, {{ HTMLElement("input") }} + {{ HTMLElement("area") }}, {{ HTMLElement("img") }}, {{ HTMLElement("input") }} Texto alternativo en caso de que la imagen no se pueda mostrar. @@ -116,16 +116,6 @@ Los elementos en HTML tienen **atributos**; estos son valores adicionales que co Atributo Global Usualmente empleado con CSS para aplicar estilos a elementos con propiedades en comun. - - code - {{ HTMLElement("applet") }} - Especifica la URL del archivo de tipo applet a ser cargado y ejecutado. - - - codebase - {{ HTMLElement("applet") }} - Este atributo contiene la URL absoluta o relativa del directorio donde los archivos de applets (.class) referenciados en el codigo se encuentran almacenados. - color {{ HTMLElement("basefont") }}, {{ HTMLElement("font") }}, {{ HTMLElement("hr") }} diff --git a/files/es/web/html/element/index.md b/files/es/web/html/element/index.md index da444b3600887f..67c8d6afa2495f 100644 --- a/files/es/web/html/element/index.md +++ b/files/es/web/html/element/index.md @@ -225,7 +225,6 @@ Los Componentes Web son una tecnología relacionada con HTML que hacen que sea p | Elemento | Descripción | | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | {{HTMLElement("acronym")}} | Permite a los autores indicar claramente una secuencia de caracteres que componen un acrónimo o abreviatura de una palabra. | -| {{HTMLElement("applet")}} | **Sus etiquetas son**: \ y \ (ambas obligatorias) | | {{HTMLElement("bgsound")}} | El elemento HTML de sonido de fondo (\) es un elemento de Internet Explorer que asocia un sonido de fondo con un página . | | {{HTMLElement("big")}} | **big** de big=grande | | {{HTMLElement("blink")}} | El elemento HTML blink (``) no es un elemento estándar que causa que el texto encerrado parpadee lentamente . | diff --git a/files/es/web/html/element/object/index.md b/files/es/web/html/element/object/index.md index 36c75a4e1c4a29..a85a4c62098a61 100644 --- a/files/es/web/html/element/object/index.md +++ b/files/es/web/html/element/object/index.md @@ -142,6 +142,5 @@ Este elemento incluye los [global attributes](/es/docs/Web/HTML/Global_attribute ## See also -- {{HTMLElement("applet")}} {{deprecated_inline}} - {{HTMLElement("embed")}} - {{HTMLElement("param")}} diff --git a/files/es/web/http/headers/content-security-policy/index.md b/files/es/web/http/headers/content-security-policy/index.md index 6e6ee559e583f0..f287bcf9ea269b 100644 --- a/files/es/web/http/headers/content-security-policy/index.md +++ b/files/es/web/http/headers/content-security-policy/index.md @@ -58,7 +58,7 @@ Content-Security-Policy: ; - : Especifica origenes válidos para carga de archivos usando elementos como {{HTMLElement("audio")}} , {{HTMLElement("video")}} y {{HTMLElement("track")}}. - {{CSP("object-src")}} - - : Specifies valid sources for the {{HTMLElement("object")}}, {{HTMLElement("embed")}}, and {{HTMLElement("applet")}} elements. + - : Specifies valid sources for the {{HTMLElement("object")}} and {{HTMLElement("embed")}} elements. Elements controlled by `object-src` are perhaps coincidentally considered legacy HTML elements and aren't recieving new standardized features (such as the security attributes `sandbox` or `allow` for `