按钮 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 that resolves when the action completes.

异步
click

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

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

参数

Parameters

relativeX

number

单击的相对位置 x。

The relative x position of the click.

relativeY

number

单击的相对位置 y。

The relative y position of the click.

返回值

Returns

Promise<void>

Promise that resolves when the action completes.

异步
click

单击按钮的中心。

Clicks the button at its center.

参数

Parameters

location

"center"

返回值

Returns

Promise<void>

Promise that resolves when the action completes.

异步
click

单击此按钮。

Clicks the button.

返回值

Returns

Promise<void>

Promise that resolves when the action completes.

异步
focus

让此按钮获得焦点。

Focuses the button.

返回值

Returns

Promise<void>

Promise that resolves when the action completes.

异步
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.