bootstrap-vue/src/components/form-file/package.json

BootstrapVue, with over 40 plugins and more than 80 custom components, custom directives, and over 300 icons, provides one of the most comprehensive implementations of Bootstrap v4 components and grid system for Vue.js. With extensive and automated WAI-AR

{
  "name": "@bootstrap-vue/form-file",
  "version": "1.0.0",
  "meta": {
    "title": "Form File",
    "description": "Customized, cross-browser consistent, file input control that supports single file, multiple files, and directory upload.",
    "components": [
      {
        "component": "BFormFile",
        "aliases": [
          "BFile"
        ],
        "props": [
          {
            "prop": "value",
            "description": "The current value of the file input. Will be a single File object or an array of File objects (if multiple or directory is set). Can be set to null, or an empty array to reset the file input"
          },
          {
            "prop": "accept",
            "description": "Value to set on the file input's 'accept' attribute"
          },
          {
            "prop": "capture",
            "description": "When set, will instruction the browser to use the devices camera (if supported)"
          },
          {
            "prop": "browseText",
            "description": "Text content for the file browse button"
          },
          {
            "prop": "dropPlaceholder",
            "description": "Text to display as the placeholder when fies are being dragged"
          },
          {
            "prop": "multiple",
            "description": "When set, will allow multiple files to be selected. v-model will be an array"
          },
          {
            "prop": "directory",
            "description": "Enable directory drop mode (on browsers that support directory mode)"
          },
          {
            "prop": "noTraverse",
            "description": "For directory drop mode: returns files as a flat array"
          },
          {
            "prop": "noDrop",
            "description": "Disable drag and drop mode"
          },
          {
            "prop": "fileNameFormatter",
            "description": "Method to format the file names for display. Refer to the docs for details"
          }
        ],
        "slots": [
          {
            "name": "file-name",
            "description": "Scoped slot for formatting the file names",
            "scope": [
              {
                "prop": "files",
                "type": "Array",
                "description": "Array of File objects"
              },
              {
                "prop": "names",
                "type": "Array",
                "description": "Array of file names (strings)"
              }
            ]
          }
        ],
        "events": [
          {
            "event": "change",
            "description": "original native change event on input",
            "args": [
              {
                "arg": "event",
                "type": "Event",
                "description": "Native change event object"
              }
            ]
          },
          {
            "event": "input",
            "description": "Updates the v-model value (see docs for more details)",
            "args": [
              {
                "arg": "file",
                "type": [
                  "File",
                  "Array"
                ],
                "description": "Will be a single File object in single mode or an array of File objects in multiple mode"
              }
            ]
          }
        ]
      }
    ]
  }
}