SideBarContainer

提供側邊欄可以顯示和隱藏的側邊欄容器，通過子組件定義側邊欄和內容區，第一個子組件表示側邊欄，第二個子組件表示內容區。

說明：
開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
該組件從API Version 8開始支持。后續版本如有新增內容，則采用上角標單獨標記該內容的起始版本。

子組件

可以包含子組件。

說明：

• 子組件類型：系統組件和自定義組件，不支持渲染控制類型（[if/else]、[ForEach]和[LazyForEach]）。
• 子組件個數：必須且僅包含2個子組件。
• 子組件個數異常時：3個或以上子組件，顯示第一個和第二個。1個子組件，顯示側邊欄，內容區為空白。

接口

SideBarContainer( type?: SideBarContainerType )

參數：

SideBarContainerType枚舉說明

屬性

除支持[通用屬性]外，還支持以下屬性：

ButtonStyle對象說明

SideBarPosition9+枚舉說明

DividerStyle10+對象說明

說明：

針對側邊欄子組件設置[通用屬性寬高]時，寬高都不生效。 針對側邊欄內容區設置[通用屬性寬高]時，寬高都不生效，默認占滿SideBarContainer的剩余空間。

當showSideBar屬性未設置時，依據組件大小進行自動顯示：

• 小于minSideBarWidth + minContentWidth：默認不顯示側邊欄。
• 大于等于minSideBarWidth + minContentWidth：默認顯示側邊欄。

事件

除支持[通用事件]外，還支持以下事件：

示例

// xxx.ets
@Entry
@Component
struct SideBarContainerExample {
  normalIcon: Resource = $r("app.media.icon")
  selectedIcon: Resource = $r("app.media.icon")
  @State arr: number[] = [1, 2, 3]
  @State current: number = 1

  build() {
    SideBarContainer(SideBarContainerType.Embed) {
      Column() {
        ForEach(this.arr, (item: number) = > {
          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: string) = > item)
      }.width('100%')
      .justifyContent(FlexAlign.SpaceEvenly)
      .backgroundColor('#19000000')


      Column() {
        Text('SideBarContainer content text1').fontSize(25)
        Text('SideBarContainer content text2').fontSize(25)
      }
      .margin({ top: 50, left: 20, right: 30 })
    }
    .controlButton({
      icons: {
        hidden: $r('app.media.drawer'),
        shown: $r('app.media.drawer'),
        switching: $r('app.media.drawer')
      }
    })
    .sideBarWidth(150)
    .minSideBarWidth(50)
    .maxSideBarWidth(300)
    .minContentWidth(0)
    .onChange((value: boolean) = > {
      console.info('status:' + value)
    })
    .divider({ strokeWidth: '1vp', color: Color.Gray, startMargin: '4vp', endMargin: '4vp' })
  }
}

審核編輯 黃宇