• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 渐变样式
2<!--Kit: ArkUI-->
3<!--Subsystem: ArkUI-->
4<!--Owner: @CCFFWW-->
5<!--Designer: @yangfan229-->
6<!--Tester: @lxl007-->
7<!--Adviser: @HelloCrease-->
8
9>  **说明：**
10>  从API version 4开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
11
12组件普遍支持在style或css中设置可以平稳过渡两个或多个指定的颜色。
13
14
15开发框架支持线性渐变 (linear-gradient)和重复线性渐变 (repeating-linear-gradient)两种渐变效果。
16
17
18## 线性渐变/重复线性渐变
19
20使用渐变样式，需要定义过渡方向和过渡颜色。
21
22
23### 过渡方向
24
25通过direction或者angle指定过渡方向。
26- direction：进行方向渐变。
27
28- angle：进行角度渐变。
29
30```
31background: linear-gradient(direction/angle, color, color, ...);
32background: repeating-linear-gradient(direction/angle, color, color, ...);
33```
34
35
36### 过渡颜色
37
38支持以下四种方式：\#ff0000、\#ffff0000、rgb(255, 0, 0)、rgba(255, 0, 0, 1)，需要指定至少两种颜色。
39
40**参数：**
41
42| 名称        | 类型                                       | 默认值                          | 必填   | 描述                                       |
43| --------- | ---------------------------------------- | ---------------------------- | ---- | ---------------------------------------- |
44| direction | to&nbsp;&lt;side-or-corner&gt;&nbsp;&nbsp;&lt;side-or-corner&gt;&nbsp;=&nbsp;[left&nbsp;\|&nbsp;right]&nbsp;\|&nbsp;[top&nbsp;\|&nbsp;bottom] | to&nbsp;bottom&nbsp;(由上到下渐变) | 否    | 指定过渡方向，如：to&nbsp;left&nbsp;(从右向左渐变)&nbsp;&nbsp;；或者<br/>to&nbsp;bottom&nbsp;right&nbsp;(从左上角到右下角)。 |
45| angle     | &lt;deg&gt;                              | 180deg                       | 否    | 指定过渡方向，以元素几何中心为坐标原点，水平方向为X轴，angle指定了渐变线与Y轴的夹角(顺时针方向)。 |
46| color     | &lt;color&gt;&nbsp;[&lt;length&gt;\|&lt;percentage&gt;] | -                            | 是    | 定义使用渐变样式区域内颜色的渐变效果。                      |
47
48**示例：**
491. 默认渐变方向为从上向下渐变。
50
51   ```css
52   #gradient {
53     height: 300px;
54     width: 600px;
55     /* 从顶部开始向底部由红色向绿色渐变 */
56     background: linear-gradient(red, #00ff00);
57   }
58   ```
59
60
61![zh-cn_image_0000001190934502](figures/zh-cn_image_0000001190934502.png)
62
632. 45度夹角渐变。
64
65   ```css
66   /* 45度夹角，从红色渐变到绿色 */
67     background: linear-gradient(45deg, rgb(255,0,0),rgb(0, 255, 0));
68   ```
69
70
71
72![zh-cn_image_0000001189854534](figures/zh-cn_image_0000001189854534.png)
73
743. 设置方向从左向右渐变。
75
76   ```css
77   /* 从左向右渐变，在距离左边90px和距离左边360px (600*0.6) 之间270px宽度形成渐变 */
78   background: linear-gradient(to right, rgb(255,0,0) 90px, rgb(0, 255, 0) 60%);
79   ```
80
81![zh-cn_image_0000001236694521](figures/zh-cn_image_0000001236694521.png)
82
834. 重复渐变。
84
85   ```css
86   /* 从左向右重复渐变，重复渐变区域30px（60-30）透明度0.5 */
87   background: repeating-linear-gradient(to right, rgba(255, 255, 0, 1) 30px,rgba(0, 0, 255, .5) 60px);
88   ```
89
90![zh-cn_image_0000001237134475](figures/zh-cn_image_0000001237134475.png)