mdui 2.1.2 → 2.1.3

package/components/top-app-bar/top-app-bar.js

@@ -65,7 +65,7 @@ let TopAppBar = class TopAppBar extends ScrollBehaviorMixin(LayoutItemBase) {
             // variant 变更时，重新为 scrollTargetContainer 元素添加 padding-top。避免 top-app-bar 覆盖内容
             this.addEventListener('transitionend', async () => {
                 await this.scrollBehaviorDefinedController.whenDefined();
-                this.updateContainerPadding();
+                this.setContainerPadding('update', this.scrollTarget);
             }, { once: true });
         }
         else {

package/custom-elements.json

@@ -572,13 +572,28 @@
             },
             {
               "kind": "method",
-              "name": "updateContainerPadding",
+              "name": "setContainerPadding",
               "privacy": "protected",
               "return": {
                 "type": {
                   "text": "void"
                 }
-              }
+              },
+              "parameters": [
+                {
+                  "name": "action",
+                  "type": {
+                    "text": "'add' | 'update' | 'remove'"
+                  }
+                },
+                {
+                  "name": "scrollTarget",
+                  "optional": true,
+                  "type": {
+                    "text": "string | HTMLElement | JQ<HTMLElement>"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
@@ -705,21 +720,7 @@
             {
               "kind": "method",
               "name": "onScrollBehaviorChange",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "oldValue",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "newValue",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ]
+              "privacy": "private"
             },
             {
               "kind": "method",
@@ -787,7 +788,7 @@
             },
             {
               "kind": "method",
-              "name": "updateContainerPadding",
+              "name": "setContainerPadding",
               "privacy": "protected",
               "return": {
                 "type": {
@@ -796,12 +797,22 @@
               },
               "parameters": [
                 {
-                  "name": "withPadding",
-                  "default": "true",
-                  "description": "该值为 false 时，为移除 padding"
+                  "name": "action",
+                  "type": {
+                    "text": "'add' | 'update' | 'remove'"
+                  },
+                  "description": "新增、更新、移除 padding"
+                },
+                {
+                  "name": "scrollTarget",
+                  "optional": true,
+                  "type": {
+                    "text": "string | HTMLElement | JQ<HTMLElement>"
+                  },
+                  "description": "在该元素上添加、更新或移除 padding"
                 }
               ],
-              "description": "更新滚动容器的 padding，避免内容被 navigation-bar 覆盖\n仅 scrollBehavior 包含 hide、shrink 时，添加 padding"
+              "description": "更新滚动容器的 padding，避免内容被 navigation-bar 覆盖"
             },
             {
               "kind": "method",
@@ -1378,20 +1389,6 @@
               "kind": "method",
               "name": "onScrollBehaviorChange",
               "privacy": "private",
-              "parameters": [
-                {
-                  "name": "oldValue",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "newValue",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
               "inheritedFrom": {
                 "name": "ScrollBehaviorMixin",
                 "module": "@mdui/shared/mixins/scrollBehavior.js"
@@ -1449,7 +1446,7 @@
             },
             {
               "kind": "method",
-              "name": "updateContainerPadding",
+              "name": "setContainerPadding",
               "privacy": "protected",
               "return": {
                 "type": {
@@ -1458,12 +1455,22 @@
               },
               "parameters": [
                 {
-                  "name": "withPadding",
-                  "default": "true",
-                  "description": "该值为 false 时，为移除 padding"
+                  "name": "action",
+                  "type": {
+                    "text": "'add' | 'update' | 'remove'"
+                  },
+                  "description": "新增、更新、移除 padding"
+                },
+                {
+                  "name": "scrollTarget",
+                  "optional": true,
+                  "type": {
+                    "text": "string | HTMLElement | JQ<HTMLElement>"
+                  },
+                  "description": "在该元素上添加、更新或移除 padding"
                 }
               ],
-              "description": "更新滚动容器的 padding，避免内容被 navigation-bar 覆盖\n仅 scrollBehavior 包含 hide、shrink 时，添加 padding",
+              "description": "更新滚动容器的 padding，避免内容被 navigation-bar 覆盖",
               "inheritedFrom": {
                 "name": "ScrollBehaviorMixin",
                 "module": "@mdui/shared/mixins/scrollBehavior.js"
@@ -14145,20 +14152,6 @@
               "kind": "method",
               "name": "onScrollBehaviorChange",
               "privacy": "private",
-              "parameters": [
-                {
-                  "name": "oldValue",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "newValue",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
               "inheritedFrom": {
                 "name": "ScrollBehaviorMixin",
                 "module": "@mdui/shared/mixins/scrollBehavior.js"
@@ -14216,7 +14209,7 @@
             },
             {
               "kind": "method",
-              "name": "updateContainerPadding",
+              "name": "setContainerPadding",
               "privacy": "protected",
               "return": {
                 "type": {
@@ -14225,12 +14218,22 @@
               },
               "parameters": [
                 {
-                  "name": "withPadding",
-                  "default": "true",
-                  "description": "该值为 false 时，为移除 padding"
+                  "name": "action",
+                  "type": {
+                    "text": "'add' | 'update' | 'remove'"
+                  },
+                  "description": "新增、更新、移除 padding"
+                },
+                {
+                  "name": "scrollTarget",
+                  "optional": true,
+                  "type": {
+                    "text": "string | HTMLElement | JQ<HTMLElement>"
+                  },
+                  "description": "在该元素上添加、更新或移除 padding"
                 }
               ],
-              "description": "更新滚动容器的 padding，避免内容被 navigation-bar 覆盖\n仅 scrollBehavior 包含 hide、shrink 时，添加 padding",
+              "description": "更新滚动容器的 padding，避免内容被 navigation-bar 覆盖",
               "inheritedFrom": {
                 "name": "ScrollBehaviorMixin",
                 "module": "@mdui/shared/mixins/scrollBehavior.js"
@@ -14721,6 +14724,11 @@
               "name": "onOpenChange",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "setObserveResize",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "onOverlayClick",
@@ -22371,6 +22379,17 @@
               "attribute": "close-on-outside-click",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "mobile",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "attribute": "mobile",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "closeTimeout",
@@ -22379,11 +22398,41 @@
               },
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "observeResize",
+              "type": {
+                "text": "ObserveResize | undefined"
+              },
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "onOpenChange",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "onStackChange",
+              "privacy": "private",
+              "description": "这两个属性变更时，需要重新排序该组件后面的 snackbar"
+            },
+            {
+              "kind": "method",
+              "name": "reorderStack",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "startSnackbar",
+                  "optional": true,
+                  "type": {
+                    "text": "Snackbar"
+                  },
+                  "description": "从哪个 snackbar 开始重新排列，默认从第一个开始"
+                }
+              ],
+              "description": "重新排序 snackbar 堆叠"
+            },
             {
               "kind": "method",
               "name": "onDocumentClick",
@@ -22517,6 +22566,14 @@
               "default": "false",
               "description": "点击或触摸 Snackbar 以外的区域时，是否关闭 Snackbar",
               "fieldName": "closeOnOutsideClick"
+            },
+            {
+              "name": "mobile",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "mobile"
             }
           ],
           "superclass": {
@@ -24668,10 +24725,10 @@
               "kind": "field",
               "name": "autocomplete",
               "type": {
-                "text": "| /*禁用浏览器的自动填充，使用者必须输入他们想要输入的所有内容。或者网页提供了自己的自动填充方法*/ 'off'\n    | /*浏览器根据用户之前输入的内容或者习惯，在用户输入的时候给出相应输入提示*/ 'on' | undefined"
+                "text": "string | undefined"
               },
               "privacy": "public",
-              "description": "是否使用浏览器的自动填充功能。可选值包括：\n\n* `off`：禁用浏览器的自动填充，使用者必须输入他们想要输入的所有内容。或者网页提供了自己的自动填充方法\n* `on`：浏览器根据用户之前输入的内容或者习惯，在用户输入的时候给出相应输入提示",
+              "description": "`input` 元素的 `autocomplete` 属性",
               "attribute": "autocomplete",
               "reflects": true
             },
@@ -25078,7 +25135,15 @@
             {
               "kind": "method",
               "name": "onInput",
-              "privacy": "private"
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "InputEvent"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
@@ -25151,6 +25216,16 @@
               "kind": "method",
               "name": "renderSuffix",
               "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "renderRightIcon",
+              "privacy": "private",
               "return": {
                 "type": {
                   "text": "TemplateResult"
@@ -25173,7 +25248,15 @@
                 "type": {
                   "text": "TemplateResult"
                 }
-              }
+              },
+              "parameters": [
+                {
+                  "name": "hasClearButton",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
@@ -25183,7 +25266,15 @@
                 "type": {
                   "text": "TemplateResult"
                 }
-              }
+              },
+              "parameters": [
+                {
+                  "name": "hasTogglePasswordButton",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
@@ -25810,9 +25901,9 @@
             {
               "name": "autocomplete",
               "type": {
-                "text": "| /*禁用浏览器的自动填充，使用者必须输入他们想要输入的所有内容。或者网页提供了自己的自动填充方法*/ 'off'\n    | /*浏览器根据用户之前输入的内容或者习惯，在用户输入的时候给出相应输入提示*/ 'on' | undefined"
+                "text": "string | undefined"
               },
-              "description": "是否使用浏览器的自动填充功能。可选值包括：\n\n* `off`：禁用浏览器的自动填充，使用者必须输入他们想要输入的所有内容。或者网页提供了自己的自动填充方法\n* `on`：浏览器根据用户之前输入的内容或者习惯，在用户输入的时候给出相应输入提示",
+              "description": "`input` 元素的 `autocomplete` 属性",
               "fieldName": "autocomplete"
             },
             {
@@ -26819,20 +26910,6 @@
               "kind": "method",
               "name": "onScrollBehaviorChange",
               "privacy": "private",
-              "parameters": [
-                {
-                  "name": "oldValue",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "newValue",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
               "inheritedFrom": {
                 "name": "ScrollBehaviorMixin",
                 "module": "@mdui/shared/mixins/scrollBehavior.js"
@@ -26864,7 +26941,7 @@
             },
             {
               "kind": "method",
-              "name": "updateContainerPadding",
+              "name": "setContainerPadding",
               "privacy": "protected",
               "return": {
                 "type": {
@@ -26873,12 +26950,22 @@
               },
               "parameters": [
                 {
-                  "name": "withPadding",
-                  "default": "true",
-                  "description": "该值为 false 时，为移除 padding"
+                  "name": "action",
+                  "type": {
+                    "text": "'add' | 'update' | 'remove'"
+                  },
+                  "description": "新增、更新、移除 padding"
+                },
+                {
+                  "name": "scrollTarget",
+                  "optional": true,
+                  "type": {
+                    "text": "string | HTMLElement | JQ<HTMLElement>"
+                  },
+                  "description": "在该元素上添加、更新或移除 padding"
                 }
               ],
-              "description": "更新滚动容器的 padding，避免内容被 navigation-bar 覆盖\n仅 scrollBehavior 包含 hide、shrink 时，添加 padding",
+              "description": "更新滚动容器的 padding，避免内容被 navigation-bar 覆盖",
               "inheritedFrom": {
                 "name": "ScrollBehaviorMixin",
                 "module": "@mdui/shared/mixins/scrollBehavior.js"

package/functions/alert.js

@@ -66,9 +66,11 @@ export const alert = (options) => {
                 $(dialog).find('[slot="action"]').text(getConfirmText());
             });
         }
-        $(dialog).on('close', () => {
-            isResolve ? resolve() : reject();
-            offLocaleReady(dialog);
+        $(dialog).on('close', (e) => {
+            if (e.target === dialog) {
+                isResolve ? resolve() : reject();
+                offLocaleReady(dialog);
+            }
         });
     });
 };

package/functions/confirm.js

@@ -87,9 +87,11 @@ export const confirm = (options) => {
                 $(dialog).find('[slot="action"]').first().text(getCancelText());
             });
         }
-        $(dialog).on('close', () => {
-            isResolve ? resolve() : reject();
-            offLocaleReady(dialog);
+        $(dialog).on('close', (e) => {
+            if (e.target === dialog) {
+                isResolve ? resolve() : reject();
+                offLocaleReady(dialog);
+            }
         });
     });
 };

package/functions/dialog.js

@@ -38,8 +38,10 @@ export const dialog = (options) => {
         }
         else if (callbacks.includes(key)) {
             const eventName = toKebabCase(key.slice(2));
-            $dialog.on(eventName, () => {
-                value.call(dialog, dialog);
+            $dialog.on(eventName, (e) => {
+                if (e.target === dialog) {
+                    value.call(dialog, dialog);
+                }
             });
         }
     });
@@ -72,7 +74,10 @@ export const dialog = (options) => {
             });
         });
     }
-    $dialog.appendTo('body').on('closed', () => {
+    $dialog.appendTo('body').on('closed', (e) => {
+        if (e.target !== dialog) {
+            return;
+        }
         $dialog.remove();
         if (options.queue) {
             currentDialog = undefined;

package/functions/prompt.js

@@ -122,9 +122,11 @@ export const prompt = (options) => {
                 $(dialog).find('[slot="action"]').first().text(getCancelText());
             });
         }
-        $(dialog).on('close', () => {
-            isResolve ? resolve(textField.value) : reject();
-            offLocaleReady(dialog);
+        $(dialog).on('close', (e) => {
+            if (e.target === dialog) {
+                isResolve ? resolve(textField.value) : reject();
+                offLocaleReady(dialog);
+            }
         });
     });
 };

package/functions/snackbar.js

@@ -28,7 +28,10 @@ export const snackbar = (options) => {
             'onClosed',
         ].includes(key)) {
             const eventName = toKebabCase(key.slice(2));
-            $snackbar.on(eventName, () => {
+            $snackbar.on(eventName, (e) => {
+                if (e.target !== snackbar) {
+                    return;
+                }
                 if (key === 'onActionClick') {
                     const actionClick = (options.onActionClick ?? returnTrue).call(snackbar, snackbar);
                     if (isPromise(actionClick)) {
@@ -55,7 +58,10 @@ export const snackbar = (options) => {
             snackbar[key] = value;
         }
     });
-    $snackbar.appendTo('body').on('closed', () => {
+    $snackbar.appendTo('body').on('closed', (e) => {
+        if (e.target !== snackbar) {
+            return;
+        }
         $snackbar.remove();
         if (options.queue) {
             currentSnackbar = undefined;

package/html-data.en.json

@@ -6082,17 +6082,7 @@
         },
         {
           "name": "autocomplete",
-          "description": "Enables the browser's autocomplete feature for text input. Possible values:\n\n* `off`: Disables browser autocomplete.\n* `on`: Enables browser autocomplete.",
-          "values": [
-            {
-              "name": "off",
-              "description": "Disables browser autocomplete."
-            },
-            {
-              "name": "on",
-              "description": "Enables browser autocomplete."
-            }
-          ],
+          "description": "The `autocomplete` attribute of the `input` element.",
           "references": [
             {
               "name": "Docs",

package/html-data.zh-cn.json

@@ -6082,17 +6082,7 @@
         },
         {
           "name": "autocomplete",
-          "description": "是否使用浏览器的自动填充功能。可选值包括：\n\n* `off`：禁用浏览器的自动填充，使用者必须输入他们想要输入的所有内容。或者网页提供了自己的自动填充方法\n* `on`：浏览器根据用户之前输入的内容或者习惯，在用户输入的时候给出相应输入提示",
-          "values": [
-            {
-              "name": "off",
-              "description": "禁用浏览器的自动填充，使用者必须输入他们想要输入的所有内容。或者网页提供了自己的自动填充方法"
-            },
-            {
-              "name": "on",
-              "description": "浏览器根据用户之前输入的内容或者习惯，在用户输入的时候给出相应输入提示"
-            }
-          ],
+          "description": "`input` 元素的 `autocomplete` 属性",
           "references": [
             {
               "name": "开发文档",

package/jsx.en.d.ts

@@ -3090,13 +3090,10 @@ declare global {
          */
         'autocorrect'?: string;
         /**
-         * Enables the browser's autocomplete feature for text input. Possible values:
-         * 
-         * * `off`: Disables browser autocomplete.
-         * * `on`: Enables browser autocomplete.
+         * The `autocomplete` attribute of the `input` element.
          * @see https://www.mdui.org/en/docs/2/components/text-field#attributes-autocomplete
          */
-        'autocomplete'?: 'off' | 'on';
+        'autocomplete'?: string;
         /**
          * Customizes the Enter key text or icon on the virtual keyboard. The effect varies based on the device and language. Possible values:
          * 

package/jsx.zh-cn.d.ts

@@ -3138,13 +3138,10 @@ declare global {
          */
         'autocorrect'?: string;
         /**
-         * 是否使用浏览器的自动填充功能。可选值包括：
-         * 
-         * * `off`：禁用浏览器的自动填充，使用者必须输入他们想要输入的所有内容。或者网页提供了自己的自动填充方法
-         * * `on`：浏览器根据用户之前输入的内容或者习惯，在用户输入的时候给出相应输入提示
+         * `input` 元素的 `autocomplete` 属性
          * @see https://www.mdui.org/zh-cn/docs/2/components/text-field#attributes-autocomplete
          */
-        'autocomplete'?: 'off' | 'on';
+        'autocomplete'?: string;
         /**
          * `input` 元素的 `enterkeyhint` 属性，用于定制虚拟键盘上的 Enter 键的显示文本或图标。具体显示效果取决于用户使用的设备和语言。可选值包括：
          *