Figure

Struct Figure 

Source
pub struct Figure;
Expand description

The <figure> element - self-contained content.

§Purpose

The <figure> element represents self-contained content, typically with a caption, that is referenced as a single unit from the main content. Often used for images, diagrams, code listings, or other content that can be moved away from the main flow.

§Content Categories

  • Flow Content
  • Palpable Content

§Permitted Content Model

  • Either: one <figcaption> followed by flow content
  • Or: flow content followed by one <figcaption>
  • Or: flow content only

§Common Use Cases

  • Images with captions
  • Code examples with descriptions
  • Diagrams or illustrations
  • Quotations with attributions
  • Videos or multimedia with captions

§Key Attributes

  • Global attributes only

§Example

<figure>
  <img src="chart.png" alt="Sales data chart">
  <figcaption>Figure 1: Q4 Sales Performance</figcaption>
</figure>

<figure>
  <pre><code>function greet(name) {
  return `Hello, ${name}!`;
}</code></pre>
  <figcaption>Example: Template literal usage</figcaption>
</figure>

§Accessibility

  • Screen readers associate caption with content
  • Use <figcaption> for accessible descriptions

§WHATWG Specification

Trait Implementations§

Source§

impl HtmlElement for Figure

Source§

const TAG: &'static str = "figure"

The HTML tag name (e.g., “div”, “span”, “img”).
Source§

const VOID: bool = false

Whether this is a void element (self-closing, no children allowed).
Source§

impl<T: FlowContent> CanContain<T> for Figure

Source§

impl FlowContent for Figure

Source§

impl PalpableContent for Figure

Auto Trait Implementations§

§

impl Freeze for Figure

§

impl RefUnwindSafe for Figure

§

impl Send for Figure

§

impl Sync for Figure

§

impl Unpin for Figure

§

impl UnwindSafe for Figure

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.