feat(CFormSwitch): add a reverse property to allow put switches to the opposite side

Author: mrholek

packages/coreui-vue/src/components/form/CFormSwitch.ts

@@ -31,6 +31,12 @@ const CFormSwitch = defineComponent({
       type: [Boolean, String],
       value: undefined,
     },
+    /**
+     * Put checkboxes or radios on the opposite side.
+     *
+     * @sinve 4.8.0
+     */
+    reverse: Boolean,
     /**
      * Size the component large or extra large. Works only with `switch`.
      *
@@ -82,6 +88,7 @@ const CFormSwitch = defineComponent({
           class: [
             'form-check form-switch',
             {
+              'form-check-reverse': props.reverse,
               [`form-switch-${props.size}`]: props.size,
               'is-invalid': props.invalid,
               'is-valid': props.valid,

packages/docs/forms/switch.md

@@ -5,9 +5,13 @@ description: Create consistent cross-browser and cross-device switch component.
 other_frameworks: switch
 ---
 
-## Switches
+## About
 
-A switch has the markup of a custom checkbox but uses the `switch` boolean properly to render a toggle switch. Switches also support the `disabled` attribute.
+Vue Switch Components are a type of UI component that allows users to toggle between two states, usually represented as "on" or "off", "enabled" or "disabled", or "checked" or "unchecked".
+
+When a user interacts with the component by clicking or tapping on it, the switch toggles its state, triggering an action or changing the appearance of the component. This type of component is often used in forms, settings panels, and other places where users need to turn something on or off or choose between two options.
+
+## Example
 
 ::: demo
 <CFormSwitch label="Default switch checkbox input" id="formSwitchCheckDefault"/>
@@ -22,7 +26,9 @@ A switch has the markup of a custom checkbox but uses the `switch` boolean prope
 <CFormSwitch label="Disabled checked switch checkbox input" id="formSwitchCheckCheckedDisabled" checked disabled/>
 ```
 
-### Sizes
+## Sizing
+
+Larger or smaller react switches? Add `size="lg"` or `size="xl"` for additional sizes.
 
 ::: demo
 <CFormSwitch label="Default switch checkbox input" id="formSwitchCheckDefault"/>
@@ -35,6 +41,19 @@ A switch has the markup of a custom checkbox but uses the `switch` boolean prope
 <CFormSwitch size="xl" label="Extra large switch checkbox input" id="formSwitchCheckDefaultXL"/>
 ```
 
+## Reverse 
+
+Put your switches on the opposite side by adding `reverse` boolean property.
+
+::: demo
+<CFormSwitch reverse type="radio" id="reverseFormSwitch1" label="Reverse switch"/>
+<CFormSwitch reverse type="radio" id="reverseFormSwitch2" label="Disabled reverse switch" disabled/>
+:::
+```vue
+<CFormSwitch reverse type="radio" id="reverseFormSwitch1" label="Reverse switch"/>
+<CFormSwitch reverse type="radio" id="reverseFormSwitch2" label="Disabled reverse switch" disabled/>
+```
+
 ## API
 
 !!!include(./api/form/CFormSwitch.api.md)!!!