半模態(tài)轉(zhuǎn)場
通過bindSheet屬性為組件綁定半模態(tài)頁面,在組件插入時可通過設(shè)置自定義或默認的內(nèi)置高度確定半模態(tài)大小。
說明:
開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 :[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md
]
從API Version 10開始支持。后續(xù)版本如有新增內(nèi)容,則采用上角標(biāo)單獨標(biāo)記該內(nèi)容的起始版本。不支持橫豎屏切換。
不支持路由跳轉(zhuǎn)。
屬性
名稱 | 參數(shù) | 參數(shù)描述 |
---|---|---|
bindSheet | isShow: boolean, builder: [CustomBuilder], options?: [SheetOptions] | 給組件綁定半模態(tài)頁面,點擊后顯示模態(tài)頁面。 isShow: 是否顯示半模態(tài)頁面。 從API version 10開始,該參數(shù)支持[$$]雙向綁定變量 builder: 配置半模態(tài)頁面內(nèi)容。 options: 配置半模態(tài)頁面的可選屬性。 |
說明:
在非雙向綁定情況下,以拖拽方式關(guān)閉半模態(tài)頁面不會改變isShow參數(shù)的值。
為了使isShow參數(shù)值與半模態(tài)界面的狀態(tài)同步,建議使用[$$]雙向綁定isShow參數(shù)。
SheetOptions
名稱 | 類型 | 必填 | 描述 |
---|---|---|---|
height | [SheetSize] | [Length] | 否 |
dragBar | boolean | 否 | 是否顯示控制條,默認顯示。 |
maskColor | [ResourceColor] | 否 | 半模態(tài)頁面的背景蒙層顏色。 |
SheetSize
名稱 | 參數(shù)描述 |
---|---|
MEDIUM | 指定半模態(tài)高度為屏幕高度一半。 |
LARGE | 指定半模態(tài)高度幾乎為屏幕高度。HarmonyOS與OpenHarmony鴻蒙文檔籽料:mau123789是v直接拿 |
示例
// xxx.ets
@Entry
@Component
struct SheetTransitionExample {
@State isShow:boolean = false
@State isShow2:boolean = false
@State sheetHeight:number = 300;
@State showDragBar:boolean = true;
@Builder myBuilder() {
Column() {
Button("change height")
.margin(10)
.fontSize(20)
.onClick(()= >{
this.sheetHeight = 500;
})
Button("Set Illegal height")
.margin(10)
.fontSize(20)
.onClick(()= >{
this.sheetHeight = -1;
})
Button("close dragBar")
.margin(10)
.fontSize(20)
.onClick(()= >{
this.showDragBar = false;
})
Button("close modal 1")
.margin(10)
.fontSize(20)
.onClick(()= >{
this.isShow = false;
})
}
.width('100%')
.height('100%')
}
build() {
Column() {
Button("transition modal 1")
.onClick(() = > {
this.isShow = true
})
.fontSize(20)
.margin(10)
.bindSheet($$this.isShow, this.myBuilder(), {height: this.sheetHeight, dragBar: this.showDragBar, backgroundColor: Color.Green, onAppear: () = > {console.log("BindSheet onAppear.")}, onDisappear: () = > {console.log("BindSheet onDisappear.")}})
}
.justifyContent(FlexAlign.Center)
.width('100%')
.height('100%')
}
}
審核編輯 黃宇
-
組件
+關(guān)注
關(guān)注
1文章
512瀏覽量
17828 -
鴻蒙
+關(guān)注
關(guān)注
57文章
2352瀏覽量
42859
發(fā)布評論請先 登錄
相關(guān)推薦
評論