Skip to main content

Layout Navigation

WdMenuLayout

Applicable Scenarios​

Commonly used in application layout design to achieve navigation + layout effects.

Basic Capabilities Description​

  1. In the layout type properties, you can select "top navigation", "left navigation", "T-shaped navigation", "navigation bar", and "Tab bar navigation". Each layout is adaptive on mobile devices.
  2. The menu properties support configuring multi-end menu data, allowing flexible customization of menu display content and navigation logic. Supports up to three-level menus. Initial menu items can be "generated with one click based on the page". Image 85b429f029b98a1e62916df652c3bc69
  3. Dynamic menu implementation. For specific operations, refer to How to Configure a Dynamic Navigation Menu

Property Introduction​

Properties​

External properties received by the component

Property Name
Property Identifier
Type
Description
layout templatetemplatestring

Example: "horizontal"

menumenuobject

menu

Example: []

Side menu unfolddefaultOpenedboolean

Left menu on PC and sidebar menu on mobile terminal expand by default

Example: true

Click public collapse menuouterClickClosableboolean

Click public collapse menu on mobile terminal

Example: true

Selected menu keyselectedMenuKeystring

Example: ""

Events​

Events exposed by the component. You can listen to component events to trigger external actions

Event Name
Event Code
Event Output Parameters event.detail
Applicable Scenarios
Description
Click menu itemmenuClickobject
  • item: object 选中菜单项
    • title: string名称
    • key: stringkey值
    • iconUrl: string图标
    • iconPath: string自定义未选中图标
    • selectedIconPath: string自定义选中图标
    • disabled: boolean禁用菜单
    • visible: boolean显示菜单
    • type: string链接类型 Optional values:link(外部链接) route(内部链接)
    • path: string跳转内部链接
    • linkUrl: string跳转外部链接
    • linkTargetBlank: boolean跳转开启新窗口
    • children: array
    • subPackageName: string子包名称
Compatible with all platforms

User click menu option, unavailable for Tab layout, top navigation bar layout

Properties API​

None

Method API​

Through the Method API, you can programmatically trigger internal methods of components, such as submitting forms, displaying popups, etc. You can call component methods using $w.componentId.methodName, such as $w.form1.submit()

Method Name
Method Identifier
Parameters
Method Description
Set selected menu itemsetSelectedInfoobject 选中项信息
  • key: string选中菜单key值
  • item: object 选中菜单项
    • title: string名称
    • key: stringkey值
    • iconUrl: string图标
    • iconPath: string自定义未选中图标
    • selectedIconPath: string自定义选中图标
    • disabled: boolean禁用菜单
    • visible: boolean显示菜单
    • type: string链接类型 Optional values:link(外部链接) route(内部链接)
    • path: string跳转内部链接
    • linkUrl: string跳转外部链接
    • linkTargetBlank: boolean跳转开启新窗口
    • children: array
    • subPackageName: string子包名称

Set selected menu item

Style API​

Through the Style API, you can override the styles of internal elements in components to achieve customization. For example, in the low-code editor, you can write styles for all button components using #wd-page-root .wd-btn, and control individual component styles with :scope. For detailed instructions, please refer toStyle API

Name
Class Name
Description and Examples
root element.wd-menulayoutcomponent root element
/* :scope refers to the current component element */
/* For details, refer to the Style API documentation */
:scope.wd-menulayout {
  /* Write CSS styles here */
}
PC-side text root element.wd-pc-menulayoutWrite styles for components on the PC side
/* :scope refers to the current component element */
/* For details, refer to the Style API documentation */
:scope.wd-pc-menulayout {
  /* Write CSS styles here */
}
H5 text root element.wd-h5-menulayoutWrite styles for components on the H5 side
/* :scope refers to the current component element */
/* For details, refer to the Style API documentation */
:scope.wd-h5-menulayout {
  /* Write CSS styles here */
}
WeChat Mini Program root element.wd-mp-menulayoutWrite style for mini program component
/* :scope refers to the current component element */
/* For details, refer to the Style API documentation */
:scope.wd-mp-menulayout {
  /* Write CSS styles here */
}
Layout navigation header.wd-menulayout-headerWrite styles for the header of layout navigation
/* :scope refers to the current component element */
/* For details, refer to the Style API documentation */
:scope .wd-menulayout-header {
  /* Write CSS styles here */
}
Layout navigation brand slot.wd-menulayout-header__logo-wrapWrite styles for the brand slot in layout navigation
/* :scope refers to the current component element */
/* For details, refer to the Style API documentation */
:scope .wd-menulayout-header__logo-wrap {
  /* Write CSS styles here */
}
Layout navigation body.wd-menulayout-bodyWrite styles for the main body of layout navigation
/* :scope refers to the current component element */
/* For details, refer to the Style API documentation */
:scope .wd-menulayout-body {
  /* Write CSS styles here */
}
Layout navigation left-side content.wd-menulayout-body__leftThe menu body for the left-side layout navigation can be styled
/* :scope refers to the current component element */
/* For details, refer to the Style API documentation */
:scope .wd-menulayout-body__left {
  /* Write CSS styles here */
}
Layout navigation bottom content.wd-menulayout-body__footerWrite styles for the bottom of layout navigation
/* :scope refers to the current component element */
/* For details, refer to the Style API documentation */
:scope .wd-menulayout-body__footer {
  /* Write CSS styles here */
}
Layout navigation page content.wd-menulayout-body__contentThe page content for layout navigation can be styled
/* :scope refers to the current component element */
/* For details, refer to the Style API documentation */
:scope .wd-menulayout-body__content {
  /* Write CSS styles here */
}
Tab bar layout navigation root element.wd-menulayout--tabWrite styles for the root element of Tab layout navigation
/* :scope refers to the current component element */
/* For details, refer to the Style API documentation */
:scope.wd-menulayout--tab {
  /* Write CSS styles here */
}

Learn about Style API