函数 (Functions)
CSS 函数被用作 CSS 属性的值,允许你在样式表中执行简单的计算、处理颜色或引用外部资源。WXSS 支持以下 CSS 函数子集,具体语法以本页为准。
以下是在 WXSS 开发中最常用的函数及其代码示例:
1. 计算与变量
calc()
用于计算尺寸与间距。当前支持两个操作数之间的 + 或 -,运算符两侧必须留空格;不支持乘除或嵌套表达式。
.container {
/* 宽度为视口宽度减去两侧的边距 */
width: calc(100vw - 60rpx);
margin: 0 auto;
}
两个操作数可为兼容的长度或两个百分比。普通尺寸与间距不支持百分比和长度混合计算,例如 width: calc(100% - 20px);使用视口长度 calc(100vw - 20px) 或布局间距替代。
var()
用于引用自定义属性(CSS 变量)的值。
:root {
--primary-color: #40FF5E;
}
.button {
/* 引用变量,并提供回退值 */
background-color: var(--primary-color, #444);
}
随机值 random()
random() 为支持的数值属性生成随机值,适合装饰位置、透明度和动画时长。它不是安全随机数接口;需要安全随机字节时使用 Crypto。
.spark {
opacity: 0.8;
opacity: random(0.4, 1);
margin-left: random(-20px, 20px, 5px);
animation-duration: random(400ms, 1s, 100ms);
}
语法与取值
random(min, max)
random(min, max, step)
random(auto, min, max)
random(--key, min, max, step)
min、max必须是兼容类型的字面量:数字、长度、时间或百分比。不同长度单位可以混用;ms与s可以混用;百分比不能与长度或无单位数字混用。step可选,必须为正值且与区间类型兼容。离散结果为min + n × step;仅当步长恰好落到max时才可能取到上界。max < min时返回min。- 属性决定可接受的类型,例如
opacity接受数字,margin-left接受长度,animation-duration接受时间。整数属性会将结果舍入,属性自身的范围限制仍然生效。 - 不支持嵌套
calc()/random()参数,也不支持随机角度、频率和分辨率。无效表达式会使对应声明失效,建议先写普通值作为回退。
稳定性与共享随机值
随机值以元素或生成的伪元素为作用域,重新计算样式不会每次重新抽样。省略首个参数或使用 auto 时,每个属性中的每次函数调用独立取样。
同一元素上的 --key 共享随机基值。使用相同区间与步长可得到相同结果;区间不同则将同一基值映射到各自范围。它不在不同元素之间共享:
.spark {
width: random(--size, 4px, 10px, 2px);
height: random(--size, 4px, 10px, 2px);
}
动画中的随机端点在插值前确定,并在该次播放期间保持稳定。每次事件触发的重播会获得独立的随机上下文,保留下来的旧实例不会改变。自定义属性中的表达式会在使用它的属性处解析。
当前支持范围不包含跨元素共享、element-shared、固定随机源或完整的浏览器随机缓存语义。动画重播示例见动画与变换。
2. 视觉效果
linear-gradient()
创建线性渐变背景。
.header {
background: linear-gradient(180deg, #40FF5E 0%, #06a954 100%);
}
rgba()
定义带透明度的颜色。
.mask {
background-color: rgba(0, 0, 0, 0.6);
}
3. 资源引入
url()
用于引入外部资源。在 WXSS 中建议使用网络路径或 base64。
.icon {
background-image: url('https://res.rokid.com/static/icon.png');
background-size: cover;
}
4. 几何变换
translate(), rotate(), scale()
配合 transform 属性实现元素的位移、旋转和缩放。
.active-item {
transform: translateX(20rpx) scale(1.1);
}
.loading-spinner {
animation: spin 1s linear infinite;
}
@keyframes spin {
from { transform: rotate(0deg); }
to { transform: rotate(360deg); }
}
完整的函数列表及其详细语法,请参考 MDN CSS 函数。