Apple Developer Connection
Member Login Log In | Not a Member? Contact ADC

< Previous PageNext Page > Hide TOC

Parameters

The following parameters are defined for use when specifying regions within a widget.

In this section:

dashboard-region
none


dashboard-region

Specifies the type and bounds of a region.

dashboard-region(label, geometry-type)
dashboard-region(label, geometry-type, offset-top, offset-right, offset-bottom, offset-left)

This parameter function is used in conjunction with the -apple-dashboard-region property. It specifies a region’s bounds and type, in function form. Table 2-1 shows the values expected by the dashboard-region parameter.

Table 2-1  dashboard-region() parameters

Parameter

Description

label

Required; specifies the type of region being defined; control is the only used value.

geometry-type

Required; specifies the shape of the region, either circle or rectangle.

offset-top

Optional; specifies the offset from the top of the wrapped area from where the defined region should begin, in pixels. Negative values not allowed.

offset-right

Optional; specifies the offset from the right of the wrapped area from where the defined region should begin, in pixels. Negative values not allowed.

offset-bottom

Optional; specifies the offset from the bottom of the wrapped area from where the defined region should begin, in pixels. Negative values not allowed.

offset-left

Optional; specifies the offset from the left of the wrapped area from where the defined region should begin, in pixels. Negative values not allowed.

If you specify circle for the geometry-type parameter, the control region created is centered in between the specified offsets (or the edges of the region, if no offsets are provided). Of the circle region’s width and height (which ideally should be equal), the resulting control region’s diameter is the smaller value.

When using the offset parameters, you either provide values for all four offsets or none of them. Note that if you do not specify values for the offset parameters, a default value of 0 is used for each of them.

You can chain multiple dashboard-region parameters together in one apple-dashboard-region property declaration, allowing you to create complex-shaped regions:

.equals-button-example {
    ...
    -apple-dashboard-region:
        dashboard-region(control circle 0px 0px 80px 0px)
        dashboard-region(control rectangle 10px 0px 10px 0px)
        dashboard-region(control circle 80px 0px 0px 0px);
    ...
}

Some elements have control regions assigned to them by default:

Whenever you use one of these elements you do not need to manually specify a control region them. The region specified on these elements extend to their edges:

 button, input, select, textarea {
    -apple-dashboard-region:dashboard-region(control rectangle);
}

none

Removes any regions on an element.

none

Setting the -apple-dashboard-region property to none removes any region applied to an element.



< Previous PageNext Page > Hide TOC

Last updated: 2006-05-23

Did this document help you?
Yes: Tell us what works for you.

It’s good, but: Report typos, inaccuracies, and so forth.

It wasn’t helpful: Tell us what would have helped.
Get information on Apple products.
Visit the Apple Store online or at retail locations.
1-800-MY-APPLE

Copyright © 2007 Apple Inc.
All rights reserved. | Terms of use | Privacy Notice