Skip to content

List out every feature of html!  #3513

@ranile

Description

@ranile

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

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions