按钮 Button

button 的 API

Angular Material button API 参考文档

import {MatButtonModule} from '@angular/material/button';

Material Design 按钮。

Material design button.

选择器: button[mat-button] button[mat-raised-button] button[mat-icon-button] button[mat-fab] button[mat-mini-fab] button[mat-stroked-button] button[mat-flat-button]
导出为: matButton
属性
名称 描述
@Input()

color: ThemePalette

此组件的主题调色板。

Theme color palette for the component.

@Input()

disableRipple: boolean

是否禁用涟漪。

Whether ripples are disabled.

@Input()

disabled: boolean

该组件是否已禁用。

Whether the component is disabled.

defaultColor: ThemePalette | undefined

如果未设置任何值,则默认颜色恢复为原来的颜色。

Default color to fall back to if no value is set.

isIconButton: boolean

此按钮是否为图标按钮。

Whether the button is icon button.

isRoundButton: boolean

此按钮是否为圆形的。

Whether the button is round.

ripple: MatRipple

引用此按钮的 MatRipple 实例。

Reference to the MatRipple instance of the button.

方法
focus

让此按钮获取焦点。

Focuses the button.

参数

Parameters

origin?

FocusOrigin

options?

FocusOptions

Material Design 锚定按钮。

Material design anchor button.

选择器: a[mat-button] a[mat-raised-button] a[mat-icon-button] a[mat-fab] a[mat-mini-fab] a[mat-stroked-button] a[mat-flat-button]
导出为: matButton, matAnchor
属性
名称 描述
@Input()

color: ThemePalette

此组件的主题调色板。

Theme color palette for the component.

@Input()

disableRipple: boolean

是否禁用涟漪。

Whether ripples are disabled.

@Input()

disabled: boolean

该组件是否已禁用。

Whether the component is disabled.

defaultColor: ThemePalette | undefined

如果未设置任何值,则默认颜色恢复为原来的颜色。

Default color to fall back to if no value is set.

isIconButton: boolean

此按钮是否为图标按钮。

Whether the button is icon button.

isRoundButton: boolean

此按钮是否为圆形的。

Whether the button is round.

ripple: MatRipple

引用此按钮的 MatRipple 实例。

Reference to the MatRipple instance of the button.

方法
focus

让此按钮获取焦点。

Focuses the button.

参数

Parameters

origin?

FocusOrigin

options?

FocusOptions

Angular Material button-testing API 参考文档

import {MatButtonHarness} from '@angular/material/button/testing';

在测试中与标准 mat-button 进行交互的测试工具。

Harness for interacting with a standard mat-button in tests.

方法
异步
blur

让此按钮失焦。

Blurs the button.

返回值

Returns

Promise<void>

当此动作完成时解析的 Promise。

异步
click

在相对于按钮左上角的指定位置单击它。

Clicks the button at the given position relative to its top-left.

单击的相对位置 x。

@param relativeX The relative x position of the click.

单击的相对位置 y。

@param relativeY The relative y position of the click.

参数

Parameters

relativeX

number

relativeY

number

返回值

Returns

Promise<void>

当此动作完成时解析的 Promise。

异步
click

单击按钮的中心。

Clicks the button at its center.

参数

Parameters

location

"center"

返回值

Returns

Promise<void>

当此动作完成时解析的 Promise。

异步
click

单击此按钮。

Clicks the button.

返回值

Returns

Promise<void>

当此动作完成时解析的 Promise。

异步
focus

让此按钮获得焦点。

Focuses the button.

返回值

Returns

Promise<void>

当此动作完成时解析的 Promise。

异步
getAllChildLoaders

参数

Parameters

selector

S

返回值

Returns

Promise<HarnessLoader[]>
异步
getAllHarnesses

参数

Parameters

query

HarnessQuery<T>

返回值

Returns

Promise<T[]>
异步
getChildLoader

参数

Parameters

selector

S

返回值

Returns

Promise<HarnessLoader>
异步
getHarness

参数

Parameters

query

HarnessQuery<T>

返回值

Returns

Promise<T>
异步
getText

获取该按钮的标签文本。

Gets the button's label text.

返回值

Returns

Promise<string>
异步
host

获取一个代表该组件宿主元素的 TestElementPromise

Gets a Promise for the TestElement representing the host element of the component.

返回值

Returns

Promise<TestElement>
异步
isDisabled

该按钮是否已禁用。

Whether the button is disabled.

返回值

Returns

Promise<boolean>
异步
isFocused

此按钮是否拥有焦点。

Whether the button is focused.

返回值

Returns

Promise<boolean>

一组可以用来过滤 MatButtonHarness 实例列表的条件。

A set of criteria that can be used to filter a list of MatButtonHarness instances.

属性
名称 描述

text: string | RegExp

只查找其文本内容匹配指定值的实例。

Only find instances whose text matches the given value.