.ODT File Format – Styles

style:style

A style has a family and a name; the pair must be unique within each of office:styles, office:automatic-styles and office:master-styles. Its children are property elements (style:text-properties, style:paragraph-properties and so on, depending on the family) and style:map conditions.

Families

Finding a property’s value

A reader works out each formatting property for an element like this:

1. Look in the style the element names. If the property is there, use it.
2. Otherwise look in its parent style, then the parent’s parent, until a style with no parent.
3. Then follow the family rule:
   • a text style inside another element with a text style: continue in the nearest enclosing text style and its parents;
   • a text style inside a paragraph: continue in the paragraph’s style and its parents;
   • a paragraph style in a shape or chart: continue in the shape’s graphic, presentation or chart style;
   • a paragraph style in a table cell: continue in the cell style, then as for cells;
   • a cell style: continue with the row’s table:default-cell-style-name, then the column’s.
4. Then the default style (style:default-style) of the family the search began with.
5. Then the default value the specification gives, if any; otherwise the value is up to the program.

style:default-style has only style:family and the same property elements as style:style. A document should contain a default style for every family it uses.

<office:styles>
 <style:default-style style:family="paragraph">
  <style:text-properties fo:font-size="12pt" fo:language="en" fo:country="GB"/>
 </style:default-style>
 <style:style style:name="Standard" style:family="paragraph" style:class="text"/>
 <style:style style:name="Heading_20_1" style:display-name="Heading 1" style:family="paragraph"
   style:parent-style-name="Standard" style:next-style-name="Standard" style:default-outline-level="1">
  <style:text-properties fo:font-size="16pt" fo:font-weight="bold"/>
 </style:style>
</office:styles>

Conditional styles

A style:map inside a style makes it conditional: when its condition is true, the style named by style:apply-style-name is used instead. That style must be a common style of the same kind and family. Paragraph styles in text documents, cell styles in spreadsheets and data styles may be conditional. style:condition is a namespace prefix, a colon and a condition; with no prefix it is OpenFormula. A reader ignores a map whose condition it does not know. style:base-cell-address (an absolute address with table name) is the base for relative addresses in a cell-style condition.

Page layouts and master pages

A page layout (style:page-layout, in automatic styles) holds the page size, margins and so on in style:page-layout-properties, and the header and footer formatting in style:header-style and style:footer-style (each holding style:header-footer-properties). style:default-page-layout has the same children and no attributes. A master page (style:master-page) uses a page layout and holds the header and footer text. Every document must have at least one master page.

Pages are made from master pages as the text flows: each new page is an empty page with the master page’s properties and fixed content, then filled with body text. Headers and footers are part of the page style, unlike XSL, where they belong to the page sequence.

A header or footer holds the same kinds of content as the body: paragraphs, headings, lists, tables, sections, indexes, tracked changes, and variable, sequence, user-field and DDE declarations.

<office:automatic-styles>
 <style:page-layout style:name="pm1">
  <style:page-layout-properties fo:page-width="21cm" fo:page-height="29.7cm"
    style:print-orientation="portrait" fo:margin="2cm"/>
  <style:header-style/>
  <style:footer-style><style:header-footer-properties fo:min-height="0cm"/></style:footer-style>
 </style:page-layout>
</office:automatic-styles>
<office:master-styles>
 <style:master-page style:name="Standard" style:page-layout-name="pm1">
  <style:footer><text:p><text:page-number text:select-page="current"/></text:p></style:footer>
 </style:master-page>
</office:master-styles>

Table templates

A table:table-template (named by table:name) names cell styles by position, for building tables. Each child has table:style-name (a table-cell style) and table:paragraph-style-name (for the empty paragraphs put in new cells). When several apply to a cell, the first in this order wins:

1. table:first-column
2. table:last-column
3. table:first-row
4. table:last-row
5. table:even-rows, table:odd-rows (banded rows)
6. table:even-columns, table:odd-columns (banded columns)
7. table:body (everything else)

