介绍
样式用于控制表格内容在屏幕上显示时的外观。它们还用于确定数字的格式。
样式可以应用于以下方面：
- 字体设置字体大小、颜色、下划线等。
- 填充以设置图案或颜色渐变
- border在单元格上设置边框
- 单元格对齐
- 保护
以下是默认值
from openpyxl.styles import PatternFill, Border, Side, Alignment, Protection, Font
font = Font(name='Calibri',
... size=11,
... bold=False,
... italic=False,
... vertAlign=None,
... underline='none',
... strike=False,
... color='FF000000')
fill = PatternFill(fill_type=None,
... start_color='FFFFFFFF',
... end_color='FF000000')
border = Border(left=Side(border_style=None,
... color='FF000000'),
... right=Side(border_style=None,
... color='FF000000'),
... top=Side(border_style=None,
... color='FF000000'),
... bottom=Side(border_style=None,
... color='FF000000'),
... diagonal=Side(border_style=None,
... color='FF000000'),
... diagonal_direction=0,
... outline=Side(border_style=None,
... color='FF000000'),
... vertical=Side(border_style=None,
... color='FF000000'),
... horizontal=Side(border_style=None,
... color='FF000000')
... )
alignment=Alignment(horizontal='general',
... vertical='bottom',
... text_rotation=0,
... wrap_text=False,
... shrink_to_fit=False,
... indent=0)
number_format = 'General'
protection = Protection(locked=True,
... hidden=False)
单元格样式和命名样式
有两种类型的样式：单元样式和命名样式，以及样式模板。
单元格样式
单元格样式在对象之间共享。在分配样式后，单元格样式对象属性无法更改。这样可以避免不必要的副作用，例如当只有一个单元格发生更改时，更改许多单元格的样式。
from openpyxl.styles import colors
from openpyxl.styles import Font, Color
from openpyxl import Workbook
wb = Workbook()
ws = wb.active
a1 = ws['A1']
d4 = ws['D4']
ft = Font(color=colors.RED)
a1.font = ft
d4.font = ft
a1.font.italic = True # is not allowed
# If you want to change the color of a Font, you need to reassign it::
a1.font = Font(color=colors.RED, italic=True) # the change only affects A1
复制样式
也可以复制样式
from openpyxl.styles import Font
from copy import copy
ft1 = Font(name='Arial', size=14)
ft2 = copy(ft1)
ft2.name = "Tahoma"
ft1.name
'Arial'
ft2.name
'Tahoma'
ft2.size # copied from the
14.0
颜色
字体、背景、边框等颜色可以通过三种方式设置：索引、aRGB或主题。索引颜色本身取决于工作簿或应用程序默认提供的索引。主题颜色对于颜色的互补色调很有用，但也取决于工作簿中的主题。因此，建议使用aRGB颜色。
aRGB颜色
RGB颜色使用十六进制值的代表红、绿、蓝三种颜色的数值来设置。
>>> from openpyxl.styles import Font
>>> font = Font(color="FF0000")
a值理论上指的是颜色的透明度，但这与单元格样式无关。默认值00将附加到RGB值前。
>>> from openpyxl.styles import Font
>>> font = Font(color="00FF00")
>>> font.color.rgb
'0000FF00'
openpyxl还支持传统索引颜色以及主题和色调。
>>> from openpyxl.styles.colors import Color
>>> c = Color(indexed=32)
>>> c = Color(theme=6, tint=0.5)
索引颜色
[图片上传失败...(image-c2248d-1594479011533)]索引64和65不能设置，分别为系统前景和背景色保留。
应用样式
样式直接应用于单元格
from openpyxl.workbook import Workbook
from openpyxl.styles import Font, Fill
wb = Workbook()
ws = wb.active
c = ws['A1']
c.font = Font(size=12)
样式也可以应用于列和行。但请注意，此项仅适用于在Excel中创建单元格后保存关闭的文件。如果要将样式应用于整行和整列，则必须自己将样式应用于每个单元格。这是对文件格式的限制：
col = ws.column_dimensions['A']
col.font = Font(bold=True)
row = ws.row_dimensions[1]
row.font = Font(underline="single")
设置合并单元格的样式
合并的单元格的行为与其他单元格对象类似。它的值和格式在左上角的单元格中定义。要更改整个合并单元格的边框，请更改其左上角单元格的边框。
from openpyxl.styles import Border, Side, PatternFill, Font, GradientFill, Alignment
from openpyxl import Workbook
wb = Workbook()
ws = wb.active
ws.merge_cells('B2:F4')
top_left_cell = ws['B2']
top_left_cell.value = "My Cell"
thin = Side(border_style="thin", color="000000")
double = Side(border_style="double", color="ff0000")
top_left_cell.border = Border(top=double, left=thin, right=thin, bottom=double)
top_left_cell.fill = PatternFill("solid", fgColor="DDDDDD")
top_left_cell.fill = fill = GradientFill(stop=("000000", "FFFFFF"))
top_left_cell.font = Font(b=True, color="FF0000")
top_left_cell.alignment = Alignment(horizontal="center", vertical="center")
wb.save("styled.xlsx")
编辑页面设置
from openpyxl.workbook import Workbook
wb = Workbook()
ws = wb.active
ws.page_setup.orientation = ws.ORIENTATION_LANDSCAPE
ws.page_setup.paperSize = ws.PAPERSIZE_TABLOID
ws.page_setup.fitToHeight = 0
ws.page_setup.fitToWidth = 1
命名样式
与单元格样式相反，命名样式是可变的。当你想一次将格式应用到许多不同的单元格时，它们是有意义的。注意如果已将命名样式分配给单元格，对样式的其他更改不会影响单元格样式。
一旦命名样式注册到工作簿中，就可以简单地按名称将其重新命名。
创建命名样式
from openpyxl.styles import NamedStyle, Font, Border, Side
highlight = NamedStyle(name="highlight")
highlight.font = Font(bold=True, size=20)
bd = Side(style='thick', color="000000")
highlight.border = Border(left=bd, top=bd, right=bd, bottom=bd)
创建命名样式后，可以将其注册到工作簿中：
wb.add_named_style(highlight)
但命名样式也将在第一次分配给单元格时自动注册：
ws['A1'].style = highlight
注册后，仅使用名称指定样式：
ws['D5'].style = 'highlight'
使用内置样式
该规范包括一些内置样式，这些样式还可以使用。很不幸，这些样式的名称存储在它们的本地化文件中。openpyxl将只识别英文名称，并且只识别以下名称：
- ‘Normal’ # same as no style
Number formats
- ‘Comma’
- ‘Comma [0]’
- ‘Currency’
- ‘Currency [0]’
- ‘Percent’
Informative
- ‘Calculation’
- ‘Total’
- ‘Note’
- ‘Warning Text’
- ‘Explanatory Text’
Text styles
- ‘Title’
- ‘Headline 1’
- ‘Headline 2’
- ‘Headline 3’
- ‘Headline 4’
- ‘Hyperlink’
- ‘Followed Hyperlink’
- ‘Linked Cell’
Comparisons
- ‘Input’
- ‘Output’
- ‘Check Cell’
- ‘Good’
- ‘Bad’
- ‘Neutral’
Highlights
- ‘Accent1’
- ‘20 % - Accent1’
- ‘40 % - Accent1’
- ‘60 % - Accent1’
- ‘Accent2’
- ‘20 % - Accent2’
- ‘40 % - Accent2’
- ‘60 % - Accent2’
- ‘Accent3’
- ‘20 % - Accent3’
- ‘40 % - Accent3’
- ‘60 % - Accent3’
- ‘Accent4’
- ‘20 % - Accent4’
- ‘40 % - Accent4’
- ‘60 % - Accent4’
- ‘Accent5’
- ‘20 % - Accent5’
- ‘40 % - Accent5’
- ‘60 % - Accent5’
- ‘Accent6’
- ‘20 % - Accent6’
- ‘40 % - Accent6’
- ‘60 % - Accent6’
- ‘Pandas’
有关内置样式的更多信息，请参阅：mod:openpyxl.styles.builtins
