Style Attributes and Their Values

Style attributes are used with the DEFINE STYLE statement. The default value for an attribute depends on the style definition that is in use. The implementation of an attribute depends on the ODS destination that formats the output. In addition, when creating HTML output, the implementation of an attribute depends on the browser that is used. For information about viewing the attributes in a style definition, see Viewing the Contents of a Style Definition. For a list of the values that style attributes can specify, see Bark Style Definition Attribute Values.

¹ This attribute can also be used to influence other characteristics as described in another section of the table.

Note:   You can use the value _UNDEF_ for any style attribute. ODS treats an attribute that is set to _UNDEF_ as if its value had never been set, even in the parent or beyond.  

ABSTRACT= ON | OFF

determines whether or not styles are used in CSS or LaTex style files.

ON

specifies that styles are used in CSS or LaTex style files.

OFF

specifies that styles are not used in CSS or LaTex style files.

Applies to:	document
ODS Destination:	HTML, MARKUP, and LaTex

ACTIVELINKCOLOR=color

specifies the color that a link changes to after you click on it, but before the browser opens that file.

Applies to:	document
ODS Destination:	HTML
See:	color

ASIS=ON|OFF

specifies how to handle leading spaces and line breaks.

ON

prints text with leading spaces and line breaks, in the same manner as the listing output.

OFF

trims leading spaces and ignores line breaks.

Default:	OFF
Applies to:	document
ODS Destinations:	HTML, RTF, PS, PCL, and PDF

BACKGROUND=color

specifies the color of the background.

Tip:	Generally, the background color of the cell overrides the background color of the table. You see the background color for the table only as the space between cells (see CELLSPACING=).
Applies to:	tables or cells and graphs
ODS Destinations:	HTML, PCL, PDF, PS, and RTF
Overridden by:	CBACK= option in the SAS/GRAPH GOPTIONS statement
Featured in:	Creating a Stand-Alone Style Definition and Modifying the Default Style Definition for the HTML and Markup Languages
See:	color

BACKGROUNDIMAGE='string'

specifies an image to use as the background. Viewers can tile or stretch the image as the background for the HTML table or graph that the procedure creates. For graphs, the specified image is stretched. string is the name of a GIF or JPEG file. You can use a simple file name, a complete path, or a URL. However, the most versatile approach is to use a simple filename and to place all image files in the local directory.

Applies to:	tables or cells and graphs
ODS Destinations:	HTML, PCL, and PS
Overridden by:	IBACK= and IMAGESTYLE=FIT options in the SAS/GRAPH GOPTIONS statement
See:	string

BODYSCROLLBAR=YES | NO | AUTO

specifies whether or not to put a scroll bar in the frame that references the body file.

YES

places a scroll bar in the frame that references the body file.

NO

specifies not to put a scroll bar in the frame that references the body file.

AUTO

places a scroll bar in the frame that references the body file only if needed.

Tip:	Typically, BODYSCROLLBAR is set to AUTO.
Applies to:	frame
ODS Destinations:	HTML

BODYSIZE=dimension | number % | *

specifies the width of the frame that displays the body file in the HTML frame file. (For information about the HTML files that ODS creates, see HTML Links and References Produced by the HTML Destination.)

dimension

is a nonnegative number. The unit of measure is pixels.

See:

dimension

number %

specifies the width of the frame as a percentage of the entire display.

*

specifies to use whatever space is left after displaying the content and page files as specified by the CONTENTSIZE= attribute.

Applies to:	frame
ODS Destinations:	HTML

BORDERCOLOR=color

specifies the color of the border if the border is just one color.

Applies to:	tables or cells
ODS Destinations:	HTML, RTF, PRINTER family
See:	color

BORDERCOLORDARK=color

specifies the darker color to use in a border that uses two colors to create a three-dimensional effect.

Interaction:	If you create HTML4 output, then the BORDERCOLORDARK style attribute is ignored because it is not part of the HTML4 standard. If you want a color border, then use the BORDERCOLOR= style attribute.
Applies to:	tables or cells
ODS Destinations:	HTML, RTF, PRINTER family
Featured in:	Defining a Table and Graph Style
See also:	color

BORDERCOLORLIGHT=color

specifies the lighter color to use in a border that uses two colors to create a three-dimensional effect.

Interaction:	If you create HTML4 output, then the BORDERCOLORLIGHT style attribute is ignored because it is not part of the HTML4 standard. If you want a color border, then use the BORDERCOLOR= style attribute.
Applies to:	tables or cells
ODS Destinations:	HTML, RTF, PRINTER family
Featured in:	Defining a Table and Graph Style
See:	color

BORDERWIDTH=dimension

specifies the width of the border of the table.

