Sync with Kendo UI Professional

Author: Kendo Bot

docs-aspnet-core/_config.yml

@@ -120,12 +120,6 @@ navigation:
      "html-helpers/data-management/grid/performance":
         title: "Performance Tips"
         position: 17
-     "html-helpers/data-management/grid/globalization":
-        title: "Globalization"
-        position: 50
-     "html-helpers/data-management/grid/accessibility":
-        title: "Accessibility"
-        position: 60
      "html-helpers/data-management/treelist/editing":
         title: "Editing"
         position: 3
@@ -135,12 +129,6 @@ navigation:
      "html-helpers/data-management/treelist/columns":
         title: "Columns"
         position: 7
-     "html-helpers/data-management/treelist/globalization":
-        title: "Globalization"
-        position: 40
-     "html-helpers/data-management/treelist/accessibility":
-        title: "Accessibility"
-        position: 50
      "html-helpers/data-management/pivotgrid":
         title: "PivotGrid"
      "html-helpers/data-management/spreadsheet/import-and-export-data":
@@ -149,65 +137,11 @@ navigation:
         title: "End-User Documentation"
      "html-helpers/editors":
         title: "Editors"
-     "html-helpers/editors/autocomplete/accessibility":
-        title: "Accessibility"
-        position: 50
-     "html-helpers/editors/combobox/accessibility":
-        title: "Accessibility"
-        position: 50
-     "html-helpers/editors/daterangepicker/globalization":
-        title: "Globalization"
-        position: 40
-     "html-helpers/editors/daterangepicker/accessibility":
-        title: "Accessibility"
-        position: 50
-     "html-helpers/editors/datetimepicker/globalization":
-        title: "Globalization"
-        position: 40
-     "html-helpers/editors/datetimepicker/accessibility":
-        title: "Accessibility"
-        position: 50
-     "html-helpers/editors/dropdownlist/accessibility":
-        title: "Accessibility"
-        position: 50
-     "html-helpers/editors/dropdowntree/accessibility":
-        title: "Accessibility"
-        position: 50
-     "html-helpers/editors/editor/accessibility":
-        title: "Accessibility"
-        position: 50
-     "html-helpers/editors/listbox/globalization":
-        title: "Globalization"
-        position: 40
-     "html-helpers/editors/listbox/accessibility":
-        title: "Accessibility"
-        position: 50
-     "html-helpers/editors/multicolumncombobox/accessibility":
-        title: "Accessibility"
-        position: 50
-     "html-helpers/editors/multiselect/accessibility":
-        title: "Accessibility"
-        position: 50
-     "html-helpers/editors/numerictextbox/accessibility":
-        title: "Accessibility"
-        position: 50
-     "html-helpers/editors/rating/accessibility":
-        title: "Accessibility"
-        position: 50
-     "html-helpers/editors/switch/accessibility":
-        title: "Accessibility"
-        position: 50
-     "html-helpers/editors/upload/accessibility":
-        title: "Accessibility"
-        position: 50
      "html-helpers/editors/listbox/binding":
         title: "Data Binding"
         position: 2
      "html-helpers/editors/flatcolorpicker":
         title: "FlatColorPicker"
-     "html-helpers/editors/datepicker/accessibility":
-        title: "Accessibility"
-        position: 50
      "html-helpers/charts":
         title: "Charts"
      "html-helpers/charts/chart":
@@ -248,24 +182,18 @@ navigation:
      "html-helpers/navigation/menu/contextmenu":
         title: "ContextMenu"
         position: 3
-     "html-helpers/navigation/menu/accessibility":
-        title: "Accessibility"
-        position: 50
      "html-helpers/conversational-ui":
         title: "Conversational UI"
         isNew: true
      "html-helpers/conversational-ui/chat":
         title: "Chat"
      "html-helpers/interactivity":
         title: "Interactivity and UX"
+     "html-helpers/interactivity/sortable/integration":
+        title: "Integration"
+        position: 6
      "html-helpers/media":
         title: "Media"
-     "html-helpers/media/mediaplayer/globalization":
-        title: "Globalization"
-        position: 40
-     "html-helpers/media/mediaplayer/accessibility":
-        title: "Accessibility"
-        position: 50
      "html-helpers/pdf":
         title: "PDF"
      "html-helpers/pdf/pdfviewer":
@@ -331,9 +259,6 @@ navigation:
         title: "ButtonGroup"
      "html-helpers/scheduling/calendar":
         title: "Calendar"
-     "html-helpers/scheduling/calendar/accessibility":
-        title: "Accessibility"
-        position: 50
      "html-helpers/scheduling/multiviewcalendar":
         title: "MultiViewCalendar"
      "tag-helpers/scheduling/multiviewcalendar":
@@ -446,8 +371,12 @@ navigation:
         title: "Templates"
      "*switch":
         title: "Switch"
+     "*/globalization":
+        title: "Globalization"
+        position: 50
      "*/accessibility":
         title: "Accessibility"
+        position: 60
 
 ## The application virtual path
 baseurl: /aspnet-core

docs-aspnet-core/html-helpers/editors/listbox/globalization/rtl-support.md

@@ -1,7 +1,7 @@
 ---
 title: RTL Support
 page_title: Right-to-Left Support | Telerik UI ListBox HtmlHelper for ASP.NET Core
-description: "Configure the Telerik UI ListBox for ASP.NET Core to enable its RTL functionality."
+description: "Get started with the Telerik UI ListBox for ASP.NET Core and learn about the RTL supports it provides."
 slug: htmlhelpers_listbox_rtl_aspnetcore
 position: 3
 ---
@@ -14,4 +14,5 @@ For more information, refer to the [demo on RTL support by the ListBox](https://
 
 ## See Also
 
+* [RTL Support by the ListBox HtmlHelper for ASP.NET Core (Demo)](https://demos.telerik.com/aspnet-core/listbox/right-to-left-support)
 * [Server-Side API](/api/listbox)

docs-aspnet-core/html-helpers/editors/maskedtextbox/accessibility.md

@@ -0,0 +1,31 @@
+---
+title: Accessibility
+page_title: MaskedTextBox Accessibility | Telerik UI MaskedTextBox HtmlHelper for ASP.NET Core
+description: "Get started with the Telerik UI MaskedTextBox for ASP.NET Core and learn about its accessibility support for WAI-ARIA, Section 508, and WCAG 2.1."
+slug: accessibility_maskedtextbox_aspnetcore
+position: 60
+---
+
+# MaskedTextBox Accessibility
+
+The MaskedTextBox is accessible by screen readers and provides WAI-ARIA, Section 508, WCAG 2.1, and keyboard support.
+
+For more information, refer to the article on [accessibility in Telerik UI for ASP.NET Core]({% slug overview_accessibility %}).
+
+## WAI-ARIA
+
+The component follows the WAI-ARIA Authoring Practices for implementing the keyboard navigation for its component role and is tested against the popular screen readers.
+
+## Section 508
+
+The MaskedTextBox is compliant with the Section 508 requirements.
+
+## WCAG 2.1
+
+The MaskedTextBox supports the standards for providing accessible web content which are set by the [Web Content Accessibility Guidelines 2.1](https://www.w3.org/TR/WCAG/).
+
+## See Also
+
+* [Basic Usage of the MaskedTextBox HtmlHelper for ASP.NET Core (Demo)](https://demos.telerik.com/aspnet-core/maskedtextbox/index)
+* [Using the API of the MaskedTextBox HtmlHelper for ASP.NET Core (Demo)](https://demos.telerik.com/aspnet-core/maskedtextbox/api)
+* [Server-Side API](/api/maskedtextbox)

docs-aspnet-core/html-helpers/editors/maskedtextbox/globalization/overview.md

@@ -0,0 +1,24 @@
+---
+title: Overview
+page_title: MaskedTextBox Globalization | Telerik UI MaskedTextBox HtmlHelper for ASP.NET Core
+description: "Get started with the Telerik UI MaskedTextBox for ASP.NET Core and learn about the globalization options it supports."
+slug: globalization_maskedtextbox_aspnetcore
+position: 1
+---
+
+# MaskedTextBox Globalization
+
+The globalization process combines the translation of component messages (localization) with adapting them to specific cultures (internationalization and right-to-left support).
+
+To determine the currency symbol and other culture-specific properties, the MaskedTextBox uses the `kendo.culture.current` culture.
+
+The globalization functionality of the MaskedTextBox is enabled through its [right-to-left support]({% slug rtl_maskedtextbox_aspnetcore %}). For a complete example, refer to the [demo on globalization of the MaskedTextBox](https://demos.telerik.com/aspnet-core/maskedtextbox/globalization).
+
+For more information on using localization and right-to-left languages with Telerik UI for ASP.NET Core HTML Helpers, refer to the article on [globalization support by Telerik UI for ASP.NET Core]({% slug overview_globalization_core %}).
+
+## See Also
+
+* [RTL Support by the MaskedTextBox HtmlHelper for ASP.NET Core (Demo)](https://demos.telerik.com/aspnet-core/maskedtextbox/right-to-left-support)
+* [Globalization by the MaskedTextBox HtmlHelper for ASP.NET Core (Demo)](https://demos.telerik.com/aspnet-core/maskedtextbox/globalization)
+* [Globalization in Telerik UI for ASP.NET Core]({% slug overview_globalization_core %})
+* [Server-Side API](/api/maskedtextbox)

docs-aspnet-core/html-helpers/editors/maskedtextbox/globalization/rtl-support.md

@@ -0,0 +1,18 @@
+---
+title: RTL Support
+page_title: Right-to-Left Support | Telerik UI MaskedTextBox HtmlHelper for ASP.NET Core
+description: "Get started with the Telerik UI MaskedTextBox for ASP.NET Core and learn about the RTL supports it provides."
+slug: rtl_maskedtextbox_aspnetcore
+position: 2
+---
+
+# Right-to-Left Support
+
+Right-to-left (RTL) support reflects the ability of a widget to render its content in a right-to-left direction for right-to-left languages, such as Arabic, Hebrew, Chinese, or Japanese.
+
+For more information, refer to the [demo on RTL support by the MaskedTextBox](https://demos.telerik.com/aspnet-core/maskedtextbox/right-to-left-support).
+
+## See Also
+
+* [RTL Support by the MaskedTextBox HtmlHelper for ASP.NET Core (Demo)](https://demos.telerik.com/aspnet-core/maskedtextbox/right-to-left-support)
+* [Server-Side API](/api/maskedtextbox)

docs-aspnet-core/html-helpers/editors/maskedtextbox/overview.md

@@ -29,7 +29,9 @@ The following example demonstrates the basic configuration for the MaskedTextBox
 
 ## Functionality and Features
 
-The MaskedTextBox provides options for [using predefined and custom masks rules and validate user input]({% slug validation_maskedtextbox_aspnetcore %}).
+* [Mask rules]({% slug validation_maskedtextbox_aspnetcore %})
+* [Globalization]({% slug globalization_maskedtextbox_aspnetcore %})
+* [Accessibility]({% slug accessibility_maskedtextbox_aspnetcore %})
 
 ## Events
 
@@ -53,7 +55,7 @@ The following example demonstrates how to subscribe to events by a handler name.
 
 ## Referencing Existing Instances
 
-To reference an existing Telerik UI MaskedTextBox instance, use the [`jQuery.data()`](http://api.jquery.com/jQuery.data/) method. Once a reference is established, use the [MaskedTextBox API](/api/maskedtextbox) to control its behavior.
+To reference an existing Telerik UI MaskedTextBox instance, use the [`jQuery.data()`](http://api.jquery.com/jQuery.data/) method. Once a reference is established, use the [MaskedTextBox client-side API](/api/maskedtextbox) to control its behavior.
 
 The following example demonstrates how to access an existing MaskedTextBox instance.
 

docs-aspnet-core/html-helpers/interactivity/sortable/common-scenarios.md

@@ -0,0 +1,135 @@
+---
+title: Common Scenarios
+page_title: Common Scenarios | Telerik UI Sortable HtmlHelper for ASP.NET Core
+description: "Get started with the Telerik UI Sortable HtmlHelper for ASP.NET Core and learn check out the common scenarios."
+slug: htmlhelpers_sortable_aspnetcore_common_scenarios
+position: 7
+---
+
+# Common Scenarios
+
+This article provides common scenarios you might encounter when working with the Telerik UI Sortable HtmlHelper for ASP.NET Core.
+
+* [Persisting the current items order](#persisting-the-current-items-order)
+* [Handling items which contain input elements](#handling-items-with-input-elements)
+* [Handling the selection of radio buttons](#handling-radio-button-selection)
+
+## Persisting the Current Items Order
+
+By default, the Sortable does not persist the order of the current items. To detect when changes in the items order occur and save them either in local storage or submit them to the server with [`jQuery.ajax`](http://api.jquery.com/jQuery.ajax/), use the `change` event. To restore the Sortable layout, render the DOM elements in their last order.
+
+The following example demonstrates how to persist the order of the current items in local storage.
+
+    <div id="sortable"></div>
+
+    <button id="reset">Reset</button>
+
+    <script id="tmp" type="text/x-kendo-template">
+        <div class="sortable">Item #:data#</div>
+    </script>
+
+    <script>
+        var initialData = [1, 2, 3, 4, 5, 6, 7], //initial items order (used if there is no saved data
+            localStorageSupport = (('localStorage' in window && window['localStorage'] !== null)),
+            data,
+            html;
+
+        if (localStorageSupport) {
+            // Retrieve local storage data if such is available. Otherwise, use the default order.
+            data = JSON.parse(localStorage.getItem("sortableData")) || initialData;
+        } else {
+            alert("your browser does not support local storage");
+            data = initialData;
+        }
+
+        html = kendo.render(kendo.template($("#tmp").html()), data); // Render the HTML with the data.
+        $("#sortable").html(html); //append the HTML to the Sortable container
+
+        function onChange(e) {
+            var item = data.splice(e.oldIndex, 1)[0]; // Remove the item that has changed its order.
+            data.splice(e.newIndex, 0, item); // Add the item back using the newIndex.
+
+            localStorage.setItem("sortableData", kendo.stringify(data)); // Set the updated data in the local storage.
+        }
+
+        $("#reset").click(function () {
+            localStorage.clear(); // Clear the local storage.
+            alert("Local storage is cleared. Please reload the page!");
+        });
+    </script>
+
+    @(Html.Kendo().Sortable()
+            .For("#sortable")
+            .Filter(".sortable")
+            .Events(ev => ev.Change("onChange"))
+    )
+
+    <style>
+        #sortable {
+            -webkit-user-select: none;
+            -moz-user-select: none;
+            -ms-user-select: none;
+            user-select: none;
+            width: 300px;
+        }
+
+        .sortable {
+            padding: 10px 0;
+            margin: 1px 0;
+            width: 358px;
+            text-align: center;
+            color: #ffffff;
+            background-color: #51A0ED;
+        }
+    </style>
+
+## Handling Items with input Elements
+
+The `<input>` elements inside Sortable items cannot be focused because the items are draggable. To avoid this behavior, use the `Ignore` option.
+
+    <ul id="sortable">
+        <li>ItemA1 <input type="text" /></li>
+        <li>ItemA2 <input type="text" /></li>
+        <li>ItemA3 <input type="text" /></li>
+    </ul>
+
+    @(Html.Kendo().Sortable()
+        .For("#sortable")
+        .Ignore("input")
+    )   
+
+## Handling Radio Button Selection
+
+A Sortable with radio buttons and a hint cloned from the Sortable element will lose the selected radio button if dragged because the clone will take over the selection. To avoid this behavior, clear the name of the radio button in the hint.
+
+    <ul id="sortable-basic">
+        <li class="sortable"><input type="radio" name="foo" />Papercut <span>3:04</span></li>
+        <li class="sortable"><input type="radio" name="foo" />One Step Closer <span>2:35</span></li>
+        <li class="sortable"><input type="radio" name="foo" />With You <span>3:23</span></li>
+        <li class="sortable"><input type="radio" name="foo" />Points of Authority <span>3:20</span></li>
+        <li class="sortable"><input type="radio" name="foo" />Crawling <span>3:29</span></li>
+    </ul>
+
+    @(Html.Kendo().Sortable()
+        .For("#sortable-basic")
+        .HintHandler("hintCustom")
+        .PlaceholderHandler("placeholderCustom")
+    )
+
+    <script>
+        function hintCustom(element) {
+            var hint = element.clone().addClass("hint");
+            // Alternatively, remove the input from the hint.
+            hint.find("input").attr("name", "");
+            return hint;
+        }
+
+        function placeholderCustom(element) {
+            return element.clone().addClass("placeholder").text("drop here");
+        }
+    </script>
+
+## See Also
+
+* [Basic Usage of the Sortable HtmlHelper for ASP.NET Core (Demo)](https://demos.telerik.com/aspnet-core/sortable/index)
+* [Server-Side API](/api/sortable)