[Table of Contents] [docx version]
WordprocessingML Reference Material - Table of Contents
eastAsianLayout (East Asian Typography Settings)
This element specifies any East Asian typography settings which shall be applied to the contents of the run.
The specific typography settings represented by this element include the two lines in one and horizontal in vertical text options.
The two lines in one setting specifies that the characters in this run should be written out on a single line in the document by creating two sub-lines within the regular line, and laying out this text equally between those sub lines.
[Example: Consider a paragraph with the text two lines in one, which shall be displayed within a single logical line in the document. This constraint would be specified as follows in the WordprocessingML:
<w:r>
<w:rPr>
<w:eastAsianLayout w:id="1" w:combine="on" />
</w:rPr>
</w:r>
The resulting text would be displayed on two sub lines within the other text on this line, like this:
end example]
The horizontal in vertical setting specifies that characters in this run should be rendered with a 90 degree rotation to the left from all other contents of the line when displayed in the document, while keeping the text on the same line as all other text in the paragraph.
[Example: Consider a paragraph with the text this word is vertical, of which the word vertical shall be displayed vertically within the document. This constraint would be specified as follows in the WordprocessingML:
<w:r>
<w:rPr>
<w:eastAsianLayout w:id="2" w:vert="on" />
</w:rPr>
</w:r>
The resulting text would be displayed with a 90 degree rotation from the other text content. end example]
Parent Elements |
rPr (§2.7.8.1); rPr (§2.3.1.29); rPr (§2.5.2.26); rPr (§2.3.2.25); rPr (§2.3.2.26); rPr (§2.7.4.4); rPr (§2.3.1.30); rPr (§2.9.26); rPr (§2.5.2.27); rPr (§2.7.5.2) |
Attributes |
Description |
combine (Two Lines in One) |
Specifies whether the contents of the current run should be combined into one line using the two lines in one logic described above in the parent element.
If this attribute is omitted, then this run shall not be displayed on two sub lines.
[Example: Consider a paragraph with the text two lines in one, which shall be displayed within a single logical line in the document. This constraint would be specified as follows in the WordprocessingML:
<w:r> <w:rPr> <w:eastAsianLayout w:id="1" w:combine="on" /> </w:rPr> </w:r>
The resulting text would be displayed on two sub lines within the other text on this line. end example]
The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
combineBrackets (Display Brackets Around Two Lines in One) |
Specifies that the two lines in one text should be enclosed within a pair of brackets when displayed. This attribute's values determine the bracket style to put around combined text.
If this attribute is not specified, then no brackets shall be placed around this content when displayed in the document. If the combine attribute is not specified, then this attribute is ignored.
[Example: Consider a paragraph with the text two lines in one, which shall be displayed within a single logical line in the document and enclosed in curly brackets. This constraint would be specified as follows in the WordprocessingML:
<w:r> <w:rPr> <w:eastAsianLayout w:id="1" w:combine="on" w:combineBrackets="curly"/> </w:rPr> </w:r>
The resulting text would be displayed on two sub lines within the other text on this line and enclosed within curly brackets when displayed. end example]
The possible values for this attribute are defined by the ST_CombineBrackets simple type (§2.18.13). |
Specifies a unique ID which shall b used to link multiple runs containing eastAsianLayout element to each other to ensure that their contents are correctly displayed in the document.
This means that multiple runs which are broken apart due to differences in formatting can be identified as belonging to the same grouping in terms of eastAsianLayout properties, although they are separated into multiple runs of text.
[Example: Consider the following three runs in a document:
<w:r> <w:rPr> <w:asianLayout w:id="-1552701694" w:combine="lines" w:combineBrackets="curly" /> </w:rPr> </w:r> <w:r> <w:rPr> <w:u w:val="single" w:color="4F81BD" w:themeColor="accent1" /> <w:asianLayout w:id="-1552701694" w:combine="lines" w:combineBrackets="curly" /> </w:rPr> </w:r> <w:r> <w:rPr> <w:asianLayout w:id="-1552701694" w:combine="lines" w:combineBrackets="curly" /> </w:rPr> </w:r>
Although there are three runs of content, all three regions shall be combined into a single two lines in one region based on the identical value used in the id attribute for all three runs. end example]
The possible values for this attribute are defined by the ST_DecimalNumber simple type (§2.18.16). | |
vert (Horizontal in Vertical (Rotate Text)) |
Specifies that characters in this run should be rendered with a 270 degree rotation to the left from all other contents of the line when displayed in the document as described above.
If this attribute is omitted, then the contents of this run shall not be rotated with respect to the normal text flow.
[Example: Consider a paragraph with the text this word is vertical, of which the word vertical shall be displayed vertically within the document. This constraint would be specified as follows in the WordprocessingML:
<w:r> <w:rPr> <w:eastAsianLayout w:id="2" w:vert="on" /> </w:rPr> </w:r>
The resulting text would be displayed with a 270 degree rotation from the other text content. end example]
The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
vertCompress (Compress Rotated Text to Line Height) |
Specifies whether the rotated text shall be compressed at display time in order to ensure that it fits into the existing line height without increasing the overall height of the line.
If the vert attribute is not specified, then this attribute is ignored. If this attribute is omitted, then text shall not be compressed in order to fit into the existing height of the line when it is rotated.
[Example: Consider a paragraph with the text this word is vertical, of which the word vertical shall be displayed vertically within the document but shall not change the height of the line. This constraint would be specified as follows in the WordprocessingML:
<w:r> <w:rPr> <w:eastAsianLayout w:id="2" w:vert="true" vertCompress="true" /> </w:rPr> </w:r>
The resulting text would be compressed in order to fit the height of the line as defined by all non-compressed characters. end example]
The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_EastAsianLayout">
<attribute name="id" type="ST_DecimalNumber" use="optional"/>
<attribute name="combine" type="ST_OnOff" use="optional"/>
<attribute name="combineBrackets" type="ST_CombineBrackets" use="optional"/>
<attribute name="vert" type="ST_OnOff" use="optional"/>
<attribute name="vertCompress" type="ST_OnOff" use="optional"/>
</complexType>