Applies to:	tables
ODS Destinations:	HTML, RTF, PRINTER family
Tip:	Typically, when BORDERWIDTH=0, the ODS destination sets RULES=NONE (see the discussion about RULES=) and FRAME=VOID (see the discussion about FRAME=).
Featured in:	Creating a Stand-Alone Style Definition and Modifying the Default Style Definition for the HTML and Markup Languages
See:	dimension

BOTTOMMARGIN=dimension

specifies the bottom margin for the document.

Applies to:	document
ODS Destinations:	HTML, RTF, PRINTER family
See:	dimension

BULLETS='string'

specifies the string to use for bullets in the contents file. ODS uses bullets in the contents file. string can be one of the following:

• circle

• decimal

• disc

• lower-alpha

• lower-roman

• none

• square

• upper-alpha

• upper-roman.

Applies to:	contents
ODS Destinations:	HTML
See:	string

CELLHEIGHT=dimension|integer%

specifies the height of the cell. If you specify a percent, it represents a percentage of the height of the table. A row of cells will have the height of the highest cell in the row.

dimension

is a nonnegative number, optionally followed by one of the following units of measure.

See:

dimension

integer%

specifies the height of the cell as a percentage of the height of the table.

Alias:	OUTPUTHEIGHT=
Tip:	HTML automatically sets cell height appropriately. You should seldom need to specify this attribute in the HTML destination.
Applies to:	cells
ODS Destinations:	HTML, RTF, PDF, PCL, and PS

CELLPADDING=dimension | integer%

specifies the amount of white space on each of the four sides of the text in a cell.

dimension

is a nonnegative number, optionally followed by one of the following units of measure.

See:

dimension

integer%

specifies the amount of white space on each of the four sides of the text in a cell as a percentage of the table.

Applies to:	tables
ODS Destinations:	HTML, RTF, PRINTER family
Featured in:	Modifying the Default Style Definition for the HTML and Markup Languages

CELLSPACING=dimension

specifies the thickness of the spacing between cells.

Applies to:	tables
Interaction:	If BORDERWIDTH= is nonzero, and if the background color of the cells contrasts with the background color of the table, then the color of the cell spacing is determined by the table's background.
Featured in:	Creating a Stand-Alone Style Definition and Modifying the Default Style Definition for the HTML and Markup Languages
See:	dimension

CELLWIDTH=dimension | integer%

specifies the width of the cell. If you specify a percent, it represents a percentage of the width of the table. A column of cells will have the width of the widest cell in the column.

dimension

is a nonnegative number, optionally followed by one of the following units of measure.

See:

dimension

integer%

specifies the width of the cell as a percentage of the width of the table.

Alias:	OUTPUTWIDTH=
Applies to:	cells
ODS Destinations:	HTML, RTF, PRINTER family

CONTENTPOSITION= LEFT | RIGHT | TOP | BOTTOM

specifies the position, within the frame file, of the frames that display the contents and the page files. (For information about the HTML files that ODS creates, see HTML Links and References Produced by the HTML Destination.)

LEFT

places the frames on the left.

Alias:

L

RIGHT

places the frames on the right.

Alias:

R

TOP

places the frames at the top.

Alias:

T

BOTTOM

places the frames at the bottom.

Alias:

B

Applies to:	frame
ODS Destinations:	HTML

CONTENTSCROLLBAR=YES | NO |AUTO

specifies whether or not to put a scroll bar in the frames in the frame file that display the contents and the page files. (For information about the HTML files that ODS creates, see HTML Links and References Produced by the HTML Destination.)

YES

places a scroll bar in the frames in the frame file that display the contents and the page files.

NO

specifies not to put a scroll bar in the frames in the frame file that display the contents and the page files.

AUTO

specifies that the browser provides a scroll bar for the frame window when necessary.

Tip:	Typically, CONTENTSCROLLBAR= is set to AUTO.
Applies to:	frame
ODS Destinations:	HTML

CONTENTSIZE=dimension | number % | *

