简要介绍YAML基础常用语法
一、简介
YAML 语言的设计目标,就是方便人类读写。它实质上是一种通用的数据串行化格式。
基本语法规则
- 大小写敏感
- 使用缩进表示层级关系
- 缩进时不允许使用Tab键,只允许使用空格
- 缩进的空格数目不重要,只要相同层级的元素左侧对齐即可
- #代表单行注释
支持的数据结构
- 对象:键值对的集合
- 数组:一组按次序排列的值
- 纯量(scalars):单个的、不可再分的值
二、对象
对象的一组键值对,使用冒号结构表示。
1
animal: pets
三、数组
一组连词线开头的行,构成一个数组。
1
2
3
- Cat
- Dog
- Goldfish
四、嵌套
map和list的元素可以是另一个map或者list或者是纯量。由此出现4种常见的数据嵌套
1、map嵌套map
1
2
3
4
5
websites:
YAML: yaml.org
Ruby: ruby-lang.org
Python: python.org
Perl: use.perl.org
2、map嵌套list
1
2
3
4
5
languages:
- Ruby
- Perl
- Python
- c
3、list嵌套list
1
2
3
4
5
6
7
8
-
- Ruby
- Perl
- Python
-
- c
- c++
- java
4、list嵌套map
1
2
3
4
5
6
-
id: 1
name: huang
-
id: 2
name: liao
五、纯量
纯量是最基本的、不可再分的值。以下数据类型都属于 JavaScript 的纯量。
- 字符串
- 布尔值
- 整数
- 浮点数
- null
- 时间
- 日期
数值直接以字面量的形式表示
1
number: 12.30
布尔值用true和false表示
1
isSet: true
null用~表示
1
parent: ~
时间采用 ISO8601 格式
1
iso8601: 2001-12-14t21:59:43.10-05:00
日期采用复合 ISO8601 格式的年、月、日表示。
1
date: 1976-07-31
YAML 允许使用两个感叹号,强制转换数据类型
1
2
e: !!str 123
f: !!str true
六、字符串
字符串默认不使用引号表示
1
str: 这是一行字符串
如果字符串之中包含空格或特殊字符,需要放在引号之中
1
str: '内容: 字符串'
单引号和双引号都可以使用,双引号不会对特殊字符转义
1
2
s1: '内容\n字符串' #转换成JS后为\\n,即字符串\n
s2: "内容\n字符串" #转换成JS后仍为\n,即回车
单引号之中如果还有单引号,必须连续使用两个单引号转义
1
str: 'labor''s day'
字符串可以写成多行,从第二行开始,必须有一个单空格缩进;换行符会被转为空格
1
2
3
str: 这是一段
多行
字符串
多行字符串可以使用|保留换行符,也可以使用>折叠换行
1
2
3
4
5
6
this: |
Foo
Bar
that: >
Foo
Bar
+表示保留文字块末尾的换行,-表示删除字符串末尾的换行
1
2
3
4
5
6
7
8
9
10
s1: |
Foo
s2: |+
Foo
s3: |-
Foo
字符串之中可以插入 HTML 标记
1
2
3
4
5
message: |
<p style="color: red">
段落
</p>
七、引用
锚点&和别名*,可以用来引用
1
2
3
4
5
6
7
8
9
10
11
defaults: &defaults
adapter: postgres
host: localhost
development:
database: myapp_development
<<: *defaults
test:
database: myapp_test
<<: *defaults
等同于下面的代码
1
2
3
4
5
6
7
8
9
10
11
12
13
defaults:
adapter: postgres
host: localhost
development:
database: myapp_development
adapter: postgres
host: localhost
test:
database: myapp_test
adapter: postgres
host: localhost
&用来建立锚点(defaults),«表示合并到当前数据,*用来引用锚点
另一个例子
1
2
3
4
5
- &showell Steve
- Clark
- Brian
- Oren
- *showell
转为 JavaScript 代码如下
1
[ 'Steve', 'Clark', 'Brian', 'Oren', 'Steve' ]
八、链接
原文链接:
参考链接: