CEL Scripting in Template Builder

你的脚本                       引擎                          结果
    |                            |                            |
    v                            v                            v
documents.get("article", "intro") --> 从数据库获取 --> { headline: "Welcome", body: "..." }
         .headline                --> 提取字段       --> "Welcome"

// 访问当前文档的价格字段
doc.price

// 根据当前文档的字段计算总价
doc.price * doc.quantity

// 根据当前文档状态进行条件判断
doc.status == "published" ? doc.title : "Draft: " + doc.title

// 在 CMS 中存储为：article / welcome-post
{
  "headline": "欢迎来到我们的平台",
  "author": "Sarah Chen",
  "body": "我们很高兴地宣布……",
  "tags": ["announcement", "news"]
}

documents.get("article", "welcome-post")

documents.get("article", "welcome-post").headline

documents.get("article", "welcome-post").author

documents.get("article", meta.params.slug).headline

// 获取所有国家
documents.find("country")

[
  { "code": "us", "name": "美国", "flag": "US" },
  { "code": "sa", "name": "沙特阿拉伯", "flag": "SA" },
  { "code": "gb", "name": "英国", "flag": "GB" }
]

// 使用过滤条件获取国家
documents.find("country", { "where": { "code": "us" } })

// 如果 meta.locale 为 "fr"，返回与基础文档合并后的法语翻译
documents.get("greeting", "welcome").headline

// 始终获取西班牙语翻译
documents.translated("greeting", "welcome", "es").headline

// 根据 URL 参数获取翻译
documents.translated("product", meta.params.id, meta.params.lang).description

// 比较不同翻译
documents.translated("article", "intro", "en").title + " / " + documents.translated("article", "intro", "fr").title

documents.get("article", "homepage-hero").headline

documents.get("country", meta.params.code).name

meta.locale == "ar-SA" ? "Welcome, everyone" : "Welcome"

documents.get("country", documents.get("article", "us-news").countryCode).name

documents.get("article", meta.params.slug) != null
  ? documents.get("article", meta.params.slug).headline
  : "Article Not Found"

documents.get("article", "intro").author != null
  ? documents.get("article", "intro").author
  : "Unknown Author"

"featured" in documents.get("article", "welcome-post").tags

documents.get("article", "welcome-post").tags[0]

size(documents.get("article", "welcome-post").tags)

{
  "pattern": "/{lang}/landingPage",
  "param_bindings": {
    "lang": "language"
  }
}

documents.get("greeting", meta.params.lang).headline

// 获取国家名称
documents.get("country", meta.params.country).name

// 根据国家获取本地化产品列表
documents.find("product", { "where": { "country": meta.params.country } })

// 组合显示特定国家、特定语言的问候语
documents.get("greeting", meta.params.lang).headline + " from " + documents.get("country", meta.params.country).name

// 获取第一个片段（通常是语言代码）
meta.segments[0]

// 检查路径深度
size(meta.segments) > 2 ? "deep" : "shallow"

// 检查是否位于管理区域
"admin" in meta.segments ? "admin mode" : "public mode"

// 如果参数未绑定，则使用路径片段
has(meta.params.lang) ? meta.params.lang : meta.segments[0]

// 检查是否为从右到左书写的语言
meta.locale == "ar-SA" || meta.locale == "he-IL" ? "rtl" : "ltr"

// 仅获取语言部分
meta.locale.split("-")[0]  // 不支持，请改用 meta.params.lang

meta.params.lang           // "ko"
meta.params.country        // "us"
meta.params.slug           // "welcome-post"
has(meta.params.category)  // true/false

documents.get("greeting", meta.params.lang)
documents.ref("airports").get(meta.params.code)

meta.segments[0]           // 第一个片段
meta.segments[1]           // 第二个片段
size(meta.segments)        // 片段数量
"products" in meta.segments  // 路径是否包含 "products"

meta.docId != null ? "editing" : "creating new"
meta.docId != null ? documents.get("article", meta.docId).status : "draft"

"Editing: " + meta.title
meta.title.contains("Draft") ? "work in progress" : "published"

// 传统写法
documents.get("airports", meta.params.code).name

// 使用 ref()，将 schema 与动态标识符分开
documents.ref("airports").get(meta.params.code).name

documents.get("schema", "identifier")       // 获取一个文档
documents.get("schema", "id").fieldName     // 获取特定字段
documents.find("schema")                    // 获取所有文档
documents.find("schema", { "where": {...}}) // 过滤查询
documents.ref("schema").get(identifier)     // 链式查询
documents.translated("schema", "id", "fr")  // 使用指定区域设置获取翻译

meta.locale          // "en-US"、"ar-SA" 等
meta.params.xyz      // 名为 "xyz" 的 URL 参数
meta.segments        // URL 路径数组，例如 ["articles", "intro"]
meta.segments[0]     // 第一个路径片段
meta.docId           // 当前文档 ID（或 null）
meta.title           // 当前文档标题
doc.fieldName        // 当前文档的字段值（编辑器上下文中）

