ai css font-variant-east-asian 2026-08-19

By Xah Lee. Date: .
work in progress
normal/jis78: 麹町 麹町
normal/ruby: しんかんせん しんかんせん
normal/traditional: 大学 tttttt 大学 school

tt (大学)

work in progress

ai css font-variant-east-asian

explain font-variant-east-asian

ai answer

2026-08-19 doesnt work. to make it work, you need font-family: "Yu Gothic", fantasy; but it only works on the char 学, not 门. seems depends on font.

洞门外有个东土来的孙悟空和尚,要见奶奶 (大学)

洞门外有个东土来的孙悟空和尚,要见奶奶 (大学)

font-variant-east-asian is a CSS property that controls the use of alternate glyphs (character shapes) for East Asian scripts such as Japanese, Chinese, and related writing systems.

It lets you influence which variant forms of characters the font should use when multiple options exist (e.g., different historical standards, simplified vs. traditional Chinese forms, or full-width vs. proportional-width characters). The browser maps these values to corresponding OpenType font features when the selected font supports them.

Syntax

font-variant-east-asian: normal | [ <east-asian-variant-values> || <east-asian-width-values> || ruby ];

You can combine the non-normal values in any order (space-separated).

Values

Value Description OpenType feature
normal Default. Disables the special East Asian glyph variants controlled by this property.
ruby Forces special glyphs designed for ruby (furigana/annotation) text. These are usually smaller and often slightly bolder for better contrast. ruby
East Asian variant values Select logographic (ideographic) glyph variants
jis78 Uses forms from the JIS X 0208:1978 standard jp78
jis83 Uses forms from the JIS X 0208:1983 standard jp83
jis90 Uses forms from the JIS X 0208:1990 standard jp90
jis04 Uses forms from the JIS X 0213:2004 standard jp04
simplified Prefers simplified Chinese glyphs smpl
traditional Prefers traditional Chinese glyphs trad
East Asian width values Control character width metrics
proportional-width Uses proportional-width (variable-width) East Asian characters pwid
full-width Uses full-width (roughly square, fixed-width) East Asian characters fwid

Key characteristics

Practical notes

Example

.japanese-text {
  font-variant-east-asian: jis90 proportional-width;
}

.chinese-traditional {
  font-variant-east-asian: traditional;
}

.ruby-annotation {
  font-variant-east-asian: ruby;
}

In short, font-variant-east-asian gives fine-grained control over typographic conventions specific to East Asian writing systems without needing low-level OpenType feature tags.

work in progress

which font, supports, Chinese traditional, and simplified for the CSS property font variant east Asian

ai answer

Fonts that work well with font-variant-east-asian: traditional / simplified (OpenType features trad / smpl) are limited, especially for full Chinese support.

Key facts about the CSS property

Practical recommendations

Font / Family Supports both Traditional + Simplified Chinese? Supports trad / smpl via font-variant-east-asian? Notes / Best use
Source Han Sans / Noto Sans CJK (and Source Han Serif / Noto Serif CJK) Yes (excellent Pan-CJK coverage) Limited / primarily via locl + language tags Best overall choice. Use language-specific versions (SC / TC / JP / KR) or the Super OTC. Control variants with lang="zh-Hans" / lang="zh-Hant" rather than relying only on the CSS property.
Yu Gothic / Yu Mincho (system fonts on Windows/macOS) Partial (mainly Japanese-focused, with some Chinese glyphs) Yes for trad (and some related features); smpl weaker The font MDN examples use. Works for demonstration of traditional (and Japanese JIS variants). Not ideal as a primary Chinese font.
PingFang SC / TC, Microsoft YaHei / JhengHei, Hiragino, etc. Yes when you pick the correct regional version Usually no (or very limited) Use the SC or TC variant of the font + lang attribute. Do not expect the CSS property alone to switch forms.
Most other single-region CJK fonts No (only one orthography) Rarely Avoid for dual Traditional/Simplified needs.

Recommended approach

  1. Prefer language-specific fonts + lang attribute (most reliable):

    :lang(zh-Hans) {
      font-family: "Noto Sans SC", "Source Han Sans SC", "PingFang SC", sans-serif;
    }
    :lang(zh-Hant) {
      font-family: "Noto Sans TC", "Source Han Sans TC", "PingFang TC", sans-serif;
    }
  2. If you specifically need the CSS property (font-variant-east-asian: traditional or simplified):

    • Try Yu Gothic / Yu Mincho (or other high-quality Japanese system fonts that implement trad).
    • For Pan-CJK coverage, use Source Han Sans / Noto Sans CJK (Super OTC or language-specific OTFs) and test whether trad/smpl respond in your target browsers. Many deployments rely more on the locl feature activated by the lang attribute.
  3. Testing tip: Always verify in the target browsers/OS because support for the OpenType features is font-dependent and not universal. The property itself has good browser support (Chrome 63+, Firefox 34+, Safari 9.1+), but the glyphs must exist in the font.

Bottom line:
For reliable support of both Traditional and Simplified Chinese, use the Source Han / Noto CJK family (language-specific or Super OTC versions) and control the orthography with the HTML lang attribute. Relying solely on font-variant-east-asian: traditional/simplified works only with fonts that explicitly implement the trad/smpl features (Yu Gothic is one of the few commonly available examples that does so for at least the traditional side).