## margin
margin 属性为给定元素设置所有四个(上下左右)方向的外边距属性。也就是 margin-top,margin-right,margin-bottom,和 margin-left 四个外边距属性设置的简写。
### uni-app x 兼容性
Web: 4.0; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61
### App平台拍平(flatten)兼容性 @flatten_compatibility
| Android(Vapor) | iOS(Vapor) | HarmonyOS(Vapor) |
| :- | :- | :- |
| 5.21 | 5.11 | 5.0 |
### 语法
```
margin: [ | | auto ]{1,4};
```
### 值限制
- length
- percentage
### margin 的属性值
| 名称 | 兼容性 | 描述 |
| :- | :- | :- |
| auto | Web: 4.0; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61 | 让浏览器自己选择一个合适的外边距。有时,在一些特殊情况下,该值可以使元素居中。 |
### 默认值 @default-value
`0`
**注意**
- margin的auto
除了flex的主轴、交叉轴属性设置外,给margin设置auto,也可以方便的实现居中和对齐。
* `margin: auto;` /* 水平和垂直双居中 */
* `margin: 0px auto;` /* 水平居中 */
* `margin: auto 0px;` /* 垂直居中 */
* `margin-left: auto;` /* 会把左边的剩余空间全部占满 */
- app平台不支持外边距折叠(上下外边距折叠合并为单个边距,其大小为两个边距中的最大值),折叠规则参考[CSS的外边距折叠](https://developer.mozilla.org/zh-CN/docs/Web/CSS/CSS_box_model/Mastering_margin_collapsing)
### 示例
示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/CSS/margin/margin.uvue),与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/CSS/margin/margin.uvue)
::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/CSS/margin/margin
> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/CSS/margin/margin
>示例
```vue
说明:左边是正常版本,右边是拍平版本
margin: 25px
margin: 10%
setProperty 设置与 getPropertyValue 获取
view 组件
设置值: {{data.margin}}
获取值: {{data.marginActual}}
view
text 组件
设置值: {{data.margin}}
获取值: {{data.marginActualText}}
红色
text
蓝色
image 组件
设置值: {{data.margin}}
获取值: {{data.marginActualImage}}
view 组件拍平
设置值: {{data.margin}}
获取值: {{data.marginActualFlat}}
view
text 组件拍平
设置值: {{data.margin}}
获取值: {{data.marginActualTextFlat}}
红色
text
蓝色
image 组件拍平
设置值: {{data.margin}}
获取值: {{data.marginActualImageFlat}}
scroll-view 组件 margin
设置值: {{data.margin}}
获取值: {{data.marginActualScrollView}}
scroll-view1
scroll-view2
scroll-view3
第一个枚举值,'' (空字符串) - 空值情况
native-view组件: margin: 25px 和 5%
```
:::
### 参见
- [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/margin)
- [相关 Bug](https://issues.dcloud.net.cn/?mid=css.properties.margin)