wordBreak property

[This documentation is preliminary and is subject to change.]

Sets or retrieves line-breaking behavior within words, particularly where multiple languages appear in the object.

CSS Text Level 3, Section 5.2


Integer value = object.put_wordBreak(BSTR v);Integer value = object.get_wordBreak(BSTR* sBreak);

Property values

Type: BSTR

normal (normal)

Default. Allows line breaking within words.

break-all (break-all)

Behaves as normal for CJK text, yet allows the line to break arbitrarily for non-CJK text. This value is suited to CJK text that contains small amounts of non-CJK text.

keep-all (keep-all)

Behaves as normal for non-CJK text, but disallows word breaking for CJK text. This value is suited to non-CJK text that includes small amounts of CJK text.

String format

normal | break-all | keep-all

CSS information

Applies To All elements
Media visual
Inherited 1
Initial Value

Standards information


Windows Internet Explorer 8. The -ms-word-break attribute is an extension to CSS, and can be used as a synonym for word-break in IE8 Standards mode.

When using the -ms-word-break attribute with a table, you must set the table-layout attribute to fixed on the table.

The behaviors of the parameter values are detailed in CSS Text Level 3: W3C Working Draft (6 March 2007), sec. 4.1, "Line Breaking Restrictions: The 'word-break' Property"; and in Unicode Standard Annex #14: Line Breaking Properties.


Minimum supported client

Windows XP

Minimum supported server

Windows Server 2003






Build date: 1/23/2012