Skip to content

Latest commit

 

History

History
46 lines (31 loc) · 1.85 KB

options-misc.md

File metadata and controls

46 lines (31 loc) · 1.85 KB

Misc

name

  • Type: string

  • Restriction: only respected when used as a component option.

  • Details:

    Allow the component to recursively invoke itself in its template. Note that when a component is registered globally with Vue.createApp({}).component({}), the global ID is automatically set as its name.

    Another benefit of specifying a name option is debugging. Named components result in more helpful warning messages. Also, when inspecting an app in the vue-devtools, unnamed components will show up as <AnonymousComponent>, which isn't very informative. By providing the name option, you will get a much more informative component tree.

inheritAttrs

  • Type: boolean

  • Default: true

  • Details:

    By default, parent scope attribute bindings that are not recognized as props will "fallthrough". This means that when we have a single-root component, these bindings will be applied to the root element of the child component as normal HTML attributes. When authoring a component that wraps a target element or another component, this may not always be the desired behavior. By setting inheritAttrs to false, this default behavior can be disabled. The attributes are available via the $attrs instance property and can be explicitly bound to a non-root element using v-bind.

    Note: this option does not affect class and style bindings.

  • Usage:

    app.component('base-input', {
      inheritAttrs: false,
      props: ['label', 'value'],
      template: `
        <label>
          {{ label }}
          <input
            v-bind="$attrs"
            v-bind:value="value"
            v-on:input="$emit('input', $event.target.value)"
          >
        </label>
      `
    })
  • See also: Disabling Attribute Inheritance