Make WordPress Core


Ignore:
Timestamp:
02/07/2023 05:08:26 PM (22 months ago)
Author:
SergeyBiryukov
Message:

I18N: Mark screen reader strings as such with translator comments.

This aims to provide better context for translators and make it easier to determine that some strings contain hidden accessibility text and are not displayed in the UI.

Props kebbet, mercime, pavelevap, ocean90, swissspidy, Chouby, jipmoors, afercia, desrosj, costdev, audrasjb, SergeyBiryukov.
Fixes #29748.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/src/wp-admin/includes/meta-boxes.php

    r55113 r55276  
    7777                    '%1$s<span class="screen-reader-text"> %2$s</span>',
    7878                    $preview_button_text,
    79                     /* translators: Accessibility text. */
     79                    /* translators: Hidden accessibility text. */
    8080                    __( '(opens in a new tab)' )
    8181                );
     
    133133                }
    134134                ?>
    135                 <a href="#post_status" <?php echo $private_style; ?> class="edit-post-status hide-if-no-js" role="button"><span aria-hidden="true"><?php _e( 'Edit' ); ?></span> <span class="screen-reader-text"><?php _e( 'Edit status' ); ?></span></a>
     135                <a href="#post_status" <?php echo $private_style; ?> class="edit-post-status hide-if-no-js" role="button"><span aria-hidden="true"><?php _e( 'Edit' ); ?></span> <span class="screen-reader-text">
     136                    <?php
     137                    /* translators: Hidden accessibility text. */
     138                    _e( 'Edit status' );
     139                    ?>
     140                </span></a>
    136141
    137142                <div id="post-status-select" class="hide-if-js">
    138143                    <input type="hidden" name="hidden_post_status" id="hidden_post_status" value="<?php echo esc_attr( ( 'auto-draft' === $post->post_status ) ? 'draft' : $post->post_status ); ?>" />
    139                     <label for="post_status" class="screen-reader-text"><?php _e( 'Set status' ); ?></label>
     144                    <label for="post_status" class="screen-reader-text">
     145                        <?php
     146                        /* translators: Hidden accessibility text. */
     147                        _e( 'Set status' );
     148                        ?>
     149                    </label>
    140150                    <select name="post_status" id="post_status">
    141151                        <?php if ( 'publish' === $post->post_status ) : ?>
     
    185195
    186196            <?php if ( $can_publish ) { ?>
    187                 <a href="#visibility" class="edit-visibility hide-if-no-js" role="button"><span aria-hidden="true"><?php _e( 'Edit' ); ?></span> <span class="screen-reader-text"><?php _e( 'Edit visibility' ); ?></span></a>
     197                <a href="#visibility" class="edit-visibility hide-if-no-js" role="button"><span aria-hidden="true"><?php _e( 'Edit' ); ?></span> <span class="screen-reader-text">
     198                    <?php
     199                    /* translators: Hidden accessibility text. */
     200                    _e( 'Edit visibility' );
     201                    ?>
     202                </span></a>
    188203
    189204                <div id="post-visibility-select" class="hide-if-js">
     
    258273                printf( __( 'Revisions: %s' ), '<b>' . number_format_i18n( $args['args']['revisions_count'] ) . '</b>' );
    259274                ?>
    260                 <a class="hide-if-no-js" href="<?php echo esc_url( get_edit_post_link( $args['args']['revision_id'] ) ); ?>"><span aria-hidden="true"><?php _ex( 'Browse', 'revisions' ); ?></span> <span class="screen-reader-text"><?php _e( 'Browse revisions' ); ?></span></a>
     275                <a class="hide-if-no-js" href="<?php echo esc_url( get_edit_post_link( $args['args']['revision_id'] ) ); ?>"><span aria-hidden="true"><?php _ex( 'Browse', 'revisions' ); ?></span> <span class="screen-reader-text">
     276                    <?php
     277                    /* translators: Hidden accessibility text. */
     278                    _e( 'Browse revisions' );
     279                    ?>
     280                </span></a>
    261281            </div>
    262282            <?php
     
    271291                <a href="#edit_timestamp" class="edit-timestamp hide-if-no-js" role="button">
    272292                    <span aria-hidden="true"><?php _e( 'Edit' ); ?></span>
    273                     <span class="screen-reader-text"><?php _e( 'Edit date and time' ); ?></span>
     293                    <span class="screen-reader-text">
     294                        <?php
     295                        /* translators: Hidden accessibility text. */
     296                        _e( 'Edit date and time' );
     297                        ?>
     298                    </span>
    274299                </a>
    275300                <fieldset id="timestampdiv" class="hide-if-js">
    276                     <legend class="screen-reader-text"><?php _e( 'Date and time' ); ?></legend>
     301                    <legend class="screen-reader-text">
     302                        <?php
     303                        /* translators: Hidden accessibility text. */
     304                        _e( 'Date and time' );
     305                        ?>
     306                    </legend>
    277307                    <?php touch_time( ( 'edit' === $action ), 1 ); ?>
    278308                </fieldset>
     
    493523        <div id="post-formats-select">
    494524        <fieldset>
    495             <legend class="screen-reader-text"><?php _e( 'Post Formats' ); ?></legend>
     525            <legend class="screen-reader-text">
     526                <?php
     527                /* translators: Hidden accessibility text. */
     528                _e( 'Post Formats' );
     529                ?>
     530            </legend>
    496531            <input type="radio" name="post_format" class="post-format" id="post-format-0" value="0" <?php checked( $post_format, '0' ); ?> /> <label for="post-format-0" class="post-format-icon post-format-standard"><?php echo get_post_format_string( 'standard' ); ?></label>
    497532            <?php foreach ( $post_formats[0] as $format ) : ?>
     
    701736function post_excerpt_meta_box( $post ) {
    702737    ?>
    703 <label class="screen-reader-text" for="excerpt"><?php _e( 'Excerpt' ); ?></label><textarea rows="1" cols="40" name="excerpt" id="excerpt"><?php echo $post->post_excerpt; // textarea_escaped ?></textarea>
     738<label class="screen-reader-text" for="excerpt">
     739    <?php
     740    /* translators: Hidden accessibility text. */
     741    _e( 'Excerpt' );
     742    ?>
     743</label><textarea rows="1" cols="40" name="excerpt" id="excerpt"><?php echo $post->post_excerpt; // textarea_escaped ?></textarea>
    704744<p>
    705745    <?php
     
    889929    $editable_slug = apply_filters( 'editable_slug', $post->post_name, $post );
    890930    ?>
    891 <label class="screen-reader-text" for="post_name"><?php _e( 'Slug' ); ?></label><input name="post_name" type="text" class="large-text" id="post_name" value="<?php echo esc_attr( $editable_slug ); ?>" />
     931<label class="screen-reader-text" for="post_name">
     932    <?php
     933    /* translators: Hidden accessibility text. */
     934    _e( 'Slug' );
     935    ?>
     936</label><input name="post_name" type="text" class="large-text" id="post_name" value="<?php echo esc_attr( $editable_slug ); ?>" />
    892937    <?php
    893938}
     
    907952    $post_type_object = get_post_type_object( $post->post_type );
    908953    ?>
    909 <label class="screen-reader-text" for="post_author_override"><?php _e( 'Author' ); ?></label>
     954<label class="screen-reader-text" for="post_author_override">
     955    <?php
     956    /* translators: Hidden accessibility text. */
     957    _e( 'Author' );
     958    ?>
     959</label>
    910960    <?php
    911961    wp_dropdown_users(
     
    11441194        <a id="category-add-toggle" href="#category-add" class="taxonomy-add-new"><?php _e( '+ Add New Category' ); ?></a>
    11451195        <p id="link-category-add" class="wp-hidden-child">
    1146             <label class="screen-reader-text" for="newcat"><?php _e( '+ Add New Category' ); ?></label>
     1196            <label class="screen-reader-text" for="newcat">
     1197                <?php
     1198                /* translators: Hidden accessibility text. */
     1199                _e( '+ Add New Category' );
     1200                ?>
     1201            </label>
    11471202            <input type="text" name="newcat" id="newcat" class="form-required form-input-tip" value="<?php esc_attr_e( 'New category name' ); ?>" aria-required="true" />
    11481203            <input type="button" id="link-category-add-submit" data-wp-lists="add:categorychecklist:link-category-add" class="button" value="<?php esc_attr_e( 'Add' ); ?>" />
     
    11651220
    11661221    ?>
    1167 <fieldset><legend class="screen-reader-text"><span><?php _e( 'Target' ); ?></span></legend>
     1222<fieldset><legend class="screen-reader-text"><span>
     1223    <?php
     1224    /* translators: Hidden accessibility text. */
     1225    _e( 'Target' );
     1226    ?>
     1227</span></legend>
    11681228<p><label for="link_target_blank" class="selectit">
    11691229<input id="link_target_blank" type="radio" name="link_target" value="_blank" <?php echo ( isset( $link->link_target ) && ( '_blank' === $link->link_target ) ? 'checked="checked"' : '' ); ?> />
     
    12551315    <tr>
    12561316        <th scope="row"><?php /* translators: xfn: https://gmpg.org/xfn/ */ _e( 'identity' ); ?></th>
    1257         <td><fieldset><legend class="screen-reader-text"><span><?php /* translators: xfn: https://gmpg.org/xfn/ */ _e( 'identity' ); ?></span></legend>
     1317        <td><fieldset>
     1318            <legend class="screen-reader-text"><span>
     1319                <?php
     1320                /* translators: Hidden accessibility text. xfn: https://gmpg.org/xfn/ */
     1321                _e( 'identity' );
     1322                ?>
     1323            </span></legend>
    12581324            <label for="me">
    12591325            <input type="checkbox" name="identity" value="me" id="me" <?php xfn_check( 'identity', 'me' ); ?> />
     
    12631329    <tr>
    12641330        <th scope="row"><?php /* translators: xfn: https://gmpg.org/xfn/ */ _e( 'friendship' ); ?></th>
    1265         <td><fieldset><legend class="screen-reader-text"><span><?php /* translators: xfn: https://gmpg.org/xfn/ */ _e( 'friendship' ); ?></span></legend>
     1331        <td><fieldset>
     1332            <legend class="screen-reader-text"><span>
     1333                <?php
     1334                /* translators: Hidden accessibility text. xfn: https://gmpg.org/xfn/ */
     1335                _e( 'friendship' );
     1336                ?>
     1337            </span></legend>
    12661338            <label for="contact">
    12671339            <input class="valinp" type="radio" name="friendship" value="contact" id="contact" <?php xfn_check( 'friendship', 'contact' ); ?> />&nbsp;<?php /* translators: xfn: https://gmpg.org/xfn/ */ _e( 'contact' ); ?>
     
    12801352    <tr>
    12811353        <th scope="row"> <?php /* translators: xfn: https://gmpg.org/xfn/ */ _e( 'physical' ); ?> </th>
    1282         <td><fieldset><legend class="screen-reader-text"><span><?php /* translators: xfn: https://gmpg.org/xfn/ */ _e( 'physical' ); ?></span></legend>
     1354        <td><fieldset>
     1355            <legend class="screen-reader-text"><span>
     1356                <?php
     1357                /* translators: Hidden accessibility text. xfn: https://gmpg.org/xfn/ */
     1358                _e( 'physical' );
     1359                ?>
     1360            </span></legend>
    12831361            <label for="met">
    12841362            <input class="valinp" type="checkbox" name="physical" value="met" id="met" <?php xfn_check( 'physical', 'met' ); ?> />&nbsp;<?php /* translators: xfn: https://gmpg.org/xfn/ */ _e( 'met' ); ?>
     
    12881366    <tr>
    12891367        <th scope="row"> <?php /* translators: xfn: https://gmpg.org/xfn/ */ _e( 'professional' ); ?> </th>
    1290         <td><fieldset><legend class="screen-reader-text"><span><?php /* translators: xfn: https://gmpg.org/xfn/ */ _e( 'professional' ); ?></span></legend>
     1368        <td><fieldset>
     1369            <legend class="screen-reader-text"><span>
     1370                <?php
     1371                /* translators: Hidden accessibility text. xfn: https://gmpg.org/xfn/ */
     1372                _e( 'professional' );
     1373                ?>
     1374            </span></legend>
    12911375            <label for="co-worker">
    12921376            <input class="valinp" type="checkbox" name="professional" value="co-worker" id="co-worker" <?php xfn_check( 'professional', 'co-worker' ); ?> />&nbsp;<?php /* translators: xfn: https://gmpg.org/xfn/ */ _e( 'co-worker' ); ?>
     
    12991383    <tr>
    13001384        <th scope="row"><?php /* translators: xfn: https://gmpg.org/xfn/ */ _e( 'geographical' ); ?></th>
    1301         <td><fieldset><legend class="screen-reader-text"><span> <?php /* translators: xfn: https://gmpg.org/xfn/ */ _e( 'geographical' ); ?> </span></legend>
     1385        <td><fieldset>
     1386            <legend class="screen-reader-text"><span>
     1387                <?php
     1388                /* translators: Hidden accessibility text. xfn: https://gmpg.org/xfn/ */
     1389                _e( 'geographical' );
     1390                ?>
     1391            </span></legend>
    13021392            <label for="co-resident">
    13031393            <input class="valinp" type="radio" name="geographical" value="co-resident" id="co-resident" <?php xfn_check( 'geographical', 'co-resident' ); ?> />&nbsp;<?php /* translators: xfn: https://gmpg.org/xfn/ */ _e( 'co-resident' ); ?>
     
    13131403    <tr>
    13141404        <th scope="row"><?php /* translators: xfn: https://gmpg.org/xfn/ */ _e( 'family' ); ?></th>
    1315         <td><fieldset><legend class="screen-reader-text"><span> <?php /* translators: xfn: https://gmpg.org/xfn/ */ _e( 'family' ); ?> </span></legend>
     1405        <td><fieldset>
     1406            <legend class="screen-reader-text"><span>
     1407                <?php
     1408                /* translators: Hidden accessibility text. xfn: https://gmpg.org/xfn/ */
     1409                _e( 'family' );
     1410                ?>
     1411            </span></legend>
    13161412            <label for="child">
    13171413            <input class="valinp" type="radio" name="family" value="child" id="child" <?php xfn_check( 'family', 'child' ); ?> />&nbsp;<?php /* translators: xfn: https://gmpg.org/xfn/ */ _e( 'child' ); ?>
     
    13361432    <tr>
    13371433        <th scope="row"><?php /* translators: xfn: https://gmpg.org/xfn/ */ _e( 'romantic' ); ?></th>
    1338         <td><fieldset><legend class="screen-reader-text"><span> <?php /* translators: xfn: https://gmpg.org/xfn/ */ _e( 'romantic' ); ?> </span></legend>
     1434        <td><fieldset>
     1435            <legend class="screen-reader-text"><span>
     1436                <?php
     1437                /* translators: Hidden accessibility text. xfn: https://gmpg.org/xfn/ */
     1438                _e( 'romantic' );
     1439                ?>
     1440            </span></legend>
    13391441            <label for="muse">
    13401442            <input class="valinp" type="checkbox" name="romantic" value="muse" id="muse" <?php xfn_check( 'romantic', 'muse' ); ?> />&nbsp;<?php /* translators: xfn: https://gmpg.org/xfn/ */ _e( 'muse' ); ?>
Note: See TracChangeset for help on using the changeset viewer.