ENH: styler.render.repr option

doc/source/user_guide/options.rst

@@ -487,6 +487,8 @@ styler.sparse.index                     True         "Sparsify" MultiIndex displ
                                                      elements in outer levels within groups).
 styler.sparse.columns                   True         "Sparsify" MultiIndex display for columns
                                                      in Styler output.
+styler.render.repr                      html         Standard output format for Styler rendered in Jupyter Notebook.
+                                                     Should be one of "html" or "latex".
 styler.render.max_elements              262144       Maximum number of datapoints that Styler will render
                                                      trimming either rows, columns or both to fit.
 ======================================= ============ ==================================

doc/source/whatsnew/v1.4.0.rst

@@ -75,6 +75,7 @@ Styler
   - :meth:`.Styler.to_latex` introduces keyword argument ``environment``, which also allows a specific "longtable" entry through a separate jinja2 template (:issue:`41866`).
   - :meth:`.Styler.to_html` introduces keyword arguments ``sparse_index`` and ``sparse_columns`` (:issue:`41946`)
   - Keyword argument ``level`` is added to :meth:`.Styler.hide_index` and :meth:`.Styler.hide_columns` for optionally controlling hidden levels in a MultiIndex (:issue:`25475`)
+  - Global options have been extended to configure default ``Styler`` properties including rendering options (:issue:`41395`)
 
 There are also bug fixes and deprecations listed below.
 

pandas/core/config_init.py

@@ -756,6 +756,11 @@ def register_converter_cb(key):
     display each explicit level element in a hierarchical key for each column.
 """
 
+styler_render_repr = """
+: str
+    Determine which output to use in Jupyter Notebook in {"html", "latex"}.
+"""
+
 styler_max_elements = """
 : int
     The maximum number of data-cell (<td>) elements that will be rendered before
@@ -769,6 +774,13 @@ def register_converter_cb(key):
         "sparse.columns", True, styler_sparse_columns_doc, validator=bool
     )
 
+    cf.register_option(
+        "render.repr",
+        "html",
+        styler_render_repr,
+        validator=is_one_of_factory(["html", "latex"]),
+    )
+
     cf.register_option(
         "render.max_elements",
         2 ** 18,

pandas/io/formats/style.py

@@ -214,6 +214,8 @@ def _repr_html_(self) -> str:
         """
         Hooks into Jupyter notebook rich display system.
         """
+        if get_option("styler.render.repr") == "latex":
+            return self.to_latex()
         return self.to_html()
 
     def render(
@@ -887,7 +889,7 @@ def to_html(
             ``class`` and ``id`` identifiers, or solely the ``<table>`` element without
             styling identifiers.
         **kwargs
-            Any additional keyword arguments are passed through to the jinj2
+            Any additional keyword arguments are passed through to the jinja2
             ``self.template.render`` process. This is useful when you need to provide
             additional variables for a custom template.
 

pandas/tests/io/formats/style/test_to_latex.py

@@ -675,3 +675,9 @@ def test_apply_map_header_render_mi(df, index, columns):
     """
     )
     assert (expected_columns in result) is columns
+
+
+def test_repr_option(styler):
+    assert "<style" in styler._repr_html_()[:6]
+    with option_context("styler.render.repr", "latex"):
+        assert "\\begin{tabular}" in styler._repr_html_()[:15]