diff --git a/index.html b/index.html index a472723df..88f9614e2 100644 --- a/index.html +++ b/index.html @@ -12070,6 +12070,20 @@

Translatable Attributes

  • aria-rowindextext
  • aria-valuetext
    • +

    + The web platform does not provide a mechanism to specify language and directionality for a translatable attribute separate from the language and directionality of its containing element. This includes aria-labelledby and aria-describedby because the Accessible Name and Description Computation [[ACCNAME-1.2]] results in a flat string. +

    +

    + It is best practice for authors to ensure that the language and directionality of the value of a translatable attribute matches the language and directionality of its containing element. +

    +

    + Where language or direction metadata for the translatable attribute value needs to differ from that of its containing element, authors can use a referencing attribute, such as aria-labelledby, aria-describedby, or aria-details, pointing to an element, on which language and direction attributes can be expressed directly. This allows translation of these values when the user agent is presenting the document in a machine-translated rendering, via a built-in "Translate this page" feature, as well as appropriate rendering when the element's contents are rendered visually. + + Authors are encouraged to avoid using plain text ARIA attribute values for text alternatives that contain inline language/direction changes or other text-level markup. +

    +

    + For more details, see Internationalization best practices for web developers. +

    Global States and Properties