From 56b76f68f127e438880bbd1a6178c67bd7d59cab Mon Sep 17 00:00:00 2001 From: Li Jin Date: Wed, 22 Apr 2026 16:41:46 +0800 Subject: Updated docs. --- doc/docs/pt-br/doc/advanced/macro.md | 56 ++++++++++++++++++++++++++++++++++++ 1 file changed, 56 insertions(+) (limited to 'doc/docs/pt-br') diff --git a/doc/docs/pt-br/doc/advanced/macro.md b/doc/docs/pt-br/doc/advanced/macro.md index 18d33e0..d1025d1 100644 --- a/doc/docs/pt-br/doc/advanced/macro.md +++ b/doc/docs/pt-br/doc/advanced/macro.md @@ -228,6 +228,62 @@ print "Valid enum type:", $BodyType Static +## Gerando código Yue em múltiplas linhas + +Quando uma macro retorna código Yue em múltiplas linhas, não é recomendado usar uma string multilinha entre aspas. Prefira `-> |`. + +Uma string entre aspas preserva o texto literal, enquanto uma string multilinha estilo YAML remove a indentação inicial comum. Isso normalmente deixa os blocos Yue gerados mais estáveis, especialmente quando o código gerado contém comentários ou blocos aninhados. + +```yuescript +macro default_conf = (conf) -> " + -- useful; only set once +#{conf}.identity = 'LOVE' +#{conf}.version = \"11.5\" + " + +love.conf = (t) -> + $default_conf t +``` + + + +```yue +macro default_conf = (conf) -> " + -- useful; only set once +#{conf}.identity = 'LOVE' +#{conf}.version = \"11.5\" + " + +love.conf = (t) -> + $default_conf t +``` + + + +```yuescript +macro default_conf = (conf) -> | + -- useful; only set once + #{conf}.identity = 'LOVE' + #{conf}.version = "11.5" + +love.conf = (t) -> + $default_conf t +``` + + + +```yue +macro default_conf = (conf) -> | + -- useful; only set once + #{conf}.identity = 'LOVE' + #{conf}.version = "11.5" + +love.conf = (t) -> + $default_conf t +``` + + + ## Validação de argumentos Você pode declarar os tipos de nós AST esperados na lista de argumentos e verificar se os argumentos da macro recebidos atendem às expectativas em tempo de compilação. -- cgit v1.2.3-55-g6feb