addHandler() — vue Function Reference

Architecture documentation for the addHandler() function in helpers.ts from the vue codebase.

Function typescript CompilerSFC ScriptCompiler calls 2 called by 5

Entity Profile

CompilerSFC→ ScriptCompiler→ addHandler() — vue Function Reference

Dependency Diagram

graph TD
  754feb41_b555_757e_313c_0f0096cdc970["addHandler()"]
  a8b5582c_75a3_d739_c9b5_27e2ceb67bc3["processAttrs()"]
  a8b5582c_75a3_d739_c9b5_27e2ceb67bc3 -->|calls| 754feb41_b555_757e_313c_0f0096cdc970
  2a02b0ab_9034_a2f9_d310_cda75957f53b["genCheckboxModel()"]
  2a02b0ab_9034_a2f9_d310_cda75957f53b -->|calls| 754feb41_b555_757e_313c_0f0096cdc970
  1a10f80b_54fb_898b_54fd_6eee5e4ca82a["genRadioModel()"]
  1a10f80b_54fb_898b_54fd_6eee5e4ca82a -->|calls| 754feb41_b555_757e_313c_0f0096cdc970
  156644d3_91e1_dced_78a2_f8489a890589["genSelect()"]
  156644d3_91e1_dced_78a2_f8489a890589 -->|calls| 754feb41_b555_757e_313c_0f0096cdc970
  39292c26_0eea_5e4d_9de0_7137f2d3a979["genDefaultModel()"]
  39292c26_0eea_5e4d_9de0_7137f2d3a979 -->|calls| 754feb41_b555_757e_313c_0f0096cdc970
  c4f7d2bf_764b_66ae_a7c6_2f516ed811a6["prependModifierMarker()"]
  754feb41_b555_757e_313c_0f0096cdc970 -->|calls| c4f7d2bf_764b_66ae_a7c6_2f516ed811a6
  c336f147_1947_5913_00aa_91254a8ee33b["rangeSetItem()"]
  754feb41_b555_757e_313c_0f0096cdc970 -->|calls| c336f147_1947_5913_00aa_91254a8ee33b
  style 754feb41_b555_757e_313c_0f0096cdc970 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

src/compiler/helpers.ts lines 92–170

export function addHandler(
  el: ASTElement,
  name: string,
  value: string,
  modifiers?: ASTModifiers | null,
  important?: boolean,
  warn?: Function,
  range?: Range,
  dynamic?: boolean
) {
  modifiers = modifiers || emptyObject
  // warn prevent and passive modifier
  /* istanbul ignore if */
  if (__DEV__ && warn && modifiers.prevent && modifiers.passive) {
    warn(
      "passive and prevent can't be used together. " +
        "Passive handler can't prevent default event.",
      range
    )
  }

  // normalize click.right and click.middle since they don't actually fire
  // this is technically browser-specific, but at least for now browsers are
  // the only target envs that have right/middle clicks.
  if (modifiers.right) {
    if (dynamic) {
      name = `(${name})==='click'?'contextmenu':(${name})`
    } else if (name === 'click') {
      name = 'contextmenu'
      delete modifiers.right
    }
  } else if (modifiers.middle) {
    if (dynamic) {
      name = `(${name})==='click'?'mouseup':(${name})`
    } else if (name === 'click') {
      name = 'mouseup'
    }
  }

  // check capture modifier
  if (modifiers.capture) {
    delete modifiers.capture
    name = prependModifierMarker('!', name, dynamic)
  }
  if (modifiers.once) {
    delete modifiers.once
    name = prependModifierMarker('~', name, dynamic)
  }
  /* istanbul ignore if */
  if (modifiers.passive) {
    delete modifiers.passive
    name = prependModifierMarker('&', name, dynamic)
  }

  let events
  if (modifiers.native) {
    delete modifiers.native
    events = el.nativeEvents || (el.nativeEvents = {})
  } else {
    events = el.events || (el.events = {})
  }

  const newHandler: any = rangeSetItem({ value: value.trim(), dynamic }, range)
  if (modifiers !== emptyObject) {
    newHandler.modifiers = modifiers
  }

  const handlers = events[name]
  /* istanbul ignore if */
  if (Array.isArray(handlers)) {
    important ? handlers.unshift(newHandler) : handlers.push(newHandler)
  } else if (handlers) {
    events[name] = important ? [newHandler, handlers] : [handlers, newHandler]
  } else {
    events[name] = newHandler
  }

  el.plain = false
}