## top
top样式属性定义了定位元素的上外边距边界与其包含块上边界之间的偏移,非定位元素设置此属性无效。
### 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 |
### 语法
```
top: | | auto;
```
### 值限制
- length
- percentage
### top 的属性值
| 名称 | 兼容性 | 描述 |
| :- | :- | :- |
| auto | Web: 4.0; Android: 3.9; iOS: 4.11; HarmonyOS: 4.61 | 这个关键字表示:
对于绝对定位元素,元素将忽略此属性已bottom属性为准,如果此时设置height: auto,将基于内容需要的高度设置高度;如果bottom也为auto的话,元素的垂直位置就是它假如作为静态 (即 static) 元素时该在的位置。
对于相对定位元素,元素相对正常位置的偏移量将基于bottom属性;如果bottom也为auto的话,元素将不会有偏移。 |
### 默认值 @default-value
`auto`
### 示例
示例为[hello uni-app x alpha分支](https://gitcode.com/dcloud/hello-uni-app-x/blob/prod_alpha/pages/CSS/layout/top.uvue),与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例[另见](https://gitcode.com/dcloud/hello-uni-app-x/blob/master//pages/CSS/layout/top.uvue)
::: preview https://hellouniappx.dcloud.net.cn/web/#/pages/CSS/layout/top
> appRedirect https://hellouniappx.dcloud.net.cn/appredirect.html?path=pages/CSS/layout/top
>示例
```vue
top: 20px (距离顶部 20px) - 右侧:拍平
top: 20rpx (距离顶部 20rpx) - 右侧:拍平
top: 20% (距离顶部 20%) - 右侧:拍平
top: auto (自动,默认顶部对齐) - 右侧:拍平
scroll-view 组件
top: 10% 和 top: 30px
setProperty 设置与 getPropertyValue 获取
view 组件
设置值: {{data.top}}
获取值: {{data.topActual}}
view
text 组件
设置值: {{data.top}}
获取值: {{data.topActualText}}
text
image 组件
设置值: {{data.top}}
获取值: {{data.topActualImage}}
view 组件拍平
设置值: {{data.top}}
获取值: {{data.topActualFlat}}
view
text 组件拍平
设置值: {{data.top}}
获取值: {{data.topActualTextFlat}}
text
image 组件拍平
设置值: {{data.top}}
获取值: {{data.topActualImageFlat}}
第一个枚举值,'' (空字符串) - 空值情况
native-view组件: top: 10% 和 top: 30px
```
:::
### 参见
- [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/top)
- [相关 Bug](https://issues.dcloud.net.cn/?mid=css.properties.position.top)