diff --git a/docs/ru/features/postcss.md b/docs/ru/features/postcss.md index 7b20bd087..b84a22439 100644 --- a/docs/ru/features/postcss.md +++ b/docs/ru/features/postcss.md @@ -4,7 +4,7 @@ ## Использование файла конфигурации -Начиная с версии 11.0 `vue-loader` поддерживает файлы конфигурации PostCSS поддерживаемые с помощью [`postcss-loader`](https://github.com/postcss/postcss-loader#usage): +`vue-loader` поддерживает файлы конфигурации PostCSS поддерживаемые с помощью [`postcss-loader`](https://github.com/postcss/postcss-loader#usage): - `postcss.config.js` - `.postcssrc` @@ -12,6 +12,17 @@ Рекомендуется использовать файл конфигурации, это позволяет использовать один и тот же конфиг для обработки ваших CSS файлов, обрабатываемых `postcss-loader` и CSS внутри `*.vue` файлов. +## Использование с `postcss-loader` + +Поскольку `vue-loader` обрабатывает PostCSS внутри стилей своими силами, вам может потребоваться только применить `postcss-loader` к отдельным CSS-файлам. Нет необходимости указывать `lang="postcss"` в блоке стилей, если в вашем проекте есть конфигурационный файл PostCSS. + +Иногда пользователь может захотеть использовать `lang="postcss"` только для целей подсветки синтаксиса. Начиная с версии 13.6.0, если никакой загрузчик не был явно настроен для частоиспользуемых расширений PostCSS (через собственную опцию `loaders` у `vue-loader`), они будут просто подвержены стандартной трансформации PostCSS в `vue-loader`: + +- `postcss` +- `pcss` +- `sugarss` +- `sss` + ## Указание настроек в опциях vue-loader В качестве альтернативы, вы можете указать конфигурацию PostCSS специально для `*.vue` файлов с помощью опции `postcss` для `vue-loader`. @@ -66,3 +77,17 @@ module.exports = { } } ``` + +### Отключение автозагрузки файла конфигурации + +С версии `13.6.0+`, автозагрузку файла конфигурации postcss можно отключить с помощью опции `postcss.useConfigFile: false`: + +``` js +postcss: { + useConfigFile: false, + plugins: [/* ... */], + options: {/* ... */} +} +``` + +Это позволяет конфигурации postcss внутри файлов `*.vue` быть полностью конфигурируемой через inline-конфигурацию. \ No newline at end of file diff --git a/docs/ru/options.md b/docs/ru/options.md index 6e57a70e7..15ba137e9 100644 --- a/docs/ru/options.md +++ b/docs/ru/options.md @@ -137,6 +137,15 @@ module.exports = { Предоставляет контекст для плагинов PostCSS. См. подробнее в [документации postcss-loader](https://github.com/postcss/postcss-loader#context-ctx). +### postcss.useConfigFile + +> Добавлено в версии 13.6.0 + +- Тип: `boolean` +- По умолчанию: `true` + + Установка в значение `false` отключает автозагрузку файла конфигурации postcss. + ### cssSourceMap - Тип: `boolean` diff --git a/docs/ru/workflow/testing-with-mocks.md b/docs/ru/workflow/testing-with-mocks.md index 57b4e6cd5..2f5fc299b 100644 --- a/docs/ru/workflow/testing-with-mocks.md +++ b/docs/ru/workflow/testing-with-mocks.md @@ -6,6 +6,8 @@ `vue-loader` предоставляет возможность внедрять произвольные зависимости в `*.vue` компоненты, используя [inject-loader](https://github.com/plasticine/inject-loader). Основная идея состоит в том, что вместо прямой подгрузки модуля компонента мы используем `inject-loader`, чтобы создать "фабричную функцию" для этого модуля. Когда мы вызовем эту функцию с мок-объектом, она вернет нам экземпляр модуля с внедренными мок-объектами. +> Примечание: Вы должны отключить опцию `esModule` в режиме инжектирования, иначе вы получите ошибку. + Допустим, у нас есть следующий компонент: ``` html @@ -16,9 +18,9 @@