diff --git a/files/en-us/web/html/applying_color/index.html b/files/en-us/web/html/applying_color/index.html index e0c2e9603606693..b346ef19113be1f 100644 --- a/files/en-us/web/html/applying_color/index.html +++ b/files/en-us/web/html/applying_color/index.html @@ -312,7 +312,7 @@

CSS

}
-

When you try to show it in Safari, it will not show properly. Because Safari doesn't support text-decoration: underline wavy #88ff88.

+

Note: When you try to show it in Safari, it will not show properly. Because Safari doesn't support text-decoration: underline wavy #88ff88.

Finally, the .boxRight class describes the unique properties of the box that's drawn on the right. It's configured to float the box to the right so that it appears next to the previous box. Then the following colors are established:

@@ -338,7 +338,7 @@

Example: Picking a color

{{EmbedLiveSample("Example_Picking_a_color", 525, 275)}}

-

On macOS, you indicate that you've finalized selection of the color by closing the color picker window.

+

Note: On macOS, you indicate that you've finalized selection of the color by closing the color picker window.

HTML

@@ -406,7 +406,7 @@

Base color

When trying to decide upon a base color, you may find that browser extensions that let you select colors from web content can be particularly handy. Some of these are even specifically designed to help with this sort of work. For example, the website ColorZilla offers an extension (Chrome / Firefox) that offers an eyedropper tool for picking colors from the web. It can also take averages of the colors of pixels in various sized areas or even a selected area of the page.

-

The advantage to averaging colors can be that often what looks like a solid color is actually a surprisingly varied number of related colors all used in concert, blending to create a desired effect. Picking just one of these pixels can result in getting a color that on its own looks very out of place.

+

Note: The advantage to averaging colors can be that often what looks like a solid color is actually a surprisingly varied number of related colors all used in concert, blending to create a desired effect. Picking just one of these pixels can result in getting a color that on its own looks very out of place.

Fleshing out the palette

@@ -424,7 +424,7 @@

Fleshing out the palette

When designing your palette, be sure to keep in mind that in addition to the colors these tools typically generate, you'll probably also need to add some core neutral colors such as white (or nearly white), black (or nearly black), and some number of shades of gray.

-

Usually, you are far better off using the smallest number of colors possible. By using color to accentuate rather than adding color to everything on the page, you keep your content easy to read and the colors you do use have far more impact.

+

Note: Usually, you are far better off using the smallest number of colors possible. By using color to accentuate rather than adding color to everything on the page, you keep your content easy to read and the colors you do use have far more impact.

Color theory resources

@@ -445,7 +445,7 @@

Color and accessibility

You should do at least basic research into {{interwiki("wikipedia", "color blindness")}}. There are several kinds; the most common is red-green color blindness, which causes people to be unable to differentiate between the colors red and green. There are others, too, ranging from inabilities to tell the difference between certain colors to total inability to see color at all.

-

The most important rule: never use color as the only way to know something. If, for example, you indicate success or failure of an operation by changing the color of a shape from white to green for success and red for failure, users with red-green color-blindness won't be able to use your site properly. Instead, perhaps use both text and color together, so that everyone can understand what's happening.

+

Note: The most important rule: never use color as the only way to know something. If, for example, you indicate success or failure of an operation by changing the color of a shape from white to green for success and red for failure, users with red-green color-blindness won't be able to use your site properly. Instead, perhaps use both text and color together, so that everyone can understand what's happening.

For more information about color blindness, see the following articles:

diff --git a/files/en-us/web/html/attributes/autocomplete/index.html b/files/en-us/web/html/attributes/autocomplete/index.html index 5f40ad42ef03990..da6edabce7a13fd 100644 --- a/files/en-us/web/html/attributes/autocomplete/index.html +++ b/files/en-us/web/html/attributes/autocomplete/index.html @@ -31,7 +31,7 @@

For more information, see the {{htmlattrxref("autocomplete", "form")}} attribute in {{HTMLElement("form")}}.

-

In order to provide autocompletion, user-agents might require <input>/<select>/<textarea> elements to:

+

Note: In order to provide autocompletion, user-agents might require <input>/<select>/<textarea> elements to:

  1. Have a name and/or id attribute
  2. diff --git a/files/en-us/web/html/attributes/crossorigin/index.html b/files/en-us/web/html/attributes/crossorigin/index.html index 4540e713fdb78e6..2d575581ae784d2 100644 --- a/files/en-us/web/html/attributes/crossorigin/index.html +++ b/files/en-us/web/html/attributes/crossorigin/index.html @@ -44,7 +44,7 @@

    An invalid keyword and an empty string will be handled as the anonymous keyword.

    -

    Prior to Firefox 83 the crossorigin attribute was not supported for rel="icon" there is also an open issue for Chrome.

    +

    Note: Prior to Firefox 83 the crossorigin attribute was not supported for rel="icon" there is also an open issue for Chrome.

    Example: crossorigin with the script element

    diff --git a/files/en-us/web/html/attributes/rel/index.html b/files/en-us/web/html/attributes/rel/index.html index 76cee2a34391dac..a6c1cdb59f69481 100644 --- a/files/en-us/web/html/attributes/rel/index.html +++ b/files/en-us/web/html/attributes/rel/index.html @@ -248,7 +248,7 @@

    Values

    Relevant to {{htmlelement('form')}}, {{htmlelement('link')}}, {{htmlelement('a')}}, and {{htmlelement('area')}}, the help keyword indicates that the linked to content provides context-sensitive help, providing information for the parent of the element defining the hyperlink, and its children. When used within <link>, the help is for the whole document. When included with {{htmlelement('a')}} and {{htmlelement('area')}} and supported, the default {{cssxref('cursor')}} will be help instead of pointer.
    {{htmlattrdef("icon")}}
    -

    Valid with {{htmlelement('link')}}, the linked resource represents the icon, a resource for representing the page in the user interface, for the current document.

    +

    Note: Valid with {{htmlelement('link')}}, the linked resource represents the icon, a resource for representing the page in the user interface, for the current document.

    The most common use for the icon value is the favicon:

    @@ -257,7 +257,7 @@

    Values

    If there are multiple <link rel="icon">s, the browser uses their media attribute, type, and sizes attributes to select the most appropriate icon. If several icons are equally appropriate, the last one is used. If the most appropriate icon is later found to be inappropriate, for example because it uses an unsupported format, the browser proceeds to the next-most appropriate, and so on.

    -

    Prior to Firefox 83 the crossorigin attribute was not supported for rel="icon" there is also an open issue for Chrome.

    +

    Note: Prior to Firefox 83 the crossorigin attribute was not supported for rel="icon" there is also an open issue for Chrome.

    Note: Apple's iOS does not use this link type, nor the sizes attribute, like others mobile browsers do, to select a webpage icon for Web Clip or a start-up placeholder. Instead it uses the non-standard apple-touch-icon and apple-touch-startup-image respectively.

    @@ -266,7 +266,7 @@

    Values

    {{htmlattrdef("license")}}
    -

    Valid on the {{HTMLElement("a")}}, {{HTMLElement("area")}}, {{HTMLElement("form")}}, {{HTMLElement("link")}} elements, the license value indicates that the hyperlink leads to a document describing the licensing information; that the main content of the current document is covered by the copyright license described by the referenced document. If not inside the {{HTMLElement("head")}} element, the standard doesn't distinguish between a hyperlink applying to a specific part of the document or to the document as a whole. Only the data on the page can indicate this.

    +

    Note: Valid on the {{HTMLElement("a")}}, {{HTMLElement("area")}}, {{HTMLElement("form")}}, {{HTMLElement("link")}} elements, the license value indicates that the hyperlink leads to a document describing the licensing information; that the main content of the current document is covered by the copyright license described by the referenced document. If not inside the {{HTMLElement("head")}} element, the standard doesn't distinguish between a hyperlink applying to a specific part of the document or to the document as a whole. Only the data on the page can indicate this.

    <link rel="license" href="#license">
    diff --git a/files/en-us/web/html/block-level_elements/index.html b/files/en-us/web/html/block-level_elements/index.html index 2dcaa6814bbbb89..a4e45426fc03c78 100644 --- a/files/en-us/web/html/block-level_elements/index.html +++ b/files/en-us/web/html/block-level_elements/index.html @@ -16,7 +16,7 @@

    Browsers typically display the block-level element with a newline both before and after the element. You can visualize them as a stack of boxes.

    -

    A block-level element always starts on a new line and takes up the full width available (stretches out to the left and right as far as it can).

    +

    Note: A block-level element always starts on a new line and takes up the full width available (stretches out to the left and right as far as it can).

    The following example demonstrates the block-level element's influence:

    diff --git a/files/en-us/web/html/element/dfn/index.html b/files/en-us/web/html/element/dfn/index.html index dd6948f96c56d7e..50d5062293fb7ce 100644 --- a/files/en-us/web/html/element/dfn/index.html +++ b/files/en-us/web/html/element/dfn/index.html @@ -73,7 +73,7 @@

    Specifying the term being defined

    -

    If the <dfn> element has a title attribute, it must contain the term being defined and no other text.

    +

    Note: If the <dfn> element has a title attribute, it must contain the term being defined and no other text.

    Links to <dfn> elements

    diff --git a/files/en-us/web/html/element/heading_elements/index.html b/files/en-us/web/html/element/heading_elements/index.html index 937e6a5d0a08da0..81ef698f95b4a9c 100644 --- a/files/en-us/web/html/element/heading_elements/index.html +++ b/files/en-us/web/html/element/heading_elements/index.html @@ -53,7 +53,7 @@

    Attributes

    These elements only include the global attributes.

    -

    The align attribute is obsolete; don't use it.

    +

    Note: The align attribute is obsolete; don't use it.

    Usage notes

    diff --git a/files/en-us/web/html/element/hgroup/index.html b/files/en-us/web/html/element/hgroup/index.html index 2bb9c941bafb782..eacb4c82bd5eeb6 100644 --- a/files/en-us/web/html/element/hgroup/index.html +++ b/files/en-us/web/html/element/hgroup/index.html @@ -14,8 +14,7 @@
    {{HTMLRef}}
    -

    Warning

    -

    <hgroup> should not be used because no assistive technology supports it, and as a result it has a detrimental effect on assistance for headings placed within it.

    +

    Warning: <hgroup> should not be used because no assistive technology supports it, and as a result it has a detrimental effect on assistance for headings placed within it.

    For more information see the Usage notes below.

    @@ -63,7 +62,7 @@

    Attributes

    Usage notes

    -

    The <hgroup> element has been removed from the HTML5 (W3C) specification, but it still is in the WHATWG version of HTML. It is partially implemented in most browsers, though, so is unlikely to go away.
    +

    Note: The <hgroup> element has been removed from the HTML5 (W3C) specification, but it still is in the WHATWG version of HTML. It is partially implemented in most browsers, though, so is unlikely to go away.
    However, given that a key purpose of the <hgroup> element is to affect how headings are displayed by the outline algorithm defined in the HTML specification—but the HTML outline algorithm is not implemented in any browsers—then the <hgroup> semantics are in practice only theoretical.
    So the HTML5 (W3C) specification provides advice on how to mark up Subheadings, subtitles, alternative titles and taglines without using <hgroup>.

    diff --git a/files/en-us/web/html/element/input/date/index.html b/files/en-us/web/html/element/input/date/index.html index 32b950760a952d7..29270389581b8cc 100644 --- a/files/en-us/web/html/element/input/date/index.html +++ b/files/en-us/web/html/element/input/date/index.html @@ -60,7 +60,7 @@

    Value

    {{EmbedLiveSample('Value', 600, 40)}}

    -

    Note: The displayed date format will differ from the actual value. The displayed date is formatted based on the locale of the user's browser, but the parsed value is always formatted yyyy-mm-dd.

    +

    Note: The displayed date format will differ from the actual value — the displayed date is formatted based on the locale of the user's browser, but the parsed value is always formatted yyyy-mm-dd.

    You can get and set the date value in JavaScript with the {{domxref("HTMLInputElement")}} value and valueAsNumber properties. For example:

    @@ -101,7 +101,7 @@

    step

    For date inputs, the value of step is given in days; and is treated as a number of milliseconds equal to 86,400,000 times the step value (the underlying numeric value is in milliseconds). The default value of step is 1, indicating 1 day.

    -

    Specifying any as the value for step has the same effect as 1 for date inputs.

    +

    Note: Specifying any as the value for step has the same effect as 1 for date inputs.

    Using date inputs

    @@ -111,7 +111,7 @@

    Using date inputs

    In this section, we'll look at basic and then more complex uses of <input type="date">, and offer advice on mitigating the browser support issue later (see {{anch("Handling browser support")}}).

    -

    Hopefully, over time browser support will become ubiquitous, and this problem will fade away.

    +

    Note: Hopefully, over time browser support will become ubiquitous, and this problem will fade away.

    Basic uses of date

    diff --git a/files/en-us/web/html/element/input/datetime/index.html b/files/en-us/web/html/element/input/datetime/index.html index 62902531cd9295c..1e886fb38c0d781 100644 --- a/files/en-us/web/html/element/input/datetime/index.html +++ b/files/en-us/web/html/element/input/datetime/index.html @@ -23,7 +23,7 @@

    Browser compatibility

    -

    This feature has no current browser implementations.

    +

    Note: This feature has no current browser implementations.

    See also

    diff --git a/files/en-us/web/html/element/input/index.html b/files/en-us/web/html/element/input/index.html index c19ee0e7ff1707b..312e84c5a7fccd3 100644 --- a/files/en-us/web/html/element/input/index.html +++ b/files/en-us/web/html/element/input/index.html @@ -1001,7 +1001,7 @@

    Placeholders are not accessible

    Not only is the placeholder not accessible to screen readers, but once the user enters any text into the form control, or if the form control already has a value, the placeholder disappears. Browsers with automatic page translation features may skip over attributes when translating, meaning the placeholder may not get translated.

    -

    Don't use the {{htmlattrxref("placeholder", "input", "", 1)}} attribute if you can avoid it. If you need to label an <input> element, use the {{HTMLElement("label")}} element.

    +

    Note: Don't use the {{htmlattrxref("placeholder", "input", "", 1)}} attribute if you can avoid it. If you need to label an <input> element, use the {{HTMLElement("label")}} element.

    Client-side validation

    diff --git a/files/en-us/web/html/element/input/reset/index.html b/files/en-us/web/html/element/input/reset/index.html index d488a91ffb3b058..919c62b0c7e1038 100644 --- a/files/en-us/web/html/element/input/reset/index.html +++ b/files/en-us/web/html/element/input/reset/index.html @@ -22,7 +22,7 @@
    {{EmbedInteractiveExample("pages/tabbed/input-reset.html", "tabbed-standard")}}
    -

    You should usually avoid including reset buttons in your forms. They're rarely useful, and are instead more likely to frustrate users who click them by mistake (often while trying to click the submit button).

    +

    Note: You should usually avoid including reset buttons in your forms. They're rarely useful, and are instead more likely to frustrate users who click them by mistake (often while trying to click the submit button).

    diff --git a/files/en-us/web/html/element/input/search/index.html b/files/en-us/web/html/element/input/search/index.html index 0374becc40751bc..f1181ce1c896869 100644 --- a/files/en-us/web/html/element/input/search/index.html +++ b/files/en-us/web/html/element/input/search/index.html @@ -183,7 +183,7 @@

    Basic example

    q is the most common name given to search inputs, although it's not mandatory. When submitted, the data name/value pair sent to the server will be q=searchterm.

    -

    You must remember to set a {{htmlattrxref("name", "input")}} for your input, otherwise nothing will be submitted.

    +

    Note: You must remember to set a {{htmlattrxref("name", "input")}} for your input, otherwise nothing will be submitted.

    Differences between search and text types

    diff --git a/files/en-us/web/html/element/kbd/index.html b/files/en-us/web/html/element/kbd/index.html index 8446f4a5ccdf77f..7222ab11249de9a 100644 --- a/files/en-us/web/html/element/kbd/index.html +++ b/files/en-us/web/html/element/kbd/index.html @@ -73,7 +73,7 @@

    Usage notes

    -

    You can define a custom style to override the browser's default font selection for the <kbd> element, although the user's preferences may potentially override your CSS.

    +

    Note: You can define a custom style to override the browser's default font selection for the <kbd> element, although the user's preferences may potentially override your CSS.

    Examples

    @@ -104,7 +104,7 @@
    HTML

    Note: You don't need to do all this wrapping; you can choose to simplify it by leaving out the external <kbd> element. In other words, simplifying this to just <kbd>Ctrl</kbd>+<kbd>N</kbd> would be perfectly valid.

    -

    Depending on your style sheet, though, you may find it useful to do this kind of nesting.

    +

    Note: Depending on your style sheet, though, you may find it useful to do this kind of nesting.

    Result
    diff --git a/files/en-us/web/html/element/link/index.html b/files/en-us/web/html/element/link/index.html index f790edd537b3127..fa7a8b53379e91a 100644 --- a/files/en-us/web/html/element/link/index.html +++ b/files/en-us/web/html/element/link/index.html @@ -217,7 +217,7 @@

    Obsolete attributes

    Note: This attribute is considered obsolete by the WHATWG HTML living standard (which is the specification MDN treats as canonical). However, it's worth noting that rev is not considered obsolete in the W3C specification. That said, given the uncertainty, relying on rev is unwise.

    -

    Instead, you should use the {{HTMLAttrxRef("rel", "link")}} attribute with the opposite link type value. For example, to establish the reverse link for made, specify author. Also this attribute doesn't stand for "revision" and must not be used with a version number, even though many sites misuse it in this way.

    +

    Note: Instead, you should use the {{HTMLAttrxRef("rel", "link")}} attribute with the opposite link type value. For example, to establish the reverse link for made, specify author. Also this attribute doesn't stand for "revision" and must not be used with a version number, even though many sites misuse it in this way.

    diff --git a/files/en-us/web/html/element/mark/index.html b/files/en-us/web/html/element/mark/index.html index f80a6e56adedca5..9bdf60a23f95b62 100644 --- a/files/en-us/web/html/element/mark/index.html +++ b/files/en-us/web/html/element/mark/index.html @@ -68,7 +68,7 @@

    Usage notes

    -

    Don't confuse <mark> with the {{HTMLElement("strong")}} element; <mark> is used to denote content which has a degree of relevance, while <strong> indicates spans of text of importance.

    +

    Note: Don't confuse <mark> with the {{HTMLElement("strong")}} element; <mark> is used to denote content which has a degree of relevance, while <strong> indicates spans of text of importance.

    Examples

    diff --git a/files/en-us/web/html/element/noembed/index.html b/files/en-us/web/html/element/noembed/index.html index 5f5744991fa9320..a6b78a9ce185e77 100644 --- a/files/en-us/web/html/element/noembed/index.html +++ b/files/en-us/web/html/element/noembed/index.html @@ -17,7 +17,7 @@

    The <noembed> HTML element is an obsolete, non-standard way to provide alternative, or "fallback", content for browsers that do not support the {{HTMLElement("embed")}} element or do not support the type of embedded content an author wishes to use. This element was deprecated in HTML 4.01 and above in favor of placing fallback content between the opening and closing tags of an {{HTMLElement("object")}} element.

    -

    While this element currently still works in many browsers, it is obsolete and should not be used. Use {{HTMLElement("object")}} instead, with fallback content between the opening and closing tags of the element.

    +

    Note: While this element currently still works in many browsers, it is obsolete and should not be used. Use {{HTMLElement("object")}} instead, with fallback content between the opening and closing tags of the element.

    Examples

    diff --git a/files/en-us/web/html/element/noframes/index.html b/files/en-us/web/html/element/noframes/index.html index 107a837232459cf..c5334147a6f678a 100644 --- a/files/en-us/web/html/element/noframes/index.html +++ b/files/en-us/web/html/element/noframes/index.html @@ -21,7 +21,7 @@

    <noframes> can be used to present a message explaining that the user's browser doesn't support frames, but ideally should be used to present an alternate form of the site that doesn't use frames but still offers the same or similar functionality.

    -

    In HTML 5 and later, <noframes> is obsolete and shouldn't be used, since the {{HTMLElement("frame")}} and {{HTMLElement("frameset")}} elements are also obsolete. When frames are needed at all, they should be presented using the {{HTMLElement("iframe")}} element.

    +

    Note: This element is obsolete and shouldn't be used, since the {{HTMLElement("frame")}} and {{HTMLElement("frameset")}} elements are also obsolete. When frames are needed at all, they should be presented using the {{HTMLElement("iframe")}} element.

    Attributes

    diff --git a/files/en-us/web/html/element/samp/index.html b/files/en-us/web/html/element/samp/index.html index aadeae52f5f309e..c6d56107a9da43c 100644 --- a/files/en-us/web/html/element/samp/index.html +++ b/files/en-us/web/html/element/samp/index.html @@ -66,7 +66,7 @@

    Usage notes

    }
    -

    If you need an element which will serve as a container for output generated by your website or app's JavaScript code, you should instead use the {{HTMLElement("output")}} element.

    +

    Note: If you need an element which will serve as a container for output generated by your website or app's JavaScript code, you should instead use the {{HTMLElement("output")}} element.

    Examples

    diff --git a/files/en-us/web/html/element/select/index.html b/files/en-us/web/html/element/select/index.html index 1b7cf27d84b9884..3227d8c5fa44295 100644 --- a/files/en-us/web/html/element/select/index.html +++ b/files/en-us/web/html/element/select/index.html @@ -66,7 +66,7 @@

    Selecting multiple options

    Warning: The mechanism for selecting multiple non-contiguous items via the keyboard described below currently only seems to work in Firefox.

    -

    Also note: On macOS, the Ctrl + Up and Ctrl + Down shortcuts conflict with the OS default shortcuts for Mission Control and Application windows, so you'll have to turn these off before it will work.

    +

    On macOS, the Ctrl + Up and Ctrl + Down shortcuts conflict with the OS default shortcuts for Mission Control and Application windows, so you'll have to turn these off before it will work.

    Keyboard users can select multiple contiguous items by:

    @@ -159,7 +159,7 @@

    Customizing select styles

    -

    Not all native features are supported, it's a Proof of Concept. IT starts from standard HTML but the same results can be achieved starting from JSON data, custom HTML, or other solutions.

    +

    Note: Not all native features are supported, it's a Proof of Concept. IT starts from standard HTML but the same results can be achieved starting from JSON data, custom HTML, or other solutions.

    HTML

    diff --git a/files/en-us/web/html/element/style/index.html b/files/en-us/web/html/element/style/index.html index 38b2a81c84101a1..9791d62dafa625d 100644 --- a/files/en-us/web/html/element/style/index.html +++ b/files/en-us/web/html/element/style/index.html @@ -46,7 +46,7 @@

    Deprecated attributes

    This attribute specifies that the styles only apply to the elements of its parent(s) and children.

    -

    This attribute may be re-introduced in the future per https://github.com/w3c/csswg-drafts/issues/3547. If you want to use the attribute now, you can use a polyfill.

    +

    Note: This attribute may be re-introduced in the future per https://github.com/w3c/csswg-drafts/issues/3547. If you want to use the attribute now, you can use a polyfill.

    diff --git a/files/en-us/web/html/element/tr/index.html b/files/en-us/web/html/element/tr/index.html index 149ef8bb3f02f31..6700ba9daf7a4aa 100644 --- a/files/en-us/web/html/element/tr/index.html +++ b/files/en-us/web/html/element/tr/index.html @@ -50,7 +50,7 @@

    Deprecated attributes

    If no value is expressly set for align, the parent node's value is inherited.

    -

    Instead of using the obsolete align attribute, you should instead use the CSS {{CSSxRef("text-align")}} property to establish left, center, right, or justify alignment for the row's cells. To apply character-based alignment, set the CSS {{CSSxRef("text-align")}} property to the alignment character (such as "." or ",").

    +

    Note: Instead of using the obsolete align attribute, you should instead use the CSS {{CSSxRef("text-align")}} property to establish left, center, right, or justify alignment for the row's cells. To apply character-based alignment, set the CSS {{CSSxRef("text-align")}} property to the alignment character (such as "." or ",").

    {{HTMLAttrDef("bgcolor")}}{{deprecated_inline}}
    @@ -58,7 +58,7 @@

    Deprecated attributes

    A {{DOMxRef("DOMString")}} specifying a color to apply to the backgrounds of each of the row's cells. This can be either an hexadecimal #RRGGBB or #RGB value or a color keyword. Omitting the attribute or setting it to null in JavaScript causes the row's cells to inherit the row's parent element's background color.

    -

    The {{HTMLElement("tr")}} element should be styled using CSS. To give a similar effect as the bgcolor attribute, use the CSS property {{CSSxRef("background-color")}}.

    +

    Note: The {{HTMLElement("tr")}} element should be styled using CSS. To give a similar effect as the bgcolor attribute, use the CSS property {{CSSxRef("background-color")}}.

    {{HTMLAttrDef("char")}}{{deprecated_inline}}
    @@ -66,7 +66,7 @@

    Deprecated attributes

    A {{DOMxRef("DOMString")}} which sets the character to align the cells in each of the row's columns on (each row's centering that uses the same character gets aligned with others using the same character . Typical values for this include a period (".") or comma (",") when attempting to align numbers or monetary values. If {{htmlattrxref("align", "tr")}} is not set to char, this attribute is ignored.

    -

    This attribute is not only obsolete, but was rarely implemented anyway. To achieve the same effect as the {{htmlattrxref("char", "tr")}} attribute, set the CSS {{CSSxRef("text-align")}} property to the same string you would specify for the char property, such as text-align: ".".

    +

    Note: This attribute is not only obsolete, but was rarely implemented anyway. To achieve the same effect as the {{htmlattrxref("char", "tr")}} attribute, set the CSS {{CSSxRef("text-align")}} property to the same string you would specify for the char property, such as text-align: ".".

    {{HTMLAttrDef("charoff")}}{{deprecated_inline}}
    @@ -74,7 +74,7 @@

    Deprecated attributes

    A {{DOMxRef("DOMString")}} indicating the number of characters on the tail end of the column's data should be displayed after the alignment character specified by the char attribute. For example, when displaying money values for currencies that use hundredths of a unit (such as the dollar, which is divided into 100 cents), you would typically specify a value of 2, so that in tandem with char being set to ".", the values in a column would be cleanly aligned on the decimal points, with the number of cents properly displayed to the right of the decimal point.

    -

    This attribute is obsolete, and was never widely supported anyway.

    +

    Note: This attribute is obsolete, and was never widely supported anyway.

    {{HTMLAttrDef("valign")}}{{deprecated_inline}}
    @@ -93,7 +93,7 @@

    Deprecated attributes

    -

    Don't use the obsolete valign attribute. Instead, add the CSS {{CSSxRef("vertical-align")}} property to the row.

    +

    Note: Don't use the obsolete valign attribute. Instead, add the CSS {{CSSxRef("vertical-align")}} property to the row.

    diff --git a/files/en-us/web/html/global_attributes/dir/index.html b/files/en-us/web/html/global_attributes/dir/index.html index 879a4a08de0c0c1..27f759767312c72 100644 --- a/files/en-us/web/html/global_attributes/dir/index.html +++ b/files/en-us/web/html/global_attributes/dir/index.html @@ -23,7 +23,7 @@
    -

    Usage notes: This attribute is mandatory for the {{ HTMLElement("bdo") }} element where it has a different semantic meaning.

    +

    Note: This attribute is mandatory for the {{ HTMLElement("bdo") }} element where it has a different semantic meaning.

    • @@ -42,7 +42,7 @@
    -

    Browsers might allow users to change the directionality of {{ HTMLElement("input") }} and {{ HTMLElement("textarea") }}s in order to assist with authoring content. Chrome and Safari provide a directionality option in the contextual menu of input fields while Internet Explorer and Edge use the key combinations Ctrl + Left Shift and Ctrl + Right Shift. Firefox uses Ctrl/Cmd + Shift + X but does NOT update the dir attribute value.

    +

    Note: Browsers might allow users to change the directionality of {{ HTMLElement("input") }} and {{ HTMLElement("textarea") }}s in order to assist with authoring content. Chrome and Safari provide a directionality option in the contextual menu of input fields while Internet Explorer and Edge use the key combinations Ctrl + Left Shift and Ctrl + Right Shift. Firefox uses Ctrl/Cmd + Shift + X but does NOT update the dir attribute value.

    Specifications

    diff --git a/files/en-us/web/html/global_attributes/tabindex/index.html b/files/en-us/web/html/global_attributes/tabindex/index.html index 939c6ee6bbfcba8..92e33962775135f 100644 --- a/files/en-us/web/html/global_attributes/tabindex/index.html +++ b/files/en-us/web/html/global_attributes/tabindex/index.html @@ -19,7 +19,7 @@
  3. A negative value (usually tabindex="-1") means that the element is not reachable via sequential keyboard navigation, but could be focused with JavaScript or visually by clicking with the mouse. It's mostly useful to create accessible widgets with JavaScript.
    -

    A negative value is useful when you have off-screen content that appears on a specific event. The user won't be able to focus any element with a negative tabindex using the keyboard, but a script can do so by calling the focus() method.

    +

    Note: A negative value is useful when you have off-screen content that appears on a specific event. The user won't be able to focus any element with a negative tabindex using the keyboard, but a script can do so by calling the focus() method.

  4. tabindex="0" means that the element should be focusable in sequential keyboard navigation, after any positive tabindex values and its order is defined by the document's source order.
  5. diff --git a/files/en-us/web/html/global_attributes/x-ms-format-detection/index.html b/files/en-us/web/html/global_attributes/x-ms-format-detection/index.html index 7ffc91147f40a44..05bffc55c44615f 100644 --- a/files/en-us/web/html/global_attributes/x-ms-format-detection/index.html +++ b/files/en-us/web/html/global_attributes/x-ms-format-detection/index.html @@ -16,7 +16,7 @@

    Existing links, such as ones with the tel: scheme, are unaffected.

    -

    Links created through format detection do not appear in the DOM.

    +

    Note: Links created through format detection do not appear in the DOM.

    {{Non-standard_inline}} This proprietary property is specific to Internet Explorer and Microsoft Edge.

    diff --git a/files/en-us/web/html/inline_elements/index.html b/files/en-us/web/html/inline_elements/index.html index 474a94b9da8ed7f..d69339eedcc71a0 100644 --- a/files/en-us/web/html/inline_elements/index.html +++ b/files/en-us/web/html/inline_elements/index.html @@ -17,7 +17,7 @@

    Inline elements are those which only occupy the space bounded by the tags defining the element, instead of breaking the flow of the content.

    -

    An inline element does not start on a new line and only takes up as much width as necessary.

    +

    Note: An inline element does not start on a new line and only takes up as much width as necessary.

    Inline vs. block-level elements: a demonstration