// 比较
==  !=  <  <=  >  >=

// 逻辑
&&  ||  !

// 三元运算符（条件判断）
condition ? valueIfTrue : valueIfFalse

// 成员判断
"value" in listOrMap

size(list)                    // 统计项目数量
size(string)                  // 字符串长度
"text".startsWith("te")       // true
"text".endsWith("xt")         // true
"text".contains("ex")         // true
has(object.property)          // 检查属性是否存在
hasProperty(obj, "key")       // 检查对象是否包含键

// 未来：通过 MCP 调用外部服务
mcp.translate(meta.params.text, "en", meta.params.lang)
mcp.analyze(documents.get("article", meta.params.id).body)

// 未来：由 AI 驱动的内容生成
ai.summarize(documents.get("article", meta.params.id).body, 100)
ai.translate(meta.params.text, meta.params.targetLang)
ai.classify(meta.params.input, ["positive", "negative", "neutral"])

// 文章存储作者 ID，获取作者姓名
documents.get("author", documents.get("article", "intro").authorId).name

// 传统写法
documents.get("country", documents.get("airport", meta.params.code).countryCode).name

// 使用 ref()，当 schema 已知而标识符动态时更清晰
documents.ref("country").get(documents.get("airport", meta.params.code).countryCode).name

// 机场 → 国家 → 地区 → 大洲
documents.get("continent",
  documents.get("region",
    documents.get("country",
      documents.get("airport", meta.params.code).countryCode
    ).regionCode
  ).continentCode
).name

// 获取机场所在国家的本地化名称
documents.translated("country",
  documents.get("airport", meta.params.code).countryCode,
  meta.params.lang
).name

documents.get("author", documents.get("article", meta.params.slug).authorId).name

// 机场 → 国家 → 货币
documents.get("currency",
  documents.get("country",
    documents.get("airport", meta.params.code).countryCode
  ).currencyCode
).symbol

// 在产品文档中获取相关分类详情
documents.get("category", doc.categoryId).description

// 根据产品原产国计算运费
documents.get("shipping-rates", doc.originCountry).baseRate * doc.weight

documents.find("article", { "where": { "authorId": documents.get("article", meta.params.slug).authorId } })

documents.get("content-block", "hero-1").sourceType == "article"
  ? documents.get("article", documents.get("content-block", "hero-1").sourceId).headline
  : documents.get("product", documents.get("content-block", "hero-1").sourceId).name

{
  "name": "greeting",
  "fields": [
    { "name": "code", "type": "string", "required": true },
    { "name": "headline", "type": "string", "required": true },
    { "name": "subheadline", "type": "string" },
    { "name": "ctaText", "type": "string" },
    { "name": "ctaUrl", "type": "string" }
  ]
}

{
  "lang": "language"
}

// 标题
documents.get("greeting", meta.params.lang).headline

// 副标题
documents.get("greeting", meta.params.lang).subheadline

// CTA 文案
documents.get("greeting", meta.params.lang).ctaText

// CTA URL
documents.get("greeting", meta.params.lang).ctaUrl

// app/[...slug]/page.tsx
import ParametricRoutePage from 'cms-renderer/lib/renderer';
import { registry } from '@/lib/registry';
import { cmsConfig } from '@/lib/cms-config';

export const dynamic = 'force-static';

interface PageProps {
  params: Promise<{ slug: string[] }>;
}

export default async function Page({ params }: PageProps) {
  const { slug } = await params;

  return (
    <ParametricRoutePage
      registry={registry}
      apiKey={cmsConfig.apiKey}
      websiteId={cmsConfig.websiteId}
      cmsUrl={cmsConfig.cmsUrl}
      params={Promise.resolve({ slug })}
    />
  );
}

interface CelMeta {
  /** 当前区域设置代码，例如 'en-US' */
  locale: string;
  /** 从 URL 中提取的路由参数 */
  params: Record<string, string>;
  /** URL 路径片段 */
  segments: string[];
  /** 当前文档 ID（编辑现有文档时存在） */
  docId: string | null;
  /** 当前文档标题 */
  title: string;
}

模式： /{country}/{lang}/products
路径： /us/en/products

算法：
1. 将两者标准化（删除结尾斜杠）
2. 拆分为片段：["us", "en", "products"] 和 ["{country}", "{lang}", "products"]
3. 匹配片段数量（必须相等）
4. 对每一对片段：
   - 如果模式以 : 或 {} 开头，则提取为参数
   - 否则必须完全匹配
5. 返回：{ country: "us", lang: "en" }

// 简单绑定（使用 "code" 字段查询）
{ "lang": "language" }

// 详细绑定（自定义 slug 字段）
{
  "lang": {
    "schemaName": "language",
    "slugField": "code"
  },
  "slug": {
    "schemaName": "article",
    "slugField": "slug"
  }
}