PhpStorm 2021.3 Help

代码风格。HTML

使用此页面配置 HTML 文件的格式选项。当您更改这些设置时,“预览”窗格会显示这将如何影响您的代码。

制表符和缩进

使用制表符

  • 如果选中此复选框,则使用制表符:

    • 按键Tab

    • 用于缩进

    • 用于重新格式化代码

  • 如果清除该复选框,PhpStorm 将使用空格而不是制表符。

智能标签

缩进由两部分组成。一部分是嵌套代码块的结果,另一部分是由对齐决定的。

  • 如果选中此复选框,则嵌套生成的部分包含制表符和空格(如果需要),而对齐定义的部分仅包含空格。

  • 如果清除此复选框,则仅使用选项卡。这意味着在重新格式化适合指定制表符大小的一组空格后,会自动将其替换为制表符,这可能会导致精细对齐中断。

标签大小

在此字段中,指定适合制表符的空格数。

缩进

在此字段中,指定要为每个缩进级别插入的空格数。

继续缩进

在此字段中,指定要在数组元素之间、表达式、方法声明和方法调用中插入的空格数。

在空行上保留缩进

如果选中此复选框,PhpStorm 会在空行上保留缩进,就好像它们包含一些代码一样。如果清除该复选框,PhpStorm 将删除空行上的制表符和空格。

其他

物品

描述

右边距

使用这些设置来指定元素右侧所需的边距空间。如果您选择默认选项,则将使用全局设置中的右边距值。

打字时换行

使用这些设置设置来指定编辑的文本如何适合指定的右边距

您可以选择以下选项之一:

  • 默认- 在这种情况下,PhpStorm 使用在全局设置中指定的Wrap on typing选项。

  • - 在这种情况下,使用指定右边距中的值。

  • - 在这种情况下,此选项被关闭,并且一行可以超过在右边距中指定的数量。

保留换行符

选中此复选框可让 PhpStorm 在编辑器中查看 HTML 文件时使用换行符。

在文本中保留换行符

选中此复选框可让 PhpStorm 在编辑器中查看 HTML 文件时尊重属性中的换行符(例如,冗长的描述)。

保留空行

在此文本框中,指定重新格式化后要保留的最小连续空白行数。

包装属性

使用此下拉列表来确定应如何换行属性行。可用的选项有:

  • 不换行 - 如果选择此选项,则不会对代码应用特殊换行样式。

  • 如果长则换行 - 选择此选项以使超出右边距的行以适当的缩进换行。

  • Chop down if long - 选择此选项可将列表中超出右边距的元素包裹起来,以使每行一个元素具有适当的缩进。

  • 始终换行 - 选择此选项可将列表中的所有元素换行,以使每行一个元素具有适当的缩进。

换行

选中此复选框可根据代码样式设置对长行进行换行。

对齐属性

选中此复选框可使连续行中的属性对齐。

对齐文本

选中此复选框可让 PhpStorm 对齐标签内占据多行的文本。

保留空格

选中此复选框可禁止用制表符替换实际空格。

空间

在此区域中,定义属性和标签名称使用空格。

  • 属性中的“=”周围- 选中此复选框可在属性中的“=”符号周围添加空格。

  • 在标签名称之后- 选中此复选框可在标签名称后添加空格。

  • 在空标签中 - 选中此复选框可在空标签中添加空格。

在前面插入新行

此显示字段显示应在其前插入新行的标记列表。使用图标一般展开组件字段旁边的按钮或按下Shift+Enter打开“在标签前插入新行”对话框,您可以在其中编辑标签列表。

删除之前的新行

此显示字段显示应删除断线的标记列表。使用图标一般展开组件字段旁边的按钮或按下Shift+Enter打开“删除标签前的换行符”对话框,您可以在其中编辑标签列表。

不要缩进

此显示字段显示其子级不应缩进的标记列表。使用图标一般展开组件字段旁边的按钮或按下Shift+Enter以打开不缩进子级对话框,您可以在其中编辑标记列表。

或者如果标签大小超过

在此文本框中,指定标记的最小长度(以从其子级不缩进开始的行)为单位。

内联元素

