CLN: simplify Styler._translate

doc/source/user_guide/style.ipynb

@@ -1046,7 +1046,7 @@
    "source": [
     "### 5. If every byte counts use string replacement\n",
     "\n",
-    "You can remove unnecessary HTML, or shorten the default class names with string replace functions."
+    "You can remove unnecessary HTML, or shorten the default class names by replacing the default css dict. You can read a little more about CSS [below](#More-About-CSS-and-HTML)."
    ]
   },
   {
@@ -1055,21 +1055,23 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "html = Styler(df4, uuid_len=0, cell_ids=False)\\\n",
-    "      .set_table_styles([{'selector': 'td', 'props': props},\n",
-    "                         {'selector': '.col1', 'props': 'color:green;'},\n",
-    "                         {'selector': '.level0', 'props': 'color:blue;'}])\\\n",
-    "      .to_html()\\\n",
-    "      .replace('blank', '')\\\n",
-    "      .replace('data', '')\\\n",
-    "      .replace('level0', 'l0')\\\n",
-    "      .replace('col_heading', '')\\\n",
-    "      .replace('row_heading', '')\n",
-    "\n",
-    "import re\n",
-    "html = re.sub(r'col[0-9]+', lambda x: x.group().replace('col', 'c'), html)\n",
-    "html = re.sub(r'row[0-9]+', lambda x: x.group().replace('row', 'r'), html)\n",
-    "print(html)"
+    "my_css = {\n",
+    "    \"row_heading\": \"\",\n",
+    "    \"col_heading\": \"\",\n",
+    "    \"index_name\": \"\",\n",
+    "    \"col\": \"c\",\n",
+    "    \"row\": \"r\",\n",
+    "    \"col_trim\": \"\",\n",
+    "    \"row_trim\": \"\",\n",
+    "    \"level\": \"l\",\n",
+    "    \"data\": \"\",\n",
+    "    \"blank\": \"\",\n",
+    "}\n",
+    "html = Styler(df4, uuid_len=0, cell_ids=False, css=my_css)\n",
+    "html.set_table_styles([{'selector': 'td', 'props': props},\n",
+    "                       {'selector': '.c1', 'props': 'color:green;'},\n",
+    "                       {'selector': '.l0', 'props': 'color:blue;'}])\n",
+    "print(html.to_html())"
    ]
   },
   {
@@ -1078,8 +1080,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "from IPython.display import HTML\n",
-    "HTML(html)"
+    "html"
    ]
   },
   {
@@ -1655,6 +1656,7 @@
     "  + `row<m>`, where `m` is the numeric position of the cell.\n",
     "  + `col<n>`, where `n` is the numeric position of the cell.\n",
     "- Blank cells include `blank`\n",
+    "- Trimmed cells include `col_trim` or `row_trim`\n",
     "\n",
     "The structure of the `id` is `T_uuid_level<k>_row<m>_col<n>` where `level<k>` is used only on headings, and headings will only have either `row<m>` or `col<n>` whichever is needed. By default we've also prepended each row/column identifier with a UUID unique to each DataFrame so that the style from one doesn't collide with the styling from another within the same notebook or page. You can read more about the use of UUIDs in [Optimization](#Optimization).\n",
     "\n",
@@ -2031,7 +2033,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.8.7"
+   "version": "3.8.6"
   }
  },
  "nbformat": 4,

doc/source/whatsnew/v1.4.0.rst

@@ -80,6 +80,7 @@ Styler
   - Global options have been extended to configure default ``Styler`` properties including formatting and encoding and mathjax options and LaTeX (:issue:`41395`)
   - Naive sparsification is now possible for LaTeX without the multirow package (:issue:`43369`)
   - :meth:`Styler.to_html` omits CSSStyle rules for hidden table elements (:issue:`43619`)
+  - Custom CSS classes can now be directly specified without string replacement (:issue:`43686`)
 
 Formerly Styler relied on ``display.html.use_mathjax``, which has now been replaced by ``styler.html.mathjax``.
 

pandas/io/formats/style.py

@@ -143,11 +143,16 @@ class Styler(StylerRenderer):
         uses ``pandas.options.styler.format.formatter``.
 
         .. versionadded:: 1.4.0
+    css : dict, optional
+        A dict of strings used to replace the default CSS classes described below.
 
     Attributes
     ----------
     env : Jinja2 jinja2.Environment
-    template : Jinja2 Template
+    template_html : Jinja2 Template
+    template_html_table : Jinja2 Template
+    template_html_style : Jinja2 Template
+    template_latex : Jinja2 Template
     loader : Jinja2 Loader
 
     See Also
@@ -183,6 +188,10 @@ class Styler(StylerRenderer):
 
     * Blank cells include ``blank``
     * Data cells include ``data``
+    * Trimmed cells include ``col_trim`` or ``row_trim``.
+
+    Any, or all, or these classes can be renamed by using the ``css`` argument, giving
+    a value such as `{"row": "MY_ROW_CLASS", "col_trim": "", "row_trim": ""}`.
     """
 
     def __init__(
@@ -200,6 +209,7 @@ def __init__(
         thousands: str | None = None,
         escape: str | None = None,
         formatter: ExtFormatter | None = None,
+        css: dict[str, str] | None = None,
     ):
         super().__init__(
             data=data,
@@ -210,6 +220,7 @@ def __init__(
             caption=caption,
             cell_ids=cell_ids,
             precision=precision,
+            css=css,
         )
 
         # validate ordered args
@@ -1160,6 +1171,7 @@ def _copy(self, deepcopy: bool = False) -> Styler:
           - caption
 
         Non-data dependent attributes [copied and exported]:
+          - css
           - hidden index state and hidden columns state (.hide_index_, .hide_columns_)
           - table_attributes
           - table_styles
@@ -1186,6 +1198,7 @@ def _copy(self, deepcopy: bool = False) -> Styler:
             "template_html",
         ]
         deep = [  # nested lists or dicts
+            "css",
             "_display_funcs",
             "_display_funcs_index",
             "_display_funcs_columns",