Skip to content

Commit

Permalink
fix: flaws in web/api/e* batch 1 (#3042)
Browse files Browse the repository at this point in the history
  • Loading branch information
nschonni authored Mar 12, 2021
1 parent f62d664 commit 86de129
Show file tree
Hide file tree
Showing 36 changed files with 154 additions and 154 deletions.
2 changes: 1 addition & 1 deletion files/en-us/web/api/ecdhkeyderiveparams/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
---
<div>{{ APIRef("Web Crypto API") }}</div>

<p>The <strong><code>EcdhKeyDeriveParams</code></strong> dictionary of the <a href="/en-US/docs/Web/API/Web_Crypto_API">Web Crypto API </a>represents the object that should be passed as the <code>algorithm</code> parameter into {{domxref("SubtleCrypto.deriveKey()")}},  when using the <a href="/en-US/docs/Web/API/SubtleCrypto/deriveKey#ECDH">ECDH</a> algorithm.</p>
<p>The <strong><code>EcdhKeyDeriveParams</code></strong> dictionary of the <a href="/en-US/docs/Web/API/Web_Crypto_API">Web Crypto API </a>represents the object that should be passed as the <code>algorithm</code> parameter into {{domxref("SubtleCrypto.deriveKey()")}},  when using the <a href="/en-US/docs/Web/API/SubtleCrypto/deriveKey#ecdh">ECDH</a> algorithm.</p>

<p>ECDH enables two people who each have a key pair consisting of a public and a private key to derive a shared secret. They exchange public keys and use the combination of their private key and the other entity's public key to derive a secret key that they — and noone else — share.</p>

Expand Down
10 changes: 5 additions & 5 deletions files/en-us/web/api/ecdsaparams/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
---
<div>{{ APIRef("Web Crypto API") }}</div>

<p>The <code><strong>EcdsaParams</strong></code> dictionary of the <a href="/en-US/docs/Web/API/Web_Crypto_API">Web Crypto API </a>represents the object that should be passed as the <code>algorithm</code> parameter into {{domxref("SubtleCrypto.sign()")}} or {{domxref("SubtleCrypto.verify()")}} when using the <a href="/en-US/docs/Web/API/SubtleCrypto/sign#ECDSA">ECDSA</a> algorithm.</p>
<p>The <code><strong>EcdsaParams</strong></code> dictionary of the <a href="/en-US/docs/Web/API/Web_Crypto_API">Web Crypto API </a>represents the object that should be passed as the <code>algorithm</code> parameter into {{domxref("SubtleCrypto.sign()")}} or {{domxref("SubtleCrypto.verify()")}} when using the <a href="/en-US/docs/Web/API/SubtleCrypto/sign#ecdsa">ECDSA</a> algorithm.</p>

<h2 id="Properties">Properties</h2>

Expand All @@ -20,13 +20,13 @@ <h2 id="Properties">Properties</h2>
<dt><code>hash</code></dt>
<dd>A {{domxref("DOMString")}}. An identifier for the <a href="/en-US/docs/Web/API/SubtleCrypto/digest">digest algorithm</a> to use. This should be one of the following:
<ul>
<li><code>SHA-256</code>: selects the <a href="/en-US/docs/Web/API/SubtleCrypto/digest#SHA-256">SHA-256</a> algorithm.</li>
<li><code>SHA-384</code>: selects the <a href="/en-US/docs/Web/API/SubtleCrypto/digest#SHA-384">SHA-384</a> algorithm.</li>
<li><code>SHA-512</code>: selects the <a href="/en-US/docs/Web/API/SubtleCrypto/digest#SHA-512">SHA-512</a> algorithm.</li>
<li><code>SHA-256</code>: selects the <a href="/en-US/docs/Web/API/SubtleCrypto/digest#sha-256">SHA-256</a> algorithm.</li>
<li><code>SHA-384</code>: selects the <a href="/en-US/docs/Web/API/SubtleCrypto/digest#sha-384">SHA-384</a> algorithm.</li>
<li><code>SHA-512</code>: selects the <a href="/en-US/docs/Web/API/SubtleCrypto/digest#sha-512">SHA-512</a> algorithm.</li>
</ul>

<div class="notecard warning">
<p><strong>Warning</strong>: <code>SHA-1</code> is also supported here but the <a href="/en-US/docs/Web/API/SubtleCrypto/digest#SHA-1">SHA-1</a> algorithm is considered vulnerable and should no longer be used.</p>
<p><strong>Warning</strong>: <code>SHA-1</code> is also supported here but the <a href="/en-US/docs/Web/API/SubtleCrypto/digest#sha-1">SHA-1</a> algorithm is considered vulnerable and should no longer be used.</p>
</div>
</dd>
</dl>
Expand Down
2 changes: 1 addition & 1 deletion files/en-us/web/api/eckeygenparams/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
---
<div>{{ APIRef("Web Crypto API") }}</div>

<p>The <strong><code>EcKeyGenParams</code></strong> dictionary of the <a href="/en-US/docs/Web/API/Web_Crypto_API">Web Crypto API </a>represents the object that should be passed as the <code>algorithm</code> parameter into {{domxref("SubtleCrypto.generateKey()")}}, when generating any elliptic-curve-based key pair: that is, when the algorithm is identified as either of <a href="/en-US/docs/Web/API/SubtleCrypto/sign#ECDSA">ECDSA</a> or <a href="/en-US/docs/Web/API/SubtleCrypto/deriveKey#ECDH">ECDH</a>.</p>
<p>The <strong><code>EcKeyGenParams</code></strong> dictionary of the <a href="/en-US/docs/Web/API/Web_Crypto_API">Web Crypto API </a>represents the object that should be passed as the <code>algorithm</code> parameter into {{domxref("SubtleCrypto.generateKey()")}}, when generating any elliptic-curve-based key pair: that is, when the algorithm is identified as either of <a href="/en-US/docs/Web/API/SubtleCrypto/sign#ecdsa">ECDSA</a> or <a href="/en-US/docs/Web/API/SubtleCrypto/deriveKey#ecdh">ECDH</a>.</p>

<h2 id="Properties">Properties</h2>

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/web/api/eckeyimportparams/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
- Reference
- Web Crypto API
---
<p>{{ APIRef("Web Crypto API") }}The <strong><code>EcKeyImportParams</code></strong> dictionary of the <a href="/en-US/docs/Web/API/Web_Crypto_API">Web Crypto API </a>represents the object that should be passed as the <code>algorithm</code> parameter into {{domxref("SubtleCrypto.importKey()")}} or {{domxref("SubtleCrypto.unwrapKey()")}}, when generating any elliptic-curve-based key pair: that is, when the algorithm is identified as either of <a href="/en-US/docs/Web/API/SubtleCrypto/sign#ECDSA">ECDSA</a> or <a href="/en-US/docs/Web/API/SubtleCrypto/deriveKey#ECDH">ECDH</a>.</p>
<p>{{ APIRef("Web Crypto API") }}The <strong><code>EcKeyImportParams</code></strong> dictionary of the <a href="/en-US/docs/Web/API/Web_Crypto_API">Web Crypto API </a>represents the object that should be passed as the <code>algorithm</code> parameter into {{domxref("SubtleCrypto.importKey()")}} or {{domxref("SubtleCrypto.unwrapKey()")}}, when generating any elliptic-curve-based key pair: that is, when the algorithm is identified as either of <a href="/en-US/docs/Web/API/SubtleCrypto/sign#ecdsa">ECDSA</a> or <a href="/en-US/docs/Web/API/SubtleCrypto/deriveKey#ecdh">ECDH</a>.</p>

<h2 id="Properties">Properties</h2>

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/web/api/element/blur_event/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
---
<div>{{APIRef}}</div>

<p>The <strong><code>blur</code></strong> event fires when an element has lost focus. The main difference between this event and {{domxref("Element/focusout_event", "focusout")}} is that <code>focusout</code> <a href="/en-US/docs/Learn/JavaScript/Building_blocks/Events#Event_bubbling_and_capture">bubbles</a> while <code>blur</code> does not.</p>
<p>The <strong><code>blur</code></strong> event fires when an element has lost focus. The main difference between this event and {{domxref("Element/focusout_event", "focusout")}} is that <code>focusout</code> <a href="/en-US/docs/Learn/JavaScript/Building_blocks/Events#event_bubbling_and_capture">bubbles</a> while <code>blur</code> does not.</p>

<p>The opposite of <code>blur</code> is {{domxref("Element/focus_event", "focus")}}.</p>

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/web/api/element/click_event/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@

<h2 id="Usage_notes">Usage notes</h2>

<p>The {{domxref("MouseEvent")}} object passed into the event handler for <code>click</code> has its {{domxref("Event.detail", "detail")}} property set to the number of times the {{domxref("Event.target", "target")}} was clicked. In other words, <code>detail</code> will be 2 for a double-click, 3 for triple-click, and so forth. This counter resets after a short interval without any clicks occurring; the specifics of how long that interval is may vary from browser to browser and across platforms. The interval is also likely to be affected by user preferences; for example, accessibility options may extend this interval to make it easier to perform multiple clicks with adaptive interfaces.</p>
<p>The {{domxref("MouseEvent")}} object passed into the event handler for <code>click</code> has its {{domxref("UIEvent/detail", "detail")}} property set to the number of times the {{domxref("Event.target", "target")}} was clicked. In other words, <code>detail</code> will be 2 for a double-click, 3 for triple-click, and so forth. This counter resets after a short interval without any clicks occurring; the specifics of how long that interval is may vary from browser to browser and across platforms. The interval is also likely to be affected by user preferences; for example, accessibility options may extend this interval to make it easier to perform multiple clicks with adaptive interfaces.</p>

<h3 id="Internet_Explorer">Internet Explorer</h3>

Expand Down
16 changes: 8 additions & 8 deletions files/en-us/web/api/element/closest/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,13 @@
title: Element.closest()
slug: Web/API/Element/closest
tags:
- API
- CSS Selector
- DOM
- Element
- Method
- Reference
- Selector
- API
- CSS Selector
- DOM
- Element
- Method
- Reference
- Selector
---
<div>{{APIRef('DOM')}}</div>

Expand Down Expand Up @@ -154,7 +154,7 @@ <h2 id="See_also">See also</h2>
<ul>
<li>The {{domxref("Element")}} interface.</li>
<li>
<a href="/en-US/docs/Web/Guide/CSS/Getting_started/Selectors">The syntax of
<a href="/en-US/docs/Learn/CSS/Building_blocks/Selectors">The syntax of
Selectors</a>
</li>
<li>
Expand Down
20 changes: 10 additions & 10 deletions files/en-us/web/api/element/computedstylemap/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,15 @@
title: Element.computedStyleMap()
slug: Web/API/Element/computedStyleMap
tags:
- API
- CSS Typed Object Model API
- Element
- Experimental
- Houdini
- Method
- Reference
- StylePropertyMapReadOnly
- computedStyleMap()
- API
- CSS Typed Object Model API
- Element
- Experimental
- Houdini
- Method
- Reference
- StylePropertyMapReadOnly
- computedStyleMap()
---
<p>{{APIRef("CSS Typed Object Model API")}}{{SeeCompatTable}}</p>

Expand Down Expand Up @@ -75,7 +75,7 @@ <h2 id="Examples">Examples</h2>
}</pre>

