Newer Version Available

This content describes an older version of this product. View Latest

apex:pageMessages

This component displays all messages that were generated for all components on the current page, presented using the Salesforce styling.

Use this component to get user input for a controller method that does not correspond to a field on an sObject. Only <apex:inputfield> and apex:outfield can be used with sObject fields.

Example

1<apex:page standardController="Opportunity" recordSetVar="opportunities"
2    tabStyle="Opportunity" sidebar="false">
3    <p>Enter an alphabetic character for the "Close Date," 
4       then click Save to see what happens.</p>
5    <apex:form >
6        <apex:pageBlock >
7        <apex:pageMessages />
8        <apex:pageBlockButtons >
9            <apex:commandButton value="Save" action="{!save}"/>
10        </apex:pageBlockButtons>
11            <apex:pageBlockTable value="{!opportunities}" var="opp">
12                <apex:column value="{!opp.name}"/>
13                <apex:column headerValue="Close Date">
14                    <apex:inputField value="{!opp.closeDate}"/>
15                </apex:column>
16            </apex:pageBlockTable>
17        </apex:pageBlock>
18    </apex:form>
19</apex:page>

Attributes

Attribute Name Attribute Type Description Required? API Version Access
escape Boolean A Boolean value that specifies whether sensitive HTML and XML characters should be escaped in the HTML output generated by this component. If you do not specify escape="false", the character escape sequence displays as written. Be aware that setting this value to "false" may be a security risk because it allows arbitrary content, including JavaScript, that could be used in a malicious manner. 14.0
id String An identifier that allows the component to be referenced by other components in the page. 14.0 global
rendered Boolean A Boolean value that specifies whether the component is rendered on the page. If not specified, this value defaults to true. 14.0 global
showDetail Boolean A Boolean value that specifies whether to display the detail portion of the messages. If not specifed this value defaults to false. 14.0