JS.VUE.NO.RESTRICTED.PROPS

Disallow specific props

  • Some problems reported by this rule are manually fixable by editor suggestions (https://eslint.org/docs/developer-guide/working-with-rules#providing-suggestions).

Rule Details

This rule allows you to specify props that you don't want to use in your application.

Options

This rule takes a list of strings, where each string is a prop name or pattern to be restricted:

Copy
{
  "vue/no-restricted-props": ["error", "value", "/^forbidden/"]
}

{'vue/no-restricted-props': ['error', 'value', '/^forbidden/']}

Copy
<script>
export default {
  props: {
    /* BAD */
    value: String,
    forbiddenNum: Number,

    /* GOOD */
    foo: {},
    bar: {},
    arrowedBool: Boolean,
  }
}
</script>

{'vue/no-restricted-props': ['error', 'value', '/^forbidden/']}

Copy
<script>
export default {
  props: [
    /* BAD */
    'value',
    'forbiddenNum',

    /* GOOD */
    'foo',
    'bar',
    'arrowedBool',
  ]
}
</script>

Alternatively, the rule also accepts objects.

Copy
{
  "vue/no-restricted-props": ["error",
    {
      "name": "value",
      "message": "If you intend a prop for v-model, it should be 'modelValue' in Vue 3.",
      "suggest": "modelValue"
    },
  ]
}

The following properties can be specified for the object.

  • name ... Specify the prop name or pattern.
  • message ... Specify an optional custom message.
  • suggest ... Specify an optional name to suggest changes.

{'vue/no-restricted-props': ['error', { name: 'value', message: 'If you intend a prop for v-model, it should be \'modelValue\' in Vue 3.', suggest: 'modelValue'}]}

Copy
<script>
export default {
  props: [
    /* BAD */
    'value',
  ]
}
</script>

The content on this page is adapted from the ESLint User Guide. Copyright © OpenJS Foundation and other contributors, www.openjsf.org. All rights reserved. https://eslint.org/docs/rules/