mdui 1.0.2 → 2.0.0

package/components/button/button-base.d.ts

@@ -0,0 +1,138 @@
+import { LitElement } from 'lit';
+import '../circular-progress.js';
+import type { CSSResultGroup, TemplateResult } from 'lit';
+type RenderButtonOptions = {
+    id?: string;
+    className?: string;
+    part?: string;
+    content?: TemplateResult | TemplateResult[];
+    tabindex?: number;
+};
+declare const ButtonBase_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;
+export declare class ButtonBase extends ButtonBase_base {
+    static styles: CSSResultGroup;
+    /**
+     * 是否禁用
+     */
+    disabled: boolean;
+    /**
+     * 是否为加载中状态
+     */
+    loading: boolean;
+    /**
+     * 按钮的名称，将与表单数据一起提交
+     *
+     * **Note**：仅在未指定 `href` 属性时可用
+     */
+    name: string;
+    /**
+     * 按钮的初始值，将与表单数据一起提交
+     *
+     * **Note**：仅在未指定 `href` 属性时可用
+     */
+    value: string;
+    /**
+     * 按钮的类型。默认值为 `button`。可选值为：
+     *
+     * * `submit`：点击按钮将表单数据提交给服务器
+     * * `reset`：点击按钮将表单中所有组件重置为初始值
+     * * `button`：按钮没有默认行为
+     *
+     * **Note**：仅在未指定 `href` 属性时可用
+     */
+    type: /*此按钮将表单数据提交给服务器*/ 'submit' | /*此按钮重置所有组件为初始值*/ 'reset' | /*此按钮没有默认行为*/ 'button';
+    /**
+     * 关联的 `form` 元素。此属性值必须为同一页面中的一个 `<form>` 元素的 `id` 属性。
+     *
+     * 如果此属性未指定，则元素必须是 `form` 元素的后代。利用此属性，你可以将元素放置在页面中的任何位置，而不仅仅是作为 `form` 元素的后代。
+     *
+     * **Note**：仅在未指定 `href` 属性时可用
+     */
+    form?: string;
+    /**
+     *
+     * 指定提交表单的 URL。
+     *
+     * 指定了该属性时，将覆盖 `form` 元素的 `action` 属性。
+     *
+     * **Note**：仅在未指定 `href` 属性、且 `type="submit"` 时可用。
+     */
+    formAction?: string;
+    /**
+     * 指定提交表单到服务器的内容类型。可选值为：
+     *
+     * * `application/x-www-form-urlencoded`：未指定属性时的默认值
+     * * `multipart/form-data`：当表单包含 `<input type="file">` 元素时使用此值
+     * * `text/plain`：出现于 HTML5，用于调试
+     *
+     * 指定了该属性时，将覆盖 `form` 元素的 `enctype` 属性。
+     *
+     * **Note**：仅在未指定 `href` 属性、且 `type="submit"` 时可用
+     */
+    formEnctype?: /*未指定属性时的默认值*/ 'application/x-www-form-urlencoded' | /*当表单包含 `<input type="file">` 元素时使用此值*/ 'multipart/form-data' | /*出现于 HTML5，用于调试*/ 'text/plain';
+    /**
+     * 指定提交表单使用的 HTTP 方法。可选值为：
+     *
+     * * `post`：来自表单的数据被包含在表单内容中，被发送到服务器
+     * * `get`：来自表单的数据以 `?` 作为分隔符被附加到 form 的 URI 属性中，得到的 URI 被发送到服务器。当表单没有副作用，且仅包含 ASCII 字符时使用这种方法
+     *
+     * 指定了该属性时，将覆盖 `form` 元素的 `method` 属性。
+     *
+     * **Note**：仅在未指定 `href` 属性、且 `type="submit"` 时可用。
+     */
+    formMethod?: /*来自表单的数据被包含在表单内容中，被发送到服务器*/ 'post' | /*来自表单的数据以 `?` 作为分隔符被附加到 form 的 URI 属性中，得到的 URI 被发送到服务器。当表单没有副作用，且仅包含 ASCII 字符时使用这种方法*/ 'get';
+    /**
+     * 指定了该属性时，表示当表单被提交时不需要验证。
+     *
+     * 指定了该属性时，将覆盖 `form` 元素的 `novalidate` 属性。
+     *
+     * **Note**：仅在未指定 `href` 属性、且 `type="submit"` 时可用。
+     */
+    formNoValidate: boolean;
+    /**
+     * 在何处显示提交表单后接收到的响应。可选值为：
+     *
+     * * `_self`：默认。在同一框架中打开
+     * * `_blank`：在新窗口中打开
+     * * `_parent`：在父框架中打开
+     * * `_top`：在整个窗口中打开
+     *
+     * 指定了该属性时，将覆盖 `form` 元素的 `target` 属性。
+     *
+     * **Note**：仅在未指定 `href` 属性、且 `type="submit"` 时可用
+     */
+    formTarget?: /*默认。在同一框架中打开*/ '_self' | /*在新窗口中打开*/ '_blank' | /*在父框架中打开*/ '_parent' | /*在整个窗口中打开*/ '_top';
+    private readonly formController;
+    /**
+     * 表单验证状态对象
+     */
+    get validity(): ValidityState | undefined;
+    /**
+     * 表单验证的错误提示信息
+     */
+    get validationMessage(): string | undefined;
+    protected get rippleDisabled(): boolean;
+    protected get focusElement(): HTMLElement | null;
+    protected get focusDisabled(): boolean;
+    connectedCallback(): void;
+    /**
+     * 检查表单字段是否验证通过。若未通过则返回 `false`，并触发 `invalid` 事件；若验证通过，则返回 `true`
+     */
+    checkValidity(): boolean;
+    /**
+     * 检查表单字段是否验证通过。若未通过则返回 `false`，并触发 `invalid` 事件；若验证通过，则返回 `true`。
+     *
+     * 验证未通过时，还将在组件上显示未通过的提示。
+     */
+    reportValidity(): boolean;
+    /**
+     * 设置自定义的错误提示文本。只要文本不为空，则表示字段验证未通过
+     *
+     * @param message 自定义的提示文本
+     */
+    setCustomValidity(message: string): void;
+    protected renderLoading(): TemplateResult;
+    protected renderButton({ id, className, part, content, }: RenderButtonOptions): TemplateResult;
+    protected isButton(): boolean;
+}
+export {};

