DiffLineModified

Plays a sound / audio cue when the focus moves to an modified line in Accessible Diff Viewer mode or to the next/previous change.

{
  "accessibility.signals.diffLineModified": {
    "sound": "auto"
  } // default
}

Type

object

Default

{
  "sound": "auto"
}

Object Properties

KeyTypeDefaultRangeDescription
"sound"string"auto""auto", "off", "on"Plays a sound when the focus moves to a modified line in Accessible Diff Viewer mode or to the next/previous change.

Description

Controls if a sound signal will play when you focus a line that has been modified in the Diff View. The sound signal will play when you move the cursor to the modified line or when you use the Next Change/Previous Change commands. Note that adding a blank line weirdly counts as modifying a line and not adding one. Thus, such lines will not play the accessibility.signals.diffLineInserted signal, but the accessibility.signals.diffLineModified signal.

edit The Accessible Diff Viewer (F7) does not distinguish between lines that are inserted and lines that are modified. It also does not distinguish between lines that have been deleted and lines that have been modified. Lines that have been modified will appear as lines that have been inserted. Also, if several lines have been deleted, Accessible Diff View Mode will allow you to focus each line that has been deleted while the regular Diff View Mode treats consecutive deleted lines as a single line. The Accessibile Diff View Mode is also displayed inline. Accessible Diff View Mode can be exited by clicking the “X” button or by pressing “escape”. Accessible Diff View Mode will also not show the entire file, just modified portions with a small surrounding context… and you will need to execute the Open Accessible Diff Viewer (F7) command for each change outside of that context.

When sound is set to auto, the sound signal will play only if a screen reader is detected. When set to off, the sound signal will never play even when a screen reader is detected or when "editor.accessibiltySupport": "on". When set to on, the sound signal will always play even when a screen reader is not detected or when "editor.accessibilitySupport": "off".