Documentation

### This is machine translation

Translated by
Mouseover text to see original. Click the button below to return to the English version of the page.

To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

# grid

Display or hide axes grid lines

## Syntax

``grid on``
``grid off``
``grid``
``grid minor``
``grid(target,___)``

## Description

example

````grid on` displays the major grid lines for the current axes or chart returned by the `gca` command. Major grid lines extend from each tick mark.```

example

````grid off` removes all grid lines from the current axes or chart.```
````grid` toggles the visibility of the major grid lines.```

example

````grid minor` toggles the visibility of the minor grid lines. Minor grid lines lie between the tick marks. Not all types of charts support minor grid lines.```

example

````grid(target,___)` uses the axes or chart specified by `target` instead of the current axes or chart. Specify `target` as the first input argument. Use single quotes around other input arguments, for example, `grid(target,'on')`.```

## Examples

collapse all

Display the grid lines for a sine plot.

```x = linspace(0,10); y = sin(x); plot(x,y) grid on```

Create a surface plot and remove the grid lines.

```[X,Y,Z] = peaks; surf(X,Y,Z) grid off```

Display the major and minor grid lines for a sine plot.

```x = linspace(0,10); y = sin(x); plot(x,y) grid on grid minor```

Create a figure with two subplots and assign the Axes objects to the variables `ax1` and `ax2`. Plot a sine wave in each subplot. Then display the grid lines on the upper subplot by specifying `ax1` as an input argument to the `grid` function.

```x = linspace(0,10); y = sin(x); ax1 = subplot(2,1,1); plot(ax1,x,y) y2 = sin(3*x); ax2 = subplot(2,1,2); plot(ax2,x,y2)```

`grid(ax1,'on')`

## Input Arguments

collapse all

Target axes or chart, specified as an `Axes` object, a `PolarAxes` object, or a graphics object that has a `GridVisible` property. For example, you can add or remove grid lines from a `HeatmapChart` object using the `grid` function.

If you do not specify the target, then the `grid` function affects the graphics object returned by the `gca` command.

## Algorithms

The `grid` function sets these graphics object properties to either `'on'` or `'off'`: