recursal/MDN huggingface dataset:
<rp>: The Ruby Fallback Parenthesis element
===========================================

The **`<rp>`** HTML element is used to provide fall-back parentheses for browsers that do not support display of ruby annotations using the `<ruby>` element. One `<rp>` element should enclose each of the opening and closing parentheses that wrap the `<rt>` element that contains the annotation's text.

Try it
------

Attributes
----------

This element only includes the global attributes.

Usage notes
-----------

* Ruby annotations are for showing pronunciation of East Asian characters, like using Japanese furigana or Taiwanese bopomofo characters. The `<rp>` element is used in the case of lack of `<ruby>` element support; the `<rp>` content provides what should be displayed in order to indicate the presence of a ruby annotation, usually parentheses.
Examples
--------

### Using ruby annotations

This example uses ruby annotations to display the Romaji equivalents for each character.


```html
<ruby>
  漢 <rp>(</rp><rt>Kan</rt><rp>)</rp> 字 <rp>(</rp><rt>ji</rt><rp>)</rp>
</ruby>
```


```
body {
  font-size: 22px;
}
```


#### Result

See the article about the `<ruby>` element for further examples.

### Without ruby support

If your browser does not support ruby annotations, the result looks like this instead:
```

漢 (Kan) 字 (ji)
```


```
body {
  font-size: 22px;
}
```

Technical summary
-----------------

|  |  |
| --- | --- |
| Content categories | None. |
| Permitted content | Text |
| Tag omission | 
 The end tag can be omitted if the element is immediately followed by an
 `<rt>` or another `<rp>` element,
 or if there is no more content in the parent element.
  |
| Permitted parents | 
 A `<ruby>` element. `<rp>` must
 be positioned immediately before or after an
 `<rt>` element.
  |
| Implicit ARIA role | No corresponding role |
| Permitted ARIA roles | Any |
| DOM interface | `HTMLElement` |

Specifications
--------------

| Specification |
| --- |
| HTML Standard # the-rp-element |

Browser compatibility
---------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

See also
--------

* `<ruby>`
* `<rt>`
* `<rb>`
* `<rtc>`
<option>: The HTML Option element
=================================

The **`<option>`** HTML element is used to define an item contained in a `<select>`, an `<optgroup>`, or a `<datalist>` element. As such, `<option>` can represent menu items in popups and other lists of items in an HTML document.

Try it
------

Attributes
----------

This element includes the global attributes.

`disabled`

If this Boolean attribute is set, this option is not checkable. Often browsers grey out such control and it won't receive any browsing event, like mouse clicks or focus-related ones. If this attribute is not set, the element can still be disabled if one of its ancestors is a disabled `<optgroup>` element.

`label`

This attribute is text for the label indicating the meaning of the option. If the `label` attribute isn't defined, its value is that of the element text content.

`selected`

If present, this Boolean attribute indicates that the option is initially selected. If the `<option>` element is the descendant of a `<select>` element whose `multiple` attribute is not set, only one single `<option>` of this `<select>` element may have the `selected` attribute.

`value`

The content of this attribute represents the value to be submitted with the form, should this option be selected. If this attribute is omitted, the value is taken from the text content of the option element.

Styling with CSS
----------------

Styling the **`<option>`** element is highly limited. Options don't inherit the font set on the parent. In Firefox, only `color` and `background-color` can be set, however in Chrome and Safari it's not possible to set any properties. You can find more details about styling in our guide to advanced form styling.

Examples
--------

See `<select>` for examples.

Technical summary
-----------------

|  |  |
| --- | --- |
| Content categories | None. |
| Permitted content | 
 Text, possibly with escaped characters (like
 `&eacute;`).
  |
| Tag omission | 
 The start tag is mandatory. The end tag is optional if this element is
 immediately followed by another `<option>` element or an
 `<optgroup>`, or if the parent element has no
 more content.
  |
| Permitted parents | 
 A `<select>`, an
 `<optgroup>` or a
 `<datalist>` element.
  |
| Implicit ARIA role | `option` |
| Permitted ARIA roles | No `role` permitted |
| DOM interface | `HTMLOptionElement` |

Specifications
--------------

| Specification |
| --- |
| HTML Standard # the-option-element |

Browser compatibility
---------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

See also
--------

* Other form-related elements: `<form>`, `<legend>`, `<label>`, `<button>`, `<select>`, `<datalist>`, `<optgroup>`, `<fieldset>`, `<textarea>`, `<input>`, `<output>`, `<progress>` and `<meter>`.
<xmp>
=====

**Deprecated:** This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.

Summary
-------