<p>In <a
href="/en-US/docs/Web/API/Element/computedStyleMap#Browser_compatibility">browsers
href="/en-US/docs/Web/API/Element/computedStyleMap#browser_compatibility">browsers
that support <code>computedStyleMap()</code></a>, you'll see a list of all the CSS
properties and values. In other browsers you'll just see a link.</p>

Expand Down
16 changes: 8 additions & 8 deletions files/en-us/web/api/element/createshadowroot/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -2,18 +2,18 @@
title: Element.createShadowRoot()
slug: Web/API/Element/createShadowRoot
tags:
- API
- Deprecated
- Element
- Method
- Non-standard
- Reference
- shadow dom
- API
- Deprecated
- Element
- Method
- Non-standard
- Reference
- shadow dom
---
<p>{{APIRef('Shadow DOM')}}{{non-standard_header}}{{deprecated_header}}{{draft}}</p>

<p>Use <code>Element.createShadowRoot</code> to create an instance of <a
href="/en-US/docs/Web/Web_Components/Shadow_DOM">shadow DOM</a>. When shadow DOM is
href="/en-US/docs/Web/Web_Components/Using_shadow_DOM">shadow DOM</a>. When shadow DOM is
created, it is always attached to an existing element. After the shadow DOM is created,
the element that it is attached to is called the {{glossary("shadow root")}}.</p>

