CSS

CSS 是描述 SWAN 的样式语言。支持 CSS 的属性。在此基础上,做了一些编译支持:

  • 尺寸单位
  • 样式导入

尺寸单位

  • 对于自适应的单位,推荐使用 CSS3 vw 为单位,vw 代表视窗( Viewport )的宽度为1%;
  • 同时也支持 rpx,规定屏幕宽为750rpx。在 iPhone X 上,屏幕宽度为375px,共有750个物理像素,则750rpx = 375px = 750物理像素,1rpx = 0.5px = 1物理像素。

样式导入

为了工程化和代码复用,我们支持 @import 语句,导入 CSS 文件。

代码示例

  1. /* header.css */
  2. .header {
  3. padding: 8px;
  4. }
  1. /* index.css */
  2. @import "header.css";
  3. .body {
  4. padding: 12px;
  5. }

适配样式

为了兼容iPhoneX底部安全区,我们提供了一组兼容样式:

  1. .swan-security-padding-bottom {
  2. padding-bottom: 34px;
  3. }
  4. .swan-security-margin-bottom {
  5. margin-bottom: 34px;
  6. }
  7. .swan-security-fixed-bottom {
  8. bottom: 34px;
  9. }

注意: 该组样式会自动在需要适配安全区的场景动态注入,开发者不需要自行添加,只要在.swan文件中使用这组类名即可。

代码示例

  1. <!--test.swan-->
  2. <view class="swan-security-padding-bottom">test</view>
  3. <!--在iPhoneX等机型下,该view节点会自动获得一个“padding-bottom:34px”的样式-->

内联样式

内联样式与Web开发一致,且支持动态更新

代码示例

  1. <view style="color: {{eleColor}}; font-size: {{eleFontsize}}"> swan </view>
Page({
    data: {
        eleColor: 'red',
        eleFontsize: '48rpx'
    }
});

选择器权重

权重越高越优先。在优先级相同的情况下,后设置的样式优先级高于先设置的样式。

代码示例

在开发者工具中预览效果

view{ 
    // 权重为 1
  color: blue
}

.ele{ 
    // 权重为 10
  color: red
}

#ele{ 
// 权重为 100
  color: pink
}

view#ele{ 
// 权重为 1 + 100 = 101,优先级最高,元素颜色为orange
  color: orange
}

view.ele{ 
// 权重为 1 + 10 = 11
  color: green
}

说明

  • 使用时请注意 box-sizing 属性为非默认值的场景;
  • 百度 App 11.0 版本开始支持 iPhoneX,11.0.5 开始支持 iPhoneXS iPhoneXSMax iPhoneXR。