Vertical Alignment

When enabled, this option performs vertical alignment.

  • Vertical Alignment Tokens (DVT.textEditor.systemVerilog.formatting.verticalAlignment.verticalAlignTokens)

The lines of code inside the same scope are aligned by the specified list of vertical alignment tokens. Vertical alignment is performed left to right, by the same token. For example, assuming = and : as vertical align tokens: In order to use the comma character , as a vertical alignment token, the character must be preceded by the escaping character \.

Before

After (“:” token)

../../_images/before-vertical-align-tokens.png
../../_images/after-vertical-align-tokens.png
  • Only Consecutive Lines (DVT.textEditor.systemVerilog.formatting.verticalAlignment.onlyConsecutiveLines) - Controls whether vertical alignment is applied only to consecutive lines.

Before

After

../../_images/before-only-consecutive-lines.png
../../_images/after-only-consecutive-lines.png
  • Vertical Align Single Line Comments (DVT.textEditor.systemVerilog.formatting.verticalAlignment.verticalAlignSingleLineComments) - Controls whether single line comments are vertically aligned.

Before

After

../../_images/before-vertical-align-single-line-comments.png
../../_images/after-vertical-align-single-line-comments.png
  • Vertical Align To Open Parenthesis (DVT.textEditor.systemVerilog.formatting.verticalAlignment.verticalAlignToOpenParenthesis) - Controls whether to vertically align relative to open parenthesis.

Before

After

../../_images/before-vertical-align-to-open-parenthesis.png
../../_images/after-vertical-align-to-open-parenthesis.png
  • Vertical Align To Open Curly (DVT.textEditor.systemVerilog.formatting.verticalAlignment.verticalAlignToOpenCurly) - Controls whether to vertically align relative to open curly.

Before

After

../../_images/before-vertical-align-to-open-curly.png
../../_images/after-vertical-align-to-open-curly.png
  • Independent Preprocessing Scopes (DVT.textEditor.systemVerilog.formatting.verticalAlignment.independentPreprocessingScopes) - Controls whether preprocessing scopes create independent alignment scopes.

Before

After

../../_images/before-independent-preprocessing-scopes.png
../../_images/after-independent-preprocessing-scopes.png

Vertical Align Patterns (DVT.textEditor.systemVerilog.formatting.verticalAlignment.verticalAlignPatterns)

  • By Name Port Connections (VlogByNamePortConnections) - When enabled, this pattern aligns instance port connections by name:

Before

After

../../_images/before-vertical-align-patterns-by-name-port-connections.png
../../_images/after-vertical-align-patterns-by-name-port-connections.png
  • Class Declarations (VlogClassDeclarationsGroupDimensions) - When enabled, this pattern aligns class parameters while excluding vertical alignment of dimensions:

Before

After

../../_images/before-vertical-align-patterns-class-declarations.png
../../_images/after-vertical-align-patterns-class-declarations.png
  • Class Declarations (split dimensions) (VlogClassDeclarations) - When enabled, this pattern aligns class parameters while vertically aligning dimensions:

Before

After

../../_images/before-vertical-align-patterns-class-declarations.png
../../_images/after-vertical-align-patterns-class-declarations-split-dimensions.png
  • Class Variable Declarations (VlogClassVariableDeclarationsGroupDimensions) - When enabled, this pattern aligns class variable while excluding vertical alignment of dimensions:

Before

After

../../_images/before-vertical-align-patterns-class-variable-declarations.png
../../_images/after-vertical-align-patterns-class-variable-declarations.png
  • Class Variable Declarations (split dimensions) (VlogClassVariableDeclarations) - When enabled, this pattern aligns class variables while vertically aligning dimensions:

Before

After

../../_images/before-vertical-align-patterns-class-variable-declarations.png
../../_images/after-vertical-align-patterns-class-variable-declarations-split-dimensions.png
  • `defines (VlogDefines) - When enabled, this pattern aligns `defines:

Before

After

../../_images/before-vertical-align-patterns-defines.png
../../_images/after-vertical-align-patterns-defines.png
  • Function Declarations (VlogFunctionDeclarationsGroupDimensions) - When enabled, this pattern aligns function and task declarations while excluding vertical alignment of dimensions:

Before

After

../../_images/before-vertical-align-patterns-function-declarations.png
../../_images/after-vertical-align-patterns-function-declarations.png
  • Function Declarations (split dimensions) (VlogFunctionDeclarations) - When enabled, this pattern aligns function and task declarations while vertically aligning dimensions:

Before

After

../../_images/before-vertical-align-patterns-function-declarations.png
../../_images/after-vertical-align-patterns-function-declarations-split-dimensions.png
  • Function Variable Declarations (VlogFunctionVariableDeclarationsGroupDimensions) - When enabled, this pattern aligns function and task while excluding vertical alignment of dimensions:

Before

After

../../_images/before-vertical-align-patterns-function-variable-declarations.png
../../_images/after-vertical-align-patterns-function-variable-declarations.png
  • Function Variable Declarations (split dimensions) (VlogFunctionVariableDeclarations) - When enabled, this pattern aligns function and task while vertically aligning dimensions:

Before

After

../../_images/before-vertical-align-patterns-function-variable-declarations.png
../../_images/after-vertical-align-patterns-function-variable-declarations-split-dimensions.png
  • Interface Port Declarations (VlogInterfacePortDeclarationsGroupDimensions) - When enabled, this pattern aligns interface ports while excluding vertical alignment of dimensions:

Before

After

../../_images/before-vertical-align-patterns-interface-port-declarations.png
../../_images/after-vertical-align-patterns-interface-port-declarations.png
  • Interface Port Declarations (split dimensions) (VlogInterfacePortDeclarations) - When enabled, this pattern aligns interface ports while vertically aligning dimensions:

Before

After

../../_images/before-vertical-align-patterns-interface-port-declarations.png
../../_images/after-vertical-align-patterns-interface-port-declarations-split-dimensions.png
  • Interface Signal Declarations (VlogInterfaceSignalDeclarationsGroupDimensions) - When enabled, this pattern aligns interface signals while excluding vertical alignment of dimensions:

Before

After

../../_images/before-vertical-align-patterns-interface-signal-declarations.png
../../_images/after-vertical-align-patterns-interface-signal-declarations.png
  • Interface Signal Declarations (split dimensions) (VlogInterfaceSignalDeclarations) - When enabled, this pattern aligns interface signals while vertically aligning dimensionss:

Before

After

../../_images/before-vertical-align-patterns-interface-signal-declarations.png
../../_images/after-vertical-align-patterns-interface-signal-declarations-split-dimensions.png
  • Module Port Declarations (VlogModulePortDeclarationsGroupDimensions) - When enabled, this pattern aligns module ports while excluding vertical alignment of dimensions:

Before

After

../../_images/before-vertical-align-patterns-module-port-declarations.png
../../_images/after-vertical-align-patterns-module-port-declarations.png
  • Module Port Declarations (split dimensions) (VlogModulePortDeclarations) - When enabled, this pattern aligns module ports while vertically aligning dimensions:

Before

After

../../_images/before-vertical-align-patterns-module-port-declarations.png
../../_images/after-vertical-align-patterns-module-port-declarations-split-dimensions.png
  • Module Signal Declarations (VlogModuleSignalDeclarationsGroupDimensions) - When enabled, this pattern aligns module signals while excluding vertical alignment of dimensions:

Before

After

../../_images/before-vertical-align-patterns-module-signal-declarations.png
../../_images/after-vertical-align-patterns-module-signal-declarations.png
  • Module Signal Declarations (split dimensions) (VlogModuleSignalDeclarations) - When enabled, this pattern aligns module signals while vertically aligning dimensions:

Before

After

../../_images/before-vertical-align-patterns-module-signal-declarations.png
../../_images/after-vertical-align-patterns-module-signal-declarations-split-dimensions.png
  • `xvm_field macros (VlogXVMFieldMacros) - When enabled, this pattern aligns `xvm_field factory registration macros:

Before

After

../../_images/before-vertical-align-patterns-xvm_field-macros.png
../../_images/after-vertical-align-patterns-xvm_field-macros.png
  • Compact Whitespace For Vertical Align Patterns (DVT.textEditor.systemVerilog.formatting.verticalAlignment.compactWhitespaceForVerticalAlignPatterns) - Controls whether consecutive whitespace characters are trimmed to a single space character for vertical align patterns.

Before

After

../../_images/before-vertical-align-patterns-module-port-declaration-compact-ws.png
../../_images/after-vertical-align-patterns-module-port-declaration-compact-ws.png