修改属性对话框
使用修改属性对话框中的设置,可以设置或更改光标左侧的标注的属性值。如果光标左侧的标注是实体引用、标记部分、备注、不带属性的元素或处理指令,则修改属性对话框不可用。
此对话框中的属性和可用属性值取决于所选元素和文档类型。
|
|
如果对文档应用了 别名映射,则对于已分配有别名的属性和属性值,此对话框将列出别名而非实际名称。
如果别名映射包含属性说明,将光标置于带说明的属性标签之上时,该说明将显示在修改属性对话框的底部。
|
默认情况下,属性按类别分组,且对话框会基于这些类别显示在选项卡布局中。文档类型管理员可以对文档类型的 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 文档和元素) 将新建属性字段中的属性附加到现有属性的列表中。
• 确定 - 在关闭对话框前,验证并应用所做的变更。如果验证发现错误:
a. 则会显示一个错误消息框,其中包含所有错误详细信息。在错误消息框中,单击关闭,解除此对话框。
b. 在修改属性对话框中更正该错误。含有错误的字段名称均以红色显示。
c. 在更正所有错误后,单击确定,关闭对话框。随即显示一条确认消息,表明未找到任何错误。
• 取消 - 关闭对话框。
• 帮助 - 显示联机帮助。
• 
(
验证) - 验证输入的所有值均有效,但不会应用变更,也不会关闭对话框。对于采用自由格式 XML 文档类型的文档,
验证不可用。
• 
(
重置) - 对于光标所在的字段,将更改的属性值重置为打开对话框时显示的值。
• 
(
删除) - 对于光标所在的字段,移除属性值。
• 
(
全部删除) - 移除修改的所有属性值设置,使其返回原始的未修改状态。
DITA 文档选项
编辑
DITA 文档时,
修改属性对话框会提供下列附加选项:
• 浏览对
conref、
href 和类似属性的支持 - 调用 DITA 文档的
修改属性对话框时,按钮 (

) 显示在引用其他文件的属性 (例如
conref 和
href) 旁。此按钮用于调用
资源管理器以便修改属性。可以通过
资源管理器,在文件系统或内容管理系统 (CMS) 中进行浏览以查找要通过该属性引用的文档或元素。
• 配置属性支持 - 按钮 (

) 显示在通常用于配置 (
audience、
platform、
product 和
otherprops) 的 DITA 属性旁。在
修改属性对话框中,无法修改这些属性的值。选取该按钮可调用
应用配置文件对话框,从中可选取要应用到属性的配置文件。
修改无效标注的属性
本部分介绍该对话框在以下所述的标注无效的情况下的行为:
• 带有无效值的已声明属性的已声明标记。
• 带有未声明属性的已声明标记。
• 未声明的标记。
选取 > 将会在对话框中显示这些标记。如果未声明标记,则 Arbortext Editor 会将未声明的标记追加到对话框的标题。
Arbortext Editor 会按以下方式处理无效的属性标注:
• 进入时 - 当对话框首次出现时,将以红色显示带有无效值的声明的属性。所有未声明属性将以红色删除线显示。
• 编辑 - 可以修改声明的及未声明的属性的值。还可以使用删除按钮或手动删除属性值来删除任何 (声明的或未声明的) 属性。
• 验证 - 如果所有声明的属性均有效,验证按钮可对声明的属性执行其标准功能,并标记未声明的属性。如果删除未声明属性的值,“验证”功能将略过它。
• 未声明的属性 - 如果存在任何未声明的属性,则 Arbortext Editor 会让您采用所做变更,以便能够以后处理。
• 进入和退出时值无效 - 如果声明的属性在进入时包含无效属性值,则 Arbortext Editor 会让您采用所做的变更,而不修正这些值。
• 进入时有效,退出时无效 - 如果属性值在进入时有效,但之后被编辑为无效值,Arbortext Editor 将“不”允许采用所做的变更。