# 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 ``` ::: ## 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 ``` ::: ## 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 ``` ::: ## 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 ``` ::: ## 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 ``` ::: ## 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 ``` ::: **注意:** App平台相比web平台,calc有以下差异: - `calc`中只支持`var` 方法, 不支持 ``, ``, `