mdui 2.0.2 → 2.0.4

package/components/menu/menu-item.d.ts

@@ -1,18 +1,18 @@
-import { LitElement } from 'lit';
 import '@mdui/jq/methods/css.js';
 import '@mdui/jq/methods/height.js';
 import '@mdui/jq/methods/innerHeight.js';
 import '@mdui/jq/methods/innerWidth.js';
 import '@mdui/jq/methods/width.js';
 import '@mdui/jq/static/contains.js';
+import { MduiElement } from '@mdui/shared/base/mdui-element.js';
 import '@mdui/shared/icons/arrow-right.js';
 import '@mdui/shared/icons/check.js';
 import '../icon.js';
 import type { Ripple } from '../ripple/index.js';
 import type { CSSResultGroup, PropertyValues, TemplateResult } from 'lit';
-declare const MenuItem_base: import("@open-wc/dedupe-mixin").Constructor<import("@mdui/shared/mixins/anchor.js").AnchorMixinInterface> & import("@open-wc/dedupe-mixin").Constructor<import("../ripple/ripple-mixin.js").RippleMixinInterface> & import("@open-wc/dedupe-mixin").Constructor<import("@mdui/shared/mixins/focusable.js").FocusableMixinInterface> & typeof LitElement;
+declare const MenuItem_base: import("@open-wc/dedupe-mixin").Constructor<import("@mdui/shared/mixins/anchor.js").AnchorMixinInterface> & import("@open-wc/dedupe-mixin").Constructor<import("../ripple/ripple-mixin.js").RippleMixinInterface> & import("@open-wc/dedupe-mixin").Constructor<import("@mdui/shared/mixins/focusable.js").FocusableMixinInterface> & typeof MduiElement;
 /**
- * @summary 菜单项组件
+ * @summary 菜单项组件。需配合 `<mdui-menu>` 组件使用
  *
  * ```html
  * <mdui-menu>
@@ -44,20 +44,20 @@ declare const MenuItem_base: import("@open-wc/dedupe-mixin").Constructor<import(
  * @csspart selected-icon - 选中状态的图标
  * @csspart submenu - 子菜单元素
  */