table:background names a table style that shows through transparent parts. A table uses a template through table:template-name and the table:use-…-styles switches (see Tables). The old attributes table:first-row-start-column, table:first-row-end-column, table:last-row-start-column and table:last-row-end-column (row or column: whether that corner cell takes the row’s or the column’s style) are deprecated.

Font faces

Fonts are declared in office:font-face-decls, one style:font-face each. A declaration matches a CSS2 @font-face and an SVG font-face. Text properties pick one by name with style:font-name; a font chosen by name is used directly, without CSS font matching.

Children, as in SVG: svg:font-face-src holding svg:font-face-uri (an xlink:href to a font file, with svg:font-face-format and its svg:string) and svg:font-face-name (svg:name, a locally installed font); and svg:definition-src (xlink:href).

Data styles

Data styles say how a number, date, time, Boolean or text value is shown. A cell style or a field names one. A data style may not have two number:text elements in a row, and may have at most one number:fill-character.

Every data style element takes style:name, style:display-name, number:title, style:volatile (true: keep it even if unused; false: it may be discarded), the locale attributes number:language, number:country, number:script and number:rfc-language-tag (an RFC 5646 tag, only when the other three cannot express it), and the digit transliteration attributes number:transliteration-format (a digit one character naming the digit set, default 1; with none, ASCII digits and the other transliteration attributes are ignored), number:transliteration-language, number:transliteration-country and number:transliteration-style (short (default), medium, long; meaning up to the locale and program). Date and currency styles also take number:automatic-order (default false; true: put the parts in the locale’s usual order); date and time styles take number:format-source; time styles take number:truncate-on-overflow.

<number:date-style style:name="N37" number:automatic-order="true">
 <number:day number:style="long"/><number:text>/</number:text>
 <number:month number:style="long"/><number:text>/</number:text>
 <number:year number:style="long"/>
</number:date-style>

List and outline styles

A text:list-style (style:name, style:display-name, text:consecutive-numbering: default false, each level restarts its numbering; true: one count across all levels) holds one level style per level. A level with no level style uses the one for the next lower level, or the program’s default. A list style placed inside a graphic style works as if the graphic style had style:list-style-name pointing to it; its name is not shown to users.

Each level style holds style:list-level-properties (indents and label position, see paragraph formatting) and, for number and bullet levels, style:text-properties.

style:num-format is 1 (1, 2, 3), a (a, b, c), A, i (i, ii, iii), I, another string, or empty (no number). style:num-letter-sync: false counts a…z, aa, bb…zz, aaa; true counts a…z, aa, ab…az, ba. Prefix and suffix are text put before and after the number or bullet; if they contain no letters or digits, prefix + format + suffix forms an XSLT format string.

Typical text:bullet-char values given by the standard: U+2022 • BULLET, U+25CF ● BLACK CIRCLE, U+2714 ✔ HEAVY CHECK MARK, U+2717 ✗ BALLOT X, U+2794 ➔ HEAVY WIDE-HEADED RIGHTWARDS ARROW, U+27A2 ➢ THREE-D TOP-LIGHTED RIGHTWARDS ARROWHEAD. Not every font has them.

The text:outline-style (only style:name) is the list style for all headings whose paragraph style has no list style. It holds text:outline-level-style elements, which take the same attributes and children as text:list-level-style-number.

Notes, line numbering and bibliography settings

Gradients, hatches, images, markers and dashes

Graphic styles name these by draw:name; each also has draw:display-name. They are kept in office:styles; fill images, opacity gradients, markers and dash styles cannot be automatic styles.

Source

OpenDocument Version 1.3, OASIS Standard, 27 April 2021, part 3 (schema), chapter 16 and the style:, number:, text:, draw: and svg: attributes it references in chapter 19; read in full for this page. Presentation page layouts and placeholders (16.43, 16.44) and notes pages (16.19) are described on the ODP pages.