帮助 > 创作 > 对话框 > 编辑窗口 > 编辑对话框 > 修改属性对话框
修改属性对话框
使用修改属性对话框中的设置,可以设置或更改光标左侧的标注的属性值。如果光标左侧的标注是实体引用、标记部分、备注、不带属性的元素或处理指令,则修改属性对话框不可用。
此对话框中的属性和可用属性值取决于所选元素和文档类型。
* 
如果对文档应用了别名映射,则对于已分配有别名的属性和属性值,此对话框将列出别名而非实际名称。
如果别名映射包含属性说明,将光标置于带说明的属性标签之上时,该说明将显示在修改属性对话框的底部。
默认情况下,属性按类别分组,且对话框会基于这些类别显示在选项卡布局中。文档类型管理员可以对文档类型的 DCF 文件中的属性类别进行定义。有关要使用的标注的信息,请参阅定义属性类别
对于 XML 文档类型,属性通常按字母顺序列出。如果已对属性进行分类,则可以使用 DCF 文件中 ModifyAttributeCategorysort 属性对其进行排序。对于 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 文档类型的文档,验证不可用。
图示为一个折回到左侧的黑色箭头。 (重置) - 对于光标所在的字段,将更改的属性值重置为打开对话框时显示的值。
图示为一个黑色 X。 (删除) - 对于光标所在的字段,移除属性值。
图示为两个红色 X。 (全部删除) - 移除修改的所有属性值设置,使其返回原始的未修改状态。
DITA 文档选项
编辑 DITA 文档时,修改属性对话框会提供下列附加选项:
浏览对 conrefhref 和类似属性的支持 - 调用 DITA 文档的修改属性对话框时,按钮 (图示为一个对话框按钮,其内有三个句点。) 显示在引用其他文件的属性 (例如 conrefhref) 旁。此按钮用于调用资源管理器以便修改属性。可以通过资源管理器,在文件系统或内容管理系统 (CMS) 中进行浏览以查找要通过该属性引用的文档或元素。
配置属性支持 - 按钮 (图示为一个对话框按钮,上面依次叠放一个灰色正方形和一个蓝色正方形。) 显示在通常用于配置 (audienceplatformproductotherprops) 的 DITA 属性旁。在修改属性对话框中,无法修改这些属性的值。选取该按钮可调用应用配置文件对话框,从中可选取要应用到属性的配置文件。
修改无效标注的属性
本部分介绍该对话框在以下所述的标注无效的情况下的行为:
带有无效值的已声明属性的已声明标记。
带有未声明属性的已声明标记。
未声明的标记。
选取编辑 > 修改属性将会在对话框中显示这些标记。如果未声明标记,则 Arbortext Editor 会将未声明的标记追加到对话框的标题。
Arbortext Editor 会按以下方式处理无效的属性标注:
进入时 - 当对话框首次出现时,将以红色显示带有无效值的声明的属性。所有未声明属性将以红色删除线显示。
编辑 - 可以修改声明的及未声明的属性的值。还可以使用删除按钮或手动删除属性值来删除任何 (声明的或未声明的) 属性。
验证 - 如果所有声明的属性均有效,验证按钮可对声明的属性执行其标准功能,并标记未声明的属性。如果删除未声明属性的值,“验证”功能将略过它。
未声明的属性 - 如果存在任何未声明的属性,则 Arbortext Editor 会让您采用所做变更,以便能够以后处理。
进入和退出时值无效 - 如果声明的属性在进入时包含无效属性值,则 Arbortext Editor 会让您采用所做的变更,而不修正这些值。
进入时有效,退出时无效 - 如果属性值在进入时有效,但之后被编辑为无效值,Arbortext Editor 将“不”允许采用所做的变更。
这对您有帮助吗?