-export declare class MenuItem extends MenuItem_base {
+export declare class MenuItem extends MenuItem_base<MenuItemEventMap> {
     static styles: CSSResultGroup;
     /**
-     * 该菜单项的值
+     * 菜单项的值
      */
     value?: string;
     /**
-     * 是否禁用该菜单项
+     * 是否禁用菜单项
      */
     disabled: boolean;
     /**
      * 左侧的 Material Icons 图标名。也可以通过 `slot="icon"` 设置
      *
-     * 如果需要在左侧留出一个图标的位置，可以传入空字符串进行占位
+     * 如果左侧不需要显示图标，但需要预留一个图标的位置，可传入空字符串进行占位
      */
     icon?: string;
     /**
@@ -116,6 +116,14 @@ export declare class MenuItem extends MenuItem_base {
     private updateSubmenuPositioner;
     private renderInner;
 }
+export interface MenuItemEventMap {
+    focus: FocusEvent;
+    blur: FocusEvent;
+    'submenu-open': CustomEvent<void>;
+    'submenu-opened': CustomEvent<void>;
+    'submenu-close': CustomEvent<void>;
+    'submenu-closed': CustomEvent<void>;
+}
 declare global {
     interface HTMLElementTagNameMap {
         'mdui-menu-item': MenuItem;

package/components/menu/menu-item.js

@@ -1,5 +1,5 @@
 import { __decorate } from "tslib";
-import { html, LitElement } from 'lit';
+import { html } from 'lit';
 import { customElement, property, state } from 'lit/decorators.js';
 import { createRef, ref } from 'lit/directives/ref.js';
 import { when } from 'lit/directives/when.js';
@@ -12,12 +12,12 @@ import '@mdui/jq/methods/innerWidth.js';
 import '@mdui/jq/methods/width.js';
 import { isUndefined } from '@mdui/jq/shared/helper.js';
 import '@mdui/jq/static/contains.js';
+import { MduiElement } from '@mdui/shared/base/mdui-element.js';
 import { DefinedController } from '@mdui/shared/controllers/defined.js';
 import { HasSlotController } from '@mdui/shared/controllers/has-slot.js';
 import { watch } from '@mdui/shared/decorators/watch.js';
 import { animateTo, stopAnimations } from '@mdui/shared/helpers/animate.js';
 import { booleanConverter } from '@mdui/shared/helpers/decorator.js';
-import { emit } from '@mdui/shared/helpers/event.js';
 import { getDuration, getEasing } from '@mdui/shared/helpers/motion.js';
 import { nothingTemplate } from '@mdui/shared/helpers/template.js';
 import { uniqueId } from '@mdui/shared/helpers/uniqueId.js';
@@ -30,7 +30,7 @@ import '../icon.js';
 import { RippleMixin } from '../ripple/ripple-mixin.js';
 import { menuItemStyle } from './menu-item-style.js';
 /**
- * @summary 菜单项组件
+ * @summary 菜单项组件。需配合 `<mdui-menu>` 组件使用
  *
  * ```html
  * <mdui-menu>
@@ -62,11 +62,11 @@ import { menuItemStyle } from './menu-item-style.js';
  * @csspart selected-icon - 选中状态的图标
  * @csspart submenu - 子菜单元素
  */
-let MenuItem = class MenuItem extends AnchorMixin(RippleMixin(FocusableMixin(LitElement))) {
+let MenuItem = class MenuItem extends AnchorMixin(RippleMixin(FocusableMixin(MduiElement))) {
     constructor() {
         super();
         /**
-         * 是否禁用该菜单项
+         * 是否禁用菜单项
          */
         this.disabled = false;
         /**
@@ -128,10 +128,8 @@ let MenuItem = class MenuItem extends AnchorMixin(RippleMixin(FocusableMixin(Lit
         // 要区分是否首次渲染，首次渲染时不触发事件，不执行动画；非首次渲染，触发事件，执行动画
         if (this.submenuOpen) {
             if (hasUpdated) {
-                const requestOpen = emit(this, 'submenu-open', {
-                    cancelable: true,
-                });
-                if (requestOpen.defaultPrevented) {
+                const eventProceeded = this.emit('submenu-open', { cancelable: true });
+                if (!eventProceeded) {
                     return;
                 }
             }
@@ -150,14 +148,12 @@ let MenuItem = class MenuItem extends AnchorMixin(RippleMixin(FocusableMixin(Lit
                 }),
             ]);
             if (hasUpdated) {
-                emit(this, 'submenu-opened');
+                this.emit('submenu-opened');
             }
         }
         else {
-            const requestClose = emit(this, 'submenu-close', {
-                cancelable: true,
-            });
-            if (requestClose.defaultPrevented) {
+            const eventProceeded = this.emit('submenu-close', { cancelable: true });
+            if (!eventProceeded) {
                 return;
             }
             const duration = getDuration(this, 'short4');
@@ -169,7 +165,7 @@ let MenuItem = class MenuItem extends AnchorMixin(RippleMixin(FocusableMixin(Lit
             if (this.submenuRef.value) {
                 this.submenuRef.value.hidden = true;
             }
-            emit(this, 'submenu-closed');
+            this.emit('submenu-closed');
         }
     }
     connectedCallback() {

package/components/menu/menu.d.ts

@@ -1,4 +1,3 @@
-import { LitElement } from 'lit';
 import '@mdui/jq/methods/add.js';
 import '@mdui/jq/methods/children.js';
 import '@mdui/jq/methods/find.js';
@@ -6,6 +5,7 @@ import '@mdui/jq/methods/get.js';
 import '@mdui/jq/methods/is.js';
 import '@mdui/jq/methods/parent.js';
 import '@mdui/jq/methods/parents.js';
+import { MduiElement } from '@mdui/shared/base/mdui-element.js';
 import type { CSSResultGroup, PropertyValues, TemplateResult } from 'lit';
 /**
  * 键盘快捷键：
@@ -15,7 +15,7 @@ import type { CSSResultGroup, PropertyValues, TemplateResult } from 'lit';
  * * `Enter` - 包含子菜单时，打开子菜单；为链接时，跳转链接
  * * `Escape` - 子菜单已打开时，关闭子菜单
  *
- * @summary 菜单组件。需与 `<mdui-menu-item>` 组件配合使用
+ * @summary 菜单组件。需配合 `<mdui-menu-item>` 组件使用
  *
  * ```html
  * <mdui-menu>
@@ -24,49 +24,46 @@ import type { CSSResultGroup, PropertyValues, TemplateResult } from 'lit';
  * </mdui-menu>
  * ```
  *
- * @event change - 菜单项的选中状态变化时触发
+ * @event change - 菜单项选中状态变化时触发
  *
  * @slot - 子菜单项（`<mdui-menu-item>`）、分割线（[`<mdui-divider>`](/docs/2/components/divider)）等元素
  *
- * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐引用[设计令牌](/docs/2/styles/design-tokens#shape-corner)
  */
-export declare class Menu extends LitElement {
+export declare class Menu extends MduiElement<MenuEventMap> {
     static styles: CSSResultGroup;
     /**
-     * 菜单项的可选中状态。默认为不可选中。可选值为：
+     * 菜单项的可选状态。默认不可选。可选值包括：
      *
-     * * `single`：最多只能选中一个
-     * * `multiple`：可以选中多个
+     * * `single`：单选
+     * * `multiple`：多选
      */
-    selects?: /*最多只能选中一个*/ 'single' | /*可以选中多个*/ 'multiple';
+    selects?: /*单选*/ 'single' | /*多选*/ 'multiple';
     /**
-     * 当前选中的 `<mdui-menu-item>` 的值
+     * 当前选中的 `<mdui-menu-item>` 的值。
      *
-     * Note:
-     * 该属性的 HTML 属性始终为字符串，且仅在 `selects="single"` 时可以通过 HTML 属性设置初始值；
-     * 该属性的 JavaScript 属性值在 `selects="single"` 时为字符串、在 `selects="multiple"` 时为字符串数组。
-     * 所以，在 `selects="multiple"` 时，如果要修改该值，只能通过修改 JavaScript 属性值实现。
+     * **Note**：该属性的 HTML 属性始终为字符串，仅在 `selects="single"` 时可通过 HTML 属性设置初始值；该属性的 JavaScript 属性值在 `selects="single"` 时为字符串，在 `selects="multiple"` 时为字符串数组。因此，在 `selects="multiple"` 时，若要修改该值，只能通过修改 JavaScript 属性值实现。
      */
     value?: string | string[];
     /**
-     * 菜单项是否使用更紧凑的布局
+     * 菜单项是否使用紧凑布局
      */
     dense: boolean;
     /**
-     * 子菜单的触发方式，支持传入多个值，用空格分隔。可选值为：
+     * 子菜单的触发方式，支持多个值，用空格分隔。可选值包括：
      *
      * * `click`：点击菜单项时打开子菜单
      * * `hover`：鼠标悬浮到菜单项上时打开子菜单
      * * `focus`：聚焦到菜单项上时打开子菜单
-     * * `manual`：使用了该值时，只能使用编程方式打开和关闭子菜单，且不能再指定其他触发方式
+     * * `manual`：仅能通过编程方式打开和关闭子菜单，不能再指定其他触发方式
      */
-    submenuTrigger: /*点击菜单项时打开子菜单*/ 'click' | /*鼠标悬浮到菜单项上时打开子菜单*/ 'hover' | /*聚焦到菜单项上时打开子菜单*/ 'focus' | /*使用了该值时，只能使用编程方式打开和关闭子菜单，且不能再指定其他触发方式*/ 'manual' | string;
+    submenuTrigger: /*点击菜单项时打开子菜单*/ 'click' | /*鼠标悬浮到菜单项上时打开子菜单*/ 'hover' | /*聚焦到菜单项上时打开子菜单*/ 'focus' | /*仅能通过编程方式打开和关闭子菜单，不能再指定其他触发方式*/ 'manual' | string;
     /**
-     * 通过 hover 触发子菜单打开时的延时，单位为毫秒
+     * 鼠标悬浮触发子菜单打开的延时，单位毫秒
      */
     submenuOpenDelay: number;
     /**
-     * 通过 hover 触发子菜单关闭时的延时，单位为毫秒
+     * 鼠标悬浮触发子菜单关闭的延时，单位毫秒
      */
     submenuCloseDelay: number;
     private selectedKeys;
@@ -107,6 +104,9 @@ export declare class Menu extends LitElement {
     private onClick;
     private onKeyDown;
 }
+export interface MenuEventMap {
+    change: CustomEvent<void>;
+}
 declare global {
     interface HTMLElementTagNameMap {
         'mdui-menu': Menu;

package/components/menu/menu.js

@@ -1,5 +1,5 @@
 import { __decorate } from "tslib";
-import { html, LitElement } from 'lit';
+import { html } from 'lit';
 import { customElement, property, queryAssignedElements, state, } from 'lit/decorators.js';
 import { $ } from '@mdui/jq/$.js';
 import '@mdui/jq/methods/add.js';
@@ -10,12 +10,12 @@ import '@mdui/jq/methods/is.js';
 import '@mdui/jq/methods/parent.js';
 import '@mdui/jq/methods/parents.js';
 import { isString, isUndefined } from '@mdui/jq/shared/helper.js';
+import { MduiElement } from '@mdui/shared/base/mdui-element.js';
 import { DefinedController } from '@mdui/shared/controllers/defined.js';
 import { watch } from '@mdui/shared/decorators/watch.js';
 import { arraysEqualIgnoreOrder } from '@mdui/shared/helpers/array.js';
 import { booleanConverter } from '@mdui/shared/helpers/decorator.js';
 import { delay } from '@mdui/shared/helpers/delay.js';
-import { emit } from '@mdui/shared/helpers/event.js';
 import { componentStyle } from '@mdui/shared/lit-styles/component-style.js';
 import { menuStyle } from './menu-style.js';
 /**
@@ -26,7 +26,7 @@ import { menuStyle } from './menu-style.js';
  * * `Enter` - 包含子菜单时，打开子菜单；为链接时，跳转链接
  * * `Escape` - 子菜单已打开时，关闭子菜单
  *
- * @summary 菜单组件。需与 `<mdui-menu-item>` 组件配合使用
+ * @summary 菜单组件。需配合 `<mdui-menu-item>` 组件使用
  *
  * ```html
  * <mdui-menu>
@@ -35,34 +35,34 @@ import { menuStyle } from './menu-style.js';
  * </mdui-menu>
  * ```
  *
- * @event change - 菜单项的选中状态变化时触发
+ * @event change - 菜单项选中状态变化时触发
  *
  * @slot - 子菜单项（`<mdui-menu-item>`）、分割线（[`<mdui-divider>`](/docs/2/components/divider)）等元素
  *
- * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐引用[设计令牌](/docs/2/styles/design-tokens#shape-corner)
  */
-let Menu = class Menu extends LitElement {
+let Menu = class Menu extends MduiElement {
     constructor() {
         super(...arguments);
         /**
-         * 菜单项是否使用更紧凑的布局
+         * 菜单项是否使用紧凑布局
          */
         this.dense = false;
         /**
-         * 子菜单的触发方式，支持传入多个值，用空格分隔。可选值为：
+         * 子菜单的触发方式，支持多个值，用空格分隔。可选值包括：
          *
          * * `click`：点击菜单项时打开子菜单
          * * `hover`：鼠标悬浮到菜单项上时打开子菜单
          * * `focus`：聚焦到菜单项上时打开子菜单
-         * * `manual`：使用了该值时，只能使用编程方式打开和关闭子菜单，且不能再指定其他触发方式
+         * * `manual`：仅能通过编程方式打开和关闭子菜单，不能再指定其他触发方式
          */
         this.submenuTrigger = 'click hover';
         /**
-         * 通过 hover 触发子菜单打开时的延时，单位为毫秒
+         * 鼠标悬浮触发子菜单打开的延时，单位毫秒
          */
         this.submenuOpenDelay = 200;
         /**
-         * 通过 hover 触发子菜单关闭时的延时，单位为毫秒
+         * 鼠标悬浮触发子菜单关闭的延时，单位毫秒
          */
         this.submenuCloseDelay = 200;
         // 因为 menu-item 的 value 可能会重复，所有在每一个 menu-item 元素上都加了一个唯一的 key 属性，通过 selectedKeys 来记录选中状态的 key
@@ -145,7 +145,7 @@ let Menu = class Menu extends LitElement {
         const value = this.isMultiple ? values : values[0] || undefined;
         this.setValue(value);
         if (!this.isInitial) {
-            emit(this, 'change');
+            this.emit('change');
         }
     }
     async onValueChange() {
@@ -334,7 +334,7 @@ let Menu = class Menu extends LitElement {
         }
         const target = event.target;
         const item = target.closest('mdui-menu-item');
-        if (item?.disabled) {
+        if (!item || item.disabled) {
             return;
         }
         this.lastActiveItem = item;

package/components/navigation-bar/navigation-bar-item.d.ts

@@ -1,10 +1,10 @@
-import { LitElement } from 'lit';
+import { MduiElement } from '@mdui/shared/base/mdui-element.js';
 import '../icon.js';
 import type { Ripple } from '../ripple/index.js';
 import type { CSSResultGroup, TemplateResult } from 'lit';
-declare const NavigationBarItem_base: import("@open-wc/dedupe-mixin").Constructor<import("@mdui/shared/mixins/anchor.js").AnchorMixinInterface> & import("@open-wc/dedupe-mixin").Constructor<import("../ripple/ripple-mixin.js").RippleMixinInterface> & import("@open-wc/dedupe-mixin").Constructor<import("@mdui/shared/mixins/focusable.js").FocusableMixinInterface> & typeof LitElement;
+declare const NavigationBarItem_base: import("@open-wc/dedupe-mixin").Constructor<import("@mdui/shared/mixins/anchor.js").AnchorMixinInterface> & import("@open-wc/dedupe-mixin").Constructor<import("../ripple/ripple-mixin.js").RippleMixinInterface> & import("@open-wc/dedupe-mixin").Constructor<import("@mdui/shared/mixins/focusable.js").FocusableMixinInterface> & typeof MduiElement;
 /**
- * @summary 底部导航栏项组件。需与 `<mdui-navigation-bar>` 组件配合使用
+ * @summary 底部导航栏项组件。需配合 `<mdui-navigation-bar>` 组件使用
  *
  * ```html
  * <mdui-navigation-bar>
@@ -14,7 +14,7 @@ declare const NavigationBarItem_base: import("@open-wc/dedupe-mixin").Constructo
  * </mdui-navigation-bar>
  * ```
  *
- * @slot - 文本
+ * @slot - 导航项文本
  * @slot icon - 图标
  * @slot active-icon - 激活状态的图标元素
  * @slot badge - 徽标
@@ -27,11 +27,11 @@ declare const NavigationBarItem_base: import("@open-wc/dedupe-mixin").Constructo
  * @csspart badge - 徽标
  * @csspart icon - 图标
  * @csspart active-icon - 激活状态的图标
- * @csspart label - 文本
+ * @csspart label - 导航项文本
  *
- * @cssprop --shape-corner-indicator - 指示器的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ * @cssprop --shape-corner-indicator - 指示器的圆角大小。可以指定一个具体的像素值；但更推荐引用[设计令牌](/docs/2/styles/design-tokens#shape-corner)
  */
-export declare class NavigationBarItem extends NavigationBarItem_base {
+export declare class NavigationBarItem extends NavigationBarItem_base<NavigationBarItemEventMap> {
     static styles: CSSResultGroup;
     /**
      * 未激活状态的 Material Icons 图标名。也可以通过 `slot="icon"` 设置
@@ -42,7 +42,7 @@ export declare class NavigationBarItem extends NavigationBarItem_base {
      */
     activeIcon?: string;
     /**
-     * 该导航项的值
+     * 导航项的值
      */
     value?: string;
     /**
@@ -68,6 +68,10 @@ export declare class NavigationBarItem extends NavigationBarItem_base {
     protected render(): TemplateResult;
     private renderInner;
 }
+export interface NavigationBarItemEventMap {
+    focus: FocusEvent;
+    blur: FocusEvent;
+}
 declare global {
     interface HTMLElementTagNameMap {
         'mdui-navigation-bar-item': NavigationBarItem;

package/components/navigation-bar/navigation-bar-item.js

@@ -1,8 +1,9 @@
 import { __decorate } from "tslib";
-import { html, LitElement } from 'lit';
+import { html } from 'lit';
 import { customElement, property, state } from 'lit/decorators.js';
 import { createRef, ref } from 'lit/directives/ref.js';
 import cc from 'classcat';
+import { MduiElement } from '@mdui/shared/base/mdui-element.js';
 import { HasSlotController } from '@mdui/shared/controllers/has-slot.js';
 import { booleanConverter } from '@mdui/shared/helpers/decorator.js';
 import { nothingTemplate } from '@mdui/shared/helpers/template.js';
@@ -14,7 +15,7 @@ import '../icon.js';
 import { RippleMixin } from '../ripple/ripple-mixin.js';
 import { navigationBarItemStyle } from './navigation-bar-item-style.js';
 /**
- * @summary 底部导航栏项组件。需与 `<mdui-navigation-bar>` 组件配合使用
+ * @summary 底部导航栏项组件。需配合 `<mdui-navigation-bar>` 组件使用
  *
  * ```html
  * <mdui-navigation-bar>
@@ -24,7 +25,7 @@ import { navigationBarItemStyle } from './navigation-bar-item-style.js';
  * </mdui-navigation-bar>
  * ```
  *
- * @slot - 文本
+ * @slot - 导航项文本
  * @slot icon - 图标
  * @slot active-icon - 激活状态的图标元素
  * @slot badge - 徽标
@@ -37,11 +38,11 @@ import { navigationBarItemStyle } from './navigation-bar-item-style.js';
  * @csspart badge - 徽标
  * @csspart icon - 图标
  * @csspart active-icon - 激活状态的图标
- * @csspart label - 文本
+ * @csspart label - 导航项文本
  *
- * @cssprop --shape-corner-indicator - 指示器的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ * @cssprop --shape-corner-indicator - 指示器的圆角大小。可以指定一个具体的像素值；但更推荐引用[设计令牌](/docs/2/styles/design-tokens#shape-corner)
  */
-let NavigationBarItem = class NavigationBarItem extends AnchorMixin(RippleMixin(FocusableMixin(LitElement))) {
+let NavigationBarItem = class NavigationBarItem extends AnchorMixin(RippleMixin(FocusableMixin(MduiElement))) {
     constructor() {
         super(...arguments);
         /**

package/components/navigation-bar/navigation-bar.d.ts

@@ -5,7 +5,7 @@ import type { ScrollPaddingPosition } from '@mdui/shared/mixins/scrollBehavior.j
 import type { CSSResultGroup, TemplateResult } from 'lit';
 declare const NavigationBar_base: import("@open-wc/dedupe-mixin").Constructor<import("@mdui/shared/mixins/scrollBehavior.js").ScrollBehaviorMixinInterface> & typeof LayoutItemBase;
 /**
- * @summary 底部导航栏组件。需与 `<mdui-navigation-bar-item>` 组件配合使用
+ * @summary 底部导航栏组件。需配合 `<mdui-navigation-bar-item>` 组件使用
  *
  * ```html
  * <mdui-navigation-bar>
@@ -23,30 +23,31 @@ declare const NavigationBar_base: import("@open-wc/dedupe-mixin").Constructor<im
  *
  * @slot - `<mdui-navigation-bar-item>` 组件
  *
- * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
- * @cssprop --z-index - 组件的 CSS 的 `z-index` 值
+ * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐引用[设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ * @cssprop --z-index - 组件的 CSS `z-index` 值
  */
-export declare class NavigationBar extends NavigationBar_base {
+export declare class NavigationBar extends NavigationBar_base<NavigationBarEventMap> {
     static styles: CSSResultGroup;
     /**
      * 是否隐藏
      */
     hide: boolean;
     /**
-     * 文本的可视状态。可选值为：
+     * 文本的可视状态。可选值包括：
      *
-     * * `auto`：小于等于3个选项时，始终显示；大于3个选项时，仅显示选中状态的文本
-     * * `selected`：仅选中状态显示文本
+     * * `auto`：当选项小于等于3个时，始终显示文本；当选项大于3个时，仅显示选中状态的文本
+     * * `selected`：仅在选中状态显示文本
      * * `labeled`：始终显示文本
      * * `unlabeled`：始终不显示文本
      */
-    labelVisibility: /*小于等于3个选项时，始终显示；大于3个选项时，仅显示选中状态的文本*/ 'auto' | /*仅选中状态显示文本*/ 'selected' | /*始终显示文本*/ 'labeled' | /*始终不显示文本*/ 'unlabeled';
+    labelVisibility: /*当选项小于等于3个时，始终显示文本；当选项大于3个时，仅显示选中状态的文本*/ 'auto' | /*仅在选中状态显示文本*/ 'selected' | /*始终显示文本*/ 'labeled' | /*始终不显示文本*/ 'unlabeled';
     /**
      * 当前选中的 `<mdui-navigation-bar-item>` 的值
      */
     value?: string;
     /**
-     * 滚动行为。可选值为：
+     * 滚动行为。可选值包括：
+     *
      * * `hide`：滚动时隐藏
      */
     scrollBehavior?: 'hide';
@@ -70,6 +71,13 @@ export declare class NavigationBar extends NavigationBar_base {
     private updateItems;
     private onSlotChange;
 }
+export interface NavigationBarEventMap {
+    change: CustomEvent<void>;
+    show: CustomEvent<void>;
+    shown: CustomEvent<void>;
+    hide: CustomEvent<void>;
+    hidden: CustomEvent<void>;
+}
 declare global {
     interface HTMLElementTagNameMap {
         'mdui-navigation-bar': NavigationBar;

package/components/navigation-bar/navigation-bar.js

@@ -4,13 +4,12 @@ import { customElement, property, queryAssignedElements, state, } from 'lit/deco
 import { DefinedController } from '@mdui/shared/controllers/defined.js';
 import { watch } from '@mdui/shared/decorators/watch.js';
 import { booleanConverter } from '@mdui/shared/helpers/decorator.js';
-import { emit } from '@mdui/shared/helpers/event.js';
 import { componentStyle } from '@mdui/shared/lit-styles/component-style.js';
 import { ScrollBehaviorMixin } from '@mdui/shared/mixins/scrollBehavior.js';
 import { LayoutItemBase } from '../layout/layout-item-base.js';
 import { navigationBarStyle } from './navigation-bar-style.js';
 /**
- * @summary 底部导航栏组件。需与 `<mdui-navigation-bar-item>` 组件配合使用
+ * @summary 底部导航栏组件。需配合 `<mdui-navigation-bar-item>` 组件使用
  *
  * ```html
  * <mdui-navigation-bar>
@@ -28,8 +27,8 @@ import { navigationBarStyle } from './navigation-bar-style.js';
  *
  * @slot - `<mdui-navigation-bar-item>` 组件
  *
- * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
- * @cssprop --z-index - 组件的 CSS 的 `z-index` 值
+ * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐引用[设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ * @cssprop --z-index - 组件的 CSS `z-index` 值
  */
 let NavigationBar = class NavigationBar extends ScrollBehaviorMixin(LayoutItemBase) {
     constructor() {
@@ -39,10 +38,10 @@ let NavigationBar = class NavigationBar extends ScrollBehaviorMixin(LayoutItemBa
          */
         this.hide = false;
         /**
-         * 文本的可视状态。可选值为：
+         * 文本的可视状态。可选值包括：
          *
-         * * `auto`：小于等于3个选项时，始终显示；大于3个选项时，仅显示选中状态的文本
-         * * `selected`：仅选中状态显示文本
+         * * `auto`：当选项小于等于3个时，始终显示文本；当选项大于3个时，仅显示选中状态的文本
+         * * `selected`：仅在选中状态显示文本
          * * `labeled`：始终显示文本
          * * `unlabeled`：始终不显示文本
          */
@@ -67,7 +66,7 @@ let NavigationBar = class NavigationBar extends ScrollBehaviorMixin(LayoutItemBa
         const item = this.items.find((item) => item.key === this.activeKey);
         this.value = item?.value;
         if (!this.isInitial) {
-            emit(this, 'change');
+            this.emit('change');
         }
     }
     async onValueChange() {
@@ -85,7 +84,7 @@ let NavigationBar = class NavigationBar extends ScrollBehaviorMixin(LayoutItemBa
         super.firstUpdated(_changedProperties);
         this.addEventListener('transitionend', (event) => {
             if (event.target === this) {
-                emit(this, this.hide ? 'hidden' : 'shown');
+                this.emit(this.hide ? 'hidden' : 'shown');
             }
         });
     }
@@ -99,15 +98,15 @@ let NavigationBar = class NavigationBar extends ScrollBehaviorMixin(LayoutItemBa
     runScrollThreshold(isScrollingUp) {
         // 向下滚动
         if (!isScrollingUp && !this.hide) {
-            const requestHide = emit(this, 'hide');
-            if (!requestHide.defaultPrevented) {
+            const eventProceeded = this.emit('hide', { cancelable: true });
+            if (eventProceeded) {
                 this.hide = true;
             }
         }
         // 向上滚动
         if (isScrollingUp && this.hide) {
-            const requestShow = emit(this, 'show');
-            if (!requestShow.defaultPrevented) {
+            const eventProceeded = this.emit('show', { cancelable: true });
+            if (eventProceeded) {
                 this.hide = false;
             }
         }
@@ -119,6 +118,9 @@ let NavigationBar = class NavigationBar extends ScrollBehaviorMixin(LayoutItemBa
         }
         const target = event.target;
         const item = target.closest('mdui-navigation-bar-item');
+        if (!item) {
+            return;
+        }
         this.activeKey = item.key;
         this.isInitial = false;
         this.updateItems();