WordPress 6.1 新增必填字段相關(guān)函數(shù)和鉤子

當(dāng)表單包含多個(gè)必填字段時(shí)，它們的標(biāo)簽可能帶有一個(gè)帶有圖例的星號(hào)，以說明這些字段是必填的。為了減少代碼重復(fù)并幫助維護(hù)全局一致的標(biāo)記，WordPress 有兩個(gè)新函數(shù)：wp_required_field_indicator()和wp_required_field_message()。如果主題和插件至少需要 WordPress 6.1，它們也可以使用這些函數(shù)。

必填字段的標(biāo)簽使用wp_required_field_indicator()函數(shù)，它給出了包含必填星號(hào)的span標(biāo)簽添加了“required”類名。翻譯人員現(xiàn)在可以用他們語言中更合適的字形替換星號(hào)。

對(duì)于圖例（legend），還使用wp_required_field_message()在包裹“Required fields are marked *”的span元素添加一個(gè)“required-field-message”類名 。該符號(hào)與wp_required_field_indicator()函數(shù)生成的標(biāo)記相匹配。

在 WordPress 5.9 和 6.0 中，屏幕閱讀器不會(huì)閱讀評(píng)論表單的星號(hào)或必填字段消息文本，因?yàn)樗鼈兪且曈X提示。在 6.1 中，修訂版恢復(fù)了這些項(xiàng)目，因此看到文本的屏幕閱讀器用戶也能聽到它。

過濾標(biāo)記

這兩個(gè)函數(shù)都有用于編輯其輸出的鉤子，并且過濾器名稱與相關(guān)函數(shù)匹配。

指示符示例

如果語言保留單個(gè)星號(hào)，使用過濾器可以添加更多星號(hào)：

function wpdocs_replace_single_asterisk_in_default_indicator( $indicator ) {
    $indicator = str_replace( '>*</', '>***</', $indicator );
    return $indicator;
}
add_filter( 'wp_required_field_indicator', 'wpdocs_replace_single_asterisk_in_default_indicator', 10, 1 );

消息示例

將消息中指示符之前的空格替換為不間斷空格，以便符號(hào)不會(huì)換行到下一行，與消息的其余部分分開。

function wpdocs_use_nonbreaking_space_in_required_fields_message( $message ) {
    $message = str_replace( ' <span class="required"', '&nbsp;<span class="required"', $message );
    return $message;
}
add_filter( 'wp_required_field_message', 'wpdocs_use_nonbreaking_space_in_required_fields_message', 10, 1 );

有關(guān)更多信息，請(qǐng)查看工單#54394、#56389和#55717。