YAML语法

YAML

Playground：YAML - JavaScript parser

语法特点

• 大小写敏感
• 用空格缩进表示层级关系
• 缩进只能用 space，不能用 tab
• 缩进几格不重要，同一层级缩进必须相同
• '' 单引号会对内部的特殊符号进行转义，"" 双引号不会
• # 表示注释
• 文档开头用 --- 表示开始
• 文档结束用 ... 表示结束

数据结构

mapping

对象用冒号结构表示一对键值对：

animal: pet
tree: !!map
  willow: true
  cypress: true

{
    animal: 'pet',
    tree: { willow: true, cypress: true }
}

sequence

一组开头是连词线的行：

color: !!seq
 - blue
 - yellow
 - pink

{
    color: ['blue', 'yellow', 'pink']
}

scalars

纯量指单个的、不可再分的值：

• 字符串可以直接写，也可以用单/双引号
• 数值以字面量形式表示
• 布尔值 true 和 false
• null 用 ~ 表示
• 时间可以用 yyyy-MM-dd hh:mm:ss +Z 来表示，其中 Z 表示时区的数字，例如 8 表示这个是东八区时间
• 日期用 yyyy-MM-dd 表示

string: "12"
number: 12.11
infinity: .inf
negativeInfinity: -.inf
octal: 014
hexadecimal: 0xc
boolean: true
null: ~
undefined: !!js/undefined ~
time: 2020-10-29 00:00:00 +8

{
    string: "12",
    number: 12.11,
    infinity: Infinity,
    negativeInfinity: -Infinity,
    octal: 12,
    hexadecimal: 12,
    boolean: true,
    null: null,
    undefined: undefined,
    time: Thu Oct 29 2020 00:00:00 GMT+0800 (中国标准时间)
}

强制转换

!! 表示强制类型转换，常见的有：

• map
• omap：有序 mapping（字典）
• seq
• pairs：键值对以 [key, value] 形式存储的 sequence
• js/undefined：js 的 undefined

pairs: !!pairs
 - foo: ofoo
 - bar: obar

{
  pairs: [
    ["foo", "ofoo"],
    ["bar", "obar"]
  ]
}

• set：值为 null 的一个 mapping：

set: !!set
 ? foo
 ? bar

{
  foo: null,
  bar: null
}

变量引用

& 作为一个锚点引用变量，* 可以引用，<< 表示合并数据（如果有同名，后面的声明会覆盖前面的）：

merge: &merge
 - &Center { x: 1, y: 2 }
 - &Left { x: 0, y: 3 }
foo: *merge
bar:
  <<: *Left
  y: 10

{
  merge: [
    { x: 1, y: 2 },
    { x: 0, y: 3 }
  ],
  foo: [
    { x: 1, y: 2 },
    { x: 0, y: 3 }
  ],
  bar: { x: 0, y: 10 }
}