replaceShadowColors() — tailwindcss Function Reference

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

Function typescript OxideCore Scanner calls 1 called by 2

Entity Profile

OxideCore→ Scanner→ replaceShadowColors() — tailwindcss Function Reference

Dependency Diagram

graph TD
  ee6a51e8_b2d4_4e8c_e8b0_55eae5041272["replaceShadowColors()"]
  537db6f9_ffa5_12bf_0cec_283e545c7822["alphaReplacedShadowProperties()"]
  537db6f9_ffa5_12bf_0cec_283e545c7822 -->|calls| ee6a51e8_b2d4_4e8c_e8b0_55eae5041272
  f82aa221_959b_12a7_fef5_44d13694b11e["alphaReplacedDropShadowProperties()"]
  f82aa221_959b_12a7_fef5_44d13694b11e -->|calls| ee6a51e8_b2d4_4e8c_e8b0_55eae5041272
  03b8d706_a876_a776_0056_186ced5d6067["segment()"]
  ee6a51e8_b2d4_4e8c_e8b0_55eae5041272 -->|calls| 03b8d706_a876_a776_0056_186ced5d6067
  style ee6a51e8_b2d4_4e8c_e8b0_55eae5041272 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(', ')
}