Файл формы

Настраиваемый, кросс-браузерный, элемент управления вводом файлов, который поддерживает загрузку одного файла, нескольких файлов и каталогов (для браузеров, поддерживающих режим каталогов).

Справочник по компонентам

`<b-form-file>`

Смотреть источник

<b-form-file> Псевдонимы компонентов
<b-form-file> Свойства
<b-form-file> v-model
<b-form-file> Слоты
<b-form-file> События

Псевдонимы компонентов

<b-form-file> также может использоваться через следующие псевдонимы:

<b-file>

Примечание: Псевдонимы компонентов доступны только при импорте всего BootstrapVue или при использовании подключаемого модуля группы компонентов.

Свойства

Все значения свойств по умолчанию настраиваются глобально.

Свойство (Click to sort ascending)	Тип (Click to sort ascending)	По умолчанию	Описание
`accept`	`String`	`''`	Значение, устанавливаемое для атрибута `accept` входного файла
`autofocus`	`Boolean`	`false`	Если установлено значение `true`, пытается автоматически сфокусировать элемент управления, когда он установлен, или повторно активировать, когда находится в состоянии активности. Не устанавливает атрибут `autofocus` на элементе управления
`browse-text`	`String`	`'Browse'`	Текстовое содержимое для кнопки просмотра файла
`capture`	`Boolean`	`false`	Если установлено, будет указывать браузеру использовать камеру устройства (если поддерживается)
`directory`	`Boolean`	`false`	Включите режим `directory` (в браузерах, которые его поддерживают)
`disabled`	`Boolean`	`false`	Если установлено значение `true`, отключает функциональность компонента и переводит его в отключенное состояние.
`drop-placeholder`	`String`	`'Drop files here'`	Текст, отображаемый в качестве заполнителя, когда файлы перетаскиваются, и их можно оставить
`file-name-formatter`	`Function`		Метод форматирования имен файлов для отображения. Подробности смотрите в документации
`form`	`String`		Идентификатор формы, к которой принадлежит элемент управления формой. Устанавливает атрибут `form` в элементе управления
`id`	`String`		Используется для установки атрибута `id` для визуализированного контента и используется в качестве основы для генерации любых дополнительных идентификаторов элементов по мере необходимости.
`multiple`	`Boolean`	`false`	Если установлено, можно выбрать несколько файлов. `v-model` будет массивом
`name`	`String`		Устанавливает значение атрибута `name` в элементе управления формы
`no-drop`	`Boolean`	`false`	Отключить режим перетаскивания
`no-drop-placeholder`	`String`	`'Not allowed'`	Текст, отображаемый в качестве заполнителя, когда файлы перетаскиваются, и их нельзя бросать
`no-traverse`	`Boolean`	`false`	Следует ли возвращать в виде плоского массива в режиме `directory`
`placeholder`	`String`	`'No file chosen'`	Устанавливает значение атрибута `placeholder` элементе управления формы
`plain`	`Boolean`	`false`	Визуализируйте элемент управления формы в обычном режиме, а не в режиме пользовательского стиля
`required`	`Boolean`	`false`	Добавляет атрибут `required` в элемент управления формы
`size`	`String`		Устанавливает размер внешнего вида компонента. 'sm', 'md' (по умолчанию) или 'lg'
`state`	`Boolean`	`null`	Управляет внешним видом состояния проверки компонента. `true` для действительного, `false` для недопустимого или `null` для отсутствия проверки состояния
`value` v-model	`Array` или `File`	`null`	Текущее значение входного файла. Будет одиночным объектом `File` или массивом объектов `File` (если установлено `multiple` или `directory`). Может иметь значение `null` или пустой массив для сброса ввода файла

`v-model`

Свойство	Событие
`value`	`input`

Слоты

Наименование	Область	Описание
`drop-placeholder`		Контент-заполнитель, когда файлы собираются отбрасывать. По умолчанию значение свойства `drop-placeholder`
`file-name`		Слот с ограниченным размером для форматирования имен файлов
`placeholder`	Нет	Заполнитель содержимого, когда файлы не выбраны. По умолчанию значение свойства `placeholder`

События

Событие	Аргументы	Описание
`change`	`event` - Собственный объект события изменения	Исходное событие изменения ввода
`input`	`file` - Будет одиночным объектом File в одиночном режиме или массивом объектов File в множественном режиме	Обновляет значение `v-model` (подробности смотрите в документации)

Импорт отдельных компонентов

Вы можете импортировать отдельные компоненты в свой проект с помощью следующих именованных экспортов:

Компонент	Именованный экспорт	Путь импорта
`<b-form-file>`	`BFormFile`	`bootstrap-vue`

Пример:

import { BFormFile } from 'bootstrap-vue'
Vue.component('b-form-file', BFormFile)

Импортировать как плагин Vue.js

Этот плагин включает в себя все перечисленные выше отдельные компоненты. Плагины также включают псевдонимы любых компонентов.

Именованный экспорт	Путь импорта
`FormFilePlugin`	`bootstrap-vue`

Пример:

import { FormFilePlugin } from 'bootstrap-vue'
Vue.use(FormFilePlugin)