ScrollView

<ScrollView> 是一个用于渲染可滚动内容的 UI 组件。内容可以垂直（默认）或水平滚动。

<ScrollView>
  <StackLayout padding="12">
    <Label text="v1" height="50" />
    <Label text="v2" height="50" />
    <Label text="v3" height="50" />
    <Label text="v4" height="50" />
    <Label text="v5" height="50" />
    <Label text="v6" height="50" />
    <Label text="v7" height="50" />
    <Label text="v8" height="50" />
    <Label text="v9" height="50" />
  </StackLayout>
</ScrollView>

属性 ​

orientation ​

orientation: 'horizontal' | 'vertical'

获取或设置内容可以滚动的方向。

默认为vertical。

scrollBarIndicatorVisible ​

scrollBarIndicatorVisible: boolean

指定滚动条是否可见。

默认为true。

isScrollEnabled ​

isScrollEnabled: boolean

启用或禁用 ScrollView 的滚动。

verticalOffset ​

verticalOffset: number

获取已滚动内容的垂直偏移量。

horizontalOffset ​

horizontalOffset: number

获取已滚动内容的水平偏移量。

scrollableHeight ​

scrollableHeight: number

获取最大可滚动高度，这也是verticalOffset的最大值。

scrollableWidth ​

scrollableWidth: number = scrollView.scrollableWidth

获取最大可滚动宽度，这也是horizontalOffset的最大值。

方法 ​

scrollToVerticalOffset() ​

scrollToVerticalOffset(value: number, animated: boolean)

将内容滚动到指定的垂直偏移量。

将animated设置为true以进行动画滚动，设置为false以立即滚动。

scrollToHorizontalOffset() ​

scrollToHorizontalOffset(value: number, animated: boolean)

将内容滚动到指定的水平偏移量位置。

将animated设置为true以进行动画滚动，设置为false以立即滚动。

事件 ​

scroll ​

on('scroll', (args: ScrollEventData) => {
  const scrollView = args.object as ScrollView
  console.log('Scrolled', {
    scrollX: args.scrollX,
    scrollY: args.scrollY,
  })
})

当 ScrollView 滚动时发出。

参见 ScrollEventData。

原生组件 ​

• Android: android.view
• iOS: UIScrollView