The **`<xmp>`** HTML element renders text between the start and end tags without interpreting the HTML in between and using a monospaced font. The HTML2 specification recommended that it should be rendered wide enough to allow 80 characters per line.

**Note:** Do not use this element.

* It has been deprecated since HTML3.2 and was not implemented in a consistent way. It was completely removed from current HTML.
* Use the `<pre>` element or, if semantically adequate, the `<code>` element instead. Note that you will need to escape the '`<`' character as '`&lt;`' and the '`&`' character as '`&amp;`' to make sure they are not interpreted as markup.
* A monospaced font can also be obtained on any element, by applying an adequate CSS style using `monospace` as the generic-font value for the `font-family` property.

Attributes
----------

This element has no other attributes than the global attributes, common to all elements.

DOM interface
-------------

This element implements the `HTMLElement` interface.

Specifications
--------------

| Specification |
| --- |
| HTML Standard # xmp |

Browser compatibility
---------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

See also
--------

* The `<pre>` and `<code>` elements to be used instead.
* The `<plaintext>` element, similar to `<xmp>` but also obsolete.
<slot>: The Web Component Slot element
======================================

Baseline Widely available
-------------------------

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

* Learn more
* See full compatibility
* Report feedback
The **`<slot>`** HTML element—part of the Web Components technology suite—is a placeholder inside a web component that you can fill with your own markup, which lets you create separate DOM trees and present them together.

Attributes
----------

This element includes the global attributes.

`name`

The slot's name.

A ***named slot*** is a `<slot>` element with a `name` attribute.

Examples
--------


```html
<template id="element-details-template">
  <style>
 details {
 font-family: "Open Sans Light", Helvetica, Arial, sans-serif;
 }
 .name {
 font-weight: bold;
 color: #217ac0;
 font-size: 120%;
 }
 h4 {
 margin: 10px 0 -8px 0;
 background: #217ac0;
 color: white;
 padding: 2px 6px;
 border: 1px solid #cee9f9;
 border-radius: 4px;
 }
 .attributes {
 margin-left: 22px;
 font-size: 90%;
 }
 .attributes p {
 margin-left: 16px;
 font-style: italic;
 }
 </style>
  <details>
    <summary>
      <code class="name">
        &lt;<slot name="element-name">NEED NAME</slot>&gt;
      </code>
      <span class="desc"><slot name="description">NEED DESCRIPTION</slot></span>
    </summary>
    <div class="attributes">
      <h4>Attributes</h4>
      <slot name="attributes"><p>None</p></slot>
    </div>
  </details>
  <hr />
</template>
```


**Note:** You can see this complete example in action at element-details (see it running live). In addition, you can find an explanation at Using templates and slots.

Technical summary
-----------------

|  |  |
| --- | --- |
| Content categories | Flow content,
 phrasing content |
| Permitted content | Transparent |
| Events | `slotchange` |
| Tag omission | None, both the starting and ending tag are mandatory. |
| Permitted parents | 
 Any element that accepts
 phrasing content |
| Implicit ARIA role | No corresponding role |
| Permitted ARIA roles | No `role` permitted |
| DOM interface | `HTMLSlotElement` |

Specifications
--------------

| Specification |
| --- |
| HTML Standard # the-slot-element |
| DOM Standard # shadow-tree-slots |

Browser compatibility
---------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

See also
--------

* HTML `<template>` element
* HTML `slot` attribute
* CSS `::slotted` pseudo-element
* CSS scoping module
<hgroup>: The Heading Group element
===================================

The **`<hgroup>`** HTML element represents a heading and related content. It groups a single `<h1>–<h6>` element with one or more `<p>`.

Try it
------

**Note:** The `<hgroup>` element is not recommended as it does not work properly with assistive technologies. It was removed from the W3C HTML specification but is still part of the WHATWG specification and is at least partially supported by most browsers.

Attributes
----------

This element only includes the global attributes.

Usage notes
-----------

The `<hgroup>` element allows the grouping of a heading with any secondary content, such as subheadings, an alternative title, or tagline. Each of these types of content represented as a `<p>` element within the `<hgroup>`.

The `<hgroup>` itself has no impact on the document outline of a web page. Rather, the single allowed heading within the `<hgroup>` contributes to the document outline.

Examples
--------


```html
<!doctype html>
<title>HTML Standard</title>
<body>
  <hgroup id="document-title">
    <h1>HTML: Living Standard</h1>
    <p>Last Updated 12 July 2022</p>
  </hgroup>
  <p>Some intro to the document.</p>
  <h2>Table of contents</h2>
  <ol id="toc">
    …
  </ol>
  <h2>First section</h2>
  <p>Some intro to the first section.</p>
</body>
```

### Result

Accessibility concerns
----------------------

The `<hgroup>` presently has no strong accessibility semantics. The content of the element (a heading and optional paragraphs) is what is exposed by browser accessibility APIs.

Technical summary
-----------------

|  |  |
| --- | --- |
| Content categories | Flow content, heading content, palpable content. |
| Permitted content | 
 Zero or more `<p>` elements, followed by one
 h1, h2,
 h3, h4,
 h5, or h6 element,
 followed by zero or more `<p>` elements.
  |
| Tag omission | None, both the starting and ending tag are mandatory. |
| Permitted parents | 
 Any element that accepts
 flow content.
  |
| Implicit ARIA role | `generic` |
| Permitted ARIA roles | Any |
| DOM interface | `HTMLElement` |

Specifications
--------------

| Specification |
| --- |
| HTML Standard # the-hgroup-element |

Browser compatibility
---------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

See also
--------

* Others section-related elements: `<body>`, `<article>`, `<section>`, `<aside>`, h1, h2, h3, h4, h5, h6, `<nav>`, `<header>`, `<footer>`, `<address>`;
* Sections and outlines of an HTML document.
<map>: The Image Map element
============================

The **`<map>`** HTML element is used with `<area>` elements to define an image map (a clickable link area).

Try it
------

Attributes
----------

This element includes the global attributes.

`name`

The `name` attribute gives the map a name so that it can be referenced. The attribute must be present and must have a non-empty value with no space characters. The value of the `name` attribute must not be equal to the value of the `name` attribute of another `<map>` element in the same document. If the `id` attribute is also specified, both attributes must have the same value.

Examples
--------

### Image map with two areas

Click the left-hand parrot for JavaScript, or the right-hand parrot for CSS.

#### HTML


```html
<!-- Photo by Juliana e Mariana Amorim on Unsplash -->
<map name="primary">
  <area
 shape="circle"
 coords="75,75,75"
 href="https://developer.mozilla.org/docs/Web/JavaScript"
 target="\_blank"
 alt="JavaScript" />
  <area
 shape="circle"
 coords="275,75,75"
 href="https://developer.mozilla.org/docs/Web/CSS"
 target="\_blank"
 alt="CSS" />
</map>
<img
 usemap="#primary"
 src="parrots.jpg"
 alt="350 x 150 picture of two parrots" />
```


#### Result

Technical summary
-----------------

|  |  |
| --- | --- |
| Content categories | Flow content,
 phrasing content, palpable content.
  |
| Permitted content | 
 Any
 transparent
 element.
  |
| Tag omission | None, both the starting and ending tag are mandatory. |
| Permitted parents | 
 Any element that accepts
 phrasing content.
  |
| Implicit ARIA role | No corresponding role |
| Permitted ARIA roles | No `role` permitted |
| DOM interface | `HTMLMapElement` |

Specifications
--------------

| Specification |
| --- |
| HTML Standard # the-map-element |

Browser compatibility
---------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

See also
--------

* `<a>`
* `<area>`
<dir>: The Directory element
============================

**Deprecated:** This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.

The **`<dir>`** HTML element is used as a container for a directory of files and/or folders, potentially with styles and icons applied by the user agent. Do not use this obsolete element; instead, you should use the `<ul>` element for lists, including lists of files.

**Warning:** Do not use this element. Though present in early HTML specifications, it has been deprecated in HTML 4, and has since been removed entirely. **No major browsers support this element.**

DOM interface
-------------

This element implements the `HTMLDirectoryElement` interface.

Attributes
----------

Like all other HTML elements, this element supports the global attributes.

`compact` 
Deprecated

This Boolean attribute hints that the list should be rendered in a compact style. The interpretation of this attribute depends on the user agent and it doesn't work in all browsers.

Specifications
--------------

Not part of any current specifications.

Browser compatibility
---------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

See also
--------

* Other list-related HTML Elements: `<ol>`, `<ul>`, `<li>`, and `<menu>`;
* CSS properties that may be specially useful to style the `<dir>` element:
    + The `list-style` property, useful to choose the way the ordinal is displayed.
    + CSS counters, useful to handle complex nested lists.
    + The `line-height` property, useful to simulate the deprecated `compact` attribute.
    + The `margin` property, useful to control the indent of the list.
<noframes>: The Frame Fallback element
======================================

**Deprecated:** This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.

The **`<noframes>`** HTML element provides content to be presented in browsers that don't support (or have disabled support for) the `<frame>` element. Although most commonly-used browsers support frames, there are exceptions, including certain special-use browsers including some mobile browsers, as well as text-mode browsers.

A `<noframes>` element can contain any HTML elements that are allowed within the body of an HTML document, except for the `<frameset>` and `<frame>` elements, since using frames when they aren't supported doesn't make sense.

