SideBarContainer:提供侧边栏可以显示和隐藏的侧边栏容器,通过子组件定义侧边栏和内容区,第一个子组件表示侧边栏,第二个子组件表示内容区
SideBarContainer( type?: SideBarContainerType )
type:设置侧边栏的显示类型(默认SideBarContainerType.Embed)
SideBarContainerType枚举说明
Embed:侧边栏嵌入到组件内,侧边栏和内容区并列显示
Overlay:侧边栏浮在内容区上面
属性:
showSideBar:设置是否显示侧边栏
controlButton:设置侧边栏控制按钮的属性
left:设置侧边栏控制按钮距离容器左界限的间距(默认16)
top:设置侧边栏控制按钮距离容器上界限的间距(默认48)
width:设置侧边栏控制按钮的宽度(默认32)
height:设置侧边栏控制按钮的高度(默认32)
icons:设置侧边栏控制按钮的图标
{
shown: string | PixelMap | Resource ,//设置侧边栏显示时控制按钮的图标
hidden: string | PixelMap | Resource ,//设置侧边栏隐藏时控制按钮的图标
switching?: string | PixelMap | Resource//设置侧边栏显示和隐藏状态切换时控制按钮的图标
}
showControlButton:设置是否显示控制按钮
sideBarWidth:设置侧边栏的宽度
minSideBarWidth:设置侧边栏最小宽度
maxSideBarWidth:设置侧边栏最大宽度
autoHide:设置当侧边栏拖拽到小于最小宽度后,是否自动隐藏(api9)
事件:
onChange(callback: (value: boolen) => void) 当侧边栏的状态在显示和隐藏之间切换时触发回调,value的true表示显示,false表示隐藏
案例效果:

代码:
- @Entry
- @Component
- struct SideBarContainerPage {
- //未选择图片
- normalIcon: Resource = $r("app.media.icon4")
- //选中图片
- selectedIcon: Resource = $r("app.media.icon3")
- @State arr: number[] = [1, 2, 3]
- @State current: number = 1
-
- build() {
- SideBarContainer(SideBarContainerType.Embed) {
- Column() {
- ForEach(this.arr, (item, index) => {
- Column({ space: 5 }) {
- Image(this.current === item ? this.selectedIcon : this.normalIcon).width(64).height(64)
- Text("index0" + item)
- .fontSize(25)
- .fontColor(this.current === item ? '#0A59F7' : '#999')
- .fontFamily('source-sans-pro,cursive,sans-serif')
- }.onClick(() => {
- this.current = item
- })
- }, item => item)
- }.width('100%')
- .justifyContent(FlexAlign.SpaceEvenly)
- .backgroundColor('#19000000')
-
- RowSplit() {
- Column() {
- Text('Split page one').fontSize(30)
- }.justifyContent(FlexAlign.Center)
- }.width('100%')
- }
- .sideBarWidth(240)
- .minSideBarWidth(210)
- .maxSideBarWidth(260)
- .onChange((value: boolean) => {
- console.info('status:' + value)
- })
- }
- }