@material/touch-target

Touch Target

Touch targets are the parts of the screen that respond to user input. They extend beyond the visual bounds of an element. For example, a button may appear to be 48 x 36 px, but the padding surrounding it comprises the full 48 x 48 px touch target.

Material Design spec states that touch targets should be at least 48 x 48 px. The MDC Web library provides mixins and guidance on adding an increased touch target for the following components:

• Button
• Chips
• Checkbox
• Radio
• Mini FAB

Design & API Documentation

• Material Design guidelines: Touch Targets

Installation

npm install @material/touch-target

Basic Usage

HTML Structure

For a given button component:

<button class="mdc-button">
  <div class="mdc-button__ripple"></div>
  <span class="mdc-button__label">My Inaccessible Button</span>
</button>

You would add an increased touch target as follows:

<div class="mdc-touch-target-wrapper">
  <button class="mdc-button mdc-button--touch">
    <div class="mdc-button__ripple"></div>
    <div class="mdc-button__touch"></div>
    <span class="mdc-button__label">My Accessible Button</span>
  </button>
</div>

Note that the outer mdc-touch-target-wrapper element is only necessary if you want to avoid potentially overlapping touch targets on adjacent elements (due to collapsing margins).

Styles

@use "@material/touch-target/mdc-touch-target";

Style Customization

Sass Mixins

Mixin	Description
wrapper	Applied to the wrapper touch target element.
touch-target	Applied to the inner touch target element.
margin	Applied to the component root element. Adds margin to compensate for the increased touch target.

Changelog

13.0.0 (2021-09-24)

Bug Fixes

• Fix missing $ripple-target param for ripple mixin (1340ee9)
• banner: Adjusting theme api selectors to use mdc-button. (15981e9)
• banner: Correcting incorrect theme values passed through to button's theme-mixin. (0de2f2e)
• banner: exclude source from npm package (#7381) (d48a017), closes #7360
• banner: Removing action-<state>-label-text-color values from MDC light-theme map. (d97f8f1)
• button: cleanup outlined button theme keys (28d0d75)
• button: fix touch target reset in context of link buttons (3b8d442)
• button: remove negative padding around icons (d470693)
• button: remove rem/em transformers from typography theme-styles (a395972)
• button: stack ripple behind content (e1e69fd)
• density: typo in variable exports (6df682e)
• dom: Support providing an owner document for announcer messages. (6236f35)
• elevation: reduce warnings when not providing elevation tokens (adb9f1a)
• iconbutton: Fix icon button theme keys/light theme values based on updated tokens. (42d175e)
• menu: apply elevation overlay to new lists (0ad12ed)
• sass: Wrap templated calc expressions in strings (818f4ee), closes #7391
• slider: Reorder such that dragstart event is emitted before any other events when handling drag start. (877e3fb)
• slider: Replace innerHTML with firstChild (37d4db8)
• Fix compilation issues with TypeScript 4.4 (7246447)
• switch: add pointer cursor (12f5622)
• switch: distribute correct css (#7292) (7b6bcb8)
• switch: elevation theme custom properties not working (2865629)
• switch: use correct colors for icons in all HCM themes (d86fb6f)
• theme: ensure state selectors negate properly (7249a30)
• tooltip: Add a getActiveElement() method to MDCTooltipAdapter to delegate getting the active element from the correct document. (e334676)
• tooltip: Adjust tooltip focusout handler. Ensures that interactive tooltips remain open when ChromeVox uses linear navigation to read non-focusable content inside the tooltip. (7c96e6b)
• tooltip: non-persistent tooltips disappear on scroll (1f9259b)
• update combined mdc package to use new switch CSS (077dcfc), closes #7304
• tooltip: allow the Mac zoom service to access plain tooltip contents (510cf90)

Code Refactoring

• fab: Deprecate legacy Fab theme mixins (83bdd02)
• iconbutton: Forward only theme mixins from MDC icon button index module. (0a90693)
• theme: Rename validate-keys() to validate-theme() (2fb068f)

Features

• button: add custom props to outlined button theme-styles (bf405d2)
• button: add custom props to protected button theme-styles (4ca11fe)
• button: add custom props to text button theme-styles (3dd6110)
• button: add missing transitions to box-shadow/border (3b92903)
• button: add static-styles-without-ripple for MWC consumption (f4241a4)
• button: add theme mixin that emits custom properties instead (4c40586)
• button: emit custom properties fill button theme-styles (a80c8b2)
• button: m3 elevation + icon base theme modules (2da3606)
• button: resolve elevation keys in theme mixin (843342f)
• chips: Add theming Sass mixin to MDC Filter Chip (8390093)
• chips: Add theming Sass mixin to MDC input & suggestion Chip (860ad06)
• chips: Added theme mixins to Assist Chip (d4e16a6)
• chips: Export all non-deprecated members through chips index (8647986)
• chips: Rename action's exported members to avoid naming collisions (b49359c)
• chips: Rename chip set's exported members to avoid naming collisions (13db34b)
• chips: Rename chip's exported members to avoid naming collisions (470bd34)
• data-table: Implement row click feature to MDC data table (8de07c0)
• data-table: use new select + list templates for pagination (08398f8)
• dialog: Add theme styles mixin to dialog (21ece53)
• dialog: Separate static styles from dialog core-styles mixin (43d2eed)
• fab: create theming file for small fabs (d082790)
• fab: prepare fab-extended for theming in MWC (ce25bc3)
• iconbutton: Add .mdc-icon-button--display-flex class that centers icon via flexbox. When using the new theme API, the icon button should have this class. (8355e14)
• iconbutton: Add MDC theme mixin that declares custom properties. (fa7520f)
• iconbutton: Add theme styles mixin. (65aa63b)
• menu: Added getter method to check fixed position status of menu (fb76c50)
• menu: Adds option to prevent focus from being restored after an item action. (65084ba)
• select: start compatibility work for evolution lists (e8554db)
• theme: Added validate-theme-keys() mixin to validate theme keys only (457d89a)

BREAKING CHANGES

• menu: Adds new menu adapter method:

  /**

  • @return the attribute string if present on an element at the index
  • provided, null otherwise. */ getAttributeFromElementAtIndex(index: number, attr: string): string|null;

PiperOrigin-RevId: 398575780

• iconbutton: MDC iconbutton _index Sass module will only export theme mixins.

PiperOrigin-RevId: 391773229

• theme: Renamed Sass mixins validate-keys() to validate-theme() in @material/theme

PiperOrigin-RevId: 390671152

• fab: Renamed Fab's mixins to deprecate legacy theme mixins.

PiperOrigin-RevId: 387378201