Merge remote-tracking branch 'origin/develop' into feat/programmatic/…

…devtools

packages/oruga/src/components/autocomplete/examples/readme.md

@@ -1,3 +1,3 @@
 The **Autocomplete** input component allows you to search through a list of options.
 It is an advanced input that provides suggestions as the user types.
-Based on the Dropdown component, the Autocomplete component implements the W3C ARIA APG [Combobox Pattern](https://www.w3.org/WAI/ARIA/apg/patterns/combobox/).
+Based on the Dropdown component, the Autocomplete component implements the W3C ARIA APG [Combobox Pattern](https://www.w3.org/WAI/ARIA/apg/patterns/combobox/).

packages/oruga/src/components/carousel/examples/readme.md

@@ -1 +1 @@
-The **Carousel** component is a slideshow for cycling through elements — images or slides of text—like a carousel.
+The **Carousel** component is a slideshow for cycling through elements — images or slides of text—like a carousel.

packages/oruga/src/components/checkbox/examples/readme.md

@@ -2,4 +2,4 @@ The **Checkbox** input component uses [HTML's native checkbox input](https://dev
 It can display one or many options to a user and is a great way to allow users to select multiple items from a list.
 The component supports single and multiple checkbox inputs.
 The component supports the W3C ARIA APG [Checkbox  Pattern](https://www.w3.org/WAI/ARIA/apg/patterns/checkbox/).
-Use it with the Field component to access all the functionalities.
+Use it with the Field component to access all the functionalities.

packages/oruga/src/components/field/examples/readme.md

@@ -1 +1 @@
-The **Field** component is used to add functionality to controls and to attach/group components and elements together.
+The **Field** component is used to add functionality to controls and to attach/group components and elements together.

packages/oruga/src/components/loading/examples/readme.md

@@ -1 +1 @@
-The **Loading** component allows you to display a loading state for use on a global state or a specific element. 
+The **Loading** component allows you to display a loading state for use on a global state or a specific element. 

packages/oruga/src/components/menu/examples/index.vue

@@ -21,6 +21,39 @@ import OptionsCode from "./options.vue?raw";
         </p>
         <ExampleViewer :component="Links" :code="LinksCode" />
 
-    <h3 id="options">Options</h3>
-    <ExampleViewer :component="Options" :code="OptionsCode" />
+        <h3 id="options">Options</h3>
+        <p>
+            Instead of using the <code>&lt;o-menu-item&gt;</code> component
+            directly inside the default slot, an <code>options</code> prop can
+            be defined, which can be used to define the options
+            programmatically. It accepts several different formats of values:
+        </p>
+        <ul>
+            <li>An array of primitives <code>['A', 'B', 'C']</code></li>
+            <li>
+                An object literal with key-value pairs
+                <code>{ a: 'A', b: 'B', c: 'C' }</code>
+            </li>
+            <li>
+                An array of objects with <code>label</code> and
+                <code>value</code> properties
+            </li>
+            <li>
+                Grouped options by adding additional
+                <code>options</code> to the option object.
+            </li>
+        </ul>
+
+        <div class="info custom-block">
+            <p class="custom-block-title">Note</p>
+            <p>
+                The <code>options</code> prop works the same as the
+                <a href="/components/select.html">
+                    <b>Select</b>
+                </a>
+                input component <code>options</code> prop.
+            </p>
+        </div>
+        <ExampleViewer :component="Options" :code="OptionsCode" />
+    </div>
 </template>

packages/oruga/src/components/pagination/examples/readme.md

@@ -1 +1 @@
-The **Pagination** component is responsive and flexible way to indicate a series of related content exists across multiple pages.
+The **Pagination** component is responsive and flexible way to indicate a series of related content exists across multiple pages.

packages/oruga/src/components/radio/examples/readme.md

@@ -1,3 +1,3 @@
 The **Radio** input component uses [HTML's native radio inputs](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/radio) to allow a user to select one value from a set of options. 
 The component supports the W3C ARIA APG [Radio Group Pattern](https://www.w3.org/WAI/ARIA/apg/patterns/radio/).
-Use it with the Field component to access all the functionalities.
+Use it with the Field component to access all the functionalities.

packages/oruga/src/components/select/examples/readme.md

@@ -1,3 +1,3 @@
 The **Select** input component uses [HTML's native select input](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select).
 Select inputs can be single value selections, or multi-value selections by using the `multiple` attribute. 
-Use it with the Field component to access all the functionalities.
+Use it with the Field component to access all the functionalities.

packages/oruga/src/components/skeleton/examples/readme.md

@@ -1 +1 @@
-The **Skeleton** component is a placeholder for content to load.
+The **Skeleton** component is a placeholder for content to load.

packages/oruga/src/components/slider/examples/readme.md

@@ -1,3 +1,3 @@
 The **Slider** input component let user select a value or range from a given range with a graphic slider.
 The component implements the W3C ARIA APG [Slider Pattern](https://www.w3.org/WAI/ARIA/apg/patterns/slider/).
-Use it with the Field component to access all the functionalities.
+Use it with the Field component to access all the functionalities.

packages/oruga/src/components/switch/examples/readme.md

@@ -1,4 +1,4 @@
 The **Switch** input component — sometimes called a "toggle" — offers a choice between one of two values; 
 it's a great option when you want the user to toggle a feature on or off.
 This component implements the W3C ARIA APG [Switch Pattern](https://www.w3.org/WAI/ARIA/apg/patterns/switch/).
-Use it with the Field component to access all the functionalities.
+Use it with the Field component to access all the functionalities.

packages/oruga/src/components/taginput/examples/readme.md

@@ -1,3 +1,3 @@
 The **Taginput** input component allows users to search through a list of options and apply any number of tags. 
 The component is based on the Autocomplete component and supports the W3C ARIA APG [Combobox Pattern](https://www.w3.org/WAI/ARIA/apg/patterns/combobox/).
-Use it with the Field component to access all the functionalities.
+Use it with the Field component to access all the functionalities.

packages/oruga/src/components/upload/examples/readme.md

@@ -1,2 +1,2 @@
 The **Upload** input component uses [HTML's native file input](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file). It allows users to select files from their device for upload. In addition to native input features, it adds support for Drag and drop and clearing the input.
-Use it with the Field component to access all the functionalities.
+Use it with the Field component to access all the functionalities.