* [ pandas.io.formats.style.Styler.set_uuid ](pandas.io.formats.style.Styler.set_uuid.html)
    * [ pandas.io.formats.style.Styler.clear ](pandas.io.formats.style.Styler.clear.html)
    * [ pandas.io.formats.style.Styler.pipe ](pandas.io.formats.style.Styler.pipe.html)
    * [ pandas.io.formats.style.Styler.highlight_null ](pandas.io.formats.style.Styler.highlight_null.html)
    * [ pandas.io.formats.style.Styler.highlight_max ](pandas.io.formats.style.Styler.highlight_max.html)
    * [ pandas.io.formats.style.Styler.highlight_min ](pandas.io.formats.style.Styler.highlight_min.html)
    * [ pandas.io.formats.style.Styler.highlight_between ](pandas.io.formats.style.Styler.highlight_between.html)
    * [ pandas.io.formats.style.Styler.highlight_quantile ](pandas.io.formats.style.Styler.highlight_quantile.html)
    * [ pandas.io.formats.style.Styler.background_gradient ](pandas.io.formats.style.Styler.background_gradient.html)
    * [ pandas.io.formats.style.Styler.text_gradient ](pandas.io.formats.style.Styler.text_gradient.html)
    * [ pandas.io.formats.style.Styler.bar ](pandas.io.formats.style.Styler.bar.html)
    * [ pandas.io.formats.style.Styler.to_html ](pandas.io.formats.style.Styler.to_html.html)
    * [ pandas.io.formats.style.Styler.to_latex ](pandas.io.formats.style.Styler.to_latex.html)
    * [ pandas.io.formats.style.Styler.to_excel ](pandas.io.formats.style.Styler.to_excel.html)
    * [ pandas.io.formats.style.Styler.to_string ](pandas.io.formats.style.Styler.to_string.html)
    * [ pandas.io.formats.style.Styler.export ](pandas.io.formats.style.Styler.export.html)
    * [ pandas.io.formats.style.Styler.use ](pandas.io.formats.style.Styler.use.html)
  * [ Plotting ](../plotting.html)
  * [ Options and settings ](../options.html)
  * [ Extensions ](../extensions.html)
  * [ Testing ](../testing.html)
  * [ Missing values ](../missing_value.html)

  * [ __ ](../../index.html)
  * [ API reference ](../index.html)
  * [ Style ](../style.html)
  * pandas.io.fo... 

#  pandas.io.formats.style.Styler.map  #

Styler.  map  (  _ func  _ , _ subset  =  None  _ , _ **  kwargs  _ )  [
[source]  ](https://github.com/pandas-
dev/pandas/blob/v2.2.2/pandas/io/formats/style.py#L2031-L2089) #

    

Apply a CSS-styling function elementwise.

Updates the HTML representation with the result.

Parameters  :

    

**func** function

    

` func  ` should take a scalar and return a string.

**subset** label, array-like, IndexSlice, optional

    

A valid 2d input to  DataFrame.loc[<subset>]  , or, in the case of a 1d input
or single key, to  DataFrame.loc[:, <subset>]  where the columns are
prioritised, to limit ` data  ` to _before_ applying the function.

****kwargs** dict

    

Pass along to ` func  ` .

Returns  :

    

Styler

    

See also

[ ` Styler.map_index  `
](pandas.io.formats.style.Styler.map_index.html#pandas.io.formats.style.Styler.map_index
"pandas.io.formats.style.Styler.map_index")

    

Apply a CSS-styling function to headers elementwise.

[ ` Styler.apply_index  `
](pandas.io.formats.style.Styler.apply_index.html#pandas.io.formats.style.Styler.apply_index
"pandas.io.formats.style.Styler.apply_index")

    

Apply a CSS-styling function to headers level-wise.

[ ` Styler.apply  `
](pandas.io.formats.style.Styler.apply.html#pandas.io.formats.style.Styler.apply
"pandas.io.formats.style.Styler.apply")

    

Apply a CSS-styling function column-wise, row-wise, or table-wise.

Notes

The elements of the output of ` func  ` should be CSS styles as strings, in
the format âattribute: value; attribute2: value2; â¦â or, if nothing is
to be applied to that element, an empty string or ` None  ` .

Examples

    
    
    >>> def color_negative(v, color):
    ...     return f"color: {color};" if v < 0 else None
    >>> df = pd.DataFrame(np.random.randn(5, 2), columns=["A", "B"])
    >>> df.style.map(color_negative, color='red')  
    

Using ` subset  ` to restrict application to a single column or multiple
columns