DOCUMENTATION CENTER SEARCH

Mathematica > Grids & Tables >

Grid

Grid[{{expr₁₁, expr₁₂, ...}, {expr₂₁, expr₂₂, ...}, ...}]
is an object that formats with the expr_ij arranged in a two-dimensional grid.

MORE INFORMATION

In a notebook, you can enter expressions in a two-dimensional layout by using Ctrl+, to add columns and Ctrl+Enter 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 Tab to move to the next placeholder in a Grid. Ctrl+Space moves out of the whole Grid.

Grid[...] formats as a grid in StandardForm and TraditionalForm.

In InputForm, Grid[...] formats literally as Grid[...].

First[grid] extracts the list of lists that make up a grid.

The expr_ij 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 list_i in Grid[{list₁, list₂, ...}] 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:

	SpanFromLeft	span from left
	SpanFromAbove	span from above
	SpanFromBoth	span 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
	Background	None	what background colors to use
	BaselinePosition	Automatic	what to align with a surrounding text baseline
	BaseStyle	{}	base style specifications for the grid
	DefaultElement	""	what element to insert in an empty item
	Dividers	None	where to draw divider lines in the grid
	Frame	None	where to draw frames in the grid
	FrameStyle	Automatic	style to use for frames
	ItemSize	Automatic	width and height of each item
	ItemStyle	None	styles for columns and rows
	Spacings	Automatic	horizontal and vertical spacings

Common settings for Frame include:

	None	no frame
	True	frame around the whole grid
	All	frame around every item in the grid
	Center	draw 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:

	spec	apply spec to all items
	{spec_x}	apply spec_x at successive horizontal positions
	{spec_x,spec_y}	apply spec_k at successive horizontal and vertical positions
	${spec_(x),spec_(y),rules}$	also allow explicit rules for individual elements

The spec_k can have the following forms:

	{s₁,s₂,...,s_n}	use through ; then use defaults
	{{c}}	use in all cases
	{{c₁,c₂}}	alternate between and
	{{c₁,c₂,...}}	cycle through all
	{s,{c}}	use , then repeatedly use
	{s₁,{c},s_n}	use , then repeatedly use , but use at the end
	{s₁,s₂,...,{c₁, c₂, ... }, s_m, ... , s_n}	use the first sequence of at the beginning, then cyclically use the , then use the last sequence of at the end
	{s₁,s₂,...,{},s_m,...,s_n}	use the first sequence of at the beginning and the last sequence at the end
	{i₁->v₁,i₂->v₂,...}	specify what to use at positions
	{spec,rules}	use rules to override specifications in spec

With settings of the form ${s_1,s_2,…,{…},s_m,…,s_n}$ , if there are more specified than items across the grid, 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 items in a particular direction, Dividers and Spacings can specify settings for the gaps between elements, starting before the first element, and ending after the last element.

Settings for Dividers and Spacings can have the following forms:

	spec	apply spec to all gaps between items
	{spec_x,spec_y}	apply spec_i to successive horizontal and vertical gaps

The spec_i can have the same forms as for Alignment, Background and other item-oriented options.

The following settings can be used for BaselinePosition:

	Axis	axis of the middle row in the grid (default)
	Baseline	baseline of the middle row in the grid
	Bottom	bottom of the whole grid
	Center	halfway from top to bottom
	Top	top of the whole grid
	{{i,j},pos}	position pos in element

The settings for BaseStyle are appended to the default style typically given by the "Grid" style in the current stylesheet.

Basic Examples (3)

Display elements in a grid:

Put a frame around every element:

Use Text to format grid elements as text:

Applications (2)

Possible Issues (2)

Neat Examples (3)

GraphicsGrid Row Column TableForm MatrixForm ArrayPlot MatrixPlot Labeled

Tables and Matrices

Grids, Rows, and Columns in Mathematica

Formatted Output

New in 6

© 2008 Wolfram Research, Inc.

Ask a question about this page | Suggest an improvement | Leave a message for the team