此显示字段显示在源代码中与其他标签在同一行中显示的标签列表。如果从列表中删除了一个标签,当您将这样的标签添加到源代码时,编辑器会自动将其移至新行。使用图标一般展开组件字段旁边的按钮或按下Shift+Enter打开“内联元素”对话框,您可以在其中编辑标签列表。

保留内部空白

此显示字段显示标签列表,您希望编辑器在其中保留空白而不进行任何更改。使用该图标一般展开组件字段旁边的按钮或按下Shift+Enter以打开“将空白保留在内部”对话框,您可以在其中编辑标签列表。

如果内联内容不要中断

此显示字段显示如果内容被内联则不被包装的标签列表。使用图标一般展开组件字段旁边的按钮或按下Shift+Enter以打开“仅内联内容时不换行”对话框,您可以在其中编辑标签列表。

生成的引号

选择要在键入时自动插入 HTML 属性周围的引号样式(双引号、单引号或无引号)=

当使用 JavaScript 或 PHP 动态插入 HTML 并且您希望对 JavaScript 或 PHP 字符串始终使用双引号对而对 HTML 使用单引号对以防止出现问题时,这一点很重要,例如,在复制和粘贴时。

强制格式

如果选中此复选框,则在 重新格式化代码时,先前生成的引号将被替换(例如,双引号与单引号)。

安排

在此选项卡中,定义一组规则以根据您的偏好重新排列您的 HTML 代码。

匹配规则

使用此区域将元素顺序定义为规则列表,其中每个规则都有一组匹配项,例如修饰符或类型。

  • 图标一般添加- 使用此按钮添加规则。空白规则区域打开。

  • 图标一般删除- 使用此按钮从列表中删除规则。

  • 图标动作编辑- 使用此按钮编辑现有规则。要查看此按钮,请导航到要编辑的规则并单击该按钮。在打开的弹出窗口中,修改规则字段。

  • 图标动作以前发生 下一次出现的图标动作- 使用这些按钮向上或向下移动选定的规则。

空规则

使用此区域创建新的匹配规则或编辑现有的匹配规则。您可以从以下过滤器中进行选择:

  • 类型- 使用此过滤器为您的规则选择标签或属性。请注意,单击类型关键字两次会否定该条件。

  • 名称- 使用此字段指定规则中的条目名称。此过滤器仅匹配条目名称,例如标记名称或属​​性名称。该过滤器支持正则表达式并使用标准语法。匹配是针对整个名称执行的。

  • 命名空间- 使用此字段指定规则中的命名空间。它允许您指定控制命名空间属性位置的规则。

  • 顺序- 使用此下拉列表选择规则的排序顺序。当多个元素使用相同的匹配规则时,此选项很有用。在这种情况下,选择Keep order将保持与重新排列之前设置的顺序相同,选择Order by Name将按照名称对具有相同匹配规则的元素进行排序。

图标排序

当您从Order列表中选择Order by Name时,会出现此图标。图标表示此规则中的项目按字母顺序排序。

代码生成

在此选项卡上,配置生成代码的代码样式。

注释

在此区域中,为生成的注释配置代码样式。

  • 第一列的行注释:选中此复选框可在第一列开始行注释。当复选框被清除时,行注释在代码中对齐。

    第一列的行注释被清除
    选择第一列的行注释
  • 第一列的块注释:默认情况下,此复选框被清除并且块注释在代码中对齐。选中复选框以在第一列开始块注释。

    第一列的块评论已关闭
    第一列的块评论已开启
  • 在块注释周围添加空格:选中此复选框可在块注释中添加前导和尾随空格。

    默认情况下,当您将代码片段包含在块注释中时,文本会在开始<!--字符之后开始,没有任何空格。在结束-->字符之前也没有插入空格。此默认代码样式可能与某些 linter 的规则冲突,例如 ESLint。

    块注释开始处没有空格添加
    添加了块注释开始处的空格

设置自

如果适用,该链接将显示在页面的右上角。单击此链接并选择要用作当前语言代码样式的基础的语言。

要返回到初始代码样式设置集并放弃更改,请单击重置

最后修改时间:2021 年 11 月 11 日