From 5418cab76fec5c99acc9a4a3086e3dc4be9541ed Mon Sep 17 00:00:00 2001
From: jiajia_deng <2894220@gmail.com>
Date: Tue, 18 Jun 2019 13:45:22 +0800
Subject: [PATCH] [docs] Updated doc of global font
Signed-off-by: jiajia_deng <2894220@gmail.com>
---
bin/resources/themes/default/global.xml | 72 ++++++++-----------------
docs/GLOBAL.md | 12 +++--
2 files changed, 28 insertions(+), 56 deletions(-)
diff --git a/bin/resources/themes/default/global.xml b/bin/resources/themes/default/global.xml
index f2509721..a167f9ea 100644
--- a/bin/resources/themes/default/global.xml
+++ b/bin/resources/themes/default/global.xml
@@ -1,64 +1,36 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
-
+
+
+
+
+
+
+
+
+
+
+
+
-
-
-
-
-
-
+
+
+
@@ -184,9 +156,7 @@
-
+
-
-
\ No newline at end of file
diff --git a/docs/GLOBAL.md b/docs/GLOBAL.md
index 067cd77b..06dd5dee 100644
--- a/docs/GLOBAL.md
+++ b/docs/GLOBAL.md
@@ -7,24 +7,26 @@ Global 全局样式提供了通用的样式列表,避免在多个不同的 XML
## 字体(Font)
-如果你想添加一个字体,则在 `global.xml` 中添加如下代码,程序启动后会根据字体位置顺序依次给字体进行编号,排在第一位的字体编号为 0,第二位的为 1,依次递增。
+如果你想添加一个字体,则在 `global.xml` 中添加如下代码,程序启动后会加载所有字体列表到缓存中,以 ID 作为区分(注意,老版本没有 ID 属性,缓存时是根据字体的顺序依次编号放入内存中,一旦指定了 ID 属性,索引将不再生效!)。
```xml
-
+
```
-当需要使用时,指定字体的编号即可。比如你希望一个 Button 按钮使用第 2 号字体,可以这样写:
+当需要使用时,指定字体的编号即可。比如你希望一个 Button 按钮使用 ID 为 system_12 的字体,可以这样写:
```xml
-
+
```
### Font 所有可用属性
| 属性名称 | 默认值 | 参数类型 | 用途 |
| :--- | :--- | :--- | :--- |
-| name | | STRING | 字体名称 |
+| id | | STRING | 字体ID(一旦使用 ID 属性,字体索引将不再生效) |
+| default | false | STRING | 是否是默认字体,如果未给控件指定字体,则使用该字体 |
+| name | | STRING | 字体在系统中的名称 |
| size | 12 | INT | 字体大小 |
| bold | false | BOOL | 是否粗体 |
| underline | false | BOOL | 是否下划线 |