Home
HCL Domino Designer XPages User Guide
This guide focuses on the aspects of creating applications using XPages technology.
Designing XPages applications
HCL Domino® Designer provides the means to populate an XPage with controls and other artifacts, and to associate an XPage with data stores.
Adding controls
Controls are visual elements such as edit boxes, buttons, images, and text that allow users to manipulate data on an XPage.
Property reference
Specified here are the XPages properties.
role - Control Identifier
Provides a role for the use of assistive technologies.

HCL Domino Designer XPages User Guide
This guide focuses on the aspects of creating applications using XPages technology.
- Product overview
  HCL Domino® Designer supports applications development for the HCL Domino platform using XPages, forms, views, and other elements such as controls.
- Tutorials
  This section contains tutorials and information about tutorials.
- Administering applications
  HCL Domino Designer provides features for administering and managing your work and related files while developing your application projects.
- Designing XPages applications
  HCL Domino® Designer provides the means to populate an XPage with controls and other artifacts, and to associate an XPage with data stores.
  - Previewing and running XPages
    XPages run in Domino® server and Notes® client environments. From Domino Designer, you can preview XPages in both environments.
  - Adding controls
    Controls are visual elements such as edit boxes, buttons, images, and text that allow users to manipulate data on an XPage.
    - Manipulating controls and text
      You can add controls and text to an XPage using the Design or Source editor. The Controls palette provides a source for controls.
    - Using an extension point to override design time tooling for Core and Extension Library controls
      An extension point is provided to let you override design time tooling for the Core and Extension Library controls that are shipped with Designer.
    - Setting properties
      Properties define XPages and controls.
    - Understanding events
      Events are actions that a user might perform such as clicking a button or removing focus from an edit box. Event handlers are actions that you (the designer) perform in response to events.
    - Understanding facets
      A facet defines a region in a control for the placement of other controls.
    - Understanding Dojo widgets
      Dojo widgets are prepackaged JavaScript™ code, HTML, and CSS declarations that enhance the appearance and use of controls in both a browser and the Notes® client.
    - Control reference
      Specified here are the XPages controls.
    - Property reference
      Specified here are the XPages properties.
      - accept - Accept
        Lists an acceptable MIME type for the uploaded file.
      - accesskey - Accelerator
        Specifies a character used in conjunction with the ALT key to put focus on a control.
      - acl - Access Control List
        Defines an access control list for a page or control.
      - action - Application Action
        Specifies the MethodBinding application action to invoke when the user activates the control.
      - actionListener - Action Listener
        Specifies the MethodBinding action listener to be notified when the user activates the control.
      - actionListeners - Action Listener List
        Specifies a collection of action listeners.
      - afterPageLoad - After Page Load Method Binding
        Activates an event handler after a page loads.
      - afterRenderResponse - After Render Response Method Binding
        Activates an event handler after the Render Response phase of the JSF cycle.
      - afterRestoreView - After Restore View Method Binding
        Activates an event handler after the Restore View phase of the JSF cycle.
      - align - Alignment
        Aligns content in a container.
      - allowDelete - Allow File Delete
        Allows users to delete attached files or not.
      - alt - Alternate Text
        Specifies text to display when an image cannot be rendered.
      - alwaysCalculateLast - Always Calculate Last
        Always calculates the last document in a container.
      - ariaLabel - ARIA Label (property)
        Specifies descriptive text for an assistive technologies label for a control.
      - attrs - Attribute List
        Adds attributes to a control. Use this property only where attributes are not available as properties.
      - autocomplete - Automatically Complete
        Enables or disables the browser feature for remembering and automatically completing user input.
      - beforePageLoad - Before Page Load Method Binding
        Activates an event handler before a page loads.
      - beforeRenderResponse - Before Render Response Method Binding
        Activates an event handler before the Render Response phase of the JSF cycle.
      - bgcolor - Background Color
        Specifies the background color.
      - binding - Control Binding
        Specifies an expression that binds the control to a control property.
      - border - Table Border
        Specifies the width in pixels of the border around a table or group of controls.
      - caption - Caption
        Displays a caption above a container control.
      - captionStyleClass - Caption CSS Style Classes
        Specifies a list of CSS classes to be applied to a table caption.
      - cellpadding - Cell Padding
        Specifies the space between a table cell border and its content in pixels.
      - cellspacing - Cell Spacing
        Specifies the space between a table border and cells, and between cells in pixels.
      - charset - Character Set
        Specifies the character encoding of the retrieved resource.
      - checkedValue - Value when checked
        Specifies the value of a data element bound to a selected (as opposed to cleared) control.
      - collapsedImage - Collapsed Section Image
        Specifies an image for a collapsed section.
      - cols - Columns
        Specifies the number of columns to display.
      - colspan - Column Span
        Specifies the number of columns spanned by the current cell.
      - columnClasses - Column CSS Classes
        Specifies a list of CSS classes to be applied to view or table columns.
      - columnName - Column Name
        Specifies the name of the underlying view column in the data source.
      - componentId - Control ID
        Specifies the identifier of a control on an included page.
      - computeDocument - Compute Document Method Binding
        Activates an event handler when a document is computed or recomputed.
      - containerStyleClass - CSS Container Style Classes
        Specifies a list of CSS classes to be applied when a container control is rendered.
      - contentStyleClass - Tab Content Class
        Specifies a list of CSS classes to be applied to tab content if it does not have a style.
      - contentType - Content Type
        Specifies the content type, text or HTML.
      - converter - Converter
        Defines the data format if it is not string.
      - coords - Coordinates
        Specifies the position and shape of a hot spot on the screen for use in client image maps,
      - createdStyleClass - Created Style Class
        Specifies a list of CSS classes to be applied to a Created On column.
      - createdTitle - Created Title
        Specifies an alternate title for a Created On header.
      - createdValue - Created Value Binding
        Overrides the value of the creation date.
      - createForm - Create Form Flag
        Creates a form element or not.
      - currentStyleClass - Current Page Style Classes
        Specifies a list of CSS classes to be applied to the current page control if it does not have a style.
      - data - Data Source
        Defines data sources for a page or control.
      - dataContexts - Control Data Contexts
        Defines data contexts.
      - dataTableStyle - Data Table CSS Styles
        Specifies a list of CSS styles to be applied to a view data table.
      - dataTableStyleClass - Data Table CSS Style Classes
        Specifies a list of CSS style classes to be applied to a view data table.
      - defaultChecked - Checked by Default
        Specifies whether a control is initially selected or cleared.
      - defaultLinkTarget - Page Base URL Used by Links
        Specifies how a target page opens by default on the Notes® client.
      - defaultSelected - Default Selected
        Specifies whether a control is initially selected or cleared.
      - defaultValue - Default Value
        Specifies an initial value for a bound data element.
      - defer - Defer Script
        Indicates that the script does not output document content, for example, with a document.write statement.
      - deleteImageTitle - Delete File Image Title
        Specifies the text that appears when the user mouses over the delete icon.
      - deleteMessage - Delete File Message
        Specifies the body of the dialog that verifies deletion of the attached file.
      - deleteStyleClass - Delete Style Class
        Specifies a list of CSS classes to be applied to a Delete column.
      - dir - Direction
        Specifies text direction for a control that does not inherit its direction.
      - disableClientSideValidation - Disable Client Side Validation
        Disables or enables client side validation.
      - disabled - Disabled
        Disables a control or not.
      - disabledClass - Disabled Label Class
        Specifies the CSS style class to apply to the label for the disabled list.
      - disableModifiedFlag - Disable Modified Flag
        Disables or enables modified notifications for a control.
      - disableTheme - Disable Theme
        Disables the theme or not.
      - disableValidators - Disable Validators
        Disables execution of validators or not.
      - displayAs - Display Fields As Links
        Displays a selected item as plain text or a link to the underlying document.
      - displayCreated - Display Created
        Displays the creation date or not.
      - displayLastModified - Display Last Modified
        Displays the modification date or not.
      - displaySize - Display File Size
        Displays the file size or not.
      - displayType - Display File Type
        Displays the file type or not.
      - dojoArgs - Dojo Arguments
        Specifies a list of dojo arguments for output to the script tag.
      - dojoAttributes - Dojo Attributes
        Specifies a list of Dojo attributes.
      - dojoEvent - Dojo Event
        Specifies a dojo event or function name for output to the script tag.
      - dojoForm - Create a Dojo Form
        Creates or does not create a dojo form element for the page.
      - dojoParseOnLoad - Trigger Dojo Parser on Load
        Starts or does not start the dojo parser when the page is loaded.
      - dojoStoreType - Dojo Store Type
        Overrides the default dojo type used to create the data store for a control.
      - dojoTheme - Use Dojo Theme
        Uses or does not use a dojo theme.
      - dojoType - Dojo Type
        Specifies the default Dojo type for creating a control.
      - enabledClass - Enabled Label Class
        Specifies the CSS style class to apply to the label for the enabled list.
      - enableModifiedFlag - Enable Modified Flag
        Allows saving a modified page if the user navigates away.
      - endTabStyleClass - End Tab Class
        Specifies a list of CSS classes to be applied to the end tab if it does not have a style.
      - errorClass - Error Class
        Specifies a list of CSS style classes to be applied to messages with a severity of error.
      - errorStyle - Error CSS Styles
        Specifies a list of CSS styles to be applied to messages with a severity of error.
      - escape - Escape Characters
        Indicates whether to escape characters that can be mistaken for XML and HTML markup.
      - event - Event
        Specifies the name of this event.
      - eventHandler - Event Handler (property)
        Specifies scripts and simple actions to be executed when a control event occurs.
      - eventName - Event Name
        Specifies the name of a platform event.
      - exclude - Exclude
        Lists an excluded MIME type for the uploaded file.
      - execId - Fragment to Execute
        Specifies the fragment of the page to execute.
      - execMode - Execution Mode
        Determines the execution mode: complete or partial.
      - expandedImage - Expanded Section Image
        Specifies an image for an expanded section.
      - facetName - Facet Name
        Identifies a facet region.
      - fatalClass - Fatal Class
        Specifies a list of CSS style classes to be applied to messages with a severity of fatal.
      - fatalStyle - Fatal Styles
        Specifies a list of CSS styles to be applied to messages with a severity of fatal.
      - filename - File Name
        Specifies the name of an uploaded file.
      - fileNameHrefValue - File Name URL
        Overrides a file name reference with a URL to the file.
      - fileNameTitle - File Name Title
        Specifies an alternate title for a File Name header.
      - fileNameValue - File Name Value
        Specifies an alternate value for a File Name column.
      - first - First Row Index
        Specifies the number of the first row to be displayed.
      - firstStyleClass - First Page Style Class
        Specifies a list of CSS classes to be applied to the first page control if it does not have a style.
      - footerClass - Footer CSS Style Classes
        Specifies a list of CSS style classes to be applied to footers.
      - for - Associated Client ID
        Specifies a control for which to display error messages.
      - for - For Identifier
        Directs pager actions to a data control.
      - for - Select Target Control
        Redirects focus to another control on the XPage.
      - frame - Table Frame
        Specifies how a table is framed.
      - frequency- Frequency
        Specifies the minimum time in seconds before triggering a server request.
      - globalOnly - Global Only
        Displays only messages not associated with a control or displays all messages.
      - groupName - Group Name
        Assigns a radio button to a group.
      - handlers - Event Handlers
        Specifies a collection of event handlers to be executed.
      - header - Section Header Text
        Specifies a visible label for the top of a section.
      - headerClass - Header CSS Classes
        Specifies a list of CSS style classes to be applied to headers.
      - headerStyle - Section Header CSS Styles
        Specifies a list of CSS classes to be applied to a section header.
      - height - Height
        Specifies the height of a control.
      - hideWhen - Hide When Unavailable
        Hides a file download control when no attachments are available for download.
      - href - Link Location
        Redirects the user to a specified location.
      - hreflang - Language
        Specifies the language and country code of a retrieved resource.
      - htmlConversionWarning - HTML Conversion Warning
        Displays a warning when a document is saved with conversion from HTML to rich text.
      - htmlFilter - HTML Filtering Processor Name Sending
        Specifies an Active Content Filtering (ACF) processor for sending data.
      - htmlFilterIn - HTML Filtering Processor Name Receiving
        Specifies an Active Content Filtering (ACF) processor for receiving data.
      - icon - Icon URL
        Specifies the path for an icon.
      - iconAlt - Icon Alternate Text
        Specifies descriptive text for an icon.
      - iconSrc - Icon Source
        Displays an icon before the content of a column.
      - id - Name
        Identifies a control uniquely among all controls on a page.
      - ignoreCase - Ignore Case
        Indicates whether type ahead honors or ignores case.
      - image - Image (property)
        Specifies an image.
      - imageAlt - Image Alternate Text (property)
        Specifies alternate text for an image when the image cannot be displayed.
      - immediate - Immediate Action
        Notifies listeners or converts and validates data immediately during the Apply Request Values phase rather than later during the Invoke Application or Process Validation phase.
      - indentResponses - Indent Responses
        Indents response documents or not.
      - indexVar - Index Variable
        Specifies the name of a variable to make the row index available for children.
      - infoClass - Info CSS Style Classes
        Specifies a list of CSS style classes to be applied to messages with a severity of info.
      - infoStyle - Info CSS Styles
        Specifies a list of CSS styles to be applied to messages with a severity of info.
      - initClosed - Initially Closed Value
        Initially closes a section or not.
      - ismap - Image Map Flag
        Uses a server-side image map or not.
      - itemDescription - Item Description
        Describes a selection item.
      - itemDisabled - Item Disabled
        Describes a selection item.
      - itemLabel - Item Label
        Displays text for a selection item.
      - itemValue - Value
        Specifies a value to return to the parent control when the user selects an item.
      - label - Label (property)
        Specifies the visible label for a control.
      - lang - Language Code
        Specifies a language and country code.
      - lastModifiedTitle - Last Modified Title
        Specifies an alternate title for the Modified column header.
      - lastModifiedValue - Last Modified Value Binding
        Specifies an alternate value for the Modified column.
      - lastStyleClass - CSS Tab Last Style Classes
        Specifies a list of CSS classes to be applied to the last page control if it does not have a style.
      - layout - Layout (property 1)
        Specifies the direction of grouped controls, horizontal or vertical.
      - layout - Layout (property 2)
        Specifies the layout for displaying multiple error messages.
      - layout - Pager Layout
        Specifies how buttons appear in a pager control.
      - legend - Group Description
        Provides a screen readable group description for a control.
      - loaded - Loaded
        Creates a control when the page is loaded or not.
      - longdesc - Long Description
        Specifies the URI of a long description for a resource.
      - maxlength - Maximum Length
        Specifies a maximum number of characters that the user can enter into a control.
      - maxValues - Maximum Values
        Specifies a maximum number of selections to display.
      - middleTabStyleClass - CSS Middle Tab Style Classes
        Specifies a list of CSS classes to be applied to each middle tab if it does not have a style.
      - mimetype - MIME Type
        Forces the MIME type of the uploaded file.
      - minchars - Minimum Characters
        Specifies the minimum characters that the user must type to trigger type ahead.
      - mode - Mode
        Specifies the retrieval mode for the dropdown list for type ahead.
      - modifiedControl - Modified Control
        Specifies the control whose action to execute if the user navigates away from a modified page and elects to save the page.
      - modifiedMessage - Modified Message
        Specifies the message to display if the user navigates away from a modified page.
      - modifiedStyleClass - Modified CSS Style Classes
        Specifies a list of CSS classes to be applied to a Modified column.
      - multiple - Multiple Selection
        Allows multiple items to be selected.
      - multipleSeparator - Multiple Values Separator
        Specifies the character that separates elements of input for a control bound to a multi-value element.
      - multipleTrim - Multiple Trim
        Removes leading and trailing white space from each element of multi-value input.
      - nameStyleClass - Name CSS Style Classes
        Specifies a list of CSS classes to be applied to a Name column.
      - navigate - Navigate
        Indicates if the result of an action is used to navigate to another page.
      - navigationRules - Navigation Rules
        Specifies rules for navigating from a page.
      - onblur - Focus Off Script
        Activates an event handler when a control loses focus.
      - onchange - Input Change Script
        Activates an event handler when a control loses focus and its value changed since last gaining focus.
      - onclick - Click Script
        Activates an event handler when a mouse click occurs.
      - onClientLoad - On Client Load
        Activates event handlers when a page or panel loads to the client.
      - onComplete - On Complete Event
        Executes a client script after a server request.
      - ondblclick - Double Click Script
        Activates an event handler when a mouse double click occurs.
      - onError - On Error Event
        Executes a client script if an error occurs on a server request.
      - onevent - On Event
        Specifies a client script that responds to a platform event.
      - onfocus - Focus On Script
        Activates an event handler when a control gains focus.
      - onkeydown - Key Down Script
        Activates an event handler when a control receives a key press.
      - onkeypress - Key Press Script
        Activates an event handler when a control receives a key press and release.
      - onkeyup - Key Up Script
        Activates an event handler when a control receives a key release.
      - onmousedown - Mouse Down Script
        Activates an event handler when a control receives a mouse press.
      - onmousemove - Mouse Move Script
        Activates an event handler when a control receives a mouse movement.
      - onmouseout - Mouse Out Script
        Activates an event handler when a control receives a mouse away movement.
      - onmouseover - Mouse Over Script
        Activates an event handler when a control receives a mouse over movement.
      - onmouseup - Mouse Up Script
        Activates an event handler when a control receives a mouse release.
      - onselect - Text Select Script
        Activates an event handler when existing text in a control is selected.
      - onStart - On Start Event
        Executes a client script before a server request.
      - openDocAsReadonly - Open Document As Read-only
        Prohibits an underlying document opened through a link from being edited.
      - outerStyleClass - CSS Outer Style Classes
        Specifies a list of CSS outer classes to be applied when a control is rendered.
      - pageBaseUrl - Page Base URL Used by Links
        Generates an icon for a page.
      - pageCount - Page Count
        Specifies the number of pages in a group control.
      - pageIcon - Page Icon
        Generates an icon for a page.
      - pageManifest - Page Manifest
        Specifies an HTML5 manifest attribute to add to the HTML for the XPage.
      - pageName - Page Name (property)
        Opens a selected document using a specified page.
      - pageName - Page Name (for Include property)
        Specifies the name of an included page.
      - pageTitle - Page Title
        Generates a title for a page.
      - pageUrl - Page URL
        Opens a URL when the user clicks a link.
      - panelPosition - Navigator Position
        Specifies the location of a pager in a container.
      - parameters - Parameters
        Specifies parameters passed to a retrieved resource.
      - partialExecute - Partial Execute
        Executes only the parent control.
      - partialRefresh - Partial Refresh
        Refreshes only the parent control upon a partial refresh, for example, collapsing or expanding a view.
      - password - Password
        Masks user input to a control by echoing asterisks.
      - postNewDocument - Post New Document Method Binding
        Activates an event handler after a document is created.
      - postOpenDocument - Post Open Document Method Binding
        Activates an event handler after a document is opened.
      - postOpenview - Post Open View Method Binding
        Activates an event handler after a view is opened.
      - postSaveDocument - Post Save Document Method Binding
        Activates an event handler after a document is saved.
      - preventFiltering - Prevent Filtering
        Prevents filtering a list of values using the submitted user value.
      - properties - Properties
        Specifies parameters and values.
      - queryNewDocument - Query New Document Method Binding
        Activates an event handler before a document is created.
      - queryOpenDocument - Query Open Document Method Binding
        Activates an event handler before a document is opened.
      - queryOpenview - Query Open View Method Binding
        Activates an event handler before a view is opened.
      - querySaveDocument - Query Save Document Method Binding
        Activates an event handler before a document is saved.
      - readMarksClass - Read Marks Style Class
        Specifies a list of CSS style classes to be applied to read view entries.
      - readonly - Read Only Flag
        Makes a control read-only or editable.
      - readonly - Read Only
        Generates a span element instead of a label element.
      - redisplay - Redisplay Flag
        Renders any existing value bound to the control.
      - refreshId - Fragment to Refresh
        Specifies the fragment of the page to refresh.
      - refreshMode - Refresh Mode
        Determines the refresh mode: complete, partial, or none.
      - rel - Relationship
        Specifies the relationship between the current document and the referenced anchor.
      - removeRepeat - Remove Repeat
        Removes the repeat after repeating its content.
      - rendered - Visible
        Makes a control visible or not.
      - rendererType - Renderer Type
        Specifies a renderer to encode and decode a control.
      - repeatControls - Repeat Controls
        Creates controls multiple times or iterates over the single set of controls.
      - required - Required Flag
        Enforces the submission of a value for a control.
      - resources - Resources
        Specifies resources for a page.
      - rev - Reverse Link
        Specifies a reverse link from the referenced anchor to the current document.
      - role - Control Identifier
        Provides a role for the use of assistive technologies.
      - rowAttrs - Row Attribute List
        Adds attributes to a row. Use this property only where attributes are not available as properties.
      - rowClasses - Row CSS Classes
        Specifies a list of CSS style classes to be applied to view or table rows.
      - rows - Rows
        Specifies the maximum number of rows to display.
      - rowspan - Row Span
        Specifies the number of rows spanned by the current cell.
      - rules - Table Rules
        Specifies rules between table cells.
      - save - Save
        Indicates if a save should occur after an action.
      - script - Client Script
        Specifies a client script.
      - selectedTab - Selected Tab
        Identifies the tab that gets initial focus in a tabbed panel.
      - selectedTabStyleClass - Selected Tab Class
        Specifies a list of CSS classes to be applied to the selected tab if it does not have a style.
      - selectedValue - Selected Value
        Specifies the value of a data element bound to a selected (as opposed to cleared) control.
      - selectedValues - Selected Values
        An alias for the value property.
      - shape - Shape
        Specifies the shape of a hotspot on the screen for client image maps.
      - showCheckbox - Show Check Box
        Displays a check box before the column content.
      - showColumnHeader - Show Column Header
        Displays the column headers or not.
      - showDetail - Show Detail
        Displays the detail portion of a message or not.
      - showReadonlyAsDisabled - Show disabled control for read-only
        Displays a read-only control as disabled.
      - showSummary - Show Summary
        Displays the summary portion of a message or not.
      - showUnreadMarks - Show Unread Marks
        Displays unread marks or not.
      - size - Size
        Specifies the number of characters that the user can enter into a control at once.
      - sizeStyleClass - Size Style Class
        Specifies a list of CSS classes to be applied to a Size column.
      - sizeTitle - File Size Title
        Specifies an alternate title for a File Size header.
      - sizeValue - File Size Value Binding
        Specifies an alternate value for a Size column.
      - skipContainers - Skip Containers
        Skips a specified number of named containers to assign a group.
      - sortable - Sortable
        Makes a column sortable by the user at run time.
      - src - Import Script File
        Imports a script from a different application or domain.
      - startTabStyleClass - Start Tab Class
        Specifies a list of CSS classes to be applied to the start tab if it does not have a style.
      - style - CSS Styles
        Specifies font styles for a control.
      - styleClass - CSS Style Classes
        Specifies a list of CSS classes to be applied when a control is rendered.
      - submit - Submit
        Indicates if a request should be submitted to the server after an action.
      - summary - Description
        Provides a screen readable description of a control.
      - tabindex - Tab Index
        Specifies the order in which a control gets focus when the user presses the Tab key.
      - tagName - Tag Name
        Specifies a markup tag for the control.
      - target - Target Frame
        Specifies how a target page opens.
      - text - Label
        Attaches a visible label to a control.
      - themeId - Theme ID
        Specifies a theme for setting component properties.
      - timeClickableIncrement - Clickable Increment
        Specifies the amount by which a clickable time element increases.
      - timeVisibleIncrement - Visible Increment
        Specifies the amount by which a visible time element increases.
      - timeVisibleRange - Visible Range
        Specifies the range of a time picker.
      - title - Advisory Title
        Provides a screen readable title for a control.
      - tokens - Tokens
        Specifies client separators in the case where the user machine specifies suggestions.
      - tooltip - Tool Tip
        Displays the detail portion of a message as a tool tip or not.
      - type - Type (button)
        Describes the function of a button.
      - type - Type (input control)
        Specifies the type of input control.
      - type - Navigation Control Type
        Specifies the type of navigation control.
      - type - Section Type
        Specifies the formatting for a section.
      - type - Scripting Language Type
        Specifies the scripting language.
      - typeStyleClass - Type Style Class
        Specifies a list of CSS classes to be applied to a Type column.
      - typeTitle - File Type Title
        Specifies an alternate title for a File Type header.
      - typeValue - File Type Value
        Specifies an alternate value for a File Type column.
      - uncheckedValue - Unchecked Value
        Specifies the value of a data element bound to a cleared (as opposed to selected) control.
      - unreadMarksClass - Unread Marks Style Class
        Specifies a list of CSS style classes to be applied to unread view entries.
      - unselectedTabStyleClass - Unselected Tab Class
        Specifies a list of CSS classes to be applied to each unselected tab if it does not have a style.
      - url - Source URL
        Specifies the path to an external resource.
      - usemap - Use Image Map
        Uses a client-side image map.
      - useUploadname - Use Upload Name
        Retains the original name of a file for an attachment or not.
      - validator - Validator
        Specifies a validator method called during Process Validations of MethodBinding to perform check the value of the control.
      - validators - Validators List
        Enforces requirements for data entry.
      - valign - Vertical Alignment
        Aligns content vertically in a container.
      - value - Value (control and data binding)
        Binds a control to a data element or other value.
      - value - Script Value
        Specifies a client script.
      - value - Value (label or target assignment)
        Assigns a label or target to a control.
      - valueChangeListener - Value Change Listener
        Specifies a listener method that is notified when a new value is set.
      - valueChangeListeners - Value change listeners
        Specifies a collection of value change listeners.
      - valueList - Value List
        Specifies suggestions returned when its initial characters are entered.
      - valueListSeparator - Value List Separator
        Specifies ta character that separates suggestions in the suggestions string.
      - valueMarkup - Value Markup
        Indicates whether a value list contains an XML markup fragment rather than a list.
      - var - Var
        Specifies the name of a variable to make row data available.
      - var - Variable
        Specifies the name of a request scope variable being used by the control.
      - viewState - View State
        Defines how the view state is maintained.
      - viewStyle - View Panel CSS Styles
        Specifies a list of CSS styles to be applied to a view panel.
      - warnClass - Warning Class
        Specifies a list of CSS style classes to be applied to messages with a severity of warn.
      - warnStyle - Warning Styles
        Specifies a list of CSS styles to be applied to messages with a severity of warn.
      - viewStyleClass - View CSS Style Classes
        Specifies a list of CSS classes to be applied to a view panel.
      - width - Table Width
        Specifies the width of a control.
    - Designing with custom controls in XPages
      A custom control is a collection of controls that are stored as a single object. Similar to the way a subform can be placed on more than one form, a custom control can be created once and added to multiple XPages. When you update a custom control, every XPage that uses that custom control automatically gets updated with the changes. This saves you design time because you do not have to update each XPage separately.
  - Adding controls from the XPages Extension Library
    The XPages Extension Library provides additional controls ready to use. The controls include an application layout object, an improved dialog, pickers, in place forms, Dojo components, dynamic content, and much more. The controls support enhancements to the Domino(r)® templates.
  - Binding and submitting data
    The data store for XPages is Domino®. You can access the data store through Domino forms and views.
  - Adding images, styles, and themes
    You can enhance your design with images, styles, and themes.
  - Responsive web design support in XPages
    The XPages Extension Library supports Bootstrap, a Responsive Web Design (RWD) framework. This support comes in the form of an XPages Responsive Bootstrap plugin that you can use in your XPages applications.
- Designing composite applications
  You can create composite applications from XPages.
- Programming
  XPages uses JavaScript™ for programming while the forms-based design elements use the formula language, LotusScript®, Java™, and JavaScript.

role - Control Identifier

Provides a role for the use of assistive technologies.

Syntax

role="description"

Usage

In Design mode, click All Properties and look for role under accessibility.

This property implements the W3C ARIA specification on roles at http://www.w3.org/TR/wai-aria/#Using_intro. Screen readers such as JAWS use roles to acquire contextual information about HTML pages. For valid values, see http://www.w3.org/TR/wai-aria/#roles.

Starting with 9.0.1, this property is obsolete for xp:tabbedPanel, xp:tabPanel, xp:pager, and xp:pagerControl. By default the appropriate compliant value is generated. For compliance with accessibility standards, do not specify a value for this property for those controls.

Examples

This Edit Box control provides a title and role for accessibility.

<xp:inputText id="inputText1" value="#{document1.subject}"
	title="Subject edit box" role="end user">
/xp:inputText>

role - Control Identifier

Category

Syntax

Usage

Examples