文档中心 > 店铺动态卡片-开发指引

ACSS 语法参考

更新时间:2023/02/06 访问次数:30768

ACSS 是一套样式语言,用于描述 AXML 的组件样式,决定 AXML 的组件的显示效果。


为适应广大前端开发者,ACSS 同系统 CSS 规则完全一致,100% 可以用。同时为更适合开发应用,对 CSS 进行了扩充。


一、rpx


rpx(responsive pixel)可以根据屏幕宽度进行自适应,规定屏幕宽为 750rpx。以 Apple iPhone6 为例,屏幕宽度为 375px,共有 750 个物理像素,则 750rpx = 375px = 750 物理像素,1rpx = 0.5px = 1 物理像素。


设备 rpx 换算 px(屏幕宽度 / 750) px 换算 rpx(750 / 屏幕宽度)
iPhone5 1rpx = 0.42px 1px = 2.34rpx
iPhone6 1rpx = 0.5px 1px = 2rpx
iPhone6 Plus 1rpx = 0.552px 1px = 1.81rpx


二、样式导入


使用@import语句可以导入外联样式表,@import 后需要加上外联样式表相对路径,用;表示结束。


示例代码如下:

/** button.acss **/
.sm-button {
  padding: 5px;
}


/** app.acss **/
@import "./button.acss";
.md-button {
  padding: 15px;
}


导入路径支持从 node_modules 目录载入第三方模块,例如 page.acss:

@import "./button.acss"; /*相对路径*/
@import "/button.acss"; /*项目绝对路径*/
@import "third-party/page.acss"; /*第三方 npm 包路径*/


三、内联样式


组件上支持使用 styleclass 属性来控制样式。


1. style 属性


用于接收动态样式,样式在运行时会进行解析。

<view style="color:{{color}};" />


2. class 属性


用于接收静态样式,属性值是样式规则中类选择器名(样式类名)的集合,样式类名不需要带上.,多个以空格分隔。

<view class="my-awesome-view" />


静态样式统一写到 class 中,避免将静态样式写进 style 中,以免影响渲染速度。


四、选择器


同 CSS3 保持一致。


注意:

1).a-, .am- 开头的类选择器为系统组件占用,不可使用。

2)不支持属性选择器。


五、全局样式与局部样式


1.app.acss 中的样式为全局样式,作用于每一个页面。

2.页面文件夹内的 .acss 文件中定义的样式为局部样式,只作用在对应的页面,并会覆盖 app.acss 中相同的选择器。


六、本地资源引用


ACSS 文件里的本地资源引用请使用绝对路径的方式,不支持相对路径引用。例如:

/* 支持 */
background-image: url('/images/ant.png');
/* 不支持 */
background-image: url('./images/ant.png');



FAQ

关于此文档暂时还没有FAQ
返回
顶部