Typography

hyphens

Control language-dependent and manual hyphenation opportunities.

Overview

ClassDeclarations
hyphens:nonehyphens: none;
hyphens:manualhyphens: manual;
hyphens:autohyphens: auto;

Examples

Allow automatic hyphenation

hyphens:auto permits dictionary-based hyphenation. Set the content language with lang; actual hyphenation depends on the browser’s available language data.

Allow automatic hyphenation
Automatic hyphenation depends on the declared language and the browser’s dictionaries. Manual soft hyphens provide explicit opportunities.
<!-- hyphens:none --><div id="scrollport" role="region" aria-label="Automatic hyphenation" tabindex="0" class="overflow:auto w:128px max-w:100%">  <p id="target" lang="en" class="w:128px m:0 font-md leading:24px hyphens:none">Antidisestablishmentarianism</p></div>
<!-- hyphens:auto --><div id="scrollport" role="region" aria-label="Automatic hyphenation" tabindex="0" class="overflow:auto w:128px max-w:100%">  <p id="target" lang="en" class="w:128px m:0 font-md leading:24px hyphens:auto">Antidisestablishmentarianism</p></div>
Generated CSS
@layer utilities {  .hyphens\:auto {    hyphens: auto  }}

A browser without a suitable dictionary may leave the word unbroken. The specimen does not insert fake hyphens.

Respect manual hyphenation points

hyphens:manual permits a break at an authored soft hyphen. &shy; is invisible when no break is needed and supplies a hyphen when the line breaks there.

Respect manual hyphenation points
Automatic hyphenation depends on the declared language and the browser’s dictionaries. Manual soft hyphens provide explicit opportunities.
<!-- Narrow · soft hyphen used --><p id="target" class="w:100px m:0 font-md leading:24px hyphens:manual">trans&shy;formation</p>
<!-- Wide · soft hyphen hidden --><p id="target" class="w:220px max-w:100% m:0 font-md leading:24px hyphens:manual">trans&shy;formation</p>

Disable hyphenation

hyphens:none suppresses both automatic and soft-hyphen opportunities. Compare the same authored word at the same width; other break opportunities, such as spaces, still work.

Disable hyphenation
Automatic hyphenation depends on the declared language and the browser’s dictionaries. Manual soft hyphens provide explicit opportunities.
<!-- hyphens:manual --><div id="scrollport" role="region" aria-label="Manual hyphenation comparison" tabindex="0" class="overflow:auto w:100px max-w:100%">  <p id="target" class="w:100px m:0 font-md leading:24px hyphens:manual">trans&shy;formation</p></div>
<!-- hyphens:none --><div id="scrollport" role="region" aria-label="Manual hyphenation comparison" tabindex="0" class="overflow:auto w:100px max-w:100%">  <p id="target" class="w:100px m:0 font-md leading:24px hyphens:none">trans&shy;formation</p></div>

Apply conditionally

Resize this fluid column from 80px toward 100px. It starts with an explicit soft-hyphen opportunity. At sm on screen, and in print, hyphenation is disabled; the whole word still exceeds the column width and can be scrolled.

Apply conditionally
hyphens: Apply conditionally controls
Automatic hyphenation depends on the declared language and the browser’s dictionaries. Manual soft hyphens provide explicit opportunities.
<!-- Fluid column · native hyphenation reset --><div id="scrollport" role="region" aria-label="Responsive hyphenation" tabindex="0" class="overflow:auto w:clamp(80px,10vw,100px) max-w:100%">  <p id="target" class="w:100% m:0 font-md leading:24px hyphens:manual hyphens:none@print hyphens:none@screen@sm">trans&shy;formation</p></div>


© 2026 Aoyue Design LLC.MIT License
Trademark Policy