mdui 2.0.1 → 2.0.3

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

@@ -1,12 +1,9 @@
 import { __decorate } from "tslib";
 import { html } from 'lit';
-import { customElement, property, state } from 'lit/decorators.js';
-import { $ } from '@mdui/jq/$.js';
-import '@mdui/jq/methods/find.js';
-import '@mdui/jq/methods/get.js';
+import { customElement, property, queryAssignedElements, state, } from 'lit/decorators.js';
+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';
@@ -33,7 +30,7 @@ import { navigationBarStyle } from './navigation-bar-style.js';
  * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
  * @cssprop --z-index - 组件的 CSS 的 `z-index` 值
  */
-export let NavigationBar = class NavigationBar extends ScrollBehaviorMixin(LayoutItemBase) {
+let NavigationBar = class NavigationBar extends ScrollBehaviorMixin(LayoutItemBase) {
     constructor() {
         super(...arguments);
         /**
@@ -51,8 +48,11 @@ export let NavigationBar = class NavigationBar extends ScrollBehaviorMixin(Layou
         this.labelVisibility = 'auto';
         // 因为 navigation-bar-item 的 value 可能会重复，所以在每个 navigation-bar-item 元素上都添加了一个唯一的 key，通过 activeKey 来记录激活状态的 key
         this.activeKey = 0;
-        // 是否已完成初始 value 的设置。首次设置初始值时，不触发 change 事件
-        this.hasSetDefaultValue = false;
+        // 是否是初始状态，初始状态不触发 change 事件，没有动画
+        this.isInitial = true;
+        this.definedController = new DefinedController(this, {
+            relatedElements: ['mdui-navigation-bar-item'],
+        });
     }
     get scrollPaddingPosition() {
         return 'bottom';
@@ -60,46 +60,31 @@ export let NavigationBar = class NavigationBar extends ScrollBehaviorMixin(Layou
     get layoutPlacement() {
         return 'bottom';
     }
-    // 所有的子项元素
-    get items() {
-        return $(this)
-            .find('mdui-navigation-bar-item')
-            .get();
-    }
-    onActiveKeyChange() {
+    async onActiveKeyChange() {
+        await this.definedController.whenDefined();
         // 根据 activeKey 读取对应 navigation-bar-item 的值
         const item = this.items.find((item) => item.key === this.activeKey);
-        this.value = item === null || item === void 0 ? void 0 : item.value;
-        if (this.hasSetDefaultValue) {
-            emit(this, 'change');
-        }
-        else {
-            this.hasSetDefaultValue = true;
+        this.value = item?.value;
+        if (!this.isInitial) {
+            this.emit('change');
         }
     }
-    onValueChange() {
-        var _a;
+    async onValueChange() {
+        this.isInitial = !this.hasUpdated;
+        await this.definedController.whenDefined();
         const item = this.items.find((item) => item.value === this.value);
-        this.activeKey = (_a = item === null || item === void 0 ? void 0 : item.key) !== null && _a !== void 0 ? _a : 0;
-        this.updateActive();
+        this.activeKey = item?.key ?? 0;
+        this.updateItems();
     }
-    onLabelVisibilityChange() {
-        const items = this.items;
-        // 为 navigation-bar-item 设置 labelVisibility 属性
-        const labelVisibility = this.labelVisibility === 'auto'
-            ? items.length <= 3
-                ? 'labeled'
-                : 'selected'
-            : this.labelVisibility;
-        items.forEach((item) => {
-            item.labelVisibility = labelVisibility;
-        });
+    async onLabelVisibilityChange() {
+        await this.definedController.whenDefined();
+        this.updateItems();
     }
-    connectedCallback() {
-        super.connectedCallback();
+    firstUpdated(_changedProperties) {
+        super.firstUpdated(_changedProperties);
         this.addEventListener('transitionend', (event) => {
             if (event.target === this) {
-                emit(this, this.hide ? 'hidden' : 'shown');
+                this.emit(this.hide ? 'hidden' : 'shown');
             }
         });
     }
@@ -113,15 +98,15 @@ export let NavigationBar = class NavigationBar extends ScrollBehaviorMixin(Layou
     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;
             }
         }
@@ -133,14 +118,31 @@ export let NavigationBar = class NavigationBar extends ScrollBehaviorMixin(Layou
         }
         const target = event.target;
         const item = target.closest('mdui-navigation-bar-item');
+        if (!item) {
+            return;
+        }
         this.activeKey = item.key;
-        this.updateActive();
+        this.isInitial = false;
+        this.updateItems();
     }
-    updateActive() {
-        this.items.forEach((item) => (item.active = this.activeKey === item.key));
+    // 更新 <mdui-navigation-bar-item> 的状态
+    updateItems() {
+        const items = this.items;
+        // <mdui-navigation-bar-item> 的 labelVisibility 不含 auto
+        const labelVisibility = this.labelVisibility === 'auto'
+            ? items.length <= 3
+                ? 'labeled'
+                : 'selected'
+            : this.labelVisibility;
+        items.forEach((item) => {
+            item.active = this.activeKey === item.key;
+            item.labelVisibility = labelVisibility;
+            item.isInitial = this.isInitial;
+        });
     }
-    onSlotChange() {
-        this.onLabelVisibilityChange();
+    async onSlotChange() {
+        await this.definedController.whenDefined();
+        this.updateItems();
     }
 };
 NavigationBar.styles = [
@@ -167,7 +169,13 @@ __decorate([
     state()
 ], NavigationBar.prototype, "activeKey", void 0);
 __decorate([
-    watch('activeKey')
+    queryAssignedElements({
+        selector: 'mdui-navigation-bar-item',
+        flatten: true,
+    })
+], NavigationBar.prototype, "items", void 0);
+__decorate([
+    watch('activeKey', true)
 ], NavigationBar.prototype, "onActiveKeyChange", null);
 __decorate([
     watch('value')
@@ -178,3 +186,4 @@ __decorate([
 NavigationBar = __decorate([
     customElement('mdui-navigation-bar')
 ], NavigationBar);
+export { NavigationBar };

package/components/navigation-drawer/index.d.ts

@@ -2,7 +2,7 @@ import '@mdui/jq/methods/css.js';
 import '@mdui/jq/methods/innerWidth.js';
 import { LayoutItemBase } from '../layout/layout-item-base.js';
 import type { LayoutPlacement } from '../layout/helper.js';
-import type { CSSResultGroup, TemplateResult } from 'lit';
+import type { CSSResultGroup, PropertyValues, TemplateResult } from 'lit';
 /**
  * 在手机端，`modal` 始终为 `true`；大于手机端时，`modal` 属性才开始生效
  *
@@ -26,7 +26,7 @@ import type { CSSResultGroup, TemplateResult } from 'lit';
  * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
  * @cssprop --z-index - 组件的 CSS 的 `z-index` 值
  */
-export declare class NavigationDrawer extends LayoutItemBase {
+export declare class NavigationDrawer extends LayoutItemBase<NavigationDrawerEventMap> {
     static styles: CSSResultGroup;
     /**
      * 是否打开抽屉导航
@@ -66,16 +66,27 @@ export declare class NavigationDrawer extends LayoutItemBase {
     private modalHelper;
     private readonly overlayRef;
     private readonly panelRef;
+    private readonly definedController;
     protected get layoutPlacement(): LayoutPlacement;
     private get lockTarget();
     private get isModal();
     private onContainedChange;
     private onPlacementChange;
+    private onMobileChange;
     private onOpenChange;
     connectedCallback(): void;
     disconnectedCallback(): void;
+    protected firstUpdated(_changedProperties: PropertyValues): void;
     protected render(): TemplateResult;
     private onOverlayClick;
+    private getLockTargetAnimate;
+}
+export interface NavigationDrawerEventMap {
+    open: CustomEvent<void>;
+    opened: CustomEvent<void>;
+    close: CustomEvent<void>;
+    closed: CustomEvent<void>;
+    'overlay-click': CustomEvent<void>;
 }
 declare global {
     interface HTMLElementTagNameMap {

package/components/navigation-drawer/index.js

@@ -6,12 +6,12 @@ import { when } from 'lit/directives/when.js';
 import { $ } from '@mdui/jq/$.js';
 import '@mdui/jq/methods/css.js';
 import '@mdui/jq/methods/innerWidth.js';
-import { isNull } from '@mdui/jq/shared/helper.js';
+import { isFunction, isNull } from '@mdui/jq/shared/helper.js';
+import { DefinedController } from '@mdui/shared/controllers/defined.js';
 import { watch } from '@mdui/shared/decorators/watch.js';
 import { animateTo, stopAnimations } from '@mdui/shared/helpers/animate.js';
 import { breakpoint } from '@mdui/shared/helpers/breakpoint.js';
 import { booleanConverter } from '@mdui/shared/helpers/decorator.js';
-import { emit } from '@mdui/shared/helpers/event.js';
 import { Modal } from '@mdui/shared/helpers/modal.js';
 import { getDuration, getEasing } from '@mdui/shared/helpers/motion.js';
 import { observeResize } from '@mdui/shared/helpers/observeResize.js';
@@ -42,7 +42,7 @@ import { style } from './style.js';
  * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
  * @cssprop --z-index - 组件的 CSS 的 `z-index` 值
  */
-export let NavigationDrawer = class NavigationDrawer extends LayoutItemBase {
+let NavigationDrawer = class NavigationDrawer extends LayoutItemBase {
     constructor() {
         super(...arguments);
         /**
@@ -81,6 +81,9 @@ export let NavigationDrawer = class NavigationDrawer extends LayoutItemBase {
         this.mobile = false;
         this.overlayRef = createRef();
         this.panelRef = createRef();
+        this.definedController = new DefinedController(this, {
+            needDomReady: true,
+        });
     }
     get layoutPlacement() {
         return this.placement;
@@ -94,11 +97,9 @@ export let NavigationDrawer = class NavigationDrawer extends LayoutItemBase {
         return this.mobile || this.modal;
     }
     // contained 变更后，修改监听尺寸变化的元素。为 true 时，监听父元素；为 false 时，监听 body
-    onContainedChange() {
-        var _a;
-        if (this.hasUpdated) {
-            (_a = this.observeResize) === null || _a === void 0 ? void 0 : _a.unobserve();
-        }
+    async onContainedChange() {
+        await this.definedController.whenDefined();
+        this.observeResize?.unobserve();
         this.observeResize = observeResize(this.contained ? this.parentElement : document.body, () => {
             const target = this.contained ? this.parentElement : undefined;
             this.mobile = breakpoint(target).down('md');
@@ -115,11 +116,24 @@ export let NavigationDrawer = class NavigationDrawer extends LayoutItemBase {
             this.layoutManager.updateLayout(this);
         }
     }
+    async onMobileChange() {
+        if (!this.open || this.isParentLayout || this.contained) {
+            return;
+        }
+        await this.definedController.whenDefined();
+        if (this.isModal) {
+            lockScreen(this, this.lockTarget);
+            await this.getLockTargetAnimate(false, 0);
+        }
+        else {
+            unlockScreen(this, this.lockTarget);
+            await this.getLockTargetAnimate(true, 0);
+        }
+    }
     async onOpenChange() {
         let panel = this.panelRef.value;
         let overlay = this.overlayRef.value;
         const isRight = this.placement === 'right';
-        const paddingPropName = isRight ? 'paddingRight' : 'paddingLeft';
         const easingLinear = getEasing(this, 'linear');
         const easingEmphasized = getEasing(this, 'emphasized');
         // 在当前 drawer 位于 layout 中时，设置所有 layout-item 和 layout-main 元素的 transition 样式
@@ -147,16 +161,19 @@ export let NavigationDrawer = class NavigationDrawer extends LayoutItemBase {
                 overlay = this.overlayRef.value;
             }
             if (hasUpdated) {
-                const requestOpen = emit(this, 'open', { cancelable: true });
-                if (requestOpen.defaultPrevented) {
+                const eventProceeded = this.emit('open', { cancelable: true });
+                if (!eventProceeded) {
                     return;
                 }
             }
+            await this.definedController.whenDefined();
             this.style.display = 'block';
             this.originalTrigger = document.activeElement;
             if (this.isModal) {
                 this.modalHelper.activate();
-                lockScreen(this, this.lockTarget);
+                if (!this.contained) {
+                    lockScreen(this, this.lockTarget);
+                }
             }
             await stopOldAnimations();
             // 设置聚焦
@@ -180,14 +197,7 @@ export let NavigationDrawer = class NavigationDrawer extends LayoutItemBase {
             }
             // 不位于 layout 中，父元素 padding 变化的动画
             else if (!this.isParentLayout) {
-                animations.push(animateTo(this.lockTarget, [
-                    { [paddingPropName]: 0 },
-                    { [paddingPropName]: $(panel).innerWidth() + 'px' },
-                ], {
-                    duration: hasUpdated ? duration : 0,
-                    easing: easingEmphasized,
-                    fill: 'forwards',
-                }));
+                animations.push(this.getLockTargetAnimate(true, hasUpdated ? duration : 0));
             }
             // 若位于 layout 中，则 layout-main 的 padding 变化需要有和 drawer 相同的动画
             // 但首次渲染不执行动画
@@ -208,16 +218,16 @@ export let NavigationDrawer = class NavigationDrawer extends LayoutItemBase {
                 setLayoutTransition(null);
             }
             if (hasUpdated) {
-                emit(this, 'opened');
+                this.emit('opened');
             }
-            return;
         }
-        // 关闭
-        if (!this.open && this.hasUpdated) {
-            const requestClose = emit(this, 'close', { cancelable: true });
-            if (requestClose.defaultPrevented) {
+        else if (this.hasUpdated) {
+            // 关闭
+            const eventProceeded = this.emit('close', { cancelable: true });
+            if (!eventProceeded) {
                 return;
             }
+            await this.definedController.whenDefined();
             if (this.isModal) {
                 this.modalHelper.deactivate();
             }
@@ -233,14 +243,7 @@ export let NavigationDrawer = class NavigationDrawer extends LayoutItemBase {
             }
             // 不位于 layout 中，父元素 padding 变化的动画
             else if (!this.isParentLayout) {
-                animations.push(animateTo(this.lockTarget, [
-                    { [paddingPropName]: $(panel).innerWidth() + 'px' },
-                    { [paddingPropName]: 0 },
-                ], {
-                    duration,
-                    easing: easingEmphasized,
-                    fill: 'forwards',
-                }));
+                animations.push(this.getLockTargetAnimate(false, duration));
             }
             // 若位于 layout 中，则 layout-main 的 padding 变化需要有和 drawer 相同的动画
             if (this.isParentLayout) {
@@ -260,21 +263,28 @@ export let NavigationDrawer = class NavigationDrawer extends LayoutItemBase {
                 setLayoutTransition(null);
             }
             this.style.display = 'none';
-            if (this.isModal) {
+            if (this.isModal && !this.contained) {
                 unlockScreen(this, this.lockTarget);
             }
             // 抽屉导航关闭后，恢复焦点到原有的元素上
             const trigger = this.originalTrigger;
-            if (typeof (trigger === null || trigger === void 0 ? void 0 : trigger.focus) === 'function') {
+            if (isFunction(trigger?.focus)) {
                 setTimeout(() => trigger.focus());
             }
-            emit(this, 'closed');
-            return;
+            this.emit('closed');
         }
     }
     connectedCallback() {
         super.connectedCallback();
         this.modalHelper = new Modal(this);
+    }
+    disconnectedCallback() {
+        super.disconnectedCallback();
+        unlockScreen(this, this.lockTarget);
+        this.observeResize?.unobserve();
+    }
+    firstUpdated(_changedProperties) {
+        super.firstUpdated(_changedProperties);
         this.addEventListener('keydown', (event) => {
             if (this.open &&
                 this.closeOnEsc &&
@@ -285,21 +295,26 @@ export let NavigationDrawer = class NavigationDrawer extends LayoutItemBase {
             }
         });
     }
-    disconnectedCallback() {
-        var _a;
-        super.disconnectedCallback();
-        unlockScreen(this, this.lockTarget);
-        (_a = this.observeResize) === null || _a === void 0 ? void 0 : _a.unobserve();
-    }
     render() {
         return html `${when(this.isModal, () => html `<div ${ref(this.overlayRef)} part="overlay" class="overlay" @click="${this.onOverlayClick}"></div>`)}<slot ${ref(this.panelRef)} part="panel" class="panel" tabindex="0"></slot>`;
     }
     onOverlayClick() {
-        emit(this, 'overlay-click');
-        if (!this.closeOnOverlayClick) {
-            return;
+        this.emit('overlay-click');
+        if (this.closeOnOverlayClick) {
+            this.open = false;
         }
-        this.open = false;
+    }
+    getLockTargetAnimate(open, duration) {
+        const paddingName = this.placement === 'right' ? 'paddingRight' : 'paddingLeft';
+        const panelWidth = $(this.panelRef.value).innerWidth() + 'px';
+        return animateTo(this.lockTarget, [
+            { [paddingName]: open ? 0 : panelWidth },
+            { [paddingName]: open ? panelWidth : 0 },
+        ], {
+            duration,
+            easing: getEasing(this, 'emphasized'),
+            fill: 'forwards',
+        });
     }
 };
 NavigationDrawer.styles = [componentStyle, style];
@@ -355,11 +370,16 @@ __decorate([
     watch('contained')
 ], NavigationDrawer.prototype, "onContainedChange", null);
 __decorate([
-    watch('placement')
+    watch('placement', true)
 ], NavigationDrawer.prototype, "onPlacementChange", null);
+__decorate([
+    watch('mobile', true),
+    watch('modal', true)
+], NavigationDrawer.prototype, "onMobileChange", null);
 __decorate([
     watch('open')
 ], NavigationDrawer.prototype, "onOpenChange", null);
 NavigationDrawer = __decorate([
     customElement('mdui-navigation-drawer')
 ], NavigationDrawer);
+export { NavigationDrawer };

package/components/navigation-drawer/style.js

@@ -1,2 +1,2 @@
 import { css } from 'lit';
-export const style = css `:host{--shape-corner:var(--mdui-shape-corner-large);--z-index:2200;display:none;position:fixed;top:0;bottom:0;left:0;z-index:1;width:22.5rem}:host([placement=right]){left:initial;right:0}:host([mobile]),:host([modal]){top:0!important;right:0;bottom:0!important;width:initial;z-index:var(--z-index)}:host([placement=right][mobile]),:host([placement=right][modal]){left:0}:host([contained]){position:absolute}.overlay{position:absolute;inset:0;z-index:inherit;background-color:rgba(var(--mdui-color-scrim),.4)}.panel{display:block;position:absolute;top:0;bottom:0;left:0;width:100%;overflow:auto;z-index:inherit;background-color:rgb(var(--mdui-color-surface));box-shadow:var(--mdui-elevation-level0)}:host([mobile]) .panel,:host([modal]) .panel{border-radius:0 var(--shape-corner) var(--shape-corner) 0;width:22.5rem;background-color:rgb(var(--mdui-color-surface-container-low));box-shadow:var(--mdui-elevation-level1)}:host([placement=right]) .panel{left:initial;right:0}:host([placement=right][mobile]) .panel,:host([placement=right][modal]) .panel{border-radius:var(--shape-corner) 0 0 var(--shape-corner)}`;
+export const style = css `:host{--shape-corner:var(--mdui-shape-corner-large);--z-index:2200;display:none;position:fixed;top:0;bottom:0;left:0;z-index:1;width:22.5rem}:host([placement=right]){left:initial;right:0}:host([mobile]),:host([modal]){top:0!important;right:0;bottom:0!important;width:initial;z-index:var(--z-index)}:host([placement=right][mobile]),:host([placement=right][modal]){left:0}:host([contained]){position:absolute}.overlay{position:absolute;inset:0;z-index:inherit;background-color:rgba(var(--mdui-color-scrim),.4)}.panel{display:block;position:absolute;top:0;bottom:0;left:0;width:100%;overflow:auto;z-index:inherit;background-color:rgb(var(--mdui-color-surface));box-shadow:var(--mdui-elevation-level0)}:host([mobile]) .panel,:host([modal]) .panel{border-radius:0 var(--shape-corner) var(--shape-corner) 0;max-width:80%;width:22.5rem;background-color:rgb(var(--mdui-color-surface-container-low));box-shadow:var(--mdui-elevation-level1)}:host([placement=right]) .panel{left:initial;right:0}:host([placement=right][mobile]) .panel,:host([placement=right][modal]) .panel{border-radius:var(--shape-corner) 0 0 var(--shape-corner)}`;

package/components/navigation-rail/navigation-rail-item-style.js

@@ -1,2 +1,2 @@
 import { css } from 'lit';
-export const navigationRailItemStyle = css `:host{--shape-corner-indicator:var(--mdui-shape-corner-full);position:relative;z-index:0;width:100%;--mdui-comp-ripple-state-layer-color:var(--mdui-color-on-surface-variant)}.container{display:flex;flex-direction:column;align-items:center;justify-content:center;text-decoration:none;cursor:pointer;-webkit-user-select:none;user-select:none;-webkit-tap-highlight-color:transparent;transition:padding var(--mdui-motion-duration-short4) var(--mdui-motion-easing-standard);height:3.5rem}mdui-ripple{z-index:1;width:3.5rem;height:2rem;border-radius:var(--mdui-shape-corner-full)}.container:not(.has-label)+mdui-ripple{height:3.5rem}.indicator{position:relative;display:flex;align-items:center;justify-content:center;background-color:transparent;border-radius:var(--shape-corner-indicator);transition:background-color var(--mdui-motion-duration-short1) var(--mdui-motion-easing-standard),width var(--mdui-motion-duration-short4) var(--mdui-motion-easing-standard),height var(--mdui-motion-duration-short4) var(--mdui-motion-easing-standard);height:2rem;width:2rem}::slotted([slot=badge]){position:absolute;transform:translate(50%,-50%)}:host([placement=right]) ::slotted([slot=badge]){transform:translate(-50%,-50%)}::slotted([slot=badge][variant=small]){transform:translate(.5625rem,-.5625rem)}:host([placement=right]) ::slotted([slot=badge][variant=small]){transform:translate(-.5625rem,-.5625rem)}.active-icon,.icon{color:rgb(var(--mdui-color-on-surface-variant));font-size:1.5rem}.active-icon mdui-icon,.icon mdui-icon,::slotted([slot=active-icon]),::slotted([slot=icon]){font-size:inherit}.icon{display:flex}.active-icon{display:none}.label{display:flex;align-items:center;transition:opacity var(--mdui-motion-duration-short4) var(--mdui-motion-easing-linear);height:1rem;color:rgb(var(--mdui-color-on-surface-variant));margin-top:.25rem;margin-bottom:.25rem;font-size:var(--mdui-typescale-label-medium-size);font-weight:var(--mdui-typescale-label-medium-weight);letter-spacing:var(--mdui-typescale-label-medium-tracking);line-height:var(--mdui-typescale-label-medium-line-height)}:host([active]){--mdui-comp-ripple-state-layer-color:var(--mdui-color-on-surface)}:host([active]) .indicator{width:3.5rem;background-color:rgb(var(--mdui-color-secondary-container))}:host([active]) :not(.has-label) .indicator{height:3.5rem}:host([active]) .active-icon,:host([active]) .icon{color:rgb(var(--mdui-color-on-secondary-container))}:host([active]) .has-active-icon .active-icon{display:flex}:host([active]) .has-active-icon .icon{display:none}:host([active]) .label{color:rgb(var(--mdui-color-on-surface))}`;
+export const navigationRailItemStyle = css `:host{--shape-corner-indicator:var(--mdui-shape-corner-full);position:relative;z-index:0;width:100%;--mdui-comp-ripple-state-layer-color:var(--mdui-color-on-surface-variant)}.container{display:flex;flex-direction:column;align-items:center;justify-content:center;text-decoration:none;cursor:pointer;-webkit-user-select:none;user-select:none;-webkit-tap-highlight-color:transparent;height:3.5rem}.container:not(.initial){transition:padding var(--mdui-motion-duration-short4) var(--mdui-motion-easing-standard)}mdui-ripple{z-index:1;width:3.5rem;height:2rem;border-radius:var(--mdui-shape-corner-full)}.container:not(.has-label)+mdui-ripple{height:3.5rem}.indicator{position:relative;display:flex;align-items:center;justify-content:center;background-color:transparent;border-radius:var(--shape-corner-indicator);height:2rem;width:2rem}:not(.initial) .indicator{transition:background-color var(--mdui-motion-duration-short1) var(--mdui-motion-easing-standard),width var(--mdui-motion-duration-short4) var(--mdui-motion-easing-standard),height var(--mdui-motion-duration-short4) var(--mdui-motion-easing-standard)}::slotted([slot=badge]){position:absolute;transform:translate(50%,-50%)}.placement-right::slotted([slot=badge]){transform:translate(-50%,-50%)}::slotted([slot=badge][variant=small]){transform:translate(.5625rem,-.5625rem)}.placement-right::slotted([slot=badge][variant=small]){transform:translate(-.5625rem,-.5625rem)}.active-icon,.icon{color:rgb(var(--mdui-color-on-surface-variant));font-size:1.5rem}.active-icon mdui-icon,.icon mdui-icon,::slotted([slot=active-icon]),::slotted([slot=icon]){font-size:inherit}.icon{display:flex}.active-icon{display:none}.label{display:flex;align-items:center;height:1rem;color:rgb(var(--mdui-color-on-surface-variant));margin-top:.25rem;margin-bottom:.25rem;font-size:var(--mdui-typescale-label-medium-size);font-weight:var(--mdui-typescale-label-medium-weight);letter-spacing:var(--mdui-typescale-label-medium-tracking);line-height:var(--mdui-typescale-label-medium-line-height)}:not(.initial) .label{transition:opacity var(--mdui-motion-duration-short4) var(--mdui-motion-easing-linear)}:host([active]){--mdui-comp-ripple-state-layer-color:var(--mdui-color-on-surface)}:host([active]) .indicator{width:3.5rem;background-color:rgb(var(--mdui-color-secondary-container))}:host([active]) :not(.has-label) .indicator{height:3.5rem}:host([active]) .active-icon,:host([active]) .icon{color:rgb(var(--mdui-color-on-secondary-container))}:host([active]) .has-active-icon .active-icon{display:flex}:host([active]) .has-active-icon .icon{display:none}:host([active]) .label{color:rgb(var(--mdui-color-on-surface))}`;

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

@@ -1,8 +1,8 @@
-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 NavigationRailItem_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 NavigationRailItem_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-rail>` 组件配合使用
  *
@@ -31,7 +31,7 @@ declare const NavigationRailItem_base: import("@open-wc/dedupe-mixin").Construct
  *
  * @cssprop --shape-corner-indicator - 指示器的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
  */
-export declare class NavigationRailItem extends NavigationRailItem_base {
+export declare class NavigationRailItem extends NavigationRailItem_base<NavigationRailItemEventMap> {
     static styles: CSSResultGroup;
     /**
      * 未激活状态的 Material Icons 图标名。也可以通过 `slot="icon"` 设置
@@ -46,11 +46,15 @@ export declare class NavigationRailItem extends NavigationRailItem_base {
      */
     value?: string;
     /**
-     * 是否为激活状态，由 `navigation-rail` 组件控制该参数
+     * 是否为激活状态，由 `<mdui-navigation-rail>` 组件控制该参数
      */
     protected active: boolean;
     /**
-     * 导航栏的位置，由 `navigation-rail` 组件控制该参数
+     * 是否是初始状态，不显示动画。由 `<mdui-navigation-rail>` 组件控制该参数
+     */
+    protected isInitial: boolean;
+    /**
+     * 导航栏的位置，由 `<mdui-navigation-rail>` 组件控制该参数
      */
     protected placement: 'left' | 'right';
     private disabled;
@@ -64,6 +68,10 @@ export declare class NavigationRailItem extends NavigationRailItem_base {
     protected render(): TemplateResult;
     private renderInner;
 }
+export interface NavigationRailItemEventMap {
+    focus: FocusEvent;
+    blur: FocusEvent;
+}
 declare global {
     interface HTMLElementTagNameMap {
         'mdui-navigation-rail-item': NavigationRailItem;

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

@@ -1,8 +1,10 @@
 import { __decorate } from "tslib";
-import { html, LitElement, nothing } from 'lit';
+import { html, nothing } from 'lit';
 import { customElement, property, state } from 'lit/decorators.js';
+import { classMap } from 'lit/directives/class-map.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';
@@ -41,20 +43,24 @@ import { navigationRailItemStyle } from './navigation-rail-item-style.js';
  *
  * @cssprop --shape-corner-indicator - 指示器的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
  */
-export let NavigationRailItem = class NavigationRailItem extends AnchorMixin(RippleMixin(FocusableMixin(LitElement))) {
+let NavigationRailItem = class NavigationRailItem extends AnchorMixin(RippleMixin(FocusableMixin(MduiElement))) {
     constructor() {
         super(...arguments);
         /**
-         * 是否为激活状态，由 `navigation-rail` 组件控制该参数
+         * 是否为激活状态，由 `<mdui-navigation-rail>` 组件控制该参数
          */
         this.active = false;
         /**
-         * 导航栏的位置，由 `navigation-rail` 组件控制该参数
+         * 是否是初始状态，不显示动画。由 `<mdui-navigation-rail>` 组件控制该参数
+         */
+        this.isInitial = true;
+        /**
+         * 导航栏的位置，由 `<mdui-navigation-rail>` 组件控制该参数
          */
         this.placement = 'left';
         // 是否禁用该元素，该组件没有禁用状态
         this.disabled = false;
-        // 每一个 `navigation-rail-item` 元素都添加一个唯一的 key
+        // 每一个 `<mdui-navigation-rail-item>` 元素都添加一个唯一的 key
         this.key = uniqueId();
         this.rippleRef = createRef();
         this.hasSlotController = new HasSlotController(this, '[default]', 'active-icon');
@@ -66,8 +72,7 @@ export let NavigationRailItem = class NavigationRailItem extends AnchorMixin(Rip
         return this.disabled;
     }
     get focusElement() {
-        var _a;
-        return this.href ? (_a = this.renderRoot) === null || _a === void 0 ? void 0 : _a.querySelector('._a') : this;
+        return this.href ? this.renderRoot?.querySelector('._a') : this;
     }
     get focusDisabled() {
         return this.disabled;
@@ -78,6 +83,7 @@ export let NavigationRailItem = class NavigationRailItem extends AnchorMixin(Rip
             container: true,
             'has-label': hasDefaultSlot,
             'has-active-icon': this.activeIcon || this.hasSlotController.test('active-icon'),
+            initial: this.isInitial,
         });
         return html `${this.href
             ? this.renderAnchor({
@@ -88,7 +94,10 @@ export let NavigationRailItem = class NavigationRailItem extends AnchorMixin(Rip
             : html `<div part="container" class="${className}">${this.renderInner(hasDefaultSlot)}</div>`}<mdui-ripple .noRipple="${!this.active || this.noRipple}" ${ref(this.rippleRef)}></mdui-ripple>`;
     }
     renderInner(hasDefaultSlot) {
-        return html `<div part="indicator" class="indicator"><slot name="badge" part="badge" class="badge"></slot><slot name="active-icon" part="active-icon" class="active-icon">${this.activeIcon
+        return html `<div part="indicator" class="indicator"><slot name="badge" part="badge" class="${classMap({
+            badge: true,
+            'placement-right': this.placement === 'right',
+        })}"></slot><slot name="active-icon" part="active-icon" class="active-icon">${this.activeIcon
             ? html `<mdui-icon name="${this.activeIcon}"></mdui-icon>`
             : nothingTemplate}</slot><slot name="icon" part="icon" class="icon">${this.icon
             ? html `<mdui-icon name="${this.icon}"></mdui-icon>`
@@ -118,7 +127,10 @@ __decorate([
     })
 ], NavigationRailItem.prototype, "active", void 0);
 __decorate([
-    property({ reflect: true })
+    state()
+], NavigationRailItem.prototype, "isInitial", void 0);
+__decorate([
+    state()
 ], NavigationRailItem.prototype, "placement", void 0);
 __decorate([
     state()
@@ -126,3 +138,4 @@ __decorate([
 NavigationRailItem = __decorate([
     customElement('mdui-navigation-rail-item')
 ], NavigationRailItem);
+export { NavigationRailItem };