def _get_style_tagname(self, family, is_default=False):
"""Widely match possible tag names given the family (or not).
"""
if family is None:
tagname = '(style:default-style|*[@style:name])'
famattr = None
elif is_default is True:
# Default style
tagname = 'style:default-style'
famattr = family
else:
tagname, famattr = _get_style_tagname(family)
if famattr:
# Include family default style
tagname = '(%s|style:default-style)' % tagname
return tagname, famattr
def odf_create_style(family, name=None, display_name=None, parent=None,
# Where properties apply
area=None,
# For family 'text':
color=None, background_color=None, italic=False, bold=False,
# For family 'paragraph'
master_page=None,
# For family 'master-page'
page_layout=None, next_style=None,
# For family 'table-cell'
data_style=None, border=None, border_top=None, border_right=None,
border_bottom=None, border_left=None, padding=None, padding_top=None,
padding_bottom=None, padding_left=None, padding_right=None, shadow=None,
# For family 'table-row'
height=None, use_optimal_height=None,
# For family 'table-column'
width=None, break_before=None, break_after=None,
# For family 'graphic'
min_height=None,
# For family 'font-face'
font_name=None, font_family=None, font_family_generic=None,
font_pitch=u"variable",
# Every other property
**kw):
"""Create a style of the given family. The name is not mandatory at this
point but will become required when inserting in a document as a common
style.
The display name is the name the user sees in an office application.
The parent is the name of the style this style will inherit from.
To set properties, pass them as keyword arguments. The area properties
apply to is optional and defaults to the family.
Arguments:
family -- 'paragraph', 'text', 'section', 'table', 'table-column',
'table-row', 'table-cell', 'table-page', 'chart',
'drawing-page', 'graphic', 'presentation',
'control', 'ruby', 'list', 'number', 'page-layout'
'font-face', or 'master-page'
name -- unicode
display_name -- unicode
parent -- unicode
area -- str
'text' Properties:
italic -- bool
bold -- bool
'paragraph' Properties:
master_page -- unicode
'master-page' Properties:
page_layout -- unicode
next_style -- unicode
'table-cell' Properties:
border, border_top, border_right, border_bottom, border_left -- str,
e.g. "0.002cm solid #000000" or 'none'
padding, padding_top, padding_right, padding_bottom, padding_left -- str,
e.g. "0.002cm" or 'none'
shadow -- str, e.g. "#808080 0.176cm 0.176cm"
'table-row' Properties:
height -- str, e.g. '5cm'
use_optimal_height -- bool
'table-column' Properties:
width -- str, e.g. '5cm'
break_before -- 'page', 'column' or 'auto'
break_after -- 'page', 'column' or 'auto'
Return: odf_style
"""
tagname, famattr = _get_style_tagname(family)
element = odf_create_element(tagname)
# Common attributes
if name:
element.set_name(name)
if famattr:
element.set_family(famattr)
if display_name:
element.set_display_name(display_name)
if parent:
element.set_parent_style(parent)
# Paragraph
if family == 'paragraph':
if master_page:
element.set_master_page(master_page)
# Master Page
elif family == 'master-page':
if page_layout:
element.set_page_layout(page_layout)
if next_style:
element.set_next_style(next_style)
# Font face
elif family == 'font-face':
element.set_font(font_name, family=font_family,
family_generic=font_family_generic, pitch=font_pitch)
# Properties
if area is None:
area = family
# Text
if area == 'text':
if color:
kw['fo:color'] = color
if background_color:
kw['fo:background-color'] = background_color
if italic:
kw['fo:font-style'] = 'italic'
kw['style:font-style-asian'] = 'italic'
kw['style:font-style-complex'] = 'italic'
if bold:
kw['fo:font-weight'] = 'bold'
kw['style:font-weight-asian'] = 'bold'
kw['style:font-weight-complex'] = 'bold'
# Table cell
elif area == 'table-cell':
if border:
kw['fo:border'] = border
elif border_top or border_right or border_bottom or border_left:
kw['fo:border-top'] = border_top or 'none'
kw['fo:border-right'] = border_right or 'none'
kw['fo:border-bottom'] = border_bottom or 'none'
kw['fo:border-left'] = border_left or 'none'
else: # no border_top, ... neither border are defined
pass # left untouched
if padding:
kw['fo:padding'] = padding
elif padding_top or padding_right or padding_bottom or padding_left:
kw['fo:padding-top'] = padding_top or 'none'
kw['fo:padding-right'] = padding_right or 'none'
kw['fo:padding-bottom'] = padding_bottom or 'none'
kw['fo:padding-left'] = padding_left or 'none'
else: # no border_top, ... neither border are defined
pass # left untouched
if shadow:
kw['style:shadow'] = shadow
if background_color:
kw['fo:background-color'] = background_color
# Table row
elif area == 'table-row':
if height:
kw['style:row-height'] = height
if use_optimal_height is not None:
kw['style:use-optimal-row-height'] = Boolean.encode(
use_optimal_height)
if background_color:
kw['fo:background-color'] = background_color
# Table column
elif area == 'table-column':
if width:
kw['style:column-width'] = width
if break_before:
kw['fo:break-before'] = break_before
if break_after:
kw['fo:break-after'] = break_after
# Graphic
elif area == 'graphic':
if min_height:
kw['fo:min-height'] = min_height
# Every other properties
if kw:
element.set_properties(kw, area=area)
return element
