# Yahoo! UI Library

### dom 2.5.0

Yahoo! UI Library > dom > YAHOO.util.Region

Show Private Show Protected

## Class YAHOO.util.Region

Known Subclasses:
  YAHOO.util.Point

A region is a representation of an object on a grid. It is defined by the top, right, bottom, left extents, so is rectangular by default. If other shapes are required, this class could be extended to support it.

### Constructor

YAHOO.util.Region `( t , r , b , l )`

Parameters:
  `t <Int>` the top extent
  `r <Int>` the right extent
  `b <Int>` the bottom extent
  `l <Int>` the left extent

### Properties

#### 0 `- Int`

The region's left extent as index, for symmetry with set/getXY

#### 1 `- Int`

The region's top extent as index, for symmetry with set/getXY

#### bottom `- Int`

The region's bottom extent

#### left `- Int`

The region's left extent

#### right `- int`

The region's right extent

#### top `- Int`

The region's top extent

### Methods

#### contains

`Boolean contains ( region )`
Returns true if this region contains the region passed in

Parameters:
  `region <Region>` The region to evaluate

Returns: `Boolean`
  True if the region is contained with this region, else false

#### getArea

`Int getArea ( )`
Returns the area of the region

Returns: `Int`
  the region's area

#### getRegion

`static Region getRegion ( el )`
Returns a region that is occupied by the DOM element

Parameters:
  `el <HTMLElement>` The element

Returns: `Region`
  The region that the element occupies

#### intersect

`Region intersect ( region )`
Returns the region where the passed in region overlaps with this one

Parameters:
  `region <Region>` The region that intersects

Returns: `Region`
  The overlap region, or null if there is no overlap

#### toString

`void toString ( )`
toString

Returns: `void`
  string the region properties

#### union

`Region union ( region )`
Returns the region representing the smallest region that can contain both the passed in region and this region.

Parameters:
  `region <Region>` The region that to create the union with

Returns: `Region`
  The union region

Copyright © 2007 Yahoo! Inc. All rights reserved.