is an object that formats with the exprij arranged in a two-dimensional grid.

Details and Options

  • In a notebook, you can enter expressions in a two-dimensional layout by using to add columns and to add rows. By default, this layout evaluates to a nested list. You can make a Grid that preserves the layout by using Grid[layout].
  • You can use to move to the next placeholder in a Grid. moves out of the whole Grid.
  • Grid[] formats as a grid in StandardForm and TraditionalForm.
  • In InputForm, Grid[] formats literally as Grid[].
  • Normal[grid] extracts the list of lists that make up a grid.
  • The exprij can be expressions of any kind, including graphics and controls.
  • You can enter text in an element of a Grid by giving it as a string. You can use Text["string"] or Style["string","style"] to specify a particular style.
  • The listi in Grid[{list1,list2,}] do not all need to be the same length; there will be empty space in the grid at the ends of shorter rows.
  • You can specify that an element e should span multiple positions in a grid using, for example, Grid[{{e,SpanFromLeft,SpanFromLeft},}].
  • The following specify that a particular position should be spanned:
  • SpanFromLeftspan from left
    SpanFromAbovespan from above
    SpanFromBothspan from both left and above
  • A particular element can span both multiple rows and multiple columns, by having a rectangular section of the array with the form {{e,SpanFromLeft,SpanFromLeft,}, {SpanFromAbove,SpanFromBoth,SpanFromBoth,},}.
  • In a notebook, you can combine selected elements in a grid to make a single spanning element using the Make Spanning menu item.
  • The following options can be given:
  • Alignment{Center,Baseline}horizontal and vertical alignment of items
    AllowedDimensionsAutomaticrestrictions on number of rows or columns
    AutoDeleteFalsewhether to remove the grid structure if only one item remains
    BackgroundNonewhat background colors to use
    BaselinePositionAutomaticwhat to align with a surrounding text baseline
    BaseStyle{}base style specifications for the grid
    DefaultElement""what element to insert in an empty item
    Dividers{}where to draw divider lines in the grid
    FrameNonewhere to draw frames in the grid
    FrameStyleAutomaticstyle to use for frames
    ItemSizeAutomaticwidth and height of each item
    ItemStyleNonestyles for columns and rows
    SpacingsAutomatichorizontal and vertical spacings
  • Common settings for Frame include:
  • Noneno frame
    Trueframe around the whole grid
    Allframe around every item in the grid
    Centerdraw interior frames only
    {All, False}put a frame at every horizontal position (column lines)
    {False, All}put a frame at every vertical position (row lines)
  • Settings for the options Alignment, Background, Frame, ItemSize, and ItemStyle can be given as follows to apply separately to different items:
  • specapply spec to all items
    {specx}apply specx at successive horizontal positions
    {specx,specy}apply speck at successive horizontal and vertical positions
    {specx,specy,rules}also allow explicit rules for individual i,j elements
  • 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
    {i1->v1,i2->v2,}specify what to use at positions ik
    {spec,rules}use rules to override specifications in spec
  • With settings of the form {s1,s2,,{},sm,,sn}, if there are more si specified than items across the grid, si from the beginning are used for the first items, and ones from the end are used for the last items.
  • Settings such as Alignment, Background, and Frame can effectively be specified for individual items in the grid using Item.
  • With the default setting ItemSize->Automatic, Grid will break elements across multiple lines if necessary.
  • Grid will not change the size of graphics or other objects that have explicit ImageSize settings.
  • For a grid with n items in a particular direction, Dividers and Spacings can specify settings for the n+1 gaps between elements, starting before the first element and ending after the last element.
  • Settings for Dividers and Spacings can have the following forms:
  • specapply spec to all gaps between items
    {specx,specy}apply specx, specy to successive horizontal and vertical gaps
  • The speci can have the same forms as for Alignment, Background, and other item-oriented options.
  • The following settings can be used for BaselinePosition:
  • Axisaxis of the middle row in the grid
    Baselinebaseline of the middle row in the grid
    Bottombottom of the whole grid
    Centerhalfway from top to bottom
    Toptop of the whole grid
    {{i,j},pos}position pos in element i,j
    pos->refbaseline offset to make pos be aligned with ref
  • The BaselinePosition is by default taken to be Center->Axis.
  • The settings for BaseStyle are appended to the default style typically given by the "Grid" style in the current stylesheet.


open all close all

Basic Examples  (3)

Display elements in a grid:

Click for copyable input

Put a frame around every element:

Click for copyable input

Use Text to format grid elements as text:

Click for copyable input

Scope  (27)

Options  (36)

Applications  (2)

Properties & Relations  (1)

Possible Issues  (2)

Neat Examples  (3)

Introduced in 2007
Updated in 2012