title: 通用样式 type: references order: 1.6 version: 0.10

通用样式

所有 Weex 组件都支持以下通用样式规则。

盒模型

box model @300*

Weex 盒模型基于 CSS 盒模型，每个 Weex 元素都可视作一个盒子。我们一般在讨论设计或布局时，会提到「盒模型」这个概念。

盒模型描述了一个元素所占用的空间。每一个盒子有四条边界：外边距边界 margin edge, 边框边界 border edge, 内边距边界 padding edge 与内容边界 content edge。这四层边界，形成一层层的盒子包裹起来，这就是盒模型大体上的含义。

注意： Weex 对于长度值目前只支持像素值，单位可省略，不支持相对单位（em、rem）。

width {length}：，默认值 0
height {length}：，默认值 0
padding {length}：内边距，内容和边框之间的距离。默认值 0
可有如下写法：
- padding-left {length}：，默认值 0
- padding-right {length}：，默认值 0
- padding-top {length}：，默认值 0
- padding-bottom {length}：，默认值 0
margin：
外边距，元素和元素之间的空白距离。值类型为 length，默认值 0
可有如下写法：
- margin-left {length}：，默认值 0
- margin-right {length}：，默认值 0
- margin-top {length}：，默认值 0
- margin-bottom {length}：，默认值 0
border：
设定边框，border 目前不支持类似这样 border: 1 solid #ff0000; 的组合写法。
可有如下写法：
- border-style：
  设定边框样式，值类型为 string，可选值为 solid | dashed | dotted，默认值 solid
  可有如下写法：
  - border-left-style {string}：可选值为 solid | dashed | dotted，默认值 solid
  - border-top-style {string}：可选值为 solid | dashed | dotted，默认值 solid
  - border-right-style {string}：可选值为 solid | dashed | dotted，默认值 solid
  - border-bottom-style {string}：可选值为 solid | dashed | dotted，默认值 solid
- border-width {length}：
  设定边框宽度，非负值, 默认值 0
  可有如下写法：
  - border-left-width {length}：，非负值, 默认值 0
  - border-top-width {length}：，非负值, 默认值 0
  - border-right-width {length}：，非负值, 默认值 0
  - border-bottom-width {length}：，非负值, 默认值 0
- border-color {color}：
  设定边框颜色，默认值 #000000
  可有如下写法：
  - border-left-color {color}：，默认值 #000000
  - border-top-color {color}：，默认值 #000000
  - border-right-color {color}：，默认值 #000000
  - border-bottom-color {color}：，默认值 #000000
- border-radius {length}：
  设定圆角，默认值 0
  可有如下写法：
  - border-bottom-left-radius {length}：，非负值, 默认值 0
  - border-bottom-right-radius {length}：，非负值, 默认值 0
  - border-top-left-radius {length}：，非负值, 默认值 0
  - border-top-right-radius {length}：，非负值, 默认值 0

注意：目前在 <image> 和 <text> 组件上尚无法只定义一个或几个角的 border-radius。比如你无法在这两个组件上使用 border-top-left-radius。

Weex 盒模型的 box-sizing 默认为 border-box，即盒子的宽高包含内容、内边距和边框的宽度，不包含外边距的宽度。

示例：

<template>
  <div>
    <image  style="width: 400; height: 200; margin-left: 20;" src="https://g.alicdn.com/mtb/lab-zikuan/0.0.18/weex/weex_logo_blue@3x.png"></image>
  </div>
</template>

Flexbox

Weex 布局模型基于 CSS Flexbox，以便所有页面元素的排版能够一致可预测，同时页面布局能适应各种设备或者屏幕尺寸。

Flexbox 包含 flex 容器和 flex 成员项。如果一个 Weex 元素可以容纳其他元素，那么它就成为 flex 容器。需要注意的是，flexbox 的老版规范相较新版有些出入，比如是否能支持 wrapping。这些都描述在 W3C 的工作草案中了，你需要注意下新老版本之间的不同。另外，老版本只在安卓 4.4 版以下得到支持。

Flex 容器

在 Weex 中，Flexbox 是默认且唯一的布局模型，所以你不需要手动为元素添加 display: flex; 属性。

flex-direction：
定义了 flex 容器中 flex 成员项的排列方向。可选值为 row | column，默认值为 column
- column：从上到下排列。
- row：从左到右排列。
justify-content：
定义了 flex 容器中 flex 成员项在主轴方向上如何排列以处理空白部分。可选值为 flex-start | flex-end | center | space-between，默认值为 flex-start。
- flex-start：是默认值，所有的 flex 成员项都排列在容器的前部；
- flex-end：则意味着成员项排列在容器的后部；
- center：即中间对齐，成员项排列在容器中间、两边留白；
- space-between：表示两端对齐，空白均匀地填充到 flex 成员项之间。
align-items：