specifies the width of the frames in the frame file that display the contents and the page files. (For information about the HTML files that ODS creates, see HTML Links and References Produced by the HTML Destination

dimension

is a nonnegative number. The unit of measure is pixels.

See:

dimension

number %

specifies the width of the frames as a percentage of the entire display.

Requirement:

number % must be a positive number between 0 and 100.

*

specifies to use whatever space is left after displaying the body file as specified by the BODYSIZE= attribute.

See also:	BODYSIZE=
Applies to:	frame
ODS Destinations:	HTML

CONTRASTCOLOR=color

specifies the alternate colors for maps. The alternate colors are applied to the blocks on region areas in block maps.

Applies to:	graphs
ODS Destinations:	HTML
See:	color

DROPSHADOW= ON | OFF

determines whether drop shadow effect is used with text.

ON

specifies that a drop shadow effect is used with text.

OFF

specifies that a drop shadow effect is not used with text.

Applies to:	graphs
ODS Destinations:	HTML

ENDCOLOR=color

indicates the end fill color for a graph. It is used to create a gradient effect.

Note:   You can have either a start and end gradient effect or no gradient effect. If you specify a TRANSPARENCY level and you only specify the ENDCOLOR, then the start color will be completely transparent gradationally to the end color.  

Applies to:	graphs
ODS Destinations:	HTML
See:	color

FILLRULEWIDTH=dimension

causes a rule of the specified width to be placed into the space around the text (or entire cell if there is no text) where white space would otherwise appear.

Tip:	If no text is specified, then FILLRULEWIDTH= fills the space around the text with dash marks. For example: --this-- or this ------.
Applies to:	tables
ODS Destinations:	PDF, PS, and PCL
See:	dimension

FLYOVER='string'

specifies the text to show in a tool tip for the cell.

Applies to:	cells
ODS Destinations:	HTML and PDF
See:	string

FONT=font-definition

specifies a font definition to use.

Tip:	When you specify this attribute for a table, it affects only the text that is specified with the PRETEXT=, POSTTEXT=, PREHTML=, and POSTHTML= attributes. To alter the font for the text that appears in the table, you must set the attribute for a cell.
Tip:	If the system does not recognize the font specified, then it will refer to your system's default font. This attribute does not accept concatenated fonts. SAS Graph Styles can only specify one font.
Applies to:	tables, cells, and graphs
ODS Destinations:	HTML, RTF, PRINTER family
Featured in:	Modifying the Default Style Definition for the HTML and Markup Languages
See:	font-definition

FONT_FACE='string-1<..., string-n>'

specifies the font to use. If you supply multiple fonts, then the destination device uses the first one that is installed on your system.

You cannot be sure what fonts are available to someone who is viewing your output in a browser or printing it on a high-resolution printer. Most devices support

• times

• courier

• arial, helvetica.

Tip:	When you specify this attribute for a table, it affects only the text that is specified with the PRETEXT=, POSTTEXT=, PREHTML=, and POSTHTML= attributes. To alter the font for the text that appears in the table, you must set the attribute for a cell.
Applies to:	cells and graphs
ODS Destinations:	HTML, RTF, PRINTER family
Featured in:	Creating a Stand-Alone Style Definition
See:	string

FONT_SIZE=dimension | size

specifies the size of the font.

dimension

is a nonnegative number.

See:	dimension
Restriction:	If you specify a dimension, then you must specify a unit of measure. Without a unit of measure, the number becomes a relative size.

size

The value of size is relative to all other font sizes in the document.

Range:

1 to 7, for size

Tip:	When you specify this attribute for a table, it affects only the text that is specified with the PRETEXT=, POSTTEXT=, PREHTML=, and POSTHTML= attributes. To alter the font for the text that appears in the table, you must set the attribute for a cell.
Applies to:	table, cells, and graphs
ODS Destinations:	HTML, RTF, PDF, PCL, and PS
Featured in:	Creating a Stand-Alone Style Definition

FONT_STYLE=ITALIC | ROMAN | SLANT

specifies the style of the font. In many cases, italic and slant map to the same font.

Tip:	When you specify this attribute for a table, it affects only the text that is specified with the PRETEXT=, POSTTEXT=, PREHTML=, and POSTHTML= attributes. To alter the font for the text that appears in the table, you must set the attribute for a cell.
Applies to:	tables, cells, and graphs
ODS Destinations:	HTML, PCL, PDF, PS, and RTF
Featured in:	Creating a Stand-Alone Style Definition and Modifying the Default Style Definition for the HTML and Markup Languages

FONT_WEIGHT=weight

specifies the font weight. weight can be any of the following:

• MEDIUM

• BOLD

• DEMI_BOLD

• EXTRA_BOLD

• LIGHT

• DEMI_LIGHT

• EXTRA_LIGHT

Restriction:	You cannot be sure what font weights are available to someone who is viewing your output in a browser or printing it on a high-resolution printer. Most devices support only MEDIUM and BOLD, and possibly LIGHT.
Tip:	When you specify this attribute for a table, it affects only the text that is specified with the PRETEXT=, POSTTEXT=, PREHTML=, and POSTHTML= attributes. To alter the font for the text that appears in the table, you must set the attribute for a cell.
Applies to:	tables, cells, and graphs
ODS Destinations:	HTML, PCL, PDF, PS, and RTF
Featured in:	Creating a Stand-Alone Style Definition

FONT_WIDTH=relative-width

specifies the font width compared to the width of the usual design. relative-width can be any of the following:

• NORMAL

• COMPRESSED

• EXTRA_COMPRESSED

• NARROW

• WIDE

• EXPANDED

Restriction:	Few fonts honor these values.
Tip:	When you specify this attribute for a table, it affects only the text that is specified with the PRETEXT=, POSTTEXT=, PREHTML=, and POSTHTML= attributes. To alter the font for the text that appears in the table, you must set the attribute for a cell.
Applies to:	tables, cells, and graphs
ODS Destinations:	HTML, RTF, PCL, PDF, PS, and RTF
Featured in:	Creating a Stand-Alone Style Definition

FOREGROUND=color

specifies the color of the foreground, which is primarily the color of text.

Tip:	When you specify this attribute for a table, it affects only the text that is specified with the PRETEXT=, POSTTEXT=, PREHTML=, and POSTHTML= attributes. To alter the font for the text that appears in the table, you must set the attribute for a cell.
Applies to:	tables, cells, and graphs
ODS Destinations:	HTML, PCL, PDF, PS, and RTF
Overridden by:	CBACK= option in the SAS/GRAPH GOPTIONS statement
Featured in:	Modifying the Default Style Definition for the HTML and Markup Languages
See:	color

FRAME=frame-type

specifies the type of frame to use on a table. The following table shows the possible values for frame-type and their meanings:

Value for frame-type ...	Frame type
ABOVE	a border at the top
BELOW	a border at the bottom
BOX	borders at the top, bottom, and both sides
HSIDES	borders at the top and bottom
LHS	a border at the left side
RHS	a border at the right side
VOID	no borders
VSIDES	borders at the left and right sides

Applies to:	tables
ODS Destinations:	HTML, PRINTER family, and RTF
Featured in:	Modifying the Default Style Definition for the HTML and Markup Languages

FRAMEBORDER=ON | OFF

specifies whether or not to put a border around the frame for an HTML file that uses frames.

ON

places a border around the frame for an HTML file that uses frames.

OFF

specifies not to put a border around the frame for an HTML file that uses frames.

Applies to:	frame
ODS Destinations:	HTML

FRAMEBORDERWIDTH=dimension

specifies the width of the border around the frames for an HTML file that uses frames.

Applies to:	frame
ODS Destinations:	HTML
See:	dimension

FRAMESPACING=integer

specifies the width of the space between frames for HTML that uses frames.

Applies to:	frame
ODS Destinations:	HTML

GRADIENT_DIRECTION= XAXIS | YAXIS

specifies the direction for the gradient effect for a graph's background, legend background, charts, walls, and floors. Use XAXIS for a left-to-right gradient and YAXIS for a bottom-to-top gradient.

Applies to:	graphs
ODS Destinations:	HTML

HREFTARGET=target

specifies the window or frame in which to open the target of the link. target can be one of the following values.

_BLANK

opens the target in a new, blank window. The window has no name.

_PARENT

opens the target in the window from which the current window was opened.

_SEARCH

opens the target in the browser's search pane.

Restriction:

Only available in Internet Explorer 5.0 or later.

_SELF

opens the target in the current window.

_TOP

opens the target in the topmost window.

'name'

opens the target in the specified window or the frame.

Default:	_SELF
Applies to:	cells
ODS Destinations:	HTML

HTMLCLASS='string'

specifies the name of the style sheet class to use for the table or cell.

Applies to:	document
ODS Destinations:	HTML
See:	string

HTMLCONTENTTYPE='string'

provides the value of the content type for pages that you send directly to a web server rather than to a file.

Tip:	The value of string is usually "text/html".
Applies to:	document
ODS Destinations:	HTML
See:	string

HTMLDOCTYPE='string'

specifies the entire doctype declaration for the HTML document, including the opening "<!DOCTYPE" and the closing ">".

Applies to:	document
ODS Destinations:	HTML
See:	string

HTMLID='string'

specifies an id for the table or cell. The id is for use by a JavaScript.

Applies to:	tables and cells
ODS Destinations:	HTML
See:	string

HTMLSTYLE='string'

specifies individual attributes and values for the table or cell.

Applies to:	document
ODS Destinations:	HTML
See:	string

IMAGE=string

specifies the image to appear in the graph. This image can be positioned or tiled.

Applies to:	graphs
ODS Destinations:	HTML
Overridden by:	IBACK= and IMAGESTYLE=TILE options in the SAS/GRAPH GOPTIONS statement
See:	string

INDENT=n

specifies that the output be indented one more indention level, using the number of spaces specified by the INDENT= statement.

Default:	The default value for XML is 2. For all other ODS destinations, the default value is 0.
ODS Destinations:	MARKUP, RTF and PRINTER family

n

specifies the number of spaces that you want the output to indent.

JUST=CENTER | DEC | LEFT | RIGHT

specifies justification. In graphs, this option specifies the justification of the image specified with the IMAGE= statement.

CENTER

specifies center justification.

Alias:

C

DEC

specifies aligning the values by the decimal point.

Alias:

D

LEFT

specifies left justification.

Alias:

L

RIGHT

specifies right justification.

Alias:	R
Restriction:	Not all contexts support RIGHT. If RIGHT is not supported, it is interpreted as CENTER.

Interaction:	If the column is numeric, then values are aligned to the right if you specify JUST=C and JUSTIFY=OFF.
Interaction:	All destinations except LISTING justify the values in columns as if JUSTIFY=ON for JUST=R and JUST=L.
Main discussion:	Values in Table Columns and How They Are Justified
Applied to:	tables, cells, and graphs
ODS Destinations:	HTML, PCL, PDF, PS, and RTF
Tip:	For PRINTER Family destinations and the MARKUP destination, you can use the style attribute JUST= with the style attribute VJUST= in the style element PAGENO to control the placement of page numbers. For example, the following statement would produce a page number that is centered at the bottom of the page: style PageNo from TitleAndFooters / just=c vjust=b;
Tip:	For PRINTER Family destinations and the MARKUP destination, you can control the placement of dates by using the style attribute JUST= with the style attribute VJUST= in any of the following style elements: BODYDATE DATE. For example, the following statement would produce a date in the body file that is left justified at the top of the page: style BodyDate from Date / just=l vjust=t;

LEFTMARGIN= dimension

specifies the left margin for the document.

Applies to:	document
ODS Destinations:	HTML, RTF, PRINTER family
See:	dimension

LINESTYLE= 1...46

controls the line style for a graph. Possible values are SAS/GRAPH line types one through 46. If LINESTYLE=1, then a solid line is drawn. Dashed lines are drawn when values between (and including) two and 46 are specified as the LINESTYLE= value.

Applies to:	graphs
ODS Destinations:	HTML, RTF, PRINTER family
See also:	SAS/GRAPH Software: Reference, Volumes 1 and 2

LINETHICKNESS= dimension | dimension%

specifies the thickness (width) of a line that is part of a graph. This attribute can appear in many style elements that pertain to graphs such as GraphAxisLines and GraphBorderLines. If you specify a percent, it represents a percentage of the width of the window or display.

dimension

is a nonnegative number.

See:

dimension

Restriction:	The LINETHICKNESS= attribute does not apply to output generated as a result of GRSEG (graph segment) output.
Overridden by:	WIDTH= option in the AXIS or SYMBOL statement, or other options that are specific to charts that set line width.
Applies to:	graphs
ODS Destinations:	HTML, RTF, PRINTER Family
See also:	SAS/GRAPH Software: Reference, Volumes 1 and 2

LINKCOLOR=color

specifies the color for links that have not yet been visited.

Applies to:	document
ODS Destinations:	HTML, RTF, and PDF
See:	color

LISTENTRYANCHOR=ON | OFF

specifies whether or not to make this entry in the table of contents a link to the body file.

ON

specifies to make this entry in the table of contents a link to the body file.

OFF

specifies not to make this entry in the table of contents a link to the body file.

Applies to:	document
ODS Destinations:	HTML

LISTENTRYDBLSPACE=ON | OFF

specifies whether or not to double space between entries in the table of contents.

ON

specifies to double space between entries in the table of contents.

OFF

specifies not to double space between entries in the table of contents.

Applies to:	document
ODS Destinations:	HTML

MARKERSIZE=dimension

specifies the size of marker symbols used to represent data values in graphs.

dimension

is a nonnegative number that specifies the size of marker symbols.

Tip:	The MARKERSIZE= attribute is valid only for SAS/GRAPH and ODS statistical graphics.
See:	For a list of marker symbols, see SAS/GRAPH Software: Reference, Volumes 1 and 2.
See:	dimension

MARKERSYMBOL= 'string'

specifies the symbol used to represent data values in graphs.

string

specifies the name of the marker symbol.

Requirement:	string must be enclosed in quotation marks.
See:	string

Tip:	The MARKERSYMBOL= attribute is valid only for SAS/GRAPH and ODS statistical graphics.
See:	For a list of marker symbols, see SAS/GRAPH Software: Reference, Volumes 1 and 2.

NOBREAKSPACE=ON | OFF

specifies how to handle space characters.

ON

does not allow SAS to break a line at a space character.

OFF

allows SAS to break a line at a space character if appropriate.

Applies to:	cells
ODS Destinations:	All

OUTPUTHEIGHT= dimension

specifies the height for a graph or graphics in a document.

Note:   When used with graphs, the OUTPUTHEIGHT=dimension must be specified as a pixel or percentage value. If a unit of measure is not specified with the dimension, then the value will be in pixels. If a unit of measure other than pixels or percentage is specified with the dimension, then the OUTPUTHEIGHT=dimension is not applied to the graph.  

Alias:	CELLHEIGHT=
Restriction:	The OUTPUTHEIGHT= option does not apply to output generated as a result of GRSEG (graph segment) output.
Applies to:	graphs and documents
ODS Destinations:	HTML, RTF, PRINTER family
Overridden by:	YPIXELS= option in the SAS/GRAPH GOPTIONS statement
See:	dimension

OUTPUTWIDTH=dimension | dimension%

specifies the width of a table, line, or a graph. If you specify a percent, it represents a percentage of the width of the window or display.

Note:   When used with graphs, the OUTPUTHEIGHT=dimension must be specified as a pixel or percentage value. If a unit of measure is not specified with the dimension, then the value will be in pixels. If a unit of measure other than pixels or percentage is specified with the dimension, then the OUTPUTHEIGHT=dimension is not applied to the graph.  

dimension

is a nonnegative number.

See:

dimension

Alias:	CELLWIDTH=
Restriction:	The OUTPUTHEIGHT= option does not apply to output generated as a result of GRSEG (graph segment) output.
Tip:	Use OUTPUTWIDTH=100% to make the table or graph as wide as the window that it is open in.
Applies to:	tables and graphs
ODS Destinations:	HTML, RTF, PRINTER family
Overridden by:	XPIXELS= option in the SAS/GRAPH GOPTIONS statement

OVERHANGFACTOR=nonnegative-number

specifies an upper limit for extending the width of the column.

Tip:	Typically, an overhang factor between 1 and 2 works well.
Tip:	The HTML that is generated by ODS tries to ensure that the text in a column wraps when it reaches the requested column width. If you make the overhang factor greater than 1, then the text can extend beyond the specified width.
Applies to:	document
ODS Destinations:	HTML, RTF, PRINTER family

PAGEBREAKHTML='string'

specifies HTML to place at page breaks.

Applies to:	document
ODS Destinations:	HTML
See:	string

POSTHTML='string'

specifies the HTML code to place after the table or cell.

Applies to:	tables or cells
ODS Destinations:	HTML
Featured in:	Modifying the Default Style Definition for the HTML and Markup Languages
See:	string

POSTIMAGE= 'string' | fileref

specifies an image to place before the table or cell.

string

names a GIF or JPEG file. You can use a simple filename, a complete path, or a URL.

See:

string

fileref

is a reference that has been assigned to an external file. Use the FILENAME statement to assign a fileref. (For information, see the FILENAME statement in SAS Language Reference: Dictionary.)

Applies to:	tables or cells
ODS Destinations:	HTML, PCL, PDF, PS, and RTF

POSTTEXT='string'

specifies text to place after the cell or table.

Applies to:	tables or cells
ODS Destinations:	HTML, PCL, PDF, PS, and RTF
See:	string

PREHTML='string'

specifies the HTML code to place before the table or cell.

Applies to:	tables or cells
ODS Destinations:	HTML
See:	string

PREIMAGE= 'string' | fileref

specifies an image to place before the table or cell.

string

names a GIF or JPEG file. You can use a simple filename, a complete path, or a URL.

See:

string

fileref

is a reference that has been assigned to an external file. Use the FILENAME statement to assign a fileref. (For information, see the FILENAME statement in SAS Language Reference: Dictionary.)

Applies to:	tables or cells
ODS Destinations:	HTML, PCL, PDF, PS, and RTF

PRETEXT='string'

specifies text to place before the cell or table.

Applies to:	tables or cells
ODS Destinations:	HTML, PCL, PDF, PS, and RTF
See:	string

PROTECTSPECIALCHARACTERS=ON | OFF | AUTO

determines how less-than signs (<), greater-than signs (>), and ampersands (&) are interpreted. In HTML and other markup languages, these characters indicate the beginning of a markup tag, the end of a markup tag, and the beginning of the name of a file or character entity.

ON

interprets special characters as the characters themselves. That is, when ON is in effect the characters are protected before they are passed to the HTML or other MARKUP destination so that the characters are not interpreted as part of the markup language. Using ON enables you to show markup language tags in your document.

OFF

interprets special characters as markup language tags. That is, when OFF is in effect, the characters are passed to the HTML or other MARKUP destination without any protection so that the special characters are interpreted as part of the markup language.

AUTO

interprets any string that starts with a < and ends with a > as a markup language tag (ignoring spaces that immediately precede the <, spaces that immediately follow the >, and spaces at the beginning and end of the string). In any other string, AUTO protects the special characters from their markup language meaning.

Applies to:	cells
ODS Destinations:	HTML, MARKUP family, PRINTER family, and RTF

RIGHTMARGIN=dimension

specifies the right margin for the document.

Applies to:	document
ODS Destinations:	HTML, RTF, PRINTER family
See:	dimension

RULES=rule-type

specifies the types of rules to use in a table. The following table shows the possible values for rule and their meanings:

This value of rule ...	Creates rules in these locations
ALL	between all rows and columns
COLS	between all columns
GROUPS	between the table header and the table and between the table and the table footer, if there is one
NONE	no rules anywhere
ROWS	between all rows

Applies to:	tables
ODS Destinations:	HTML, RTF, PRINTER family
Featured in:	Defining a Table and Graph Style

STARTCOLOR= color

indicates the start fill color for a graph. It is used to create a gradient effect.

Note:   You can have either a start and end gradient effect or no gradient effect. If you specify a TRANSPARENCY level and you only specify the STARTCOLOR, then the end color will be completely transparent gradationally to the specified start color.  

Applies to:	graphs
ODS Destinations:	HTML
See:	color

TAGATTR='string'

specifies text to insert in the HTML. The string must be valid HTML for the context in which the style element is created. Many style elements are created between <TD> and </TD> tags. To determine how a style element is created, look at the source for the output.

Applies to:	cells
ODS Destinations:	HTML
See:	string

TOPMARGIN=dimension

specifies the top margin for the document.

Applies to:	document
ODS Destinations:	HTML, RTF, PRINTER family
See:	dimension

TRANSPARENCY= dimension

specifies a transparency level. Valid values are 0.0 (opaque) to 1.0 (transparent).

Applies to:	graphs
ODS Destinations:	HTML
See:	dimension

URL='uniform-resource-locator'

specifies a URL to link to from the current cell.

Applies to:	cells
ODS Destinations:	HTML, RTF, and PDF

VISITEDLINKCOLOR=color

specifies the color for links that have been visited.

Applies to:	document
ODS Destinations:	HTML and RTF
See:	color

VJUST=BOTTOM | MIDDLE | TOP

specifies vertical justification. In graphs, this option specifies the vertical justification of the image specified with IMAGE=.

BOTTOM

specifies bottom justification.

Alias:

B

MIDDLE

specifies center justification.

Alias:

M

TOP

specifies top justification.

Alias:

T

Applies to:	cells and graphs
ODS Destinations:	HTML, PCL, PDF, PS, and RTF
Tip:	For PRINTER Family destinations and the MARKUP destination, you can use the style attribute VJUST= with the style attribute JUST= in the style element PAGENO to control the placement of page numbers. For example, the following statement produces a page number that is centered at the bottom of the page: style PageNo from TitleAndFooters / just=c vjust=b;
Tip:	For PRINTER Family destinations and the MARKUP destination, you can control the placement of dates by using the style attribute VJUST= with the style attribute JUST= in any of the following style elements: BODYDATE DATE . For example, the following statement produces a date in the body file that is left justified at the top of the page: style BodyDate from Date / just=l vjust=t;

WATERMARK=ON | OFF

specifies whether or not to make the image that is specified by BACKGROUNDIMAGE= into a "watermark." A watermark appears in a fixed position as the window is scrolled.

ON

specifies to make the image that is specified by BACKGROUNDIMAGE= into a "watermark."

OFF

specifies not to make the image that is specified by BACKGROUNDIMAGE= into a "watermark."

Applies to:	document
ODS Destinations:	HTML

Values for style attributes are one of the following:

Data Values

Values for style attributes are one of the following:

color

is a string that identifies a color. A color can be

• color names that are supported by SAS/GRAPH. These names include

  • a predefined SAS color (for example, blue or VIYG)

  • a red/green/blue (RGB) value (for example, CX0023FF)

  • a hue/light/saturation (HLS) value (for example, H14E162D)

  • a gray-scale value (for example, GRAYBB).

• an RGB value with a leading pound sign (#) rather than CX (for example, #0023FF).

• one of the colors that exists in the SAS session when the style definition is used:

  • DMSBLUE

  • DMSRED

  • DMSPINK

  • DMSGREEN

  • DMSCYAN

  • DMSYELLOW

  • DMSWHITE

  • DMSORANGE

  • DMSBLACK

  • DMSMAGENTA

  • DMSGRAY

  • DMSBROWN

  • SYSBACK

  • SYSSECB

  • SYSFORE.

  Note:   Use these colors only if you are running SAS in the windowing environment.  

• an English description of an HLS. Such descriptions use a combination of words to describe the lightness, the saturation, and the hue (in that order). You can use the Color Naming System to form a color by

  • combining a chromatic hue with a lightness, a saturation, or both

  • combining the achromatic hue gray with a lightness

  • combining the achromatic hue black or white without qualifiers.

  The words that you can use are shown in the following table:

  Lightness	Saturation	Chromatic Hue	Achromatic Hue
  		blue	black *
  very dark	grayish	purple
  dark	moderate	red
  medium	strong	orange | brown	gray **
  light	vivid	yellow
  very light		green
  			white *
  * Black and white cannot be combined with a lightness or a saturation value. ** Gray cannot be combined with a saturation value.

  You can combine these words to form a wide variety of colors. Some examples are

  • light vivid green

  • dark vivid orange

  • light yellow.

Note:   The Output Delivery System first tries to match a color with a SAS/GRAPH color. Thus, although brown and orange are interchangeable in the table, if you use them as unmodified hues, then they are different. The reason for this is that ODS interprets them as SAS colors, which are mapped to different colors.  

You can also specify hues that are intermediate between two neighboring colors. To do so, combine one of the following adjectives with one of its neighboring colors:

• reddish

• orangish

• brownish

• yellowish

• greenish

• bluish

• purplish.

For example, you can use the following as hues:

• bluish purple

• reddish orange

• yellowish green.

See also:

SAS/GRAPH Software: Reference, Volumes 1 and 2 for information about SAS/GRAPH colors.

dimension

is a nonnegative number, optionally followed by one of the following units of measure:

cm	centimeters
em	standard typesetting measurement unit for width
ex	standard typesetting measurement unit for height
in	inches
mm	millimeters
pt	a printer's point

Default:

For the PRINTER destination, units of 1/150 of an inch

font-definition

is the name of a font, the font size, and font keywords. A font definition has the following general format:

("font-face-1 <... , font-face-n>", font-size, keyword-list)

If you specify only one font and if its name does not include a space character, then you can omit the quotation marks. If you specify more than one font , then the destination device uses the first one that is installed on your system.

font-size specifies the size of the font. font-size can be a dimension or a number without units of measure. If you specify a dimension, then you must specify a unit of measure. Without a unit of measure the number becomes a size that is relative to all other font sizes in the document. For more information see dimension.

keyword-list specifies the font weight, font style, and font width. You can include one value for each, in any order. The following table shows the keywords that you can use:

Keywords for Font Weight	Keywords for Font Style	Keywords for Font Width
MEDIUM	ITALIC	NORMAL*
BOLD	ROMAN	COMPRESSED*
DEMI_BOLD*	SLANT	EXTRA_COMPRESSED*
EXTRA_BOLD*		NARROW*
LIGHT		WIDE*
DEMI_LIGHT*		EXPANDED*
EXTRA_LIGHT*
* Few fonts honor these values.

Featured in:

Creating and Modifying a Style Definition with User-Defined Attributes

format

is a SAS format or a user-defined format.

reference

is a reference to an attribute that is defined in the current style definition or in the parent style definition (or beyond). The value that you use is the name of the style element followed by the name of an attribute, in parentheses, within that element. For example, suppose that you create a style element called DATACELL that uses the FOREGROUND= and BACKGROUND= style elements this way:

style datacell / background=blue
                 foreground=white;

Later, you can ensure that another style element, NEWCELL, uses the same background color by defining it this way:

style newcell / background=datacell(background);

Similarly, suppose that you create a style element called HIGHLIGHTING that defines three attributes this way:

style highlighting /
   "go"=green
   "caution"=yellow
   "stop"=red;

Later, you can define a style element called MESSAGES that uses the colors that are defined in HIGHLIGHTING:

style messages;
   "note"=highlighting("go")
   "warning"=highlighting("caution")
   "error"=highlighting("stop");

In this way, multiple style elements could use the colors that you define in HIGHLIGHTING. If you decide to change the value of go to blue, you simply change its value in the definition of HIGHLIGHTING, and every style element that references highlighting ("go") will use blue instead of green.

Note:   In the first example, the style attribute BACKGROUND= is a predefined style attribute. Therefore, when you reference it, you do not put it in quotation marks. However, in the second example, go is a user-defined attribute. You define it with quotation marks, and when you reference it, you must use quotation marks.   

You can use a special form of reference to get a value for a style attribute from the macro table at the time that the style element is used. For example, the following STYLE statement uses the current value of the macro variable bkgr for the background color of the style element cell:

style cell / background=symget("bkgr");

Featured in:

Creating and Modifying a Style Definition with User-Defined Attributes

'string'

is a quoted character string.

Copyright © 2006 by SAS Institute Inc., Cary, NC, USA. All rights reserved.