accessible/docs/HCMSettings.md

   1 # HCM Settings
   2
   3 Several Firefox settings work together to determine how web content and browser chrome are rendered. They can be hard to keep track of! Use the flowcharts below for quick reference.
   4
   5 ## Settings that control color usage in browser chrome
   6 - OS HCM:
   7         - Windows: High Contrast Mode in OS accessibility settings
   8         - macOS: Increase Contrast in OS accessibility settings
   9         - Linux: High Contrast Theme in OS accessibility settings
  10 - FF Theme (AKA FF Colorway)
  11 Note: OS HCM settings will only trigger HCM color usage in chrome if a user's FF theme is set to "system auto". If they have a pre-selected colorway or other FF theme (including explicit "Dark" or "Light") they will not see color changes upon enabling OS HCM.
  12
  13 ```{mermaid}
  14 flowchart TD
  15 A[Is OS HCM enabeld?]
  16 A -->|Yes| B[Is FF's theme set to System Auto?]
  17 B --> |Yes| C[Use OS HCM colors to render browser chrome]
  18 B -->|No| D[Use FF theme colors to render browser chrome]
  19 A -->|No| D
  20 ```
  21
  22 ## Settings that control color usage in content
  23 - Colors Dialog (about:preferences > Manage Colors)
  24         - Dropdown with options: Always, Only with High Contrast Themes, and Never
  25         - Use System Colors checkbox
  26         - Text, Background, Visited and Unvisited Link color inputs
  27 - Extensions like Dark Reader, or changes to user.css, may override author specified colors independent of HCM.
  28
  29 ```{mermaid}
  30 flowchart TD
  31 A[What is the value of the dropdown in the colors dialog?]
  32 A -->|Always|C
  33
  34 A -->|Only with High Contrast Themes| B[Is a OS HCM enabled?]
  35 B -->|Yes| C[Is the Use System Colors checkbox checked?]
  36 C -->|Yes, and OS HCM is on| D[Use OS HCM colors to render web content]
  37 C -->|Yes, and OS HCM is off| D2[Use OS dark/light colors to render web content]
  38 C-->|No| E[Use colors dialog colors to render web content]
  39
  40 B -->|No| F[Is a color-modifying web extension or color-modifying user.css change active?]
  41 F -->|Yes| G[Use web extension/user.css provided colors to render web content]
  42 F -->|No| H[Use author-provided colors to render web content]
  43
  44 A -->|Never|F
  45 ```