bitrix-vue
BitrixVue 3 (ui.vue3): createApp, $Bitrix.Loc, Pinia и компоненты ядра в страницах и расширениях Битрикс. Используй для реактивного интерфейса, состояния, виджетов и миграции с Vue 2.
How do I install this agent skill?
npx skills add https://github.com/bxmaximum/bitrix-framework-skills --skill bitrix-vueIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides comprehensive documentation and code snippets for integrating Vue 3 within the Bitrix CMS framework. It covers the creation of reactive components, migration from Vue 2, and the use of core Bitrix UI libraries. No malicious patterns or security vulnerabilities were identified.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
BitrixVue 3
Baseline: main 23.0+ · Verified: main 26.1000.0, ui 26.700.0
Перед PHP-кодом прочитай bitrix-framework, если ещё не читал его в этой задаче.
ui.vue3 — Vue 3 с плагином BitrixVue ($Bitrix), единый экземпляр на страницу. Компиляция шаблонов во время выполнения; SFC .vue и SSR нет. Vue 2 (ui.vue, глобальный BX.BitrixVue) устарел, новый код пиши на Vue 3.
В расширении (предпочтительно)
import { BitrixVue, ref } from 'ui.vue3';
BitrixVue.createApp({
setup() {
return { items: ref([]) };
},
mounted() {
BX.ajax.runAction('vendor:module.item.list').then((r) => {
this.items = r.data.items;
});
},
template: `
<h2>{{ $Bitrix.Loc.getMessage('VENDOR_ITEMS_TITLE') }}</h2>
<div v-for="item in items" :key="item.id">{{ item.name }}</div>
`,
}).mount('#vendor-items');
- Импортируй
BitrixVueи API Vue (ref,computed,markRaw,defineComponent…) изui.vue3, как ядро, а не изui.vue3.bitrixvue. Достаточноrel: ['ui.vue3']. - Настройка расширения и фраз:
bitrix-extensions.
На PHP-странице без сборки
\Bitrix\Main\UI\Extension::load('ui.vue3');
<div id="vendor-app"></div>
<script>
BX.Vue3.BitrixVue.createApp({ template: '<div>Здравствуйте</div>' }).mount('#vendor-app');
</script>
Глобальный объект — BX.Vue3.BitrixVue. BX.BitrixVue — Vue 2: здесь он не определён либо молча запустит Vue 2, если загружен и ui.vue.
$Bitrix в каждом компоненте
| Член | Назначение |
|---|---|
$Bitrix.Loc.getMessage(code, {'#N#': n}) | Фразы из BX.message; вне Vue — Loc из main.core |
$Bitrix.eventEmitter | EventEmitter приложения |
$Bitrix.Data.get/set | Общие данные приложения |
$Bitrix.RestClient.get() / $Bitrix.PullClient.get() | Клиенты REST / Pull по умолчанию (bitrix-pull) |
BitrixVue.getFilteredPhrases(this, 'VENDOR_'): первый аргумент в Vue 3 — экземпляр компонента (документация показывает форму Vue 2 без него).
Готовые средства ядра
- Компоненты:
ui.vue3.components.*(button,popup,hint,switcher…), напримерimport { Counter } from 'ui.vue3.components.counter'(components: { Counter }→<Counter :value="5"/>; Since ui 26.200*; на старом ядре оберниui.cntсамостоятельно). Настройки виджетов:bitrix-ui. - Состояние и маршруты:
ui.vue3.pinia,ui.vue3.vuex,ui.vue3.router. - Отложенный компонент:
BitrixVue.defineAsyncComponent('vendor.module.heavy', 'HeavyForm')загружает расширение при первом выводе. - Расширяемый компонент:
BitrixVue.mutableComponent(name, def); изменения черезmutateComponent()/cloneComponent().
Виджеты ядра внутри Vue
Экземпляры Popup / Menu / Dialog / Popover / ActionPanel оставляй нереактивными: this.popup = markRaw(new Popup(...)) либо храни вне data(). Виджеты, переделанные с ui 26.650, используют нативные поля #private; реактивный Proxy вызывает TypeError: Cannot read private member.
Отладка
define('VUEJS_DEBUG', true); в /local/php_interface/init.php включает отладочную сборку и devtools только для разработки. Вместе с ним VUEJS_LOCALIZATION_DEBUG показывает коды фраз вместо текста.
Переход с Vue 2 (ui.vue)
BX.BitrixVue/import … from 'ui.vue'→ui.vue3.BitrixVue.component()/.directive()не регистрируют компоненты в Vue 3 (ошибка в консоли). Используй локальныеcomponents: {},app.component()либоmutableComponent().getFilteredPhrases(prefix)→getFilteredPhrases(this, prefix);destroyed→unmounted; фильтров и$on/$offнет.
Проверка
- Только
ui.vue3, все импорты из него; встроенные скрипты используютBX.Vue3.BitrixVue. - Экземпляры виджетов ядра обёрнуты в
markRaw(). - Фразы читаются через
$Bitrix.Loc/Loc, не зашиты в код. - Engine вызывается через HttpClient.action() при поддержке ядром либо BX.ajax.runAction(), с CSRF; контракт —
bitrix-extensions. - Подписки Pull сняты в
unmounted.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/bxmaximum/bitrix-framework-skills/bitrix-vue">View bitrix-vue on skillZs</a>