17370845950

本文说明 salix 原项目已正式停用，推荐迁移至更活跃、更稳定的 salix-core，并提供迁移要点、初始化示例及关键注意事项。

Salix（原 usethesource/salix）已于近年正式停止维护，其功能与架构已被重构并升级为 salix-core —— 一个轻量、类型安全、专为 Rascal 语言设计的声明式 UI 框架。你遇到的 Cannot read properties of undefined (reading 'edits') 错误，根本原因正是旧版 Salix 的运行时（如 salix.js）与当前 Rascal 编译器、HTML 生命周期或 DOM 初始化逻辑存在不兼容，尤其在 patchDOM 阶段因模型/虚拟 DOM 初始化失败导致 edits 字段未定义。

✅ 正确做法：立即迁移到 salix-core

1. 更新依赖
   在你的 .rascal 项目中，移除旧 salix 导入，改用：

   import lang::salix::core::App;
   import lang::salix::core::Dom;

2. 重写应用入口（关键变更）
   salix-core 不再使用 makeApp 或 webApp 这类高阶封装，而是通过 App::start 显式启动，且要求 view 函数返回 Dom 类型（而非 HTML 字符串）：

   module examples::Counter
   
   import lang::salix::core::App;
   import lang::salix::core::Dom;
   import lang::salix::core::Events;
   
   data Model = model(int count);
   
   Model init() = model(0);
   
   Dom view(Model m) = 
       div([
           h1("Counter: "),
           button([Events::onClick({|| update(m, "inc")})], "Increment"),
           button([Events::onClick({|| update(m, "dec")})], "Decrement")
       ]);
   
   Model update(Model m, str action) {
       switch(action) {
           case "inc": return model(m.count + 1);
           case "dec": return model(m.count - 1);
           default: return m;
       }
   }
   
   // 启动应用（替代旧版 makeApp + webApp）
   App[Model] counterApp() = App::start(
       init,
       view,
       update,
       "counterApp"  // 对应 HTML 中的 div#counterApp
   );

3. HTML 端精简配置
   确保 index.html 中仅引入 salix-core.js（非 salix.js），并移除 jQuery 依赖（salix-core 不再依赖 jQuery）：

⚠️ 注意事项：

• salix-core 要求 Rascal ≥ 0.18.0；请执行 rascal -version 核实。
• 所有事件处理器（如 onClick）必须传入闭包 {|...| ...}，不可省略参数括号。
• view 函数必须返回 Dom 类型值（由 div, h1, button 等函数构造），返回字符串将导致运行时崩溃。
• 若需富组件（如代码编辑器、图表），可搭配 salix-contrib 使用，例如 import lang::salix::contrib::Ace;。

? 总结：旧 Salix 的 webApp / makeApp 模式已过时，patchDOM 报错是典型兼容性失效信号。拥抱 salix-core 不仅解决当前问题，更能获得持续更新、更好调试体验和社区支持。迁移成本低、收益高——建议所有新旧项目统一升级。