#3513·yew

List out every feature of html!

Author: ranileCreated Nov 2, 2023Updated Apr 9, 2026
Labelsdocumentation

This is about:

  • A typo
  • Innaccurate/misleading documentation (e.g. technically incorrect advice)
  • Undocumented code
  • Outdated documentation
  • Other

Problem

There is no single place that currently lists out all the major features/differences from HTML of html! macro.

Details about the solution you'd like (Optional)

Add a list of features to API docs of html! macro listing out all features that it has. These features include, but are not limited to:

  • dynamic tags
  • if statement
  • for expression
  • self closing tags (e.g <div />)
  • compile-time enforcement of void elements
  • property syntax (~ident)
  • attribute shorthand
  • keys
  • handling of literals and expressions

Additional context (Optional)

Fragments of documentation exist on the Yew website but it's not collected anywhere. The goal of this issue to collect all the features and provide a clear pathway for deciding what should be added to the macro and what should be removed?

This should also serve as a list of features to implement, should anyone decide to make a formatter or IDE extension.

Open questions

  • Should all these features stay? What's the boundary of having features added and what should be delegated to third-party crates?

Questionaire (Optional)

  • I'd like to write this documentation
  • I'd like to write this doumentation but I'm not sure what's needed
  • I don't have time to add this right now, but maybe later