Document Types > Modify Attributes Dialog Box .dcf Settings > Defining Categories for Attributes
  
Defining Categories for Attributes
You can define categories for attributes in the document type configuration file (.dcf) for the XUI document. Once the categories are configured, the Modify Attributes dialog box will be displayed in a tabbed layout based on those categories when it is invoked for any element in that document type.
The sample markup below will configure three categories of attribute to be displayed as tabs in the Modify Attributes dialog box for all elements in the XUI document type. The categories are: Item (attributes id and resize), Font (attributes family and fontstyle), and Event (attributes ev:defaultAction and ev:event). The dialog box will also include another tab Other, which displays all other attributes not included in any of the previous three categories.
<ModifyAttributeDialog>
<ModifyAttributeCategories>
<ModifyAttributeCategory name="all-item" sort="no"
label="Item" default="yes">
<ModifyAttributeCategoryAttribute name="id"/>
<ModifyAttributeCategoryAttribute name="resize"/>
</ModifyAttributeCategory>
<ModifyAttributeCategory name="all-font" sort="no"
label="Font" default="yes">
<ModifyAttributeCategoryAttribute name="family"/>
<ModifyAttributeCategoryAttribute name="fontstyle"/>
</ModifyAttributeCategory>
<ModifyAttributeCategory name="all-event" sort="yes"
label="Event" default="yes">
<ModifyAttributeCategoryAttribute name="ev:defaultAction"/>
<ModifyAttributeCategoryAttribute name="ev:event"/>
</ModifyAttributeCategory>
</ModifyAttributeCategories>
</ModifyAttributeDialog>
DCF Markup for Attribute Category Configuration
Element Name
Attribute Name
Description
ModifyAttributeDialog
Wrapper element for markup that configures the Modify Attributes dialog box for the document type.
ModifyAttributeCategories
Wrapper element in a ModifyAttributeDialog element that defines the list of attribute categories for the document type.
ModifyAttributeCategory
Wrapper element in a ModifyAttributeCategories element that defines a specific attribute category.
name
Name used to identify the attribute category. This attribute is not defined as a ID, but its value is used as an ID within the Modify Attributes dialog box XUI document. It is recommended that this value follows the requirements for an ID.
type
Specifies an internal category type that Arbortext Editor can determine from either the document type definition or other markup from the DCF file.
• required — category of required attribute as defined by the document type definition. If this category is selected for one or more elements, then all required attributes will appear in this tab, taking priority over configuration of other tabs. If this category is not selected, then the required attributes will appear in the first category in the order that references that attribute.
• profiling — category of profiling attributes as defined in the DCF file. If this category is selected for one or more elements, then all profiling attributes will appear in this tab, taking priority over configuration of other tabs. If this category is not selected, then the profiling attributes will appear in the first category in the order that references that attribute.
• other — category of attributes that are not assigned to another category. This category is always used so no attribute is omitted from the dialog. Administrators should use the dialogHidden attribute for the attributeOption element to suppress attributes.
label
Descriptive text used to describe the category. It appears as the tab label in the dialog box.
default
Indicates whether this category is used for all elements that are not assigned categories. The order of these elements in the list determines the order that the default categories appear in the dialog. Possible values are yes and no (default).
sort
Indicates whether this category should have its attributes sorted alphabetically. Possible values are yes(default) and no.
ModifyAttributeCategoryAttribute
Child element of a ModifyAttributeCategory element that specifies the name of an attribute to include within that specified category.
name
The attribute name.