glimmerjs/glimmer-website

Template Guide

wycats opened this issue · 3 comments

Since Glimmer has a number of extensions to vanilla Handlebars (and people might not be familiar with Handlebars anyway) that overlap but are not identical to Ember, we need a templating guide focused on how to understand Glimmer templates.

Some notable examples of extension syntax:

  • @-syntax (and the relationship to this.args in component classes)
  • {{yield}}
  • {{has-block}} (and lesser priority {{has-block-params}})
  • inline if
  • <angle-bracket> invocation
  • {{action}}
  • "contextual components"
  • attributes in HTML

I'd like it if we were careful to use simple language in this guide rather than terminology like "closure action" and "contextual component" 😄

locks commented

Small note: we'll need to implement contextual components first. And inline if.

I wrote this Glimmer syntax cheat sheet a while back. Might be a good start.