mdui 2.1.2 → 2.1.4

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",
@@ -747,14 +748,14 @@
               "privacy": "protected",
               "parameters": [
                 {
-                  "name": "isScrollingUp",
+                  "name": "_isScrollingUp",
                   "type": {
                     "text": "boolean"
                   },
                   "description": "是否向上滚动"
                 },
                 {
-                  "name": "scrollTop",
+                  "name": "_scrollTop",
                   "type": {
                     "text": "number"
                   },
@@ -769,14 +770,14 @@
               "privacy": "protected",
               "parameters": [
                 {
-                  "name": "isScrollingUp",
+                  "name": "_isScrollingUp",
                   "type": {
                     "text": "boolean"
                   },
                   "description": "是否向上滚动"
                 },
                 {
-                  "name": "scrollTop",
+                  "name": "_scrollTop",
                   "type": {
                     "text": "number"
                   },
@@ -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"
@@ -1427,14 +1424,14 @@
               "privacy": "protected",
               "parameters": [
                 {
-                  "name": "isScrollingUp",
+                  "name": "_isScrollingUp",
                   "type": {
                     "text": "boolean"
                   },
                   "description": "是否向上滚动"
                 },
                 {
-                  "name": "scrollTop",
+                  "name": "_scrollTop",
                   "type": {
                     "text": "number"
                   },
@@ -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"
@@ -1878,8 +1885,8 @@
               "attribute": "href",
               "reflects": true,
               "inheritedFrom": {
-                "name": "ButtonBase",
-                "module": "components/button/button-base.js"
+                "name": "AnchorMixin",
+                "module": "@mdui/shared/mixins/anchor.js"
               }
             },
             {
@@ -1893,8 +1900,8 @@
               "attribute": "download",
               "reflects": true,
               "inheritedFrom": {
-                "name": "ButtonBase",
-                "module": "components/button/button-base.js"
+                "name": "AnchorMixin",
+                "module": "@mdui/shared/mixins/anchor.js"
               }
             },
             {
@@ -1908,8 +1915,8 @@
               "attribute": "target",
               "reflects": true,
               "inheritedFrom": {
-                "name": "ButtonBase",
-                "module": "components/button/button-base.js"
+                "name": "AnchorMixin",
+                "module": "@mdui/shared/mixins/anchor.js"
               }
             },
             {
@@ -1923,8 +1930,8 @@
               "attribute": "rel",
               "reflects": true,
               "inheritedFrom": {
-                "name": "ButtonBase",
-                "module": "components/button/button-base.js"
+                "name": "AnchorMixin",
+                "module": "@mdui/shared/mixins/anchor.js"
               }
             },
             {
@@ -1945,8 +1952,8 @@
                 }
               ],
               "inheritedFrom": {
-                "name": "ButtonBase",
-                "module": "components/button/button-base.js"
+                "name": "AnchorMixin",
+                "module": "@mdui/shared/mixins/anchor.js"
               }
             },
             {
@@ -1961,8 +1968,8 @@
               "attribute": "autofocus",
               "reflects": true,
               "inheritedFrom": {
-                "name": "ButtonBase",
-                "module": "components/button/button-base.js"
+                "name": "FocusableMixin",
+                "module": "@mdui/shared/mixins/focusable.js"
               }
             },
             {
@@ -1977,8 +1984,8 @@
               "attribute": "focused",
               "reflects": true,
               "inheritedFrom": {
-                "name": "ButtonBase",
-                "module": "components/button/button-base.js"
+                "name": "FocusableMixin",
+                "module": "@mdui/shared/mixins/focusable.js"
               }
             },
             {
@@ -1993,8 +2000,8 @@
               "attribute": "focus-visible",
               "reflects": true,
               "inheritedFrom": {
-                "name": "ButtonBase",
-                "module": "components/button/button-base.js"
+                "name": "FocusableMixin",
+                "module": "@mdui/shared/mixins/focusable.js"
               }
             },
             {
@@ -2006,8 +2013,8 @@
               "privacy": "protected",
               "default": "new DefinedController(this, { relatedElements: [''] })",
               "inheritedFrom": {
-                "name": "ButtonBase",
-                "module": "components/button/button-base.js"
+                "name": "FocusableMixin",
+                "module": "@mdui/shared/mixins/focusable.js"
               }
             },
             {
@@ -2019,8 +2026,8 @@
               "privacy": "private",
               "default": "false",
               "inheritedFrom": {
-                "name": "ButtonBase",
-                "module": "components/button/button-base.js"
+                "name": "FocusableMixin",
+                "module": "@mdui/shared/mixins/focusable.js"
               }
             },
             {
@@ -2032,8 +2039,8 @@
               "privacy": "private",
               "default": "0",
               "inheritedFrom": {
-                "name": "ButtonBase",
-                "module": "components/button/button-base.js"
+                "name": "FocusableMixin",
+                "module": "@mdui/shared/mixins/focusable.js"
               }
             },
             {
@@ -2044,8 +2051,8 @@
               },
               "privacy": "private",
               "inheritedFrom": {
-                "name": "ButtonBase",
-                "module": "components/button/button-base.js"
+                "name": "FocusableMixin",
+                "module": "@mdui/shared/mixins/focusable.js"
               }
             },
             {
@@ -2058,8 +2065,8 @@
               "description": "元素在使用 Tab 键切换焦点时的顺序",
               "attribute": "tabindex",
               "inheritedFrom": {
-                "name": "ButtonBase",
-                "module": "components/button/button-base.js"
+                "name": "FocusableMixin",
+                "module": "@mdui/shared/mixins/focusable.js"
               }
             },
             {
@@ -2069,8 +2076,8 @@
                 "text": "boolean"
               },
               "privacy": "protected",
-              "description": "父类要实现该属性，表示是否禁用 focus 状态",
               "readonly": true,
+              "description": "父类要实现该属性，表示是否禁用 focus 状态",
               "inheritedFrom": {
                 "name": "ButtonBase",
                 "module": "components/button/button-base.js"
@@ -2080,11 +2087,11 @@
               "kind": "field",
               "name": "focusElement",
               "type": {
-                "text": "HTMLElement | null | undefined"
+                "text": "HTMLElement | null"
               },
               "privacy": "protected",
-              "description": "最终获得焦点的元素",
               "readonly": true,
+              "description": "最终获得焦点的元素",
               "inheritedFrom": {
                 "name": "ButtonBase",
                 "module": "components/button/button-base.js"
@@ -2101,8 +2108,8 @@
               },
               "description": "模拟鼠标点击元素",
               "inheritedFrom": {
-                "name": "ButtonBase",
-                "module": "components/button/button-base.js"
+                "name": "FocusableMixin",
+                "module": "@mdui/shared/mixins/focusable.js"
               }
             },
             {
@@ -2125,8 +2132,8 @@
               ],
               "description": "将焦点设置到当前元素。\n\n可以传入一个对象作为参数，该对象的属性包括：\n\n* `preventScroll`：默认情况下，元素获取焦点后，页面会滚动以将该元素滚动到视图中。如果不希望页面滚动，可以将此属性设置为 `true`。",
               "inheritedFrom": {
-                "name": "ButtonBase",
-                "module": "components/button/button-base.js"
+                "name": "FocusableMixin",
+                "module": "@mdui/shared/mixins/focusable.js"
               }
             },
             {
@@ -2140,8 +2147,8 @@
               },
               "description": "移除当前元素的焦点",
               "inheritedFrom": {
-                "name": "ButtonBase",
-                "module": "components/button/button-base.js"
+                "name": "FocusableMixin",
+                "module": "@mdui/shared/mixins/focusable.js"
               }
             },
             {
@@ -2162,8 +2169,8 @@
                 }
               ],
               "inheritedFrom": {
-                "name": "ButtonBase",
-                "module": "components/button/button-base.js"
+                "name": "FocusableMixin",
+                "module": "@mdui/shared/mixins/focusable.js"
               }
             },
             {
@@ -2176,8 +2183,8 @@
                 }
               },
               "inheritedFrom": {
-                "name": "ButtonBase",
-                "module": "components/button/button-base.js"
+                "name": "FocusableMixin",
+                "module": "@mdui/shared/mixins/focusable.js"
               }
             },
             {
@@ -2531,8 +2538,8 @@
                 "text": "KeyboardEvent"
               },
               "inheritedFrom": {
-                "name": "ButtonBase",
-                "module": "components/button/button-base.js"
+                "name": "FocusableMixin",
+                "module": "@mdui/shared/mixins/focusable.js"
               }
             }
           ],
@@ -2588,8 +2595,8 @@
               "description": "链接的目标 URL。\n\n如果设置了此属性，组件内部将渲染为 `<a>` 元素，并可以使用链接相关的属性。",
               "fieldName": "href",
               "inheritedFrom": {
-                "name": "ButtonBase",
-                "module": "components/button/button-base.js"
+                "name": "AnchorMixin",
+                "module": "@mdui/shared/mixins/anchor.js"
               }
             },
             {
@@ -2600,8 +2607,8 @@
               "description": "下载链接的目标。\n\n**Note**：仅在设置了 `href` 属性时，此属性才有效。",
               "fieldName": "download",
               "inheritedFrom": {
-                "name": "ButtonBase",
-                "module": "components/button/button-base.js"
+                "name": "AnchorMixin",
+                "module": "@mdui/shared/mixins/anchor.js"
               }
             },
             {
@@ -2612,8 +2619,8 @@
               "description": "链接的打开方式。可选值包括：\n\n* `_blank`：在新窗口中打开链接\n* `_parent`：在父框架中打开链接\n* `_self`：默认。在当前框架中打开链接\n* `_top`：在整个窗口中打开链接\n\n**Note**：仅在设置了 `href` 属性时，此属性才有效。",
               "fieldName": "target",
               "inheritedFrom": {
-                "name": "ButtonBase",
-                "module": "components/button/button-base.js"
+                "name": "AnchorMixin",
+                "module": "@mdui/shared/mixins/anchor.js"
               }
             },
             {
@@ -2624,8 +2631,8 @@
               "description": "当前文档与被链接文档之间的关系。可选值包括：\n\n* `alternate`：当前文档的替代版本\n* `author`：当前文档或文章的作者\n* `bookmark`：永久链接到最近的祖先章节\n* `external`：引用的文档与当前文档不在同一站点\n* `help`：链接到相关的帮助文档\n* `license`：当前文档的主要内容由被引用文件的版权许可覆盖\n* `me`：当前文档代表链接内容的所有者\n* `next`：当前文档是系列中的一部分，被引用的文档是系列的下一个文档\n* `nofollow`：当前文档的作者或发布者不认可被引用的文件\n* `noreferrer`：不包含 `Referer` 头。类似于 `noopener` 的效果\n* `opener`：如果超链接会创建一个顶级浏览上下文（即 `target` 属性值为 `_blank`），则创建一个辅助浏览上下文\n* `prev`：当前文档是系列的一部分，被引用的文档是系列的上一个文档\n* `search`：提供一个资源链接，可用于搜索当前文件及其相关页面\n* `tag`：提供一个适用于当前文档的标签（由给定地址识别）\n\n**Note**：仅在指定了 `href` 属性时可用。",
               "fieldName": "rel",
               "inheritedFrom": {
-                "name": "ButtonBase",
-                "module": "components/button/button-base.js"
+                "name": "AnchorMixin",
+                "module": "@mdui/shared/mixins/anchor.js"
               }
             },
             {
@@ -2637,8 +2644,8 @@
               "description": "是否在页面加载完成后自动获取焦点",
               "fieldName": "autofocus",
               "inheritedFrom": {
-                "name": "ButtonBase",
-                "module": "components/button/button-base.js"
+                "name": "FocusableMixin",
+                "module": "@mdui/shared/mixins/focusable.js"
               }
             },
             {
@@ -2650,8 +2657,8 @@
               "description": "是否获得了焦点，不管是鼠标点击，还是键盘切换获得的焦点，都会添加该属性\n添加到 :host 元素上，供 CSS 选择器添加样式",
               "fieldName": "focused",
               "inheritedFrom": {
-                "name": "ButtonBase",
-                "module": "components/button/button-base.js"
+                "name": "FocusableMixin",
+                "module": "@mdui/shared/mixins/focusable.js"
               }
             },
             {
@@ -2663,8 +2670,8 @@
               "description": "是否通过键盘切换获得了焦点\n添加到 :host 元素上，供 CSS 选择器添加样式",
               "fieldName": "focusVisible",
               "inheritedFrom": {
-                "name": "ButtonBase",
-                "module": "components/button/button-base.js"
+                "name": "FocusableMixin",
+                "module": "@mdui/shared/mixins/focusable.js"
               }
             },
             {
@@ -2675,8 +2682,8 @@
               "description": "元素在使用 Tab 键切换焦点时的顺序",
               "fieldName": "tabIndex",
               "inheritedFrom": {
-                "name": "ButtonBase",
-                "module": "components/button/button-base.js"
+                "name": "FocusableMixin",
+                "module": "@mdui/shared/mixins/focusable.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"
@@ -14194,14 +14187,14 @@
               "privacy": "protected",
               "parameters": [
                 {
-                  "name": "isScrollingUp",
+                  "name": "_isScrollingUp",
                   "type": {
                     "text": "boolean"
                   },
                   "description": "是否向上滚动"
                 },
                 {
-                  "name": "scrollTop",
+                  "name": "_scrollTop",
                   "type": {
                     "text": "number"
                   },
@@ -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"
             },
             {
@@ -26014,7 +26105,7 @@
               },
               "privacy": "public",
               "default": "'auto'",
-              "description": "tooltip 的位置。默认为 `auto`。可选值包括：\n\n* `auto`：自动判断位置。`variant=\"plan\"` 时，优先使用 `top`；`variant=\"rich\"` 时，优先使用 `bottom-right`\n* `top-left`：位于左上方\n* `top-start`：位于上方，左对齐\n* `top`：位于上方，居中对齐\n* `top-end`：位于上方，右对齐\n* `top-right`：位于右上方\n* `bottom-left`：位于左下方\n* `bottom-start`：位于下方，左对齐\n* `bottom`：位于下方，居中对齐\n* `bottom-end`：位于下方，右对齐\n* `bottom-right`：位于右下方\n* `left-start`：位于左侧，顶部对齐\n* `left`：位于左侧，居中对齐\n* `left-end`：位于左侧，底部对齐\n* `right-start`：位于右侧，顶部对齐\n* `right`：位于右侧，居中对齐\n* `right-end`：位于右侧，底部对齐",
+              "description": "tooltip 的位置。默认为 `auto`。可选值包括：\n\n* `auto`：自动判断位置。`variant=\"plain\"` 时，优先使用 `top`；`variant=\"rich\"` 时，优先使用 `bottom-right`\n* `top-left`：位于左上方\n* `top-start`：位于上方，左对齐\n* `top`：位于上方，居中对齐\n* `top-end`：位于上方，右对齐\n* `top-right`：位于右上方\n* `bottom-left`：位于左下方\n* `bottom-start`：位于下方，左对齐\n* `bottom`：位于下方，居中对齐\n* `bottom-end`：位于下方，右对齐\n* `bottom-right`：位于右下方\n* `left-start`：位于左侧，顶部对齐\n* `left`：位于左侧，居中对齐\n* `left-end`：位于左侧，底部对齐\n* `right-start`：位于右侧，顶部对齐\n* `right`：位于右侧，居中对齐\n* `right-end`：位于右侧，底部对齐",
               "attribute": "placement",
               "reflects": true
             },
@@ -26318,7 +26409,7 @@
                 "text": "| /*自动判断位置*/ 'auto'\n    | /*位于左上方*/ 'top-left'\n    | /*位于上方，左对齐*/ 'top-start'\n    | /*位于上方，居中对齐*/ 'top'\n    | /*位于上方，右对齐*/ 'top-end'\n    | /*位于右上方*/ 'top-right'\n    | /*位于左下方*/ 'bottom-left'\n    | /*位于下方，左对齐*/ 'bottom-start'\n    | /*位于下方，居中对齐*/ 'bottom'\n    | /*位于下方，右对齐*/ 'bottom-end'\n    | /*位于右下方*/ 'bottom-right'\n    | /*位于左侧，顶部对齐*/ 'left-start'\n    | /*位于左侧，居中对齐*/ 'left'\n    | /*位于左侧，底部对齐*/ 'left-end'\n    | /*位于右侧，顶部对齐*/ 'right-start'\n    | /*位于右侧，居中对齐*/ 'right'\n    | /*位于右侧，底部对齐*/ 'right-end'"
               },
               "default": "'auto'",
-              "description": "tooltip 的位置。默认为 `auto`。可选值包括：\n\n* `auto`：自动判断位置。`variant=\"plan\"` 时，优先使用 `top`；`variant=\"rich\"` 时，优先使用 `bottom-right`\n* `top-left`：位于左上方\n* `top-start`：位于上方，左对齐\n* `top`：位于上方，居中对齐\n* `top-end`：位于上方，右对齐\n* `top-right`：位于右上方\n* `bottom-left`：位于左下方\n* `bottom-start`：位于下方，左对齐\n* `bottom`：位于下方，居中对齐\n* `bottom-end`：位于下方，右对齐\n* `bottom-right`：位于右下方\n* `left-start`：位于左侧，顶部对齐\n* `left`：位于左侧，居中对齐\n* `left-end`：位于左侧，底部对齐\n* `right-start`：位于右侧，顶部对齐\n* `right`：位于右侧，居中对齐\n* `right-end`：位于右侧，底部对齐",
+              "description": "tooltip 的位置。默认为 `auto`。可选值包括：\n\n* `auto`：自动判断位置。`variant=\"plain\"` 时，优先使用 `top`；`variant=\"rich\"` 时，优先使用 `bottom-right`\n* `top-left`：位于左上方\n* `top-start`：位于上方，左对齐\n* `top`：位于上方，居中对齐\n* `top-end`：位于上方，右对齐\n* `top-right`：位于右上方\n* `bottom-left`：位于左下方\n* `bottom-start`：位于下方，左对齐\n* `bottom`：位于下方，居中对齐\n* `bottom-end`：位于下方，右对齐\n* `bottom-right`：位于右下方\n* `left-start`：位于左侧，顶部对齐\n* `left`：位于左侧，居中对齐\n* `left-end`：位于左侧，底部对齐\n* `right-start`：位于右侧，顶部对齐\n* `right`：位于右侧，居中对齐\n* `right-end`：位于右侧，底部对齐",
               "fieldName": "placement"
             },
             {
@@ -26625,6 +26716,12 @@
               "privacy": "private",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "definedController",
+              "privacy": "private",
+              "default": "new DefinedController(this, { relatedElements: ['mdui-top-app-bar-title'], })"
+            },
             {
               "kind": "field",
               "name": "scrollPaddingPosition",
@@ -26819,20 +26916,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 +26947,7 @@
             },
             {
               "kind": "method",
-              "name": "updateContainerPadding",
+              "name": "setContainerPadding",
               "privacy": "protected",
               "return": {
                 "type": {
@@ -26873,12 +26956,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"