package/components/button/button-base.js

@@ -0,0 +1,206 @@
+import { __decorate } from "tslib";
+import { LitElement, html } from 'lit';
+import { property } from 'lit/decorators.js';
+import { ifDefined } from 'lit/directives/if-defined.js';
+import cc from 'classcat';
+import { FormController } from '@mdui/shared/controllers/form.js';
+import { booleanConverter } from '@mdui/shared/helpers/decorator.js';
+import { emit } from '@mdui/shared/helpers/event.js';
+import { nothingTemplate } from '@mdui/shared/helpers/template.js';
+import { componentStyle } from '@mdui/shared/lit-styles/component-style.js';
+import { AnchorMixin } from '@mdui/shared/mixins/anchor.js';
+import { FocusableMixin } from '@mdui/shared/mixins/focusable.js';
+import '../circular-progress.js';
+import { RippleMixin } from '../ripple/ripple-mixin.js';
+import { buttonBaseStyle } from './button-base-style.js';
+export class ButtonBase extends AnchorMixin(RippleMixin(FocusableMixin(LitElement))) {
+    constructor() {
+        super(...arguments);
+        /**
+         * 是否禁用
+         */
+        this.disabled = false;
+        /**
+         * 是否为加载中状态
+         */
+        this.loading = false;
+        /**
+         * 按钮的名称，将与表单数据一起提交
+         *
+         * **Note**：仅在未指定 `href` 属性时可用
+         */
+        this.name = '';
+        /**
+         * 按钮的初始值，将与表单数据一起提交
+         *
+         * **Note**：仅在未指定 `href` 属性时可用
+         */
+        this.value = '';
+        /**
+         * 按钮的类型。默认值为 `button`。可选值为：
+         *
+         * * `submit`：点击按钮将表单数据提交给服务器
+         * * `reset`：点击按钮将表单中所有组件重置为初始值
+         * * `button`：按钮没有默认行为
+         *
+         * **Note**：仅在未指定 `href` 属性时可用
+         */
+        this.type = 'button';
+        /**
+         * 指定了该属性时，表示当表单被提交时不需要验证。
+         *
+         * 指定了该属性时，将覆盖 `form` 元素的 `novalidate` 属性。
+         *
+         * **Note**：仅在未指定 `href` 属性、且 `type="submit"` 时可用。
+         */
+        this.formNoValidate = false;
+        this.formController = new FormController(this);
+    }
+    /**
+     * 表单验证状态对象
+     */
+    get validity() {
+        if (this.isButton()) {
+            return this.focusElement.validity;
+        }
+    }
+    /**
+     * 表单验证的错误提示信息
+     */
+    get validationMessage() {
+        if (this.isButton()) {
+            return this.focusElement.validationMessage;
+        }
+    }
+    get rippleDisabled() {
+        return this.disabled || this.loading;
+    }
+    get focusElement() {
+        var _a, _b;
+        return this.isButton()
+            ? (_a = this.renderRoot) === null || _a === void 0 ? void 0 : _a.querySelector('._button')
+            : (_b = this.renderRoot) === null || _b === void 0 ? void 0 : _b.querySelector('._a');
+    }
+    get focusDisabled() {
+        return this.disabled || this.loading;
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        this.addEventListener('click', () => {
+            if (this.type === 'submit') {
+                this.formController.submit(this);
+            }
+            if (this.type === 'reset') {
+                this.formController.reset(this);
+            }
+        });
+    }
+    /**
+     * 检查表单字段是否验证通过。若未通过则返回 `false`，并触发 `invalid` 事件；若验证通过，则返回 `true`
+     */
+    checkValidity() {
+        if (this.isButton()) {
+            const valid = this.focusElement.checkValidity();
+            if (!valid) {
+                emit(this, 'invalid', {
+                    bubbles: false,
+                    cancelable: true,
+                    composed: false,
+                });
+            }
+            return valid;
+        }
+        return true;
+    }
+    /**
+     * 检查表单字段是否验证通过。若未通过则返回 `false`，并触发 `invalid` 事件；若验证通过，则返回 `true`。
+     *
+     * 验证未通过时，还将在组件上显示未通过的提示。
+     */
+    reportValidity() {
+        if (this.isButton()) {
+            const invalid = !this.focusElement.reportValidity();
+            if (invalid) {
+                emit(this, 'invalid', {
+                    bubbles: false,
+                    cancelable: true,
+                    composed: false,
+                });
+                // todo 考虑是否要支持 preventDefault() 方法，当前 invalid 状态没有样式
+            }
+            return !invalid;
+        }
+        return true;
+    }
+    /**
+     * 设置自定义的错误提示文本。只要文本不为空，则表示字段验证未通过
+     *
+     * @param message 自定义的提示文本
+     */
+    setCustomValidity(message) {
+        if (this.isButton()) {
+            this.focusElement.setCustomValidity(message);
+        }
+    }
+    renderLoading() {
+        return this.loading
+            ? html `<mdui-circular-progress part="loading"></mdui-circular-progress>`
+            : nothingTemplate;
+    }
+    renderButton({ id, className, part, content = html `<slot></slot>`, }) {
+        return html `<button id="${ifDefined(id)}" class="${cc(['_button', className])}" part="${ifDefined(part)}" ?disabled="${this.rippleDisabled || this.focusDisabled}">${content}</button>`;
+    }
+    isButton() {
+        return !this.href;
+    }
+}
+ButtonBase.styles = [
+    componentStyle,
+    buttonBaseStyle,
+];
+__decorate([
+    property({
+        type: Boolean,
+        reflect: true,
+        converter: booleanConverter,
+    })
+], ButtonBase.prototype, "disabled", void 0);
+__decorate([
+    property({
+        type: Boolean,
+        reflect: true,
+        converter: booleanConverter,
+    })
+], ButtonBase.prototype, "loading", void 0);
+__decorate([
+    property({ reflect: true })
+], ButtonBase.prototype, "name", void 0);
+__decorate([
+    property({ reflect: true })
+], ButtonBase.prototype, "value", void 0);
+__decorate([
+    property({ reflect: true })
+], ButtonBase.prototype, "type", void 0);
+__decorate([
+    property({ reflect: true })
+], ButtonBase.prototype, "form", void 0);
+__decorate([
+    property({ reflect: true, attribute: 'formaction' })
+], ButtonBase.prototype, "formAction", void 0);
+__decorate([
+    property({ reflect: true, attribute: 'formenctype' })
+], ButtonBase.prototype, "formEnctype", void 0);
+__decorate([
+    property({ reflect: true, attribute: 'formmethod' })
+], ButtonBase.prototype, "formMethod", void 0);
+__decorate([
+    property({
+        type: Boolean,
+        reflect: true,
+        converter: booleanConverter,
+        attribute: 'formnovalidate',
+    })
+], ButtonBase.prototype, "formNoValidate", void 0);
+__decorate([
+    property({ reflect: true, attribute: 'formtarget' })
+], ButtonBase.prototype, "formTarget", void 0);

package/components/button/index.d.ts

@@ -0,0 +1,64 @@
+import '../icon.js';
+import { ButtonBase } from './button-base.js';
+import type { Ripple } from '../ripple/index.js';
+import type { TemplateResult, CSSResultGroup } from 'lit';
+/**
+ * @summary 按钮组件
+ *
+ * ```html
+ * <mdui-button>Button</mdui-button>
+ * ```
+ *
+ * @event focus - 获得焦点时触发
+ * @event blur - 失去焦点时触发
+ * @event invalid - 表单字段验证未通过时触发
+ *
+ * @slot - 按钮的文本
+ * @slot icon - 按钮左侧元素
+ * @slot end-icon - 按钮右侧元素
+ *
+ * @csspart button - 内部的 `<button>` 或 `<a>` 元素
+ * @csspart label - 按钮文本
+ * @csspart icon - 按钮左侧图标
+ * @csspart end-icon - 按钮右侧图标
+ * @csspart loading - 加载中状态的 `<mdui-circular-progress>` 元素
+ *
+ * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ */
+export declare class Button extends ButtonBase {
+    static styles: CSSResultGroup;
+    /**
+     * 按钮形状。可选值为：
+     *
+     * * `elevated`：带阴影的按钮，在需要把按钮和背景进行视觉分离时使用
+     * * `filled`：视觉效果仅次于 FAB，用于重要流程的最终操作，如“保存”、“确认”等
+     * * `tonal`：视觉效果介于 `filled` 和 `outlined` 之间，用于中高优先级的操作，如流程中的“下一步”
+     * * `outlined`：带边框的按钮，用于中等优先级，且次要的操作，如“返回”
+     * * `text`：文本按钮，用于最低优先级的操作
+     */
+    variant: /*带阴影的按钮，在需要把按钮和背景进行视觉分离时使用*/ 'elevated' | /*视觉效果仅次于 FAB，用于重要流程的最终操作，如“保存”、“确认”等*/ 'filled' | /*视觉效果介于 `filled` 和 `outlined` 之间，用于中等偏高优先级的场景，如流程中的“下一步”*/ 'tonal' | /*带边框的按钮，用于中等优先级，且次要操作的场景，如“返回”*/ 'outlined' | /*文本按钮，用于最低优先级的操作*/ 'text';
+    /**
+     * 是否填满父元素宽度
+     */
+    fullWidth: boolean;
+    /**
+     * 左侧的 Material Icons 图标名。也可以通过 `slot="icon"` 设置
+     */
+    icon?: string;
+    /**
+     * 右侧的 Material Icons 图标名。也可以通过 `slot="end-icon"` 设置
+     */
+    endIcon?: string;
+    private readonly rippleRef;
+    protected get rippleElement(): Ripple;
+    protected render(): TemplateResult;
+    private renderIcon;
+    private renderLabel;
+    private renderEndIcon;
+    private renderInner;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'mdui-button': Button;
+    }
+}

package/components/button/index.js

@@ -0,0 +1,110 @@
+import { __decorate } from "tslib";
+import { html } from 'lit';
+import { customElement, property } from 'lit/decorators.js';
+import { createRef, ref } from 'lit/directives/ref.js';
+import { booleanConverter } from '@mdui/shared/helpers/decorator.js';
+import { nothingTemplate } from '@mdui/shared/helpers/template.js';
+import '../icon.js';
+import { ButtonBase } from './button-base.js';
+import { style } from './style.js';
+/**
+ * @summary 按钮组件
+ *
+ * ```html
+ * <mdui-button>Button</mdui-button>
+ * ```
+ *
+ * @event focus - 获得焦点时触发
+ * @event blur - 失去焦点时触发
+ * @event invalid - 表单字段验证未通过时触发
+ *
+ * @slot - 按钮的文本
+ * @slot icon - 按钮左侧元素
+ * @slot end-icon - 按钮右侧元素
+ *
+ * @csspart button - 内部的 `<button>` 或 `<a>` 元素
+ * @csspart label - 按钮文本
+ * @csspart icon - 按钮左侧图标
+ * @csspart end-icon - 按钮右侧图标
+ * @csspart loading - 加载中状态的 `<mdui-circular-progress>` 元素
+ *
+ * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ */
+export let Button = class Button extends ButtonBase {
+    constructor() {
+        super(...arguments);
+        /**
+         * 按钮形状。可选值为：
+         *
+         * * `elevated`：带阴影的按钮，在需要把按钮和背景进行视觉分离时使用
+         * * `filled`：视觉效果仅次于 FAB，用于重要流程的最终操作，如“保存”、“确认”等
+         * * `tonal`：视觉效果介于 `filled` 和 `outlined` 之间，用于中高优先级的操作，如流程中的“下一步”
+         * * `outlined`：带边框的按钮，用于中等优先级，且次要的操作，如“返回”
+         * * `text`：文本按钮，用于最低优先级的操作
+         */
+        this.variant = 'filled';
+        /**
+         * 是否填满父元素宽度
+         */
+        this.fullWidth = false;
+        this.rippleRef = createRef();
+    }
+    get rippleElement() {
+        return this.rippleRef.value;
+    }
+    render() {
+        return html `<mdui-ripple ${ref(this.rippleRef)} .noRipple="${this.noRipple}"></mdui-ripple>${this.isButton()
+            ? this.renderButton({
+                className: 'button',
+                part: 'button',
+                content: this.renderInner(),
+            })
+            : this.disabled || this.loading
+                ? html `<span part="button" class="button _a">${this.renderInner()}</span>`
+                : this.renderAnchor({
+                    className: 'button',
+                    part: 'button',
+                    content: this.renderInner(),
+                })}`;
+    }
+    renderIcon() {
+        if (this.loading) {
+            return this.renderLoading();
+        }
+        return html `<slot name="icon" part="icon" class="icon">${this.icon
+            ? html `<mdui-icon name="${this.icon}"></mdui-icon>`
+            : nothingTemplate}</slot>`;
+    }
+    renderLabel() {
+        return html `<slot part="label" class="label"></slot>`;
+    }
+    renderEndIcon() {
+        return html `<slot name="end-icon" part="end-icon" class="end-icon">${this.endIcon
+            ? html `<mdui-icon name="${this.endIcon}"></mdui-icon>`
+            : nothingTemplate}</slot>`;
+    }
+    renderInner() {
+        return [this.renderIcon(), this.renderLabel(), this.renderEndIcon()];
+    }
+};
+Button.styles = [ButtonBase.styles, style];
+__decorate([
+    property({ reflect: true })
+], Button.prototype, "variant", void 0);
+__decorate([
+    property({
+        type: Boolean,
+        reflect: true,
+        converter: booleanConverter,
+        attribute: 'full-width',
+    })
+], Button.prototype, "fullWidth", void 0);
+__decorate([
+    property({ reflect: true })
+], Button.prototype, "icon", void 0);
+__decorate([
+    property({ reflect: true, attribute: 'end-icon' })
+], Button.prototype, "endIcon", void 0);
+Button = __decorate([
+    customElement('mdui-button')
+], Button);

package/components/button/style.d.ts

@@ -0,0 +1 @@
+export declare const style: import("lit").CSSResult;

package/components/button/style.js

@@ -0,0 +1,4 @@
+import { css } from 'lit';
+export const style = css `:host{--shape-corner:var(--mdui-shape-corner-full);position:relative;display:inline-block;overflow:hidden;text-align:center;border-radius:var(--shape-corner);cursor:pointer;-webkit-tap-highlight-color:transparent;transition:box-shadow var(--mdui-motion-duration-short4) var(--mdui-motion-easing-linear);min-width:3rem;height:2.5rem;color:rgb(var(--mdui-color-primary));font-size:var(--mdui-typescale-label-large-size);font-weight:var(--mdui-typescale-label-large-weight);letter-spacing:var(--mdui-typescale-label-large-tracking);line-height:var(--mdui-typescale-label-large-line-height)}.button{width:100%;padding:0 1rem}:host([full-width]){display:block}:host([variant=elevated]){box-shadow:var(--mdui-elevation-level1);background-color:rgb(var(--mdui-color-surface-container-low));--mdui-comp-ripple-state-layer-color:var(--mdui-color-primary)}:host([variant=filled]){color:rgb(var(--mdui-color-on-primary));background-color:rgb(var(--mdui-color-primary));--mdui-comp-ripple-state-layer-color:var(--mdui-color-on-primary)}:host([variant=tonal]){color:rgb(var(--mdui-color-on-secondary-container));background-color:rgb(var(--mdui-color-secondary-container));--mdui-comp-ripple-state-layer-color:var(
+      --mdui-color-on-secondary-container
+    )}:host([variant=outlined]){border:.0625rem solid rgb(var(--mdui-color-outline));--mdui-comp-ripple-state-layer-color:var(--mdui-color-primary)}:host([variant=text]){--mdui-comp-ripple-state-layer-color:var(--mdui-color-primary)}:host([variant=outlined][focus-visible]){border-color:rgb(var(--mdui-color-primary))}:host([variant=elevated][hover]){box-shadow:var(--mdui-elevation-level2)}:host([variant=filled][hover]),:host([variant=tonal][hover]){box-shadow:var(--mdui-elevation-level1)}:host([disabled]),:host([loading]){cursor:default;pointer-events:none}:host([disabled]){color:rgba(var(--mdui-color-on-surface),38%);box-shadow:var(--mdui-elevation-level0)}:host([variant=elevated][disabled]),:host([variant=filled][disabled]),:host([variant=tonal][disabled]){background-color:rgba(var(--mdui-color-on-surface),12%)}:host([variant=outlined][disabled]){border-color:rgba(var(--mdui-color-on-surface),12%)}.label{display:inline-flex;padding-right:.5rem;padding-left:.5rem}.end-icon,.icon{display:inline-flex;font-size:1.28571429em}.end-icon mdui-icon,.icon mdui-icon,::slotted([slot=end-icon]),::slotted([slot=icon]){font-size:inherit}mdui-circular-progress{display:inline-flex;width:1.125rem;height:1.125rem}:host([variant=filled]) mdui-circular-progress{stroke:rgb(var(--mdui-color-on-primary))}:host([variant=tonal]) mdui-circular-progress{stroke:rgb(var(--mdui-color-on-secondary-container))}:host([disabled]) mdui-circular-progress{stroke:rgba(var(--mdui-color-on-surface),38%)}`;

package/components/button-icon/index.d.ts

@@ -0,0 +1,66 @@
+import { ButtonBase } from '../button/button-base.js';
+import '../icon.js';
+import type { Ripple } from '../ripple/index.js';
+import type { CSSResultGroup, PropertyValues, TemplateResult } from 'lit';
+/**
+ * @summary 图标按钮组件
+ *
+ * ```html
+ * <mdui-button-icon icon="search"></mdui-button-icon>
+ * ```
+ *
+ * @event focus - 获得焦点时触发
+ * @event blur - 失去焦点时触发
+ * @event change - 选中状态变更时触发
+ * @event invalid - 表单字段验证未通过时触发
+ *
+ * @slot - 图标组件
+ * @slot selected-icon 选中状态显示的图标元素
+ *
+ * @csspart button - 内部的 `<button>` 或 `<a>` 元素
+ * @csspart icon - 未选中状态的图标
+ * @csspart selected-icon 选中状态的图标
+ * @csspart loading - 加载中状态的 `<mdui-circular-progress>` 元素
+ *
+ * @cssprop --shape-corner - 组件的圆角大小。可以指定一个具体的像素值；但更推荐[引用设计令牌](/docs/2/styles/design-tokens#shape-corner)
+ */
+export declare class ButtonIcon extends ButtonBase {
+    static styles: CSSResultGroup;
+    /**
+     * 图标按钮的形状。可选值为：
+     *
+     * * `standard`：用于最低优先级的操作
+     * * `filled`：具有最强视觉效果，用于高优先级的操作
+     * * `tonal`：视觉效果介于 `filled` 和 `outlined` 之间，用于中高优先级的操作
+     * * `outlined`：用于中等优先级的操作
+     */
+    variant: /*用于最低优先级的操作*/ 'standard' | /*具有最强视觉效果，用于高优先级的操作*/ 'filled' | /*视觉效果介于 `filled` 和 `outlined` 之间，用于中高优先级的操作*/ 'tonal' | /*用于中等优先级的操作*/ 'outlined';
+    /**
+     * Material Icons 图标名。也可以通过 default slot 设置
+     */
+    icon?: string;
+    /**
+     * 选中状态的 Material Icons 图标名。也可以通过 `slot="selected-icon"` 设置
+     */
+    selectedIcon?: string;
+    /**
+     * 是否可选中
+     */
+    selectable: boolean;
+    /**
+     * 是否已选中
+     */
+    selected: boolean;
+    private readonly rippleRef;
+    private readonly hasSlotController;
+    protected get rippleElement(): Ripple;
+    private onSelectedChange;
+    protected firstUpdated(changedProperties: PropertyValues): void;
+    protected render(): TemplateResult;
+    private renderIcon;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'mdui-button-icon': ButtonIcon;
+    }
+}