w:bidiVisual (Visually Right-to-Left Table)

Specifies that a table's columns should be displayed in reverse (right-to-left) visual order for right-to-left content.

Parent elements

w:tblPr

Description

w:bidiVisual is a toggle element that reverses the visual column order of a table to support right-to-left reading. When set, the first logical column appears on the right side of the table, and the last column appears on the left.

It is defined in ECMA-376 Part 1 §17.4.1.

w:bidiVisual is different from the document-level bidirectionality setting. It acts specifically on the table’s visual layout and is typically used alongside RTL paragraph properties.

Attributes

Attribute	Type	Possible Values	Description
`w:val`	`ST_OnOff`	`true`, `false`, `1`, `0`, `on`, `off`	Enables or disables the RTL visual table layout. Omitting `w:val` is equivalent to `true`.

Examples

<w:tblPr>
  <w:bidiVisual/>
  <w:tblW w:w="9000" w:type="dxa"/>
</w:tblPr>

using DocumentFormat.OpenXml.Wordprocessing;

var tblPr = new TableProperties(
    new BiDiVisual(),
    new TableWidth { Width = "9000", Type = TableWidthUnitValues.Dxa }
);

Notes

w:bidiVisual affects the visual order of columns only. The logical order of cells in the XML remains unchanged.
Pairs naturally with w:bidi on paragraph properties within the table’s cells.