Ticket #25459: 25459-functions.patch

src/wp-includes/functions.php

@@ -4206 +4206 @@
 function reset_mbstring_encoding() {
         mbstring_binary_safe_encoding( true );
 }
+
+/**
+ * Returns two versions of a string, one for sighted users and one for screen reader users.
+ * Typically used in situations where design requires a short link that may not provide enough
+ * context for a screen reader user.
+ *
+ * @param string $shortform The short version of the text for for sighted users
+ * @param string $longform The long version of the text for screen readers
+ * @param string $classname The CSS class to put on the span for screen reader text. Defaults to 'screen-reader-text'.
+ *
+ * @return string
+ *
+ * @since
+ */
+function get_a11y_short_long( $shortform, $longform, $classname = 'screen-reader-text' ) {
+   return '<span aria-hidden="true">' . $shortform . '</span><span class="' . $classname . '"> ' . $longform . '</span>';
+}
+
+/**
+ * Echos two versions of a string, one for sighted users and one for screen reader users.
+ * Typically used in situations where design requires a short link, but that link may not
+ * provide enough context for a screen reader user.
+ *
+ * @param string $shortform The short version of the text for for sighted users
+ * @param string $longform The long version of the text for screen readers
+ * @param string $classname The CSS class to put on the span for screen reader text. Defaults to 'screen-reader-text'.
+ *
+ * @see get_a11y_short_long()
+ *
+ * @since
+ */
+function a11y_short_long( $shortform, $longform, $classname = 'screen-reader-text' ) {
+   echo get_a11y_short_long( $shortform, $longform, $classname);
+}
+ No newline at end of file