`<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.

**Note:** This element is obsolete and shouldn't be used, since the `<frame>` and `<frameset>` elements are also obsolete. When frames are needed at all, they should be presented using the `<iframe>` element.

Attributes
----------

Like all other HTML elements, this element supports the global attributes. It has no other attributes available.

Example
-------

In this example, we see a frameset with two frames. In addition, `<noframes>` is used to present an explanatory message if the user agent doesn't support frames.


```html
<!doctype html>
<html lang="en-US">
  <head>
    <!-- Document metadata goes here -->
  </head>
  <frameset rows="45%, 55%">
    <frame src="https://developer.mozilla.org/en/HTML/Element/frameset" />
    <frame src="https://developer.mozilla.org/en/HTML/Element/frame" />
    <noframes>
      <p>
        It seems your browser does not support frames or is configured to not
        allow them.
      </p>
    </noframes>
  </frameset>
</html>
```

Specifications
--------------

| Specification |
| --- |
| HTML Standard # noframes |

Browser compatibility
---------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

See also
--------

* `<frameset>`
* `<frame>`
<frameset>
==========

**Deprecated:** This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.

The **`<frameset>`** HTML element is used to contain `<frame>` elements.

**Note:** Because the use of frames is now discouraged in favor of using `<iframe>`, this element is not typically used by modern websites.

Attributes
----------

Like all other HTML elements, this element supports the global attributes.

`cols` 
Deprecated

This attribute specifies the number and size of horizontal spaces in a frameset.

`rows` 
Deprecated

This attribute specifies the number and size of vertical spaces in a frameset.

Example
-------

### A frameset document

A frameset document has a `<frameset>` element instead of a `<body>` element. The `<frame>` elements are placed within the `<frameset>`.


```html
<!doctype html>
<html lang="en-US">
  <head>
    <!-- Document metadata goes here -->
  </head>
  <frameset cols="50%, 50%">
    <frame src="https://developer.mozilla.org/en/HTML/Element/iframe" />
    <frame src="https://developer.mozilla.org/en/HTML/Element/frame" />
  </frameset>
</html>
```


If you want to embed another HTML page into the `<body>` of a document, use an `<iframe>` element.

Specifications
--------------

| Specification |
| --- |
| HTML Standard # frameset |

Browser compatibility
---------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

See also
--------

* `<frame>`
* `<iframe>`
<var>: The Variable element
===========================

The **`<var>`** HTML element represents the name of a variable in a mathematical expression or a programming context. It's typically presented using an italicized version of the current typeface, although that behavior is browser-dependent.

Try it
------

Attributes
----------

This element only includes the global attributes.

Usage notes
-----------

### Related elements

Other elements that are used in contexts in which `<var>` is commonly used include:

* `<code>`: The HTML Code element
* `<kbd>`: The HTML Keyboard input element
* `<samp>`: The HTML Sample Output element

If you encounter code that is mistakenly using `<var>` for style purposes rather than semantic purposes, you should either use a `<span>` with appropriate CSS or, an appropriate semantic element among the following:

* `<em>`
* `<i>`
* `<q>`
### Default style

Most browsers apply `font-style` to `"italic"` when rendering `<var>`. This can be overridden in CSS, like this:


```css
var {
  font-style: normal;
}
```

Examples
--------

### Basic example

Here's a simple example, using `<var>` to denote variable names in a mathematical equation.


```html
<p>A simple equation: <var>x</var> = <var>y</var> + 2</p>
```


#### Result

### Overriding the default style

Using CSS, you can override the default style for the `<var>` element. In this example, variable names are rendered using bold Courier if it's available, otherwise it falls back to the default monospace font.

#### CSS


```css
var {
  font:
    bold 15px "Courier",
    "Courier New",
    monospace;
}
```


#### HTML


```html
<p>
  The variables <var>minSpeed</var> and <var>maxSpeed</var> control the minimum
  and maximum speed of the apparatus in revolutions per minute (RPM).
</p>
```


This HTML uses `<var>` to enclose the names of two variables.

#### Result

Technical summary
-----------------

|  |  |
| --- | --- |
| Content categories | Flow content,
 phrasing content, palpable content.
  |
| Permitted content | Phrasing content. |
| Tag omission | None, both the starting and ending tag are mandatory. |
| Permitted parents | 
 Any element that accepts
 phrasing content.
  |
| Implicit ARIA role | No corresponding role |
| Permitted ARIA roles | Any |
| DOM interface | `HTMLElement` |

Specifications
--------------

| Specification |
| --- |
| HTML Standard # the-var-element |

Browser compatibility
---------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.