Highlight.js 项目中对 Arcade 语言语法高亮的版本适配更新

Highlight.js 作为一款流行的代码语法高亮库，需要持续跟进各类编程语言的语法更新。近期 Arcade 脚本语言在 1.29 版本中引入了若干新特性，这对语法高亮规则提出了更新需求。

Arcade 语言的新特性解析

Arcade 是由 Esri 开发的一种表达式语言，主要用于地理空间数据处理和可视化。1.29 版本主要在三方面进行了语法扩展：

新增关键字

• of 操作符：用于类型声明和集合操作，这是对类型系统的增强

新增内置函数

地理空间计算类：

• DistanceToCoordinate：计算到指定坐标的距离
• MeasureToCoordinate：测量到坐标的空间关系
• PointToCoordinate：坐标转换函数

数据查询类：

• FeatureInFilter：要素过滤判断
• FilterBySubtypeCode：按子类型过滤
• QueryGraph：图数据查询
• KnowledgeGraphByPortalItem：知识图谱访问

实用工具：

• StandardizeFilename：文件名标准化处理

新增配置文件变量

• graph：图数据结构访问
• userInput：用户输入处理
• variables：变量管理接口

语法高亮适配方案

对于 Highlight.js 这类语法高亮引擎，需要准确识别这些新语法元素：

1. 关键词识别：需要将 of 添加到关键词列表，确保其能像其他关键字一样被正确高亮

2. 函数分类处理：

   • 地理空间函数应保持与现有空间函数相同的高亮样式
   • 数据查询函数建议使用特定颜色区分
   • 工具函数可采用中性色调

3. 变量标识：配置文件变量需要与普通变量区分显示，通常采用较浅的色调

实现建议

在 Highlight.js 的 Arcade 语言定义文件中，建议进行如下修改：

keywords: {
  keyword: 'of|...原有关键词...',
  literal: '...原有字面量...',
  built_in: 'DistanceToCoordinate|FeatureInFilter|...|StandardizeFilename|...原有函数...'
},
contains: [
  {
    className: 'variable',
    begin: '\\$(graph|userInput|variables)\\b'
  }
  //...其他规则...
]

这种更新既保持了向后兼容性，又能准确反映 Arcade 1.29 的新语法特性。对于地理信息系统开发者而言，准确的高亮显示有助于提高代码可读性和开发效率。

结语

语法高亮库的维护是一个持续的过程，需要紧跟各语言的发展步伐。本次 Arcade 语言的更新虽然改动不大，但对 GIS 领域的开发者具有重要意义。Highlight.js 通过这类及时更新，继续巩固其作为通用代码高亮解决方案的地位。