通用样式
通用样式,即所有组件都可以支持的样式
它们均与 css 的属性样式用法保持一致,开发者可写在内联样式或<style>标签里,实现组件样式的定制化
关于组件样式的设置,可以参考此文档入门
| 名称 | 类型定义 | 描述 |
|---|---|---|
| length | String |Number | 用于描述尺寸单位,输入为 number 类型时,使用 px 单位;输入为 string 类型时,需要显式指定像素单位,当前支持的像素单位有: px:逻辑尺寸单位。 |
| percentage | String | 百分比尺寸单位,如“50%”。 |
| 名称 | 类型定义 | 描述 |
|---|---|---|
| color | String |颜色枚举字符串 | 用于描述颜色信息。字符串格式如下: ‘rgb(255, 255, 255)' 'rgba(255, 255, 255, 1.0)‘ HEX 格式:‘#rrggbb’,‘#aarrggbb’ 枚举格式:‘black’,‘white’。 |
<template> <div> <div class="box-normal" style="background-color: #f00"></div> <div class="box-normal"></div> </div></template><style> .box-normal { background-color: #ff0; width: 100px; height: 100px; }</style>注:
通用样式均为非必填项。
| 名称 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| width | <length> | <percentage> | - | 未设置时使用组件自身内容需要的宽度 |
| height | <length> | <percentage> | - | 未设置时使用组件自身内容需要的高度 |
| padding | <length> | 0 | 简写属性,在一个声明中设置所有的内边距属性,该属性可以有 1 到 4 个值,具体请参考MDN文档 |
| padding-[left|top|right|bottom] | <length> | 0 | 设置一个元素的某个方向的内边距,padding 区域指一个元素的内容和其边界之间的空间,该属性不能为负值。 |
| margin | <length> | 0 | 简写属性,在一个声明中设置所有的外边距属性,该属性可以有 1 到 4 个值,具体请参考 MDN文档 |
| margin-[left|top|right|bottom] | <length> | 0 | 设置一个元素的某个方向的外边距,该属性不能为负值 |
| border | - | 0 | 简写属性,在一个声明中设置所有的边框属性,可以按顺序设置属性 width style color,不设置的值为默认值 |
| border-[left|top|right|bottom] | - | 0 | 简写属性,在一个声明中设置对应位置的所有边框属性,可以按顺序设置属性 width style color,不设置的值为默认值 |
| border-style | solid | solid | 暂时仅支持 1 个值,为元素的所有边框设置样式 |
| border-width | <length> | 0 | 简写属性,在一个声明中设置元素的所有边框宽度,或者单独为各边边框设置宽度,具体请参考 MDN 文档 |
| border-[left|top|right|bottom]-width | <length> | 0 | 为元素的某个方向的边框设置边框宽度 |
| border-color | <color> | black | 简写属性,在一个声明中设置元素的所有边框颜色,或者单独为各边边框设置颜色,颜色值的填入请参考 颜色配置 |
| border-[left|top|right|bottom]-color | <color> | black | 颜色值的填入请参考 颜色配置 |
| border-radius | <length> | <percentage> | 0 | border-radius 属性允许你设置元素的外边框圆角。设置时需要同时设置 border-width、border-color,单独设置 border-[left|top|right|bottom]-width,border-[left|top|right|bottom]-color 时 border-radius 无效 |
| border-[top|bottom]-[left|right]-radius | <length> | <percentage> | 0 | 设置四个角的圆角弧度 |
| background | <linear-gradient> | - | 暂时不能与 background-color、background-image 同时使用 |
| background-color | <color> | - | 颜色值的填入请参考 颜色配置 |
| color | <color> | - | 颜色值的填入请参考 颜色配置 |
| background-image | <uri> | - | 暂时不支持与 background-color,border-color 同时使用;支持本地图片资源;暂不支持网络图片资源 |
| background-size | contain | cover | auto | <length> | <percentage> | auto auto | 设置背景图片大小 |
| background-repeat | repeat-x | repeat-y | no-repeat | repeat | repeat | 设置是否及如何重复绘制背景图像 |
| background-position | <length> |<percentage>| left | right | top | bottom | center | 0px 0px | 描述了背景图片在容器中绘制的位置,支持 1-4 个参数 |
| opacity | <number> | 1 | opacity 属性指定了一个元素的透明度。 |
| display | flex | none | flex | 蓝河应用只支持 flex 布局;将当前元素的 display 设置为 none 蓝河应用页面将不渲染此元素 |
| visibility | visible | hidden | visible | visibility 属性控制显示或隐藏元素而不更改文档的布局 |
| flex-direction | column | row | column-reverse | row-reverse | row | 默认为横向row,父容器为<div>、<list-item>时生效 |
| align-items | stretch | flex-start | flex-end | center | flex-start | align-items 定义了伸缩项目可以在伸缩容器的当前行的侧轴上对齐方式。flex-start(默认值):伸缩项目在侧轴起点边的外边距紧靠住该行在侧轴起始的边。flex-end:伸缩项目在侧轴终点边的外边距靠住该行在侧轴终点的边 。center:伸缩项目的外边距盒在该行的侧轴上居中放置。stretch:伸缩项目拉伸填充整个伸缩容器。 |
| justify-content | flex-start | flex-end | center | space-between | space-around | flex-start | justify-content 定义了伸缩项目沿着主轴线的对齐方式。flex-start(默认值):伸缩项目向一行的起始位置靠齐。flex-end:伸缩项目向一行的结束位置靠齐。center:伸缩项目向一行的中间位置靠齐。space-between:伸缩项目会平均地分布在行里。第一个伸缩项目一行中的最开始位置,最后一个伸缩项目在一行中最终点位置。space-around:伸缩项目会平均地分布在行里,两端保留一半的空间。 |
| position | fixed | absolute | relative | relative | 父容器为<list>、<swiper>时不生效,scroll 不支持 。 |
| [left|top|right|bottom] | <length> | - | 一般配合fixed或absolute布局使用 |
注意:
flex 布局仅支持上面列出的样式,w3c 中的其他标准切勿使,如 flex: 1;,否则将会产生无法预知的布局问题。