vuex README

The project's README from github.com/vuejs/vuex. As one markdown file: README.md.

Vuex

npm ci status


Pinia is now the new default

The official state management library for Vue has changed to Pinia. Pinia has almost the exact same or enhanced API as Vuex 5, described in Vuex 5 RFC. You could simply consider Pinia as Vuex 5 with a different name. Pinia also works with Vue 2.x as well.

Vuex 3 and 4 will still be maintained. However, it's unlikely to add new functionalities to it. Vuex and Pinia can be installed in the same project. If you're migrating existing Vuex app to Pinia, it might be a suitable option. However, if you're planning to start a new project, we highly recommend using Pinia instead.


Vuex is a state management pattern + library for Vue.js applications. It serves as a centralized store for all the components in an application, with rules ensuring that the state can only be mutated in a predictable fashion. It also integrates with Vue's official devtools extension to provide advanced features such as zero-config time-travel debugging and state snapshot export / import.

Learn more about Vuex at "What is Vuex?", or get started by looking into full documentation.

Documentation

To check out docs, visit vuex.vuejs.org.

Examples

You may find example applications built with Vuex under the examples directory.

Running the examples:

$ npm install
$ npm run dev # serve examples at localhost:8080

Questions

For questions and support please use the Discord chat server or the official forum. The issue list of this repo is exclusively for bug reports and feature requests.

Issues

Please make sure to read the Issue Reporting Checklist before opening an issue. Issues not conforming to the guidelines may be closed immediately.

Changelog

Detailed changes for each release are documented in the release notes.

Stay In Touch

For latest releases and announcements, follow on Twitter: @vuejs.

Contribution

Please make sure to read the Contributing Guide before making a pull request.

License

MIT

Copyright (c) 2015-present Evan You

vuex (vuejs/vuex)

Searching Database…

28.3K ·GitHub
Что это такое?Vuex — это паттерн управления состоянием и библиотека для приложений на Vue.js: единое централизованное хранилище, общее для всех компонентов, которое меняется только предсказуемым образом.
Vuex — это отдельный инструмент или библиотека, которую я добавляю в своё Vue-приложение?Это библиотека, которую вы подключаете к Vue-приложению, а не отдельная программа. Каждый компонент читает данные из одного общего хранилища, а правила гарантируют, что состояние меняется только предсказуемо.
Как добавить его в проект и где найти документацию?Установите npm-пакет vuex в свой Vue-проект и следуйте руководству на vuex.vuejs.org. В репозитории также есть готовые примеры приложений в каталоге examples.
Нужно ли Vuex что-то ещё, кроме самого Vue?Нет. Его единственная runtime-зависимость — пакет @vue/devtools-api, который обеспечивает интеграцию с официальным расширением Vue devtools.
В README сказано, что Pinia — новое стандартное решение. Что это значит для меня, если я присматриваюсь к Vuex?Vuex находится в режиме поддержки: версии 3 и 4 по-прежнему сопровождаются, но вряд ли получат новые возможности. Команда настоятельно рекомендует Pinia для новых проектов, поэтому Vuex имеет смысл в основном для существующих приложений.
Что такое Pinia — та самая рекомендованная замена?Это актуальная официальная библиотека управления состоянием для Vue. Её API практически идентичен тому, что планировалось в Vuex 5, или расширяет его, так что её можно считать Vuex 5 под другим именем; к тому же она поддерживает и Vue 2.x.
Что мне реально даёт интеграция с devtools?Отладку с перемещением во времени (time-travel debugging) без всякой настройки — можно шагать назад по изменениям состояния — плюс экспорт и импорт снимков состояния, и всё это через официальное расширение Vue devtools.
Можно попробовать его, не встраивая сразу в своё приложение?Да. В репозитории есть примеры приложений в каталоге examples, а команда npm run dev запускает локальный сервер с примером (node examples/server.js, порт 8080).
У меня уже есть приложение на Vuex — реально ли переехать на Pinia?Да, и спешить некуда: Vuex и Pinia можно установить в одном проекте — в README это названо подходящим вариантом для миграции существующего приложения с Vuex на Pinia.
What are similar projects?formily, core, vue, nuxt, hyperapp, taro, zustand, relay
Creator
vuejs
Size
16.2 MB
Stars
28.3K
Age
11y
Commits · 90 Days