# CSS 方法
## var
### 兼容性
Web: 4.0; 微信小程序: 4.41; Android: 4.0; iOS: 4.11; HarmonyOS: 4.61
> uni-app x 4.0+ 提供内置 CSS 变量。
> uni-app x 4.52+ 全平台提供了安全区域相关 CSS 变量 --uni-safe-area-inset-* 。
> uni-app x 4.71+ App平台补充了自定义css变量
> uni-app x 5.25+ App平台 蒸汽模式 useComputedStyle 支持 css 变量。同时基于useComputedStyle的input、textarea、loading也支持了css变量
### 预置的 CSS 变量 @preset-var
- `--status-bar-height`的使用场景:当设置pages.json中的 `"navigationStyle":"custom"` 取消原生导航栏后,由于窗体为沉浸式,占据了状态栏位置。此时可以使用一个高度为 `var(--status-bar-height)` 的 view 放在页面顶部,避免页面内容出现在状态栏上。App平台自4.61版本开始自动响应状态栏高度的变化动态调整页面布局
- `--uni-safe-area-inset-xxx` 的使用场景:
1. `--uni-safe-area-inset-xxx`为安全区域边界到`position: fixed;`定位相对的区域边界距离。其中安全区域已规避LeftWindow、TopWindow、RightWindow、NavigationBar、TabBar。
2. 在 App 和 小程序 平台,pages.json中配置的导航栏和tabbar是原生的,页面内容只能在这个区域中间。而在 Web 端,不存在原生导航栏和 tabBar,由前端 view 模拟,所以页面内容如果使用绝对定位的话,就会和 Web 平台的导航栏、tabbar重叠。为了避免重叠,可以使用`--uni-safe-area-inset-xxx`系列css变量来设置位置。例如,在有tabbar页面的需要设置了一个固定位置的居底 view,如果单纯的在css中设置 bottom 为 0 ,那么在小程序和 App 端是在 tabBar 上方,但在 Web 端会与 tabBar 重叠。此时可设置 bottom 为 css变量 `--uni-safe-area-inset-bottom`,不管在哪个端,都是固定在 tabBar 上方。因为该值在 Web 平台,会自动避让导航栏高度。
3. Web 平台有 LeftWindow 、TopWindow、RightWindow 等宽屏适配时的页面,绝对定位时也需要避让,避免把内容显示在其他页面上。`--uni-safe-area-inset-xxx` 系列css变量也已经内部自动处理各种Window。
4. 除了兼容处理导航栏和tabbar、兼容LeftWindow等宽屏Window之外,`--uni-safe-area-inset-xxx` 系列css变量,还兼容了手机屏幕的安全区,避让了底部手势横条、摄像头挖孔区等。确保使用了本系列变量的内容不会和屏幕上这些内容重叠。
- `--window-top` 和 `--window-bottom` 已经废弃,推荐使用 `--uni-safe-area-inset-top` 和 `--uni-safe-area-inset-bottom` 替代。废弃原因是:
1. 这2个css变量仅处理了导航栏和tabbar,未处理LeftWindow等Window、未处理手机屏幕的底部手势横条和摄像头挖孔区等内容。
2. 这2个css变量未包含left、right,宽屏适配和横屏时无法友好兼容
3. 这2个css变量的命名未包含 `uni` 前缀,容易和开发者的代码中的自定义css变量命名冲突。
- 小程序平台目前支持 `--status-bar-height` 和 `--uni-safe-area-inset-bottom`,其他css变量均为0px。
### 自定义 CSS 变量 @customvar
> HBuilderX4.71起 App平台支持自定义变量
CSS自定义变量规范参考[MDN Reference](https://developer.mozilla.org/zh-CN/docs/Web/CSS/--*)
**注意:**
App平台相比web平台,有以下差异:
- 定义变量时不支持值为var(--*) ex: --color: var(--color)
- 回退值不支持var(--*) ex: --height: var(--height1 , var(--height2))
- App平台蒸汽模式的部分组件使用了useComputedStyle,这类组件的样式支持CSS变量需HBuilderX 5.25+,包括input、textarea、loading组件的class。
- App平台不支持:root伪类。蒸汽模式可以使用page选择器替代。vdom模式需要自行在页面根元素或合适的父级元素的class中定义css变量,以便在子元素生效。
App平台 VDOM模式注意事项:
- App平台 VDOM模式简写属性(如padding、margin等)不支持使用var,比如:--padding: 10px 20px; padding: var(--padding);。需展开后使用,比如展开成padding-left。
- App平台 VDOM模式transtion暂不支持使用var。App平台 蒸汽模式仅transtion长写属性支持var
- App平台 VDOM模式的部分组件的样式不支持CSS变量:input、textarea 的 placeholder-style、placeholder-class;picker-view 的 indicator-style、indicator-class、mask-style、mask-class。
### 示例
示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/CSS/variable/variable.uvue),与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/CSS/variable/variable.uvue)
::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/CSS/variable/variable
> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/CSS/variable/variable
>示例
```vue
通过var(--status-bar-height)获取状态栏高度
通过uni.getWindowInfo获取状态栏高度
通过this.$page.statusBarHeight获取状态栏高度
window top
window bottom
height:var(--uni-safe-area-inset-top)
height:var(--uni-safe-area-inset-left)
height:var(--uni-safe-area-inset-right)
height:var(--uni-safe-area-inset-bottom)
此区域应显示在安全区域内
```
:::
## env @env
内置 CSS 环境变量,即`env()`。
**注意:**\
env()主要用于在App平台补齐 web 规范。但浏览器的env不会考虑 uni-app x 的pages.json中配置的顶部导航栏和底部tabbar。\
所以实际开发中处理安全区时,更推荐使用本文档上方的 [--uni-safe-area-inset-xxx 系列css变量](#var)。
### 语法
```css
/* Using the four safe area inset values with no fallback values */
env(safe-area-inset-top);
env(safe-area-inset-right);
env(safe-area-inset-bottom);
env(safe-area-inset-left);
/* Using them with fallback values */
env(safe-area-inset-top, 20px);
env(safe-area-inset-right, 20px);
env(safe-area-inset-bottom, 20px);
env(safe-area-inset-left, 20px);
```
### uni-app x 兼容性
#### app平台
> app平台的 CSS 环境变量是页面相关的,即根据 uvue 页面原生导航栏和tabBar的配置自动计算。
app平台仅以下CSS属性支持使用环境变量
- padding (不支持缩写,只支持展开值,明确到具体方向,比如 padding-left)
- margin(不支持缩写,只支持展开值,明确到具体方向,比如 margin-left)
- width
- height
- top
- right
- bottom
- left
#### web平台
web平台的 CSS环境变量是应用全局值,由浏览器自动计算,与 uvue 页面无关,无法干预处理对导航栏、tabbar、leftWindow、TopWindow的兼容支持。所以不推荐使用。建议使用跨端的`--uni-safe-area-inset-xxx` 系列css变量。
web平台的 CSS环境变量规范参考[MDN Reference](https://developer.mozilla.org/zh-CN/docs/Web/CSS/env)
### 示例
示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/CSS/function/function.uvue),与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/CSS/function/function.uvue)
::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/CSS/function/function
> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/CSS/function/function
>示例
```vue
我在状态栏下边
此页面使用env()函数适配安全区域,仅在app平台生效。
safe-area-inset-top: {{safeareaInsetTop}}px
safe-area-inset-left: {{safeareaInsetLeft}}px
safe-area-inset-right: {{safeareaInsetRight}}px
safe-area-inset-bottom: {{safeareaInsetBottom}}px
我在导航栏上边
```
:::
## rgb
根据红色、绿色和蓝色值创建颜色。
### 兼容性
Web: 4.0; 微信小程序: 4.41; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61
### 示例
示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/CSS/function/rgb.uvue),与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/CSS/function/rgb.uvue)
::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/CSS/function/rgb/
> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/CSS/function/rgb
>示例
```vue
RGB 是一种颜色表示方法,通过调整红(Red)、绿(Green)、蓝(Blue)三个通道的值(0-255)来产生不同的颜色。
数值表示 (0-255)
红色
rgb(255, 0, 0)
绿色
rgb(0, 255, 0)
蓝色
rgb(0, 0, 255)
黄色
rgb(255, 255, 0)
品红
rgb(255, 0, 255)
青色
rgb(0, 255, 255)
```
:::
## rgba
根据红色、绿色、蓝色和 alpha 值创建颜色。
### 兼容性
Web: 4.0; 微信小程序: 4.41; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61
### 示例
示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/CSS/function/rgba.uvue),与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/CSS/function/rgba.uvue)
::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/CSS/function/rgba/
> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/CSS/function/rgba
>示例
```vue
RGBA 在 RGB 的基础上增加了透明度(Alpha)通道,取值范围为 0-1,0 表示完全透明,1 表示完全不透明。
数值表示 (RGB: 0-255, A: 0-1)
红色 10% 透明
rgba(255, 0, 0, 0.1)
红色 50% 透明
rgba(255, 0, 0, 0.5)
红色 不透明
rgba(255, 0, 0, 1)
蓝色 10% 透明
rgba(0, 0, 255, 0.1)
蓝色 50% 透明
rgba(0, 0, 255, 0.5)
蓝色 不透明
rgba(0, 0, 255, 1)
```
:::
## url
根据传递路径读取加载资源。
### 示例
示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/CSS/function/url.uvue),与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/CSS/function/url.uvue)
::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/CSS/function/url/
> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/CSS/function/url
>示例
```vue
url() 函数用于加载图片、字体等资源,支持 /static 目录下的本地文件和网络链接。
字体示例
阿里妈妈刀隶体
@font-face { font-family: 'AlimamaDaoLiTi'; src: url('/static/app-ios/AlimamaDaoLiTi.woff2') }
Pacifico Font Example
@font-face { font-family: 'Pacifico'; src: url('/static/font/Pacifico-Regular.ttf') }
网络字体
@font-face { font-family: 'AlimamaDaoLiTiTTF'; src: url('https://qiniu-web-assets.dcloud.net.cn/uni-app-x/static/font/AlimamaDaoLiTi.ttf') }
```
:::
## calc @calc
> uni-app x 5.31+ App平台 蒸汽模式支持calc方法
Evaluates an mathematical expression. The following operators can be used: + - * /.
### 兼容性
Web: 4.0; 微信小程序: 4.41; Android(VDOM): x; Android(Vapor): 5.31; iOS(VDOM): x; iOS(Vapor): 5.31; HarmonyOS(VDOM): x; HarmonyOS(Vapor): 5.31
calc() 函数允许在声明 CSS 属性值时执行计算。
### 语法
`calc()` 函数使用表达式作为参数,并将表达式的计算结果作为属性值。表达式可以由以下运算符组合而成,并遵循标准运算符的处理规则。
- `+`:加法。
- `-`:减法。
- `*`:乘法,乘数中至少有一个是 ``。
- `/`:除法,除数(`/` 右侧的数)必须是 ``。
表达式中的运算对象可以使用任意 `` 值,也可以混用不同单位。必要时,可以使用括号控制计算顺序。
`+` 和 `-` 运算符的两边必须有空白字符。例如,`calc(50% -8px)` 会被解析为无效表达式,结果相当于一个百分比后跟一个负数长度值;带空白的有效表达式 `calc(8px + -50%)` 则会被解析为一个长度、一个加号和一个负百分比。
`*` 和 `/` 运算符前后不要求空白字符,但为了保持格式统一,仍然建议添加空白。
单位必填:在 calc() 中,像 10 这样的纯数字不能直接与长度单位相加(例如 calc(100% - 10) 是错误的,必须写成 calc(100% - 10px))。
混合单位:它支持跨单位计算,比如用百分比减去固定像素(100% - 20px)
优先级控制:乘除法的优先级高于加减法,如果你想先算加减,必须用圆括号 () 括起来,例如 calc((100% - 20px) / 2)
### 形式化语法
```css
=
calc( )
=
[ [ '+' | '-' ] ]*
=
[ [ '*' | / ] ]*
=
|
|
|
( )
```
### 示例
示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/CSS/function/calc.uvue),与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/CSS/function/calc.uvue)
::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/CSS/function/calc/
> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/CSS/function/calc
>示例
```vue
width: {{ calcMode ? 'calc(50% / 2 + 24px)' : '375rpx' }}; height: calc((12px + 8px) * 2);
{{ calcMode ? '50% / 2 + 24px' : '375rpx' }}
width: calc(var(--calc-base) * 2); height: calc(var(--calc-base) + 12px);
var * 2
height/padding: calc(var(--uni-safe-area-inset-*) + px);
safe area
width: calc(375rpx + 50% - 12px);
width:calc(375rpx + 50% - 12px);
padding: calc(10px);
padding: calc(10px);
margin: calc(var(--calc-base) + 2px);
margin: calc(var(--calc-base) + 2px);
border-bottom-left-radius: calc(60rpx);
bottom left
border-bottom-right-radius: calc(50% - 30px);
bottom right
border-radius: calc(var(--border-radius) - 30px);
radius
border-top-left-radius: calc((12.5% + 15px)*2);
top left
border-top-right-radius: calc(60px);
top right
transform: translateX(calc(10% + 12px));
transform
transform-origin: calc(25% + 10px) calc(50% - 6px);
origin
box-shadow: calc(4px + 4rpx) calc(3px + 1rpx) calc(2px + 6rpx) #999999;
shadow
opacity: calc(0.35 + 0.35);
opacity
hover-class: width/height/opacity 使用 calc()
hover
calc
text shadow
```
:::
**注意:**
App平台相比web平台,calc有以下差异:
- `calc`中只支持`var` 方法, 不支持 ``, ``, `