useHtmlLang

JSX and TSX

摘要

¥Summary

规则生效日期：v1.0.0

¥Rule available since: v1.0.0
诊断类别：lint/a11y/useHtmlLang

¥Diagnostic Category: lint/a11y/useHtmlLang
此规则为推荐规则，默认启用。

¥This rule is recommended, which means is enabled by default.
此规则没有修复方案。

¥This rule doesn’t have a fix.
此规则的默认严重级别为 error。

¥The default severity of this rule is error.
来源：

¥Sources:
- 与 jsx-a11y/html-has-lang 相同
  
  ¥Same as jsx-a11y/html-has-lang

如何配置

¥How to configure

1
{
2
  "linter": {
3
    "rules": {
4
      "a11y": {
5
        "useHtmlLang": "error"
6
      }
7
    }
8
  }
9
}

描述

¥Description

强制 ARIA 状态和属性值有效。

¥Enforce that html element has lang attribute.

示例

¥Examples

无效

¥Invalid

1
<html></html>

code-block.jsx:1:1 lint/a11y/useHtmlLang ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✖ Provide a lang attribute when using the html element.
  
  > 1 │ <html></html>
      │ ^^^^^^
    2 │ 
  
  ℹ Setting a lang attribute on HTML document elements configures the languageused by screen readers when no user default is specified.

1
<html lang={""}></html>

code-block.jsx:1:1 lint/a11y/useHtmlLang ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✖ Provide a lang attribute when using the html element.
  
  > 1 │ <html lang={""}></html>
      │ ^^^^^^^^^^^^^^^^
    2 │ 
  
  ℹ Setting a lang attribute on HTML document elements configures the languageused by screen readers when no user default is specified.

1
<html lang={null}></html>

code-block.jsx:1:1 lint/a11y/useHtmlLang ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✖ Provide a lang attribute when using the html element.
  
  > 1 │ <html lang={null}></html>
      │ ^^^^^^^^^^^^^^^^^^
    2 │ 
  
  ℹ Setting a lang attribute on HTML document elements configures the languageused by screen readers when no user default is specified.

1
<html lang={undefined}></html>

code-block.jsx:1:1 lint/a11y/useHtmlLang ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✖ Provide a lang attribute when using the html element.
  
  > 1 │ <html lang={undefined}></html>
      │ ^^^^^^^^^^^^^^^^^^^^^^^
    2 │ 
  
  ℹ Setting a lang attribute on HTML document elements configures the languageused by screen readers when no user default is specified.

1
<html lang={true}></html>

code-block.jsx:1:1 lint/a11y/useHtmlLang ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✖ Provide a lang attribute when using the html element.
  
  > 1 │ <html lang={true}></html>
      │ ^^^^^^^^^^^^^^^^^^
    2 │ 
  
  ℹ Setting a lang attribute on HTML document elements configures the languageused by screen readers when no user default is specified.

有效

¥Valid

1
<html lang="en"></html>

1
<html lang={language}></html>

1
<html {...props}></html>

1
<html lang={""} {...props}></html>

可访问性指南

¥Accessibility guidelines

WCAG 3.1.1

useHtmlLang

摘要

如何配置

描述

示例

无效

有效

可访问性指南

相关链接