當(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"', ' <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。





點(diǎn)錯(cuò)了,怎么刪除掉
我們來刪除,不過也不用刪除了,留著吧