ItemDisplayFunction

ItemDisplayFunction

is an option for Dataset that specifies a function to apply to items before displaying them.

Details

  • The setting for ItemDisplayFunction can be any pure function.
  • With the option ItemDisplayFunctionf, the specified function will be applied to all items in the dataset before displaying them.
  • With the option ItemDisplayFunctionf, the displayed item is given by f[item,position,dataset].
  • The settings for ItemDisplayFunction can be given as follows to apply separately to different items:
  • specapply spec to all items
    {spec1,spec2,,specn}apply speck to items at dataset level k
    {spec_(1),spec_(2),...,spec_(n),rules}also allow explicit rules for individual items
  • The speck can have the following forms:
  • {s1,s2,,sn}use s1 through sn; then use defaults
    {{c}}use c in all cases
    {{c1,c2}}alternate between c1 and c2
    {{c1,c2,}}cycle through all ci
    {s,{c}}use s, then repeatedly use c
    {s1,{c},sn}use s1, then repeatedly use c, but use sn at the end
    {s1,s2,,{c1,c2,},sm,,sn} use the first sequence of si at the beginning, then cyclically use the ci, then use the last sequence of si at the end
    {s1,s2,,{},sm,,sn}use the first sequence of si at the beginning and the last sequence at the end
  • Rules have the form ispec, where i specifies a position in the dataset.
  • Positions can be patterns.
  • The position of an item can be read at the bottom of a dataset when you hover over the header.
  • If the left-hand side of a rule is not a list, the setting is applied to any position that contains the left-hand side as a key or index.

Examples

open allclose all

Basic Examples  (2)

Put a frame around all items:

Display quantities without units:

Applications  (1)

Format quantities as percents:

Possible Issues  (1)

The value of ItemDisplayFunction must be an explicit pure function. Other values will have no effect:

Use an explicit pure function:

Interactive Examples  (1)

Highlight the item under the mouse:

Neat Examples  (1)

Display Titanic passenger data using a bar chart for age, a symbol for sex and a check mark if the passenger survived:

Introduced in 2020
 (12.1)