Add support for paragraph highlight color

Author: botzill

.gitignore

@@ -45,3 +45,5 @@ main.py
 
 docs/_build
 tests/failures/*.html
+
+~$*.docx

pydocx/export/base.py

@@ -359,6 +359,7 @@ def get_run_styles_to_apply(self, run):
             (properties.hidden, self.export_run_property_hidden),
             (properties.vertical_align, self.export_run_property_vertical_align),
             (properties.color, self.export_run_property_color),
+            (properties.highlight_color, self.export_run_property_highlight_color),
             (not properties.color, self.export_run_property_parent_background_color),
         ]
         for actual_value, handler in property_rules:
@@ -408,6 +409,9 @@ def export_run_property_vertical_align(self, run, results):
     def export_run_property_color(self, run, results):
         return results
 
+    def export_run_property_highlight_color(self, run, results):
+        return results
+
     def export_run_property_parent_background_color(self, run, results):
         return results
 

pydocx/export/html.py

@@ -577,6 +577,17 @@ def export_run_property_color(self, run, results):
         tag = HtmlTag('span', **attrs)
         return self.export_run_property(tag, run, results)
 
+    def export_run_property_highlight_color(self, run, results):
+        if run.properties is None or run.properties.highlight_color is None:
+            return results
+
+        attrs = {
+            'style': 'background-color: %s' % run.properties.highlight_color
+        }
+        tag = HtmlTag('span', **attrs)
+
+        return self.export_run_property(tag, run, results)
+
     def export_run_property_parent_background_color(self, run, results):
         background_color = None
 

pydocx/openxml/wordprocessing/run_properties.py

@@ -28,17 +28,24 @@ class RunProperties(XmlModel):
     sz = XmlChild(name='sz', attrname='val')
     clr = XmlChild(name='color', attrname='val')
     r_fonts = XmlChild(type=RFonts)
+    highlight_clr = XmlChild(name='highlight', attrname='val')
 
     @property
     def color(self):
         if self.clr is None:
             return
-        # TODO: When we support background colors, remove FFFFFF check
-        if self.clr == '000000' or self.clr == 'FFFFFF':
+        if self.clr == '000000':
             return
 
         return self.clr
 
+    @property
+    def highlight_color(self):
+        if self.highlight_clr is None:
+            return
+
+        return self.highlight_clr
+
     @property
     def position(self):
         if self.pos is None:

tests/fixtures/styled_color.docx

@@ -2,7 +2,19 @@
 <p><span style="color:#31849B">BBB</span></p>
 <table border="1">
   <tr>
-    <td style="background-color: #5F497A">CCC</td>
+    <td style="background-color: #5F497A">
+      <span style="color:#FFFFFF">CCC</span>
+    </td>
   </tr>
 </table>
-<p>DDD</p>
+<p>
+  <span style="background-color: red">
+    <span style="color:#FFFFFF">DDD</span>
+  </span>
+</p>
+<p>
+    <span style="background-color: yellow">AAA</span>
+    <span style="background-color: green">BBB</span>
+    <span style="background-color: blue">CCC</span>
+    DDD
+</p>