修改属性对话框
使用修改属性对话框中的设置可设置或更改光标左侧的标注的属性值。如果光标左侧的标注是实体引用、标记部分、备注、不带属性的元素或处理指令，则修改属性对话框不可用。
此对话框中的属性和可用属性值取决于所选元素和文档类型。
|
|
如果已对文档应用了 别名映射，则对于已分配别名的属性和属性值，此对话框将列出别名而非实际名称。 如果别名映射包含属性说明，当将光标置于带说明的属性标签之上时，该说明将显示在修改属性对话框的底部。
|
默认情况下，属性按类别分组且对话框会基于这些类别显示在选项卡布局中。文档类型管理员可对文档类型的 DCF 文件中的属性类别进行定义。有关要使用的标注信息，请参考
定义属性类别。
对于 XML 文档类型，属性通常按字母顺序列出。如果已对属性进行分类，则可以使用 DCF 文件中的
ModifyAttributeCategory 的
sort 属性对其进行排序。对于 SGML 文档，默认情况下属性名称以在文档类型中定义的顺序列出。要按字母顺序列出属性，请将
高级首选项modifyattrsorted 的值设置为
on。
修改属性对话框包含以下特征：
• 属性名称旁边的红色星号表示该值是必需值。如果 requireattrs 首选项被设置为 on (默认值)，则当具有所需属性的标记插入到文档中时，修改属性对话框将自动打开。此时，光标位于第一个所需属性处。
• 以蓝色显示的属性名称表示相应值已被修改。这些属性名称显示在“编辑”窗格中的标记上。
• 以黑色显示的属性名称表示该值（如果有）是文档类型设置的默认值。
• 属性后的列表显示了可用值。这些值由文档类型决定。
• 可以在属性后面的文本框中输入文本或数字。可以为属性 (如 ID 和 IDREF) 输入文本或数字。
• 文本字段旁边的
产生一个 ID 按钮
可让您为在文档类型或 DCF 文件中作为 ID 定义的属性生成唯一 ID。该按钮是否出现可在文档类型中自定义。 系统管理员可通过
generate_id() 回调来自定义 ID 生成。
• 下拉列表显示当前文档中针对在文档类型中定义为 IDREF 的属性定义的所有 ID。
• 文本字段旁边的
浏览按钮
使您可浏览目录路径或 URL。
• 这些属性所属的元素标记显示在对话框的顶部。
• 可以为 CDATA 属性输入空值。默认情况下，删除 CDATA 属性值的最后一个字符将导致该属性从标记中被删除。但是，如果在首选项对话框的编辑类别中选中允许空字符串属性值选项，便可以为 CDATA 属性输入空值。
这种情况下，您可将光标置于 CDATA 属性的字段中，输入一个字符，然后退格删除该字符。属性名称将仍以蓝色显示以说明存在属性值，即使其为空。另外，短语 (空字符串) 会显示为该属性的值。 如果要忽略首选项设置而始终删除 CDATA 属性，可将光标置于所需字段中，然后单击删除按钮。
• 如果输入无效值，对话框将不会关闭。具有无效值的属性名称以红色显示。
• 如果文档类型为属性定义了默认值，该值既不会显示在修改属性对话框中，也不会显示在对应元素的标记中。如果要显示默认值，则请输入一个不同的值，保存更改，然后输入默认值。
• 如果文档类型的
.dcf 文件将属性定义为
只读，则可在
修改属性对话框中查看该属性的值但无法将其更改。
• 如果文档类型的
.dcf 文件将属性定义为
配置属性，则可在
修改属性对话框中查看该属性的值但无法将其更改。在该属性旁，将出现一个可用于调用
应用配置文件对话框的按钮 (
)。
• 如果要修改智能图形的属性或修改指向智能图形的链接，对话框可能会包含以下特殊属性：
◦ xmlns:atgra – 这是一个只读属性，它引用与 PTC Arbortext 的智能图形支持关联的特殊命名空间。
◦ atgra:links – 这是一个只读属性，它包含有关存储在智能图形内的链接的信息。
如果要修改链接，可使用该属性旁的按钮
，来打开
更新图形对象链接对话框。使用此对话框可以修改链接。如果删除文件 (
fileref) 或实体 (
entityref) 引用属性的值，此属性的值也将被删除。
◦ atgra:linkdata – 这是一个只读属性，它确定当选择链接时在智能图形中所执行的操作。
如果要修改此操作，请选择该链接并右键单击以打开“编辑”视图快捷菜单。从菜单中选择修改链接并使用修改链接对话框来更改链接的属性。
• 如果您正在编辑行内适用性属性的值 (例如，appl:applic)，那么您有两种方案可选择：
◦ 在文本字段中手动编辑值
在这种情况下，无法根据适用性语法验证修改的适用性表达式。
◦ 单击
修改行内适用性
按钮可调用
修改行内适用性对话框。
表示行内适用性设置的属性采用当前
PTC Arbortext 环境的适用性语法进行定义。有关详细信息，请参阅
确认适用性语法。
适用性属性通常列在修改属性对话框中的其他选项卡中。
修改属性对话框的外观会随文档中属性的种类和数量而变化。但通常会包含以下各项：
• 属性信息 — 显示由文档类型决定的属性值的若干个字段。在某些字段的右侧会显示带有修改选项的列表。
• 新建属性 —（自由格式 XML 文档和命名空间中的未在文档类型中声明的元素）文本字段，从中可输入新的属性名称。
• 添加 —（自由格式 XML 文档和命名空间中未在文档类型中声明的元素）将新建属性字段中的属性附加到现有属性得列表中。
• 确定 — 在关闭对话框前，验证并应用所作的更改。如果验证发现错误：
1. 则会显示一个包含所有错误详细信息的错误消息框。在错误消息框中，单击关闭解除此对话框。
2. 在修改属性对话框中更正该错误。含有错误的字段名称均以红色显示。
3. 在更正所有错误后，单击确定关闭对话框。随即显示一条未找到任何错误的确认消息。
• 取消 — 关闭对话框。
• 帮助 — 显示联机帮助。
• 
(
验证) - 验证所有输入的值是否均有效，但不应用更改或关闭对话框。
验证对使用自由格式 XML 文档类型的文档不可用。
• 
(
重置) - 对于光标所在字段，将更改的属性值重置为打开对话框时的值。
• 
(
删除) - 在光标所在字段，删除该属性值。
• 
(
全部删除) - 删除所有修改过的属性值设置，将它们返回到原始未修改状态。
DITA 文档选项
在您编辑
DITA 文档时，
修改属性对话框将包含下列附加选项：
• 浏览对
conref、
href 和类似属性的支持 - 当在 DITA 文档中调用
修改属性对话框时，将在引用另一个文件的
conref 和
href 等属性旁出现按钮 (
)。此按钮将调用
资源管理器以便修改属性。您可以使用
资源管理器在文件系统或内容管理系统 (CMS) 中进行浏览以查找要通过该属性引用的文档或元素。
• 配置属性支持 - 在通常用于配置 (
audience、
platform、
product 和
otherprops) 的 DITA 属性旁，会显示按钮 (
)。在
修改属性对话框中，无法修改这些属性的值。选取该按钮可调用
应用配置文件对话框，从中可选取要应用到属性的配置文件。
修改无效标注的属性
本部分介绍该对话框在以下所述的标注无效的情况下的行为：
• 带有无效值的已声明属性的已声明标记。
• 带有未声明属性的已声明标记。
• 未声明的标记。
选取 > 将会在对话框中显示这些标记。如果未声明标记，则 Arbortext Editor 会将未声明的标记追加到对话框的标题。
Arbortext Editor 会按以下方式处理无效的属性标注：
• 进入时 - 当对话框首次出现时，将以红色显示带有无效值的声明的属性。所有未声明属性将以红色删除线显示。
• 编辑 - 可以修改声明的及未声明的属性的值。还可使用删除按钮或手动删除属性值来删除任何属性（声明的或未声明的）。
• 验证 - 如果所有声明的属性均有效，验证按钮可对声明的属性执行其标准功能，并标记未声明的属性。如果删除未声明属性的值，“验证”功能将略过它。
• 未声明的属性 - 如果存在任何未声明的属性，Arbortext Editor 会让您采用所作更改以便能够以后处理。
• 进入和退出时的无效值 - 如果声明的属性在进入时包含无效属性值，Arbortext Editor 会让您采用所做的更改，而不修正这些值。
• 进入时有效，退出时无效 - 如果属性值在进入时有效，但之后编辑为无效值，Arbortext Editor 将“不”允许采用所做的更改。