Expand Down
4 changes: 2 additions & 2 deletions files/en-us/web/api/element/dblclick_event/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -115,6 +115,6 @@ <h2 id="See_also">See also</h2>
<li>{{domxref("Element/contextmenu_event", "contextmenu")}}</li>
<li>{{domxref("Element/mousedown_event", "mousedown")}}</li>
<li>{{domxref("Element/mouseup_event", "mouseup")}}</li>
<li>{{domxref("Element/pointerdown_event", "pointerdown")}}</li>
<li>{{domxref("Element/pointerup_event", "pointerup")}}</li>
<li>{{domxref("HTMLElement/pointerdown_event", "pointerdown")}}</li>
<li>{{domxref("HTMLElement/pointerup_event", "pointerup")}}</li>
</ul>
2 changes: 1 addition & 1 deletion files/en-us/web/api/element/focusout_event/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
---
<div>{{APIRef}}</div>

<p>The <strong><code>focusout</code></strong> event fires when an element is about to lose focus. The main difference between this event and {{domxref("Element/blur_event", "blur")}} is that <code>focusout</code> <a href="/en-US/docs/Learn/JavaScript/Building_blocks/Events#Event_bubbling_and_capture">bubbles</a> while <code>blur</code> does not.</p>
<p>The <strong><code>focusout</code></strong> event fires when an element is about to lose focus. The main difference between this event and {{domxref("Element/blur_event", "blur")}} is that <code>focusout</code> <a href="/en-US/docs/Learn/JavaScript/Building_blocks/Events#event_bubbling_and_capture">bubbles</a> while <code>blur</code> does not.</p>

