Changeset 62745

Timestamp:

07/14/2026 09:43:31 PM (5 weeks ago)

Author:

joedolson

Message:

Customize: Add visible text on responsive view switches.

Add a visible text label on the Customizer's responsive view switches. While the text is very small, it serves to supplement the icons to help more readily comprehend the purpose of these controls. Consolidate the labels so the visible label matches the accessible name of the control for voice command users, and add a group role with aria-label to provide improved context for screen reader users.

Developed in ​https://github.com/WordPress/wordpress-develop/pull/12519

Props ahortin, iamjolly, cheffheid, oglekler, afercia, abcd95, westonruter, celloexpressions, rianrietveld, joshuawold, estelaris, mukesh27, joedolson, wildworks.
Fixes #36447.

Location:

trunk

Files:

• src/wp-admin/css/themes.css (modified) (3 diffs)
• src/wp-admin/customize.php (modified) (2 diffs)
• src/wp-includes/class-wp-customize-manager.php (modified) (1 diff)
• tests/phpunit/tests/customize/manager.php (modified) (2 diffs)
• tests/qunit/fixtures/customize-settings.js (modified) (1 diff)

trunk/src/wp-admin/css/themes.css

@@ -1749 +1749 @@
         border: none;
         height: 45px;
+        min-width: 50px;
         padding: 0 3px;
         margin: 0 0 0 -4px;
@@ -1768 +1769 @@
         display: inline-block;
         -webkit-font-smoothing: antialiased;
-        font: normal 20px/30px "dashicons";
+        font: normal 20px/20px "dashicons";
         vertical-align: top;
-        margin: 3px 0;
+        margin: 0 0 -2px;
         padding: 4px 8px;
         color: #646970;
@@ -1811 +1812 @@
         content: "\f470";
         content: "\f470" / '';
+}
+
+.wp-full-overlay-footer .devices .devices__preview-label {
+        display: block;
+        font-size: 10px;
+        line-height: 1;
 }
 

trunk/src/wp-admin/customize.php

@@ -276 +276 @@
                         <?php $previewable_devices = $wp_customize->get_previewable_devices(); ?>
                         <?php if ( ! empty( $previewable_devices ) ) : ?>
-                        <div class="devices-wrapper">
+                        <div class="devices-wrapper" role="group" aria-label="<?php echo esc_attr_x( 'Responsive Views', 'label for responsive previews group' ); ?>">
                                 <div class="devices">
                                         <?php foreach ( (array) $previewable_devices as $device => $settings ) : ?>
@@ -290 +290 @@
                                                 ?>
                                                 <button type="button" class="<?php echo esc_attr( $class ); ?>" aria-pressed="<?php echo esc_attr( $active ); ?>" data-device="<?php echo esc_attr( $device ); ?>">
-                                                        <span class="screen-reader-text"><?php echo esc_html( $settings['label'] ); ?></span>
+                                                        <span class="devices__preview-label"><?php echo esc_html( $settings['label'] ); ?></span>
                                                 </button>
                                         <?php endforeach; ?>

trunk/src/wp-includes/class-wp-customize-manager.php

@@ -5045 +5045 @@
                 $devices = array(
                         'desktop' => array(
-                                'label'   => __( 'Enter desktop preview mode' ),
+                                'label'   => __( 'Desktop' ),
                                 'default' => true,
                         ),
                         'tablet'  => array(
-                                'label' => __( 'Enter tablet preview mode' ),
+                                'label' => __( 'Tablet' ),
                         ),
                         'mobile'  => array(
-                                'label' => __( 'Enter mobile preview mode' ),
+                                'label' => __( 'Mobile' ),
                         ),
                 );

trunk/tests/phpunit/tests/customize/manager.php

@@ -3520 +3520 @@
                 $default_devices = array(
                         'desktop' => array(
-                                'label'   => __( 'Enter desktop preview mode' ),
+                                'label'   => __( 'Desktop' ),
                                 'default' => true,
                         ),
                         'tablet'  => array(
-                                'label' => __( 'Enter tablet preview mode' ),
+                                'label' => __( 'Tablet' ),
                         ),
                         'mobile'  => array(
-                                'label' => __( 'Enter mobile preview mode' ),
+                                'label' => __( 'Mobile' ),
                         ),
                 );
@@ -3552 +3552 @@
                 return array(
                         'custom-device' => array(
-                                'label'   => __( 'Enter custom-device preview mode' ),
+                                'label'   => __( 'Custom device' ),
                                 'default' => true,
                         ),

trunk/tests/qunit/fixtures/customize-settings.js

@@ -147 +147 @@
         'previewableDevices': {
                 'desktop': {
-                        'label': 'Enter desktop preview mode',
+                        'label': 'Desktop',
                         'default': true
                 },
                 'tablet': {
-                        'label': 'Enter tablet preview mode'
+                        'label': 'Tablet'
                 },
                 'mobile': {
-                        'label': 'Enter mobile preview mode'
+                        'label': 'Mobile'
                 }
         },