定义了 flex 容器中 flex 成员项在纵轴方向上如何排列以处理空白部分。可选值为 stretch | flex-start | center | flex-end，默认值为 stretch。

stretch 是默认值，即拉伸高度至 flex 容器的大小；
flex-start 则是上对齐，所有的成员项排列在容器顶部；
flex-end 是下对齐，所有的成员项排列在容器底部；
center 是中间对齐，所有成员项都垂直地居中显示。

align-items @400*

Flex 成员项

flex 属性定义了 flex 成员项可以占用容器中剩余空间的大小。如果所有的成员项设置相同的值 flex: 1，它们将平均分配剩余空间. 如果一个成员项设置的值为 flex: 2，其它的成员项设置的值为 flex: 1，那么这个成员项所占用的剩余空间是其它成员项的2倍。

flex {number}：值为 number 类型。

示例

一个简单的网格布局。

mobile_preview

<template>
  <div>
    <div repeat="(i, v) in list" class="row">
      <div repeat="(k, text) in v" class="item">
        <div>
          <text>{{text}}</text>
        </div>
      </div>
    </div>
  </div>
</template>
<style>
  .item{
    flex:1;
    justify-content: center;
    align-items:center;
    border-width:1;
  }
  .row{
    flex-direction: row;
    height:80;
  }
</style>
<script>
  module.exports = {
    data: function () {
      return {
        list:[
          ['A', 'B', 'C'],
          ['D', 'E', 'F'],
          ['G', 'H', 'I']
        ]
      }
    }
  }
</script>

体验一下

一个在相对于屏幕水平居中，全屏居中的 <div>。

<template>
  <div class="wrapper">
    <div class="box">
    </div>
  </div>
</template>

<style>
  .wrapper {
    position: absolute;
    top: 0;
    right: 0;
    bottom: 0;
    left: 0;
    background-color: #cccccc;
    justify-content: center;
    align-items: center;
  }
  .box {
    width: 200;
    height: 200;
    background-color: #fc0000;
  }
</style>

体验一下

定位

Weex 支持 position 定位，用法与 CSS position 类似。为元素设置 position 后，可通过 top、right、bottom、left 四个属性设置元素坐标。

position {string}：
设置定位类型。可选值为 relative | absolute | fixed | sticky，默认值为 relative。
- relative 是默认值，指的是相对定位；
- absolute 是绝对定位，以元素的容器作为参考系；
- fixed 保证元素在页面窗口中的对应位置显示；
- sticky 指的是仅当元素滚动到页面之外时，元素会固定在页面窗口的顶部。
top {number}：距离上方的偏移量，默认为 0。
bottom {number}：距离下方的偏移量，默认为 0。
left {number}：距离左方的偏移量，默认为 0。
right {number}：距离右方的偏移量，默认为 0。

注意：

Weex 目前不支持 z-index 设置元素层级关系，但靠后的元素层级更高，因此，对于层级高的元素，可将其排列在后面。
如果定位元素超过容器边界，在 Android 下，超出部分将不可见，原因在于 Android 端元素 overflow 默认值为 hidden，但目前 Android 暂不支持设置 overflow: visible。

示例

mobile_preview

<template>
  <div class="wrapper">
    <div class="box box1">
    </div>
    <div class="box box2">
    </div>
    <div class="box box3">
    </div>
  </div>
</template>

<style>
  .wrapper {
    position: absolute;
    top: 0;
    right: 0;
    bottom: 0;
    left: 0;
    background-color: #cccccc;
  }
  .box {
    width: 400;
    height: 400;
    position: absolute;
  }
  .box1 {
    top: 0;
    left: 0;
    background-color: #ff0000;
  }
  .box2 {
    top: 150;
    left: 150;
    background-color: #0055dd;
  }
  .box3 {
    top: 300;
    left: 300;
    background-color: #00ff49;
  }
</style>

体验一下

其他基本样式

opacity {number}：取值范围为 [0, 1] 区间。默认值是 1，即完全不透明；0 是完全透明；0.5 是 50% 的透明度。
background-color {color}：设定元素的背景色，可选值为色值，支持RGB（ rgb(255, 0, 0) ）；RGBA（ rgba(255, 0, 0, 0.5) ）；十六进制（ #ff0000 ）；精简写法的十六进制（ #f00 ）；色值关键字（red），默认值是 transparent 。

注意： 色值的关键字列表。

上手样式

如果对于样式写法需要更多上手参考，可参考

如何做出高性能长列表
如何布局
以及每个组件的文档中，都有常见的例子可供参考。

你可以按照以下步骤来规划 Weex 页面的样式。

全局样式规划：将整个页面分割成合适的模块。
flex 布局：排列和对齐页面模块。
定位盒子：定位并设置偏移量。
细节样式处理：增加特定的具体样式。