primevue-mirror/apps/showcase/doc/guides/migration/v4/changes/BreakingDoc.vue

69 lines
4.5 KiB
Vue

<template>
<DocSectionText v-bind="$attrs">
<h4>SASS Themes</h4>
<p>
The styled mode theming has been reimplemented from scratch based on an all-new architecture. The <i>theme.css</i> and the <i>primevue/resources</i> do not exist anymore, so any imports of these assets needs to be removed. Currently, Aura
is the only available built-in preset; however, by v4 final, two more presets named Lara and Nora would be included, as well as the Material Design theme. If you had a custom theme for v3, the theme needs to be recreated using the new
APIs. See the customization section at <NuxtLink to="/theming/styled">styled mode</NuxtLink> for details.
</p>
<h4>Removed Components</h4>
<ul class="flex flex-col gap-2 leading-normal">
<li><i class="mark">TriStateCheckbox</i> | Use Checkbox with indeterminate option.</li>
<li><i class="mark">DataViewLayoutOptions</i> | Use SelectButton instead.</li>
</ul>
<h4>Removed APIs</h4>
<ul class="flex flex-col gap-2 leading-normal">
<li><i class="mark">switchTheme</i> function, use the new APIs like <i class="mark">usePreset</i> instead to dynamic theme switching.</li>
</ul>
<h4>Removed Files</h4>
<ul class="flex flex-col gap-2 leading-normal">
<li>Themes under the <i class="mark">primevue/resources</i> path, migration to new styled mode is necessary.</li>
<li>The legacy Tailwind preset at <i class="mark">primevue/passthrough/tailwind</i>, migrate to the <a href="https://tailwind.primevue.org" target="_blank" rel="noopener noreferrer" class="doc-link">Tailwind Presets</a> project.</li>
</ul>
<h4>Message and InlineMessage</h4>
<p>
<i class="mark">InlineMessage</i> is deprecated due to overlap with the <i>Message</i>. The spacing, closable and life properties of the <i>Message</i> have breaking changes to provide <i>InlineMessage</i> functionality. Default margin is
removed, closable is false by default and messages do not disappear automatically.
</p>
<h4>PT Section Names</h4>
<p>
The experimental PassThrough feature is not production ready, there are changes on the PT section names due to alignment with CSS classes for certain components. If when component element is another PrimeVue component <i>pc</i> prefix is
added for indication. Review the <i>Pass Through</i> section of a component for the new API. The Tailwind CSS presets for the unstyled mode are not updated to v4 yet.
</p>
<h4>Removed Features</h4>
<ul class="flex flex-col gap-2 leading-normal">
<li>Sidebar/Drawer <i class="mark">size</i> property is removed, use a responsive class utilty as replacement, demos have new examples.</li>
<li>Rating <i class="mark">cancel</i> prop is removed as toggling the selected star value clears it.</li>
<li>Inplace <i class="mark">closable</i> is removed in favor of templating and <i>closeCallback</i> prop.</li>
</ul>
<h4>Removed Style Classes</h4>
<ul class="flex flex-col gap-2 leading-normal">
<li><i class="mark">.p-link</i>, use a button in link mode.</li>
<li><i class="mark">.p-highlight</i>, each component have its own class such as <i class="mark">.p-select-option-selected</i>.</li>
<li><i class="mark">.p-fluid</i>, use the new built-in <i class="mark">fluid</i> properties of components.</li>
</ul>
<h4>Tailwind CSS Presets</h4>
<p>
The <a href="https://tailwind.primevue.org" target="_blank" rel="noopener noreferrer" class="doc-link">Tailwind CSS</a> presets for the unstyled mode do not support v4 yet, an update is under development and scheduled for the end of July
2024.
</p>
<h4>Premium Templates</h4>
<p>Application templates like Apollo do not support v4 yet, all templates will be updated to v4 by the end of August 2024 with new enhancements based on new theming api.</p>
<h4>Nuxt Module</h4>
<p>
The <a href="https://www.npmjs.com/package/nuxt-primevue" target="_blank" rel="noopener noreferrer" class="doc-link">nuxt-primevue</a> module has been replaced with the new
<a href="https://www.npmjs.com/package/@primevue/nuxt-module" target="_blank" rel="noopener noreferrer" class="doc-link">@primevue/nuxt-module</a>. The old module is still maintained for v3 users.
</p>
</DocSectionText>
</template>