V-Play 文档翻译 Page
翻译:qyvlik
应用的一个页面。
VPlayApps 1.0
Inherits: MouseArea
Inherited By: ListPage
属性
Item
:NavigationStack
backNavigationEnabled
:bool
backgroundColor
:color
canNavigateBack
:bool
leftBarItem
:Item
navigationBarHidden
:bool
navigationBarTranslucency
:real
navigationStack
:NavigationStack
rightBarItem
:Item
tabBarHidden
:bool
title
:string
titleItem
:Item
详细描述
The Page type provides a container for the contents of a single page within an application.
应用的一个页面提供一个内容。
属性文档
Item
:NavigationStack
read-only
The nearest parent item in the QML hierarchy that is a NavigationStack
item. (read-only)
在 QML 层次中最亲近的父级项 NavigationStack
。
If the current item or one of its parent items is a child of a NavigationStack
item, this property contains the owning NavigationStack
item. This property is null
if the Page
is not embedded inside a NavigationStack
item.
如果当前项的直接父级项是 NavigationStack
的孩子,则这个属性会自动包含 NavigationStack
。如果这个属性为 null
,则 Page
不在 NavigationStack
中。
backNavigationEnabled
:bool
Set this property to false
to disable the back navigation within a page in a NavigationStack
if previous pages exist on the stack.
设置为 false
,则不予显示回退按钮。
Disabling the back navigation hides the “back” button within a NavigationBar
, deactivates the iOS back swipe gesture and also disables the hardware back button on Android and Windows Phone.
隐藏位于 NavigationBar
上的回退按钮,意味着 iOS 上滑动回退以及安卓和 WP 上硬件返回键无效。
The default value is false
, if the current page is the first one inside a NavigationStack
, true
otherwise.
如果当前页面为 NavigationStack
的第一个页面,默认值为 false
。
backgroundColor
:color
The background color of the Page
which is displayed if no other items are placed within the page.
Page
的背景色,如果没有被其他项所替代,就会显示此颜色。
The default value is defined in the Theme::backgroundColor
property and can be overridden.
默认值是 Theme::backgroundColor
,可重新定义。
canNavigateBack
:bool
read-only
Readonly property holds whether it is possible to actually navigate back within the current stack. The property is true
if a previous page exists on the stack, otherwise false
.
当前页面是否可以回退到上一级,只读。
This QML property was introduced in V-Play 2.7.0.
leftBarItem
:Item
A custom navigation bar item displayed on the left of the navigation bar if the item is on top of a NavigationStack
as a direct child of it.
如果 Page
是 NavigationStack
的直接孩子,则显示自定义导航栏左边控件。
By default this item displays a back navigation item if the current NavigationStack
can navigate back. If setting the item to an explicit NavigationBarItem
it replaces the back button with the custom item.
如果当前 NavigationStack
可以回退至上一页,则默认显示一个回退按钮。如果直接使用 NavigationBarItem
来替代的话,会显示定制的控件。
navigationBarHidden
:bool
A boolean value indicating whether the navigation bar should be hidden for that specific Page if the item is presented within a NavigationStack
item.
You can set this property to false to implement a custom styled full-screen page within a NavigationStack
without the default navigation bar behavior (make sure to implement a custom back navigation action in that case).
By default this property is false
, meaning that the navigation bar is visible for that Page.
大体意思就是是否隐藏导航栏。
navigationBarTranslucency
:real
Set this value to make the navigation bar translucent for that specific Page within a NavigationStack
.
The allowed value range is 0.0 to 1.0. The default value is 0.0, meaning that the navigation bar is not translucent (fully opaque).
注意这里的是系统的状态栏做文章,具体就是一个应用以全屏方式显示,但是状态栏没有被应用覆盖,并且自身保持一定的透明度,以显示下层的应用画面。这里是调整系统状态栏的透明度的。默认值为 0.0,不透明。
大体就是沉浸式了。
If using a translucent navigation bar, the page content will move beneath the navigation bar and you should add that extra spacing for your pages on your own (you can get the current height from ThemeNavigationBar::height
).
如果使用了沉浸式导航栏(系统状态栏沉浸,与应用融为一体),需要使用 ThemeNavigationBar::height
修复 Page
的高度。
navigationStack
:NavigationStack
read-only
The nearest parent item in the QML hierarchy that is a NavigationStack
item. (read-only)
在 QML 层次中最亲近的父级项 NavigationStack
。
If the current item or one of its parent items is a child of a NavigationStack
item, this property contains the owning NavigationStack
item. This property is null
if the Page
is not embedded inside a NavigationStack
item.
如果当前项的直接父级项是 NavigationStack
的孩子,则这个属性会自动包含 NavigationStack
。如果这个属性为 null
,则 Page
不在 NavigationStack
中。
rightBarItem
:Item
A custom navigation bar item displayed on the right of the navigation bar if the item is on top of a NavigationStack
as a direct child of it.
如果 Page
是 NavigationStack
的直接孩子,则显示自定义导航栏右边控件。
By default this item is empty.
默认为空。
tabBarHidden
:bool
A boolean value indicating whether a tab bar should be hidden for that specific Page if the item is presented within a Navigation
item showing tabs.
By default this property is false
, meaning that the tab bar is visible for that Page.
是否显示选项板控制控件。默认不显示。
title
:string
A localized, human-readable string that represents the the content of this page.
The title is used as string in a navigation bar if the Page item is a child of a NavigationStack
.
显示本页面的标题,如果当前 Page
是 NavigationStack
的直接孩子,就显示在导航栏上。
titleItem
:Item
A custom navigation bar item displayed at the title slot of the navigation bar if the item is on top of a NavigationStack as a direct child of it.
By default, the title of the page is displayed.
This QML property was introduced in V-Play 2.6.2.
用以显示自定义标题,例如带有图片的标题等。