replaceShadowColors() — tailwindcss Function Reference

Architecture documentation for the replaceShadowColors() function in replace-shadow-colors.ts from the tailwindcss codebase.

Function typescript CompilerEngine ModuleResolution calls 1 called by 2

Entity Profile

CompilerEngine→ ModuleResolution→ replaceShadowColors() — tailwindcss Function Reference

Dependency Diagram

graph TD
  a71313ee_9751_a814_644d_8bed22215dfc["replaceShadowColors()"]
  7829d740_b77d_642a_6961_2b062dc27460["alphaReplacedShadowProperties()"]
  7829d740_b77d_642a_6961_2b062dc27460 -->|calls| a71313ee_9751_a814_644d_8bed22215dfc
  db4785ee_f9d4_d30c_c923_4237d7c754d9["alphaReplacedDropShadowProperties()"]
  db4785ee_f9d4_d30c_c923_4237d7c754d9 -->|calls| a71313ee_9751_a814_644d_8bed22215dfc
  2a20ea29_c850_cd61_5600_aeebbe3dda66["segment()"]
  a71313ee_9751_a814_644d_8bed22215dfc -->|calls| 2a20ea29_c850_cd61_5600_aeebbe3dda66
  style a71313ee_9751_a814_644d_8bed22215dfc fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

packages/tailwindcss/src/utils/replace-shadow-colors.ts lines 6–48

export function replaceShadowColors(input: string, replacement: (color: string) => string) {
  let shadows = segment(input, ',').map((shadow) => {
    shadow = shadow.trim()
    let parts = segment(shadow, ' ').filter((part) => part.trim() !== '')
    let color = null
    let offsetX = null
    let offsetY = null

    for (let part of parts) {
      if (KEYWORDS.has(part)) {
        continue
      } else if (LENGTH.test(part)) {
        if (offsetX === null) {
          offsetX = part
        } else if (offsetY === null) {
          offsetY = part
        }

        // Reset index, since the regex is stateful.
        LENGTH.lastIndex = 0
      } else if (color === null) {
        color = part
      }
    }

    // If the x and y offsets were not detected, the shadow is either invalid or
    // using a variable to represent more than one field in the shadow value, so
    // we can't know what to replace.
    if (offsetX === null || offsetY === null) return shadow

    let replacementColor = replacement(color ?? 'currentcolor')

    if (color !== null) {
      // If a color was found, replace the color.
      return shadow.replace(color, replacementColor)
    }
    // If no color was found, assume the shadow is relying on the browser
    // default shadow color and append the replacement color.
    return `${shadow} ${replacementColor}`
  })

  return shadows.join(', ')
}