Wordprocessing Tables
Cell-level properties are specified in <tcPr>. Each property is a child element of <tcPr>, and the cell properties take precedence over table and row properties.
The most commonly used properties are shown below:
Elements/Properties:
Element | Description | |
---|---|---|
gridSpan | This element defines the number of logical columns across which the cell spans. It has a single attribute w:val. See the discussion of <w:tblGrid>
at Table Grid/Column Definition.
Reference: ECMA-376, 3rd Edition (June, 2011), Fundamentals and Markup Language Reference § 17.4.17.
|
|
hideMark | See Hide End of Table Cell Mark.
Reference: ECMA-376, 3rd Edition (June, 2011), Fundamentals and Markup Language Reference § 17.4.21.
|
|
noWrap | This element will prevent text from wrapping in the cell under certain conditions. It is a boolean property. E.g., <w:noWrap/>.
Note: This only affects the behavior of the cell when the tblLayout for the row is set to auto. If the cell width is fixed, then noWrap specifies that the cell will not be smaller than that fixed value when other cells in the row are not at their minimum. If the cell width is set to auto or pct, then the content of the cell will not wrap. Reference: ECMA-376, 3rd Edition (June, 2011), Fundamentals and Markup Language Reference § 17.4.30.
|
|
shd | See Table Cell Properties - Shading.
Reference: ECMA-376, 3rd Edition (June, 2011), Fundamentals and Markup Language Reference § 17.4.33.
|
|
tcBorders | See Table Cell Properties - Borders.
Reference: ECMA-376, 3rd Edition (June, 2011), Fundamentals and Markup Language Reference § 17.4.67.
|
|
tcFitText | Text within a cell can be contracted or expanded to fit the width of the cell using the <w:tcFitText w:val="true"/>. It has a single attribute val with boolean values of true/false.
Reference: ECMA-376, 3rd Edition (June, 2011), Fundamentals and Markup Language Reference § 17.4.68.
|
|
tcMar | See Table Cell Properties - Margins.
Reference: ECMA-376, 3rd Edition (June, 2011), Fundamentals and Markup Language Reference § 17.4.69.
|
|
tcW | See Table Cell Properties - Width.
Reference: ECMA-376, 3rd Edition (June, 2011), Fundamentals and Markup Language Reference § 17.4.72.
|
|
vAlign | See Table Cell Properties - Vertical Alignment.
Reference: ECMA-376, 3rd Edition (June, 2011), Fundamentals and Markup Language Reference § 17.4.84.
|
|
vMerge | This element specifies that the cell is part of a vertically merged set of cells. defines the number of logical columns across which the cell spans. It has a single attribute w:val which specifies how the cell is part of a vertically merged region. The cell can be part of an existing group of merged cells or it can start a new group of merged cells. Possible values are:
If omitted, the value is assumed to be continue. See the discussion of <w:tblGrid> at Table Grid/Column Definition. Reference: ECMA-376, 3rd Edition (June, 2011), Fundamentals and Markup Language Reference § 17.4.85.
|
Related Open Document Format (ODF) Property:
Table cell properties are specified in the <style:table-cell-properties> element.
The <style:table-cell-properties> element can have the following attributes:
Attributes | Description |
---|---|
fo:background-color | Specifies a color for the background of the cell. |
fo:border, fo:border-bottom, fo:border-left, fo:border-right, fo:border-top | Specifies a border for the cell. |
fo:padding, fo:padding-bottom, fo:padding-left, fo:padding-right, fo:padding-top | Specifies padding for the cell. |
fo:wrap-option | Specifies whether text is to be wrapped. Possible values are no-wrap and wrap. |
style:border-line-width, style:border-line-width-bottom, style:border-line-width-left, style:border-line-width-right, style:border-line-width-top | Specifies the width of borders where the border property is double. The value is a list of three white space-separated lengths. Thie first value specifies the width of the inner line, the second specifies the distance between the two lines, and the third specifies the width of the outer line. |
style:cell-protect | Specifies how a cell is protected. Possible values are hidden-and-protected, none, protected and formula-hidden. |
style:shadow | Specifies a shadow effect for the cell. |
style:vertical-align | Specifies the vertical alignment of text. Possible values are automatic, bottom, middle, and top. |
style:writing-mode | Specifies how the content should be written. Possible values are lr-tb, rl-tb, tb-rl, tb-lr, lr, rl, tb, and page. |
Note that <style:table-cell-properties> can also contain a <style:background-image> element.