<p>The opposite of <code>focusout</code> is {{domxref("Element/focusin_event", "focusin")}}.</p>

Expand Down
12 changes: 6 additions & 6 deletions files/en-us/web/api/element/getattribute/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -2,19 +2,19 @@
title: Element.getAttribute()
slug: Web/API/Element/getAttribute
tags:
- API
- DOM
- Element
- Method
- Reference
- API
- DOM
- Element
- Method
- Reference
---
<div>{{APIRef("DOM")}}</div>

<p><span class="seoSummary">The <strong><code>getAttribute()</code></strong> method of the
{{domxref("Element")}} interface returns the value of a specified attribute on the
element.</span> If the given attribute does not exist, the value returned will
either be <code>null</code> or <code>""</code> (the empty string); see <a
href="#Non-existing_attributes">Non-existing attributes</a> for details.</p>
href="#non-existing_attributes">Non-existing attributes</a> for details.</p>

<h2 id="Syntax">Syntax</h2>

Expand Down
4 changes: 2 additions & 2 deletions files/en-us/web/api/element/getattributenode/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -34,9 +34,9 @@ <h2 id="Notes">Notes</h2>

<p>When called on an HTML element in a DOM flagged as an HTML document, <code>getAttributeNode</code> lower-cases its argument before proceeding.</p>

<p>The <code>Attr</code> node inherits from <code>Node</code>, but is not considered a part of the document tree. Common <code>Node</code> attributes like <a href="/en-US/docs/DOM/Node.parentNode">parentNode</a>, <a href="/en-US/docs/DOM/Node.previousSibling">previousSibling</a>, and <a href="/en-US/docs/DOM/Node.nextSibling">nextSibling</a> are <code>null</code> for an <code>Attr</code> node. You can, however, get the element to which the attribute belongs with the <code>ownerElement</code> property.</p>
<p>The <code>Attr</code> node inherits from <code>Node</code>, but is not considered a part of the document tree. Common <code>Node</code> attributes like <a href="/en-US/docs/Web/API/Node/parentNode">parentNode</a>, <a href="/en-US/docs/Web/API/Node/previousSibling">previousSibling</a>, and <a href="/en-US/docs/Web/API/Node/nextSibling">nextSibling</a> are <code>null</code> for an <code>Attr</code> node. You can, however, get the element to which the attribute belongs with the <code>ownerElement</code> property.</p>

<p><a href="/en-US/docs/DOM/element.getAttribute">getAttribute</a> is usually used instead of <code>getAttributeNode</code> to get the value of an element's attribute.</p>
<p><a href="/en-US/docs/Web/API/Element/getAttribute">getAttribute</a> is usually used instead of <code>getAttributeNode</code> to get the value of an element's attribute.</p>

<p>{{ DOMAttributeMethods() }}</p>

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/web/api/element/getattributenodens/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ <h2 id="Syntax">Syntax</h2>

<h2 id="Notes">Notes</h2>

<p><code>getAttributeNodeNS</code> is more specific than <a href="getAttributeNode">getAttributeNode</a> in that it allows you to specify attributes that are part of a particular namespace. The corresponding setter method is <a href="/en-US/docs/DOM/element.setAttributeNodeNS">setAttributeNodeNS</a>.</p>
<p><code>getAttributeNodeNS</code> is more specific than <a href="getAttributeNode">getAttributeNode</a> in that it allows you to specify attributes that are part of a particular namespace. The corresponding setter method is <a href="/en-US/docs/Web/API/Element/setAttributeNodeNS">setAttributeNodeNS</a>.</p>

<p>{{ DOMAttributeMethods() }}</p>

Expand Down
12 changes: 6 additions & 6 deletions files/en-us/web/api/element/getattributens/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -2,11 +2,11 @@
title: Element.getAttributeNS()
slug: Web/API/Element/getAttributeNS
tags:
- API
- DOM
- Element
- Method
- Reference
- API
- DOM
- Element
- Method
- Reference
---
<div>{{APIRef("DOM")}}</div>

Expand Down Expand Up @@ -141,6 +141,6 @@ <h2 id="Browser_compatibility">Browser compatibility</h2>
<h2 id="See_also">See also</h2>

<ul>
<li><a href="/en-US/Add-ons/Code_snippets/getAttributeNS">Code
<li><a href="/en-US/docs/Mozilla/Add-ons/Code_snippets/getAttributeNS">Code
snippets:getAttributeNS</a></li>
</ul>
14 changes: 7 additions & 7 deletions files/en-us/web/api/element/getelementsbytagname/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -2,18 +2,18 @@
title: Element.getElementsByTagName()
slug: Web/API/Element/getElementsByTagName
tags:
- API
- DOM
- Element
- Method
- Reference
- API
- DOM
- Element
- Method
- Reference
---
<div>{{ APIRef("DOM") }}</div>

<p><span class="seoSummary">The
<code><strong>Element.getElementsByTagName()</strong></code> method returns a live
{{domxref("HTMLCollection")}} of elements with the given <a
href="/en-US/docs/DOM/element.tagName">tag name</a>.</span> All descendants of the
href="/en-US/docs/Web/API/Element/tagName">tag name</a>.</span> All descendants of the
specified element are searched, but not the element itself. The returned list is
<em>live</em>, which means it updates itself with the DOM tree automatically.
Therefore, there is no need to call <code>Element.getElementsByTagName()</code> with
Expand All @@ -33,7 +33,7 @@
<h2 id="Syntax">Syntax</h2>

<pre
class="brush: js"><code><em>elements</em> = <em>element</em>.getElementsByTagName(<em>tagName</em>)</code></pre>
class="brush: js">elements = element.getElementsByTagName(tagName)</pre>

<ul>
<li><code>elements</code> is a <em>live</em> {{domxref("HTMLCollection")}} of elements
Expand Down
6 changes: 3 additions & 3 deletions files/en-us/web/api/element/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ <h2 id="Properties">Properties</h2>
<dt>{{DOMxRef("Element.namespaceURI")}} {{readonlyInline}}</dt>
<dd>The namespace URI of the element, or <code>null</code> if it is no namespace.
<div class="note">
<p><strong>Note:</strong> In Firefox 3.5 and earlier, HTML elements are in no namespace. In later versions, HTML elements are in the <code><a class="linkification-ext external" href="https://www.w3.org/1999/xhtml" title="Linkification: http://www.w3.org/1999/xhtml">http://www.w3.org/1999/xhtml</a></code> namespace in both HTML and XML trees. {{ gecko_minversion_inline("1.9.2")}}</p>
<p><strong>Note:</strong> In Firefox 3.5 and earlier, HTML elements are in no namespace. In later versions, HTML elements are in the <code><a class="linkification-ext external" href="https://www.w3.org/1999/xhtml" title="Linkification: http://www.w3.org/1999/xhtml">http://www.w3.org/1999/xhtml</a></code> namespace in both HTML and XML trees. </p>
</div>
</dd>
<dt>{{DOMxRef("Element.nextElementSibling")}} {{readOnlyInline}}</dt>
Expand Down Expand Up @@ -209,7 +209,7 @@ <h2 id="Methods">Methods</h2>
<dt>{{DOMxRef("Element.closest()")}}</dt>
<dd>Returns the {{DOMxRef("Element")}} which is the closest ancestor of the current element (or the current element itself) which matches the selectors given in parameter.</dd>
<dt>{{DOMxRef("Element.createShadowRoot()")}} {{Non-standard_Inline}} {{Deprecated_Inline}}</dt>
<dd>Creates a <a href="/en-US/docs/Web/Web_Components/Shadow_DOM">shadow DOM</a> on the element, turning it into a shadow host. Returns a {{DOMxRef("ShadowRoot")}}.</dd>
<dd>Creates a <a href="/en-US/docs/Web/Web_Components/Using_shadow_DOM">shadow DOM</a> on the element, turning it into a shadow host. Returns a {{DOMxRef("ShadowRoot")}}.</dd>
<dt>{{DOMxRef("Element.computedStyleMap()")}} {{Experimental_Inline}}</dt>
<dd>Returns a {{DOMxRef("StylePropertyMapReadOnly")}} interface which provides a read-only representation of a CSS declaration block that is an alternative to {{DOMxRef("CSSStyleDeclaration")}}.</dd>
<dt>{{DOMxRef("EventTarget.dispatchEvent()")}}</dt>
Expand Down Expand Up @@ -308,7 +308,7 @@ <h2 id="Events">Events</h2>
<p>Listen to these events using <code>addEventListener()</code> or by assigning an event listener to the <code>on<em>eventname</em></code> property of this interface.</p>

<dl>
<dt>{{domxref("Element/cancel_event", "cancel")}}</dt>
<dt>{{domxref("HTMLDialogElement/cancel_event", "cancel")}}</dt>
<dd>Fires on a {{HTMLElement("dialog")}} when the user instructs the browser that they wish to dismiss the current open dialog. For example, the browser might fire this event when the user presses the <kbd>Esc</kbd> key or clicks a "Close dialog" button which is part of the browser's UI.<br>
Also available via the {{domxref("GlobalEventHandlers/oncancel", "oncancel")}} property.</dd>
<dt>{{domxref("Element/error_event", "error")}}</dt>
Expand Down
Loading

0 comments on commit 86de129

Please sign in to comment.