style.scss

.components-button {
	display: inline-flex;
	text-decoration: none;
	font-family: inherit;
	font-weight: normal;
	font-size: $default-font-size;
	margin: 0;
	border: 0;
	cursor: pointer;
	-webkit-appearance: none;
	background: none;
	transition: box-shadow 0.1s linear;
	@include reduce-motion("transition");
	height: $button-size;
	align-items: center;
	box-sizing: border-box;
	padding: 6px 12px;
	border-radius: $radius-block-ui;
	color: $components-color-foreground;

	&.is-next-40px-default-size {
		height: $button-size-next-default-40px;
	}

	&[aria-expanded="true"],
	&:hover {
		color: $components-color-accent;
	}

	// Unset some hovers, instead of adding :not specificity.
	&:disabled:hover,
	&[aria-disabled="true"]:hover {
		color: initial;
	}

	// Focus.
	// See https://github.com/WordPress/gutenberg/issues/13267 for more context on these selectors.
	&:focus:not(:disabled) {
		box-shadow: 0 0 0 var(--wp-admin-border-width-focus) $components-color-accent;

		// Windows High Contrast mode will show this outline, but not the box-shadow.
		outline: 3px solid transparent;
	}

	/**
	 * Primary button style.
	 */

	&.is-primary {
		white-space: nowrap;
		background: $components-color-accent;
		color: $components-color-accent-inverted;
		text-decoration: none;
		text-shadow: none;

		// Show the boundary of the button, in High Contrast Mode.
		outline: 1px solid transparent;

		&:hover:not(:disabled) {
			background: $components-color-accent-darker-10;
			color: $components-color-accent-inverted;
		}

		&:active:not(:disabled) {
			background: $components-color-accent-darker-20;
			border-color: $components-color-accent-darker-20;
			color: $components-color-accent-inverted;
		}

		&:focus:not(:disabled) {
			box-shadow: inset 0 0 0 1px $components-color-background, 0 0 0 var(--wp-admin-border-width-focus) $components-color-accent;
		}

		&:disabled,
		&:disabled:active:enabled,
		&[aria-disabled="true"],
		&[aria-disabled="true"]:enabled, // This catches a situation where a Button is aria-disabled, but not disabled.
		&[aria-disabled="true"]:active:enabled {
			// TODO: Prepare for theming (https://github.com/WordPress/gutenberg/pull/45466/files#r1030872724)
			color: rgba($white, 0.4);
			background: $components-color-accent;
			border-color: $components-color-accent;
			opacity: 1;
			outline: none;

			&:focus:enabled {
				box-shadow:
					0 0 0 $border-width $components-color-background,
					0 0 0 3px $components-color-accent;
			}
		}

		&.is-busy,
		&.is-busy:disabled,
		&.is-busy[aria-disabled="true"] {
			color: $components-color-accent-inverted;
			background-size: 100px 100%;
			// Disable reason: This function call looks nicer when each argument is on its own line.
			/* stylelint-disable */
			background-image: linear-gradient(
				-45deg,
				$components-color-accent 33%,
				$components-color-accent-darker-20 33%,
				$components-color-accent-darker-20 70%,
				$components-color-accent 70%
			);
			/* stylelint-enable */
			border-color: $components-color-accent;
		}
	}

	/**
	 * Secondary and tertiary buttons.
	 */

	&.is-secondary,
	&.is-tertiary {
		// Show the boundary of the button, in High Contrast Mode.
		outline: 1px solid transparent;

		&:active:not(:disabled) {
			box-shadow: none;
		}

		&:disabled,
		&[aria-disabled="true"],
		&[aria-disabled="true"]:hover {
			color: $gray-600;
			background: transparent;
			transform: none;
			opacity: 1;
			box-shadow: none;
			outline: none;
		}
	}

	/**
	 * Secondary button style.
	 */

	&.is-secondary {
		box-shadow: inset 0 0 0 $border-width $components-color-accent;
		outline: 1px solid transparent; // Shown in high contrast mode.
		white-space: nowrap;
		color: $components-color-accent;
		background: transparent;

		&:hover:not(:disabled, [aria-disabled="true"]) {
			box-shadow: inset 0 0 0 $border-width $components-color-accent-darker-10;
		}
	}

	/**
	 * Tertiary buttons.
	 */

	&.is-tertiary {
		white-space: nowrap;
		color: $components-color-accent;
		background: transparent;

		&:hover:not(:disabled, [aria-disabled="true"]) {
			// TODO: Prepare for theming (https://github.com/WordPress/gutenberg/pull/45466/files#r1030872724)
			background: rgba(var(--wp-admin-theme-color--rgb), 0.04);
		}

		&:active:not(:disabled, [aria-disabled="true"]) {
			// TODO: Prepare for theming (https://github.com/WordPress/gutenberg/pull/45466/files#r1030872724)
			background: rgba(var(--wp-admin-theme-color--rgb), 0.08);
		}

		// Pull left if the tertiary button stands alone after a description, so as to vertically align with items above.
		p + & {
			margin-left: -($grid-unit-15 * 0.5);
		}
	}

	/**
	 * Destructive buttons.
	 */
	&.is-destructive {
		--wp-components-color-accent: #{$alert-red};
		--wp-components-color-accent-darker-10: #{darken($alert-red, 10%)};
		--wp-components-color-accent-darker-20: #{darken($alert-red, 20%)};

		// Only the default variant is styled differently from the non-destructive counterparts.
		&:not(.is-primary):not(.is-secondary):not(.is-tertiary):not(.is-link) {
			color: $alert-red;

			&:hover:not(:disabled) {
				color: darken($alert-red, 20%);
			}

			&:focus:not(:disabled) {
				box-shadow: 0 0 0 var(--wp-admin-border-width-focus) $alert-red;
			}

			&:active:not(:disabled) {
				background: $gray-400;
			}
		}
	}

	/**
	 * Link buttons.
	 */

	&.is-link {
		margin: 0;
		padding: 0;
		box-shadow: none;
		border: 0;
		border-radius: 0;
		background: none;
		outline: none;
		text-align: left;
		color: $components-color-accent;
		text-decoration: underline;
		transition-property: border, background, color;
		transition-duration: 0.05s;
		transition-timing-function: ease-in-out;
		@include reduce-motion("transition");
		height: auto;

		&:focus {
			border-radius: $radius-block-ui;
		}
	}

	&:not(:disabled, [aria-disabled="true"]):active {
		color: $components-color-foreground;
	}

	&:disabled,
	&[aria-disabled="true"] {
		cursor: default;
		opacity: 0.3;
	}

	&.is-busy,
	&.is-secondary.is-busy,
	&.is-secondary.is-busy:disabled,
	&.is-secondary.is-busy[aria-disabled="true"] {
		animation: components-button__busy-animation 2500ms infinite linear;
		opacity: 1;
		background-size: 100px 100%;
		// Disable reason: This function call looks nicer when each argument is on its own line.
		/* stylelint-disable */
		background-image: linear-gradient(
			-45deg,
			// TODO: Prepare for theming (https://github.com/WordPress/gutenberg/pull/45466/files#r1030872724)
			darken($white, 2%) 33%,
			darken($white, 12%) 33%,
			darken($white, 12%) 70%,
			darken($white, 2%) 70%
		);
		/* stylelint-enable */
	}

	&.is-compact {
		height: $button-size-compact;

		&.has-icon:not(.has-text) {
			padding: 0;
			width: $button-size-compact;
			min-width: $button-size-compact;
		}
	}

	&.is-small {
		height: $button-size-small;
		line-height: 22px;
		padding: 0 8px;
		font-size: 11px;

		&.has-icon:not(.has-text) {
			padding: 0;
			width: $button-size-small;
			min-width: $button-size-small;
		}
	}

	&.has-icon {
		padding: 6px; // Works for 24px icons. Smaller icons are vertically centered by flex alignments.

		// Icon buttons are square.
		min-width: $button-size;
		justify-content: center;

		&.is-next-40px-default-size {
			min-width: $button-size-next-default-40px;
		}

		.dashicon {
			display: inline-flex;
			justify-content: center;
			align-items: center;
			padding: 2px;
			box-sizing: content-box;
		}

		&.has-text {
			justify-content: start;
			padding-right: $grid-unit-15;
			padding-left: $grid-unit-10;
			gap: $grid-unit-05;
		}
	}

	// Toggled style.
	&.is-pressed {
		color: $components-color-foreground-inverted;
		background: $components-color-foreground;

		&:focus:not(:disabled) {
			box-shadow: inset 0 0 0 1px $components-color-background, 0 0 0 var(--wp-admin-border-width-focus) $components-color-accent;

			// Windows High Contrast mode will show this outline, but not the box-shadow.
			outline: 2px solid transparent;
		}

		&:hover:not(:disabled) {
			color: $components-color-foreground-inverted;
			background: $components-color-foreground;
		}
	}

	svg {
		fill: currentColor;
		outline: none;

		// Optimizate for high contrast modes.
		// See also https://blogs.windows.com/msedgedev/2020/09/17/styling-for-windows-high-contrast-with-new-standards-for-forced-colors/.
		@media (forced-colors: active) {
			fill: CanvasText;
		}
	}

	// Fixes a Safari+VoiceOver bug, where the screen reader text is announced not respecting the source order.
	// See https://core.trac.wordpress.org/ticket/42006 and https://github.com/h5bp/html5-boilerplate/issues/1985
	.components-visually-hidden {
		height: auto;
	}
}

@keyframes components-button__busy-animation {
	0% {
		background-position: 200px 0;
	}
}