72 lines
2.7 KiB
Vue
72 lines
2.7 KiB
Vue
<template>
|
|
<DocSectionText v-bind="$attrs">
|
|
<p>
|
|
The <i>@layer</i> is a standard CSS feature to define cascade layers for a customizable order of precedence. If you need to become more familiar with layers, visit the documentation at
|
|
<a href="https://developer.mozilla.org/en-US/docs/Web/CSS/@layer" class="doc-link">MDN</a> to begin with. In styled mode, when the <i>cssLayer</i> option is enabled at theme configuration, PrimeVue wraps the built-in style classes under
|
|
the <i>primevue</i> cascade layer to make the library styles easy to override. CSS in your app without a layer has the highest CSS specificity, so you'll be able to override styles regardless of the location or how strong a class is
|
|
written. The <i>cssLayer</i> is disabled by default to avoid compatibility issues with 3rd party CSS libraries which require a layer configuration for compatibility that is discussed in the next reset section.
|
|
</p>
|
|
<p>
|
|
For example, let's assume you need to remove the rounded borders of the ToggleSwitch component defined by the theme in use. In order to achieve this, <i>.p-toggleswitch .p-toggleswitch-slider</i> selector needs to be overriden. Without
|
|
the layers, we'd have to write a stronger css or use <i>!important</i>, however, with layers, this does not present an issue as your CSS can always override PrimeVue with a more straightforward class name such as <i>my-switch-slider</i>.
|
|
Another advantage of this approach is that it does not force you to figure out the built-in class names of the components.
|
|
</p>
|
|
<div class="card flex justify-center">
|
|
<ToggleSwitch v-model="checked" :pt="{ slider: 'my-switch-slider', handle: 'my-switch-handle', icon: 'my-switch-icon' }" />
|
|
</div>
|
|
<DocSectionCode :code="code" hideToggleCode hideStackBlitz />
|
|
<p>Layers also make it easier to use CSS Modules, view the CSS Modules guide for examples.</p>
|
|
</DocSectionText>
|
|
</template>
|
|
|
|
<script>
|
|
export default {
|
|
data() {
|
|
return {
|
|
checked: false,
|
|
code: {
|
|
basic: `
|
|
<template>
|
|
<ToggleSwitch v-model="checked" :pt="{ slider: 'my-switch-slider', handle: 'my-switch-handle', icon: 'my-switch-icon' }" />
|
|
</template>
|
|
|
|
<script>
|
|
import { ref } from "vue";
|
|
|
|
const checked = ref(false);
|
|
<\/script>
|
|
|
|
<style>
|
|
.my-switch-slider {
|
|
border-radius: 0;
|
|
}
|
|
|
|
.my-switch-handle {
|
|
border-radius: 0;
|
|
}
|
|
|
|
.my-switch-icon {
|
|
display: none !important;
|
|
}
|
|
</style>
|
|
`
|
|
}
|
|
};
|
|
}
|
|
};
|
|
</script>
|
|
|
|
<style>
|
|
.my-switch-slider {
|
|
border-radius: 0;
|
|
}
|
|
|
|
.my-switch-handle {
|
|
border-radius: 0;
|
|
}
|
|
|
|
.my-switch-icon {
|
|
display: none !important;
|
|
}
|
|
</style>
|