本资料是 Marko 6(Tags API)的语言规则速查与排错参考,提炼自官方文档,聚焦容易出错的规则,不覆盖 Marko 5 / class API。用途:编写或编辑任何 .marko 文件、审查 Marko 6 代码,或组件能编译但行为异常时排查。主要能力按主题分文件组织:语言语法(语句、属性与简写、内容、attr 标签、标签变量与参数、动态标签、简洁模式、空白);核心标签(if/show/for/let/const/return/script/style/define/lifecycle/id/await/try 及响应式与调度模型);原生标签(class=/style=/content=、事件委托、controllable 绑定、spread 归属);TypeScript(Input 类型、Marko.* 类型、增强原生/全局/CSS、标签内 TS 语法);模板 API(render/mount、$global 等);自定义标签与样式(标签发现顺序、tags/ 目录、marko.json、懒加载);模式(可受控组件、嵌套状态、可序列化/不可变状态、流式、工具链)。核心心智模型:文件即组件,input 即 attrs;只有 import/export/static/server/client 属模块语句,其余为响应式模板体;响应式来源为标签变量、标签参数与 input,依赖图在编译期确定,表达式须纯;let 为状态、const 为派生;更新在微任务后批量刷新,故更新后 const 与 DOM 在刷新前是旧值;script 为浏览器副作用,生命周期用 lifecycle;原生标签变量为仅浏览器可用的 getter;可受控一切属性;仅可序列化的普通数据能跨服务端/客户端边界;默认零 JS。资料还列出经真实组件验证的已知错误清单:if/else 必须是直接同级且中间不能有其他内容;顶层 interface/type/const 必须加 export 或 static;!/ 存在歧义,始终写 $!{expr};自递归标签需显式自导入;SSR 到水合必须只传原始值,避免闭包与类实例;动态标签挂载内容中避免在遍历阶段读取 const 值。用法上,建议按需查阅对应 references/ 文件;类型检查使用 mtc(@marko/type-check)而非 tsc。限制:内容为精简参考,完整细节在 references/;部分条目(如 !/ 歧义)标注为待独立验证;不涉及收费、平台或效果承诺等信息,官方文档未提供的细节暂未提供。
marko-6-language
通用与其它
更新于 10-16 09:27