MAML

提供开发增强功能和诊断工具。

主要功能

文本编辑和格式化

• XML 属性排序 — 自动排序和格式化 XML 属性，支持属性权重优化
• 诊断自动选中 — 点击诊断错误时自动选中内容，便于快速修改
• 表达式格式化 — 自动格式化复杂表达式，提高可读性
• 序列插入 — 快速生成数字序列、日期序列、字符串序列，支持历史记录（功能从https://marketplace.visualstudio.com/items?itemName=volkerdobler.insertnums提取并修改）

视觉反馈和预览

• 图片预览 — 悬浮预览图片 URL 和本地路径，支持多种格式和路径映射 （功能从https://marketplace.visualstudio.com/items?itemName=kisstkondoros.vscode-gutter-preview提取并修改）
• 颜色高亮 — 高亮显示颜色值，支持多种格式，可快速复制和修改透明度
• 缓动函数预览 — 30+ 种缓动函数（Sine、Quad、Cubic 等）和 SVG 曲线可视化
• 混合模式演示 — 交互式混合模式选择器和实时视觉演示
• 括号范围高亮 — 光标在括号内时高亮匹配的括号对和包含范围

智能代码补全和提示

• 属性名智能补全 — 根据标签类型智能提示可用属性，属性名右侧直接显示描述说明
• 智能排序 — 属性补全按标签专属性、语义优先级、使用频率综合排序
• 属性值智能提示 — 显示命令、动作、类型、传感器等属性值的详细说明和文档
• 图片路径补全 — 为 src 属性提供项目内图片文件路径补全，支持 .png/.jpg/.svg/.pag/.mp4 等格式
• 变量补全 — 输入 @/#/$/$$ 触发变量补全，包括全局变量、用户自定义变量
• SDK 点变量补全 — 输入 #elementName. 触发 SDK 自动变量后缀补全（x, y, alpha 等）
• 内置函数补全 — 智能提示 MAML 内置函数（sin、cos、ifelse 等），显示函数签名和参数说明
• 智能引用补全 — 根据标签上下文补全 target、name、states 等引用属性
• Hover 悬浮提示 — 展示表达式、属性、类型等详细信息，支持点击快速填充
• 标签名悬浮提示 — 悬浮在标签名上显示该标签的功能简介
• 传感器类型表 — 悬浮提示时显示传感器数据索引表，支持交互式切换

代码导航

• 定义跳转（F12） — 快速跳转到变量、函数、状态等定义位置
• 查找引用（Shift+F12） — 查找变量、函数、动画状态等的所有引用
• 表达式变量跳转 — 在表达式中点击变量引用直接跳转到定义

代码重构

• 变量重命名（F2） — 重命名变量时同时更新所有引用，支持 @/#/$/$$ 前缀
• 提取变量 — 选中表达式后可提取为新变量，自动推断类型
• 内联变量 — 将变量引用替换为其表达式值

快速修复（CodeAction）

• 添加 Permanence 声明 — 自动添加缺失的持久化变量声明
• 添加 const 属性 — 为被覆盖的变量添加 const="true"
• 移除无效属性 — 移除字符串类型变量的 threshold 属性
• 修复变量类型 — 修改变量类型以匹配 JSON 函数返回值
• 添加缺失按钮 — 为 Clock 添加 clock_button 按钮
• 添加 name 属性 — 自动生成变量名

表达式编辑

• 表达式语法高亮 — 为表达式内容提供语法高亮（函数、变量、数字、运算符、括号）
• 表达式语义标记 — 基于 Semantic Token 的精确着色，可自定义颜色
• 括号匹配检查 — 检查表达式中括号是否完全匹配
• 表达式完整支持 — 支持所有 MAML 表达式属性，包括变量、函数、运算符等

语言诊断和代码检查

配置

在 VSCode 设置中搜索 maml-tools 可以配置以下选项：

模块开关

所有模块可在 VSCode 设置中独立启用/禁用：

{
  "maml-tools.modules.insertSequence": true,
  "maml-tools.modules.colorHighlight": true,
  "maml-tools.modules.expressionColoring": true
}

序列插入配置

示例：

{
  "maml-tools.insertSeq.historyLimit": 100,
  "maml-tools.insertSeq.editHistory": false,
  "maml-tools.insertSeq.start": "1",
  "maml-tools.insertSeq.step": "1",
  "maml-tools.insertSeq.cast": "s",
  "maml-tools.insertSeq.dateFormat": "yyyy-MM-dd"
}

图片预览配置

sourceFolder / sourceFolders — 额外搜索文件夹

在查找图片时，除了从项目根目录，还会在这些文件夹中查找。支持相对路径（相对项目根）和绝对路径（系统路径）。

查找流程 — 当代码写 src="logo.png" 时，会依次查找：

1. 项目根/logo.png
2. 项目根/images/logo.png（sourceFolder 中的相对路径）
3. 项目根/assets/logo.png（sourceFolders 中的相对路径）
4. /usr/local/images/logo.png（sourceFolders 中的绝对路径）

{
  "maml-tools.imagePreview.sourceFolder": "images",
  "maml-tools.imagePreview.sourceFolders": ["images", "assets", "/usr/local/images"]
}

说明：

• 相对路径基于项目根目录
• 绝对路径使用系统路径（跨越项目外的文件夹）
• sourceFolder 和 sourceFolders 的查找顺序是依次尝试

showUnderline — 显示下划线

控制识别到的图片 URL 是否显示下划线装饰。默认为 true。

{
  "maml-tools.imagePreview.showUnderline": true
}

快捷键

反馈

以下问题请联系 QQ: 1452281131

• 误报错
• 增加语法检查
• 增加新功能
• bug反馈