• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# SymbolGlyph
2
3显示图标小符号的组件。<!--RP1--><!--RP1End-->
4
5>  **说明:**
6>
7>  该组件从API Version 11开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
8
9## 子组件
10
11不支持子组件。
12
13## 接口
14
15SymbolGlyph(value?: Resource)
16
17**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
18
19**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
20
21**系统能力:** SystemCapability.ArkUI.ArkUI.Full
22
23**参数:**
24
25| 参数名 | 类型 | 必填 | 说明 |
26| -------- | -------- | -------- | -------- |
27| value | [Resource](ts-types.md#resource)| 否 | SymbolGlyph组件的资源名,如 $r('sys.symbol.ohos_wifi')。 |
28
29>  **说明:**
30>
31>  $r('sys.symbol.ohos_wifi')中引用的资源为系统预置,SymbolGlyph仅支持系统预置的symbol资源名,引用非symbol资源将显示异常。
32
33## 属性
34
35支持[通用属性](ts-component-general-attributes.md),不支持文本通用属性,仅支持以下特有属性:
36
37### fontColor
38
39fontColor(value: Array&lt;ResourceColor&gt;)
40
41设置SymbolGlyph组件颜色。
42
43**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
44
45**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
46
47**系统能力:** SystemCapability.ArkUI.ArkUI.Full
48
49**参数:**
50
51| 参数名 | 类型 | 必填 | 说明  |
52| ------ | ---- | ---- | ----- |
53| value  | Array\<[ResourceColor](ts-types.md#resourcecolor)\> | 是   | SymbolGlyph组件颜色。<br/> 默认值:不同渲染策略下默认值不同。 |
54
55### fontSize
56
57fontSize(value: number | string | Resource)
58
59设置SymbolGlyph组件大小。设置string类型时,支持number类型取值的字符串形式,可以附带单位,例如"10"、"10fp"。
60
61组件的图标显示大小由fontSize控制,设置width或height后,其他通用属性仅对组件的占位大小生效。
62
63**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
64
65**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
66
67**系统能力:** SystemCapability.ArkUI.ArkUI.Full
68
69**参数:**
70
71| 参数名 | 类型 | 必填 | 说明  |
72| ------ | ---- | ---- | ----- |
73| value  | number&nbsp;\|&nbsp;string&nbsp;\|&nbsp;[Resource](ts-types.md#resource) | 是   | SymbolGlyph组件大小。<br/>默认值:16fp<br/>单位:fp<br/>不支持设置百分比字符串。|
74
75### fontWeight
76
77fontWeight(value: number | FontWeight | string)
78
79设置SymbolGlyph组件粗细。number类型取值[100,900],取值间隔为100,默认为400,取值越大,字体越粗。string类型仅支持number类型取值的字符串形式,例如“400”,以及“bold”、“bolder”、“lighter”、“regular” 、“medium”分别对应FontWeight中相应的枚举值。
80
81sys.symbol.ohos_lungs图标不支持设置fontWeight。
82
83**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
84
85**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
86
87**系统能力:** SystemCapability.ArkUI.ArkUI.Full
88
89**参数:**
90
91| 参数名 | 类型                                                         | 必填 | 说明                                                |
92| ------ | ------------------------------------------------------------ | ---- | --------------------------------------------------- |
93| value  | number&nbsp;\|&nbsp;[FontWeight](ts-appendix-enums.md#fontweight)&nbsp;\|&nbsp;string | 是   | SymbolGlyph组件粗细。<br/>默认值:FontWeight.Normal |
94
95### renderingStrategy
96
97renderingStrategy(value: SymbolRenderingStrategy)
98
99设置SymbolGlyph组件渲染策略。
100
101**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
102
103**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
104
105**系统能力:** SystemCapability.ArkUI.ArkUI.Full
106
107**参数:**
108
109| 参数名 | 类型 | 必填 | 说明  |
110| ------ | ---- | ---- | ----- |
111| value  | [SymbolRenderingStrategy](#symbolrenderingstrategy11枚举说明) | 是   | SymbolGlyph组件渲染策略。<br/>默认值:SymbolRenderingStrategy.SINGLE |
112
113不同渲染策略效果可参考以下示意图。
114
115![renderingStrategy](figures/renderingStrategy.png)
116
117### effectStrategy
118
119effectStrategy(value: SymbolEffectStrategy)
120
121设置SymbolGlyph组件动效策略。
122
123**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
124
125**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
126
127**系统能力:** SystemCapability.ArkUI.ArkUI.Full
128
129**参数:**
130
131| 参数名 | 类型 | 必填 | 说明  |
132| ------ | ---- | ---- | ----- |
133| value  | [SymbolEffectStrategy](#symboleffectstrategy11枚举说明) | 是   | SymbolGlyph组件动效策略。<br/>默认值:SymbolEffectStrategy.NONE |
134
135### symbolEffect<sup>12+</sup>
136
137symbolEffect(symbolEffect: SymbolEffect, isActive?: boolean)
138
139设置SymbolGlyph组件动效策略及播放状态。
140
141**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
142
143**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
144
145**系统能力:** SystemCapability.ArkUI.ArkUI.Full
146
147**参数:**
148
149| 参数名 | 类型 | 必填 | 说明  |
150| ------ | ---- | ---- | ----- |
151| symbolEffect  | [SymbolEffect](#symboleffect12对象说明) | 是   | SymbolGlyph组件动效策略。<br/>默认值:[SymbolEffect](#symboleffect12对象说明) |
152| isActive  | boolean | 否   | SymbolGlyph组件动效播放状态。<br/>true表示播放,false表示不播放。<br/>默认值:false |
153
154### symbolEffect<sup>12+</sup>
155
156symbolEffect(symbolEffect: SymbolEffect, triggerValue?: number)
157
158设置SymbolGlyph组件动效策略及播放触发器。
159
160**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
161
162**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
163
164**系统能力:** SystemCapability.ArkUI.ArkUI.Full
165
166**参数:**
167
168| 参数名 | 类型 | 必填 | 说明  |
169| ------ | ---- | ---- | ----- |
170| symbolEffect | [SymbolEffect](#symboleffect12对象说明) | 是   | SymbolGlyph组件动效策略。<br/>默认值:[SymbolEffect](#symboleffect12对象说明) |
171| triggerValue | number | 否   | SymbolGlyph组件动效播放触发器,在数值变更时触发动效。<br/>如果首次不希望触发动效,设置-1。 |
172
173>  **说明:**
174>
175>  动效属性,仅支持使用effectStrategy属性或单个symbolEffect属性,不支持多种动效属性混合使用。
176
177### minFontScale<sup>18+</sup>
178
179minFontScale(scale: Optional\<number | Resource>)
180
181设置SymbolGlyph组件最小的字体缩放倍数。
182
183**原子化服务API:** 从API version 18开始,该接口支持在原子化服务中使用。
184
185**系统能力:** SystemCapability.ArkUI.ArkUI.Full
186
187**参数:**
188
189| 参数名 | 类型 | 必填 | 说明  |
190| ------ | ---- | ---- | ----- |
191| scale  |[Optional](ts-universal-attributes-custom-property.md#optional12)\<number&nbsp;\|&nbsp;[Resource](ts-types.md#resource)>  | 是   | SymbolGlyph组件最小的字体缩放倍数。<br/>取值范围:[0, 1] <br/>设置为0,缩放最小。<br/>**说明:** <br/>设置的值小于0时,按值为0处理。设置的值大于1,按值为1处理。异常值默认不生效。   |
192
193### maxFontScale<sup>18+</sup>
194
195maxFontScale(scale: Optional\<number | Resource>)
196
197设置SymbolGlyph组件最大的字体缩放倍数。
198
199**原子化服务API:** 从API version 18开始,该接口支持在原子化服务中使用。
200
201**系统能力:** SystemCapability.ArkUI.ArkUI.Full
202
203**参数:**
204
205| 参数名 | 类型 | 必填 | 说明  |
206| ------ | ---- | ---- | ----- |
207| scale  |[Optional](ts-universal-attributes-custom-property.md#optional12)\<number&nbsp;\|&nbsp;[Resource](ts-types.md#resource)>  | 是   | SymbolGlyph组件最大的字体缩放倍数。<br/>取值范围:[1, +∞)<br/>**说明:** <br/>设置的值小于1时,按值为1处理,异常值默认不生效。 |
208
209## ScaleSymbolEffect<sup>12+</sup>
210
211ScaleSymbolEffect继承自父类SymbolEffect。
212
213**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
214
215**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
216
217**系统能力:** SystemCapability.ArkUI.ArkUI.Full
218
219### 属性
220
221| 名称 | 类型 | 必填 | 说明  |
222| ---- | ---- | ---- | ---- |
223| scope     | [EffectScope](#effectscope12枚举说明)  |  否   | 动效范围。<br/>默认值:EffectScope.LAYER    |
224| direction | [EffectDirection](#effectdirection12枚举说明) |  否   | 动效方向。<br/>默认值:EffectDirection.DOWN |
225
226### constructor<sup>12+</sup>
227
228constructor(scope?: EffectScope, direction?: EffectDirection)
229
230ScaleSymbolEffect的构造函数,缩放动效。
231
232**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
233
234**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
235
236**系统能力:** SystemCapability.ArkUI.ArkUI.Full
237
238**参数:**
239
240| 参数名 | 类型 | 必填 | 说明  |
241| ---- | ---- | ---- | ---- |
242| scope     | [EffectScope](#effectscope12枚举说明)         | 否   | 动效范围。<br/>默认值:EffectScope.LAYER    |
243| direction | [EffectDirection](#effectdirection12枚举说明) | 否   | 动效方向。<br/>默认值:EffectDirection.DOWN |
244
245## HierarchicalSymbolEffect<sup>12+</sup>
246
247HierarchicalSymbolEffect继承自父类SymbolEffect。
248
249**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
250
251**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
252
253**系统能力:** SystemCapability.ArkUI.ArkUI.Full
254
255### 属性
256
257| 名称 | 类型 | 必填 | 说明  |
258| ---- | ---- | ---- | ---- |
259| fillStyle | [EffectFillStyle](#effectfillstyle12枚举说明) | 否   | 动效模式。<br/>默认值:EffectFillStyle.CUMULATIVE |
260
261### constructor<sup>12+</sup>
262
263constructor(fillStyle?: EffectFillStyle)
264
265HierarchicalSymbolEffect的构造函数,层级动效。
266
267**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
268
269**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
270
271**系统能力:** SystemCapability.ArkUI.ArkUI.Full
272
273**参数:**
274
275| 参数名 | 类型 | 必填 | 说明  |
276| ---- | ---- | ---- | ---- |
277| fillStyle | [EffectFillStyle](#effectfillstyle12枚举说明) | 否   | 动效模式。<br/>默认值:EffectFillStyle.CUMULATIVE |
278
279## AppearSymbolEffect<sup>12+</sup>
280
281AppearSymbolEffect继承自父类SymbolEffect。
282
283**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
284
285**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
286
287**系统能力:** SystemCapability.ArkUI.ArkUI.Full
288
289### 属性
290
291| 名称 | 类型 | 必填 | 说明  |
292| ---- | ---- | ---- | ---- |
293| scope | [EffectScope](#effectscope12枚举说明) | 否   | 动效范围。<br/>默认值:EffectScope.LAYER |
294
295### constructor<sup>12+</sup>
296
297constructor(scope?: EffectScope)
298
299AppearSymbolEffect的构造函数,出现动效。
300
301**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
302
303**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
304
305**系统能力:** SystemCapability.ArkUI.ArkUI.Full
306
307**参数:**
308
309| 参数名 | 类型 | 必填 | 说明  |
310| ---- | ---- | ---- | ---- |
311| scope  | [EffectScope](#effectscope12枚举说明) | 否   | 动效范围。<br/>默认值:EffectScope.LAYER |
312
313## DisappearSymbolEffect<sup>12+</sup>
314
315DisappearSymbolEffect继承自父类SymbolEffect。
316
317**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
318
319**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
320
321**系统能力:** SystemCapability.ArkUI.ArkUI.Full
322
323### 属性
324
325| 名称 | 类型 | 必填 | 说明  |
326| ---- | ---- | ---- | ---- |
327| scope | [EffectScope](#effectscope12枚举说明) | 否   | 动效范围。<br/>默认值:EffectScope.LAYER |
328
329### constructor<sup>12+</sup>
330
331constructor(scope?: EffectScope)
332
333DisappearSymbolEffect的构造函数,消失动效。
334
335**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
336
337**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
338
339**系统能力:** SystemCapability.ArkUI.ArkUI.Full
340
341**参数:**
342
343| 参数名 | 类型 | 必填 | 说明  |
344| ---- | ---- | ---- | ---- |
345| scope  | [EffectScope](#effectscope12枚举说明) | 否   | 动效范围。<br/>默认值:EffectScope.LAYER |
346
347## BounceSymbolEffect<sup>12+</sup>
348
349BounceSymbolEffect继承自父类SymbolEffect。
350
351**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
352
353**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
354
355**系统能力:** SystemCapability.ArkUI.ArkUI.Full
356
357### 属性
358
359| 名称 | 类型 | 必填 | 说明  |
360| ---- | ---- | ---- | ---- |
361| scope     | [EffectScope](#effectscope12枚举说明)         | 否   | 动效范围。<br/>默认值:EffectScope.LAYER    |
362| direction | [EffectDirection](#effectdirection12枚举说明) | 否   | 动效方向。<br/>默认值:EffectDirection.DOWN |
363
364### constructor<sup>12+</sup>
365
366constructor(scope?: EffectScope, direction?: EffectDirection)
367
368BounceSymbolEffect的构造函数,弹跳动效。
369
370**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
371
372**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
373
374**系统能力:** SystemCapability.ArkUI.ArkUI.Full
375
376**参数:**
377
378| 参数名 | 类型 | 必填 | 说明  |
379| ---- | ---- | ---- | ---- |
380| scope     | [EffectScope](#effectscope12枚举说明)         | 否   | 动效范围。<br/>默认值:EffectScope.LAYER    |
381| direction | [EffectDirection](#effectdirection12枚举说明) | 否   | 动效方向。<br/>默认值:EffectDirection.DOWN |
382
383## ReplaceSymbolEffect<sup>12+</sup>
384
385ReplaceSymbolEffect继承自父类SymbolEffect。
386
387**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
388
389**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
390
391**系统能力:** SystemCapability.ArkUI.ArkUI.Full
392
393### 属性
394
395| 名称 | 类型 | 必填 | 说明  |
396| ---- | ---- | ---- | ---- |
397| scope | [EffectScope](#effectscope12枚举说明) | 否   | 动效范围。<br/>默认值:EffectScope.LAYER |
398
399### constructor<sup>12+</sup>
400
401constructor(scope?: EffectScope)
402
403ReplaceSymbolEffect的构造函数,替换动效。
404
405**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
406
407**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
408
409**系统能力:** SystemCapability.ArkUI.ArkUI.Full
410
411**参数:**
412
413| 参数名 | 类型 | 必填 | 说明  |
414| ---- | ---- | ---- | ---- |
415| scope  | [EffectScope](#effectscope12枚举说明) | 否   | 动效范围。<br/>默认值:EffectScope.LAYER |
416
417## SymbolEffectStrategy<sup>11+</sup>枚举说明
418
419动效类型的枚举值。设置动效后,动效启动即生效,无需触发。
420
421**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
422
423**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
424
425**系统能力:** SystemCapability.ArkUI.ArkUI.Full
426
427| 名称     | 值 | 说明                          |
428| ------ | --- | ----------------------------- |
429| NONE | 0 | 无动效(默认值)。 |
430| SCALE | 1 | 整体缩放动效。                 |
431|  HIERARCHICAL  | 2 | 层级动效。  |
432
433## SymbolRenderingStrategy<sup>11+</sup>枚举说明
434
435渲染模式的枚举值。
436
437**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
438
439**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
440
441**系统能力:** SystemCapability.ArkUI.ArkUI.Full
442
443| 名称     | 值 | 说明                          |
444| ------ | --- | ----------------------------- |
445| SINGLE  | 0 | 单色模式(默认值)。<br/> 可以设置一个或者多个颜色,默认为黑色。<br/> 当设置多个颜色时,仅生效第一个颜色。 |
446| MULTIPLE_COLOR  | 1 | 多色模式。<br/> 最多可以设置三个颜色。当只设置一个颜色时,修改symbol图标的第一层颜色,其他颜色保持默认颜色。<br/> 颜色设置顺序与图标分层顺序匹配,当颜色数量大于图标分层时,多余的颜色不生效。<br/> 仅支持设置颜色,设置透明度设置不生效。|
447|  MULTIPLE_OPACITY   | 2 | 分层模式。<br/> 默认为黑色,可以设置一个或者多个颜色。当设置多个颜色时,仅生效第一个颜色。<br/>不透明度与图层相关,symbol图标的第一层透明度为100%、第二层透明度为50%、第三层透明度为20%。  |
448
449## SymbolEffect<sup>12+</sup>对象说明
450
451定义SymbolEffect类。
452
453**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
454
455**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
456
457**系统能力:** SystemCapability.ArkUI.ArkUI.Full
458
459## PulseSymbolEffect<sup>12+</sup>对象说明
460
461PulseSymbolEffect的构造函数,脉冲动效。
462
463**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
464
465**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
466
467**系统能力:** SystemCapability.ArkUI.ArkUI.Full
468
469## EffectDirection<sup>12+</sup>枚举说明
470
471**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
472
473**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
474
475**系统能力:** SystemCapability.ArkUI.ArkUI.Full
476
477| 名称 | 值   | 说明             |
478| ---- | ---- | ---------------- |
479| DOWN | 0    | 图标缩小再复原。 |
480| UP   | 1    | 图标放大再复原。 |
481
482## EffectScope<sup>12+</sup>枚举说明
483
484**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
485
486**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
487
488**系统能力:** SystemCapability.ArkUI.ArkUI.Full
489
490| 名称  | 值   | 说明       |
491| ----- | ---- | ---------- |
492| LAYER | 0    | 分层模式。 |
493| WHOLE | 1    | 整体模式。 |
494
495## EffectFillStyle<sup>12+</sup>枚举说明
496
497**卡片能力:** 从API version 12开始,该接口支持在ArkTS卡片中使用。
498
499**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
500
501**系统能力:** SystemCapability.ArkUI.ArkUI.Full
502
503| 名称       | 值   | 说明       |
504| ---------- | ---- | ---------- |
505| CUMULATIVE | 0    | 累加模式。 |
506| ITERATIVE  | 1    | 迭代模式。 |
507
508## 事件
509
510支持[通用事件](ts-component-general-events.md)。
511
512## 示例
513
514###  示例1(设置渲染和动效策略)
515
516该示例通过renderingStrategy、effectStrategy属性展示了不同的渲染和动效策略。
517
518```ts
519// xxx.ets
520@Entry
521@Component
522struct Index {
523  build() {
524    Column() {
525      Row() {
526        Column() {
527          Text("Light")
528          SymbolGlyph($r('sys.symbol.ohos_trash'))
529            .fontWeight(FontWeight.Lighter)
530            .fontSize(96)
531        }
532
533        Column() {
534          Text("Normal")
535          SymbolGlyph($r('sys.symbol.ohos_trash'))
536            .fontWeight(FontWeight.Normal)
537            .fontSize(96)
538        }
539
540        Column() {
541          Text("Bold")
542          SymbolGlyph($r('sys.symbol.ohos_trash'))
543            .fontWeight(FontWeight.Bold)
544            .fontSize(96)
545        }
546      }
547
548      Row() {
549        Column() {
550          Text("单色")
551          SymbolGlyph($r('sys.symbol.ohos_folder_badge_plus'))
552            .fontSize(96)
553            .renderingStrategy(SymbolRenderingStrategy.SINGLE)
554            .fontColor([Color.Black, Color.Green, Color.White])
555        }
556
557        Column() {
558          Text("多色")
559          SymbolGlyph($r('sys.symbol.ohos_folder_badge_plus'))
560            .fontSize(96)
561            .renderingStrategy(SymbolRenderingStrategy.MULTIPLE_COLOR)
562            .fontColor([Color.Black, Color.Green, Color.White])
563        }
564
565        Column() {
566          Text("分层")
567          SymbolGlyph($r('sys.symbol.ohos_folder_badge_plus'))
568            .fontSize(96)
569            .renderingStrategy(SymbolRenderingStrategy.MULTIPLE_OPACITY)
570            .fontColor([Color.Black, Color.Green, Color.White])
571        }
572      }
573
574      Row() {
575        Column() {
576          Text("无动效")
577          SymbolGlyph($r('sys.symbol.ohos_wifi'))
578            .fontSize(96)
579            .effectStrategy(SymbolEffectStrategy.NONE)
580        }
581
582        Column() {
583          Text("整体缩放动效")
584          SymbolGlyph($r('sys.symbol.ohos_wifi'))
585            .fontSize(96)
586            .effectStrategy(1)
587        }
588
589        Column() {
590          Text("层级动效")
591          SymbolGlyph($r('sys.symbol.ohos_wifi'))
592            .fontSize(96)
593            .effectStrategy(2)
594        }
595      }
596    }
597  }
598}
599```
600![symbol](figures/symbolGlyph.gif)
601
602###  示例2(设置动效)
603
604该示例通过symbolEffect属性展示了可变颜色动效和替换动效的效果。
605
606```ts
607// xxx.ets
608@Entry
609@Component
610struct Index {
611  @State isActive: boolean = true;
612  @State triggerValueReplace: number = 0;
613  replaceFlag: boolean = true;
614
615  build() {
616    Column() {
617      Row() {
618        Column() {
619          Text("可变颜色动效")
620          SymbolGlyph($r('sys.symbol.ohos_wifi'))
621            .fontSize(96)
622            .symbolEffect(new HierarchicalSymbolEffect(EffectFillStyle.ITERATIVE), this.isActive)
623          Button(this.isActive ? '关闭' : '播放').onClick(() => {
624            this.isActive = !this.isActive;
625          })
626        }.margin({ right: 20 })
627
628        Column() {
629          Text("替换动效")
630          SymbolGlyph(this.replaceFlag ? $r('sys.symbol.checkmark_circle') : $r('sys.symbol.repeat_1'))
631            .fontSize(96)
632            .symbolEffect(new ReplaceSymbolEffect(EffectScope.WHOLE), this.triggerValueReplace)
633          Button('trigger').onClick(() => {
634            this.replaceFlag = !this.replaceFlag;
635            this.triggerValueReplace = this.triggerValueReplace + 1;
636          })
637        }
638      }
639    }.margin({
640      left: 30,
641      top: 50
642    })
643  }
644}
645```
646![symbol](figures/symbolGlyph_symbolEffect.gif)