WordPress 6.1 新增必填字段相关函数和钩子

当表单包含多个必填字段时,它们的标签可能带有一个带有图例的星号,以说明这些字段是必填的。为了减少代码重复并帮助维护全局一致的标记,WordPress 有两个新函数:wp_required_field_indicator()wp_required_field_message()。如果主题和插件至少需要 WordPress 6.1,它们也可以使用这些函数。

必填字段的标签使用wp_required_field_indicator()函数,它给出了包含必填星号的span标签添加了“required”类名。翻译人员现在可以用他们语言中更合适的字形替换星号。

对于图例(legend),还使用wp_required_field_message()在包裹“Required fields are marked *”的span元素添加一个“required-field-message”类名 。该符号与wp_required_field_indicator()函数生成的标记相匹配。

在 WordPress 5.9 和 6.0 中,屏幕阅读器不会阅读评论表单的星号或必填字段消息文本,因为它们是视觉提示。在 6.1 中,修订版恢复了这些项目,因此看到文本的屏幕阅读器用户也能听到它。

过滤标记

这两个函数都有用于编辑其输出的钩子,并且过滤器名称与相关函数匹配。

指示符示例

如果语言保留单个星号,使用过滤器可以添加更多星号:

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

消息示例

将消息中指示符之前的空格替换为不间断空格,以便符号不会换行到下一行,与消息的其余部分分开。

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

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 lk2768783601@gmail.com 举报,一经查实,本站将立刻删除。

(0)
上一篇 2023年9月4日 下午4:05
下一篇 2023年9月5日 下午2:20

相关推荐

  • 17个超实用 WordPress SEO 初学者技巧

    如果您正在为初学者寻找终极 WordPress SEO 指南,那么您来对地方了。我们的 WordPress SEO 教程将重点介绍 SEO 的所有基本方面以及如何根据本指南优化您的网站。 顶级博主不仅具有出色的写作技巧,而且还对他们在搜索引擎中的内容表现负责。 想象一下,您写了一篇很棒的博客,如果人们无法阅读它,它的价值何在。并将其提供给合适的受众,SEO …

    2023年8月29日
    2030
  • WordPress入门 之 鲜为人知的后台“小私密”

    文本是《WordPress 入门教程(共19篇)》专题的第 6 篇。阅读本文前,建议先阅读前面的文章: WordPress后台的UI和布局是比较优秀的,对于某些粗心的WordPress新手而言,是很容易忽视掉一些WordPress后台的“小私密”的,今天,倡萌就带领大家一起来“窥视”一下,记住不要大声喧哗,一般人我不告诉他滴! 私密1:伸展自如的“左侧导航菜…

    2023年8月29日
    1710
  • WordPress可以搭建哪些类型的网站

    文本是《WordPress 入门教程(共19篇)》专题的第 13 篇。阅读本文前,建议先阅读前面的文章: 国内很多人可能还没有听说过WordPress,或者听说过,但是不清楚现在的WordPress到底可以用来做哪些类型的网站。今天倡萌就来和大家简单说一下,现在的WordPress到底可以用来制作哪些类型的网站,在此之前,可以给大家一个明确的回答:WordP…

    2023年8月29日
    1770
  • WordPress 插件开发教程 Part 2 – WordPress 插件基础

    文本是《WordPress 插件开发教程(共4篇)》专题的第 2 篇。阅读本文前,建议先阅读前面的文章: 1.WordPress 插件开发教程 Part 1 – WordPress 插件简介 本部分教程包括以下内容: 创建一个可靠的插件基础 确定目录和文件的路径 使用“启用”( Active )和“停用”( Deactivate )功能 了解可用的插件的卸载…

    wordpress 2023年9月5日
    2210
  • WordPress入门 之 如何安装WordPress

    文本是《WordPress 入门教程(共19篇)》专题的第 3 篇。阅读本文前,建议先阅读前面的文章: 下面接着更新该系列的文章,今天主要演示一下如何安装WordPress,如果你已经掌握了,就看看其他文章吧。不会的朋友,一起来看看吧。 安装前的准备 1.下载最新版的 WordPress (这里演示为WordPress 3.5 官方中文版),解压后,将Wor…

    2023年8月29日
    1530
关注微信