docs: fix cascader subtitle (#4161)

* docs: fix subtitle * fix anchor * fix datepicker
2024-09-03 23:24:48 +08:00 · 2024-09-03 23:24:48 +08:00 · 3ad90ba49e
--- a/components/anchor/Anchor.razor.cs
+++ b/components/anchor/Anchor.razor.cs
@ -20,7 +20,7 @@ namespace AntDesign
    /// <para>For displaying anchor hyperlinks on page and jumping between them.</para>
    /// </summary>
    /// <seealso cref="AnchorLink" />
-    [Documentation(DocumentationCategory.Components, DocumentationType.Other, "https://gw.alipayobjects.com/zos/alicdn/_1-C1JwsC/Anchor.svg",Title = "Anchor", SubTitle = "锚点")]
+    [Documentation(DocumentationCategory.Components, DocumentationType.Other, "https://gw.alipayobjects.com/zos/alicdn/_1-C1JwsC/Anchor.svg", Title = "Anchor", SubTitle = "锚点")]
    public partial class Anchor : AntDomComponentBase, IAnchor
    {
        private string _ballClass = "ant-anchor-ink-ball";
--- a/components/badge/Badge.razor.cs
+++ b/components/badge/Badge.razor.cs
@ -19,7 +19,7 @@ namespace AntDesign
    </summary>
    <seealso cref="AntDesign.BadgeRibbon" />
    */
-    [Documentation(DocumentationCategory.Components, DocumentationType.DataDisplay, "https://gw.alipayobjects.com/zos/antfincdn/6%26GF9WHwvY/Badge.svg", Title="Badge", SubTitle = "徽标数")]
+    [Documentation(DocumentationCategory.Components, DocumentationType.DataDisplay, "https://gw.alipayobjects.com/zos/antfincdn/6%26GF9WHwvY/Badge.svg", Title = "Badge", SubTitle = "徽标数")]
    public partial class Badge : AntDomComponentBase
    {
        /// <summary>
--- a/components/button/Button.razor.cs
+++ b/components/button/Button.razor.cs
@ -35,7 +35,7 @@ namespace AntDesign
    </summary>
    <seealso cref="DownloadButton" />
    */
-    [Documentation(DocumentationCategory.Components, DocumentationType.General, "https://gw.alipayobjects.com/zos/alicdn/fNUKzY1sk/Button.svg",Title = "Button",SubTitle = "按钮")]
+    [Documentation(DocumentationCategory.Components, DocumentationType.General, "https://gw.alipayobjects.com/zos/alicdn/fNUKzY1sk/Button.svg", Title = "Button", SubTitle = "按钮")]
    public partial class Button : AntDomComponentBase
    {
        private string _formSize;
--- a/components/calendar/Calendar.razor.cs
+++ b/components/calendar/Calendar.razor.cs
@ -18,7 +18,7 @@ namespace AntDesign
    <para>When data is in the form of dates, such as schedules, timetables, prices calendar, lunar calendar. This component also supports Year/Month switch.</para>
    </summary>
     */
-    [Documentation(DocumentationCategory.Components, DocumentationType.DataDisplay, "https://gw.alipayobjects.com/zos/antfincdn/dPQmLq08DI/Calendar.svg", Columns = 1,Title = "Calendar", SubTitle = "级联选择")]
+    [Documentation(DocumentationCategory.Components, DocumentationType.DataDisplay, "https://gw.alipayobjects.com/zos/antfincdn/dPQmLq08DI/Calendar.svg", Columns = 1, Title = "Calendar", SubTitle = "日历")]
    public partial class Calendar : AntDomComponentBase, IDatePicker
    {
        DateTime IDatePicker.CurrentDate { get; set; } = DateTime.Now;
--- a/components/card/Card.razor.cs
+++ b/components/card/Card.razor.cs
@ -22,7 +22,7 @@ namespace AntDesign
    <seealso cref="CardMeta"/>
    <seealso cref="CardAction"/>
     */
-    [Documentation(DocumentationCategory.Components, DocumentationType.DataDisplay, "https://gw.alipayobjects.com/zos/antfincdn/NqXt8DJhky/Card.svg", Columns = 1, Title = "Card",SubTitle = "卡片")]
+    [Documentation(DocumentationCategory.Components, DocumentationType.DataDisplay, "https://gw.alipayobjects.com/zos/antfincdn/NqXt8DJhky/Card.svg", Columns = 1, Title = "Card", SubTitle = "卡片")]
    public partial class Card : AntDomComponentBase
    {
        /// <summary>
--- a/components/carousel/Carousel.razor.cs
+++ b/components/carousel/Carousel.razor.cs
@ -26,7 +26,7 @@ namespace AntDesign
    </summary>
    <seealso cref="CarouselSlick"/>
    */
-    [Documentation(DocumentationCategory.Components, DocumentationType.DataDisplay, "https://gw.alipayobjects.com/zos/antfincdn/%24C9tmj978R/Carousel.svg", Title="Carousel", SubTitle = "走马灯")]
+    [Documentation(DocumentationCategory.Components, DocumentationType.DataDisplay, "https://gw.alipayobjects.com/zos/antfincdn/%24C9tmj978R/Carousel.svg", Title = "Carousel", SubTitle = "走马灯")]
    public partial class Carousel : AntDomComponentBase
    {
        private const string PrefixCls = "ant-carousel";
--- a/components/cascader/Cascader.razor.cs
+++ b/components/cascader/Cascader.razor.cs
@ -28,7 +28,7 @@ namespace AntDesign
    <seealso cref="CascaderNode"/>
    <seealso cref="TriggerBoundaryAdjustMode"/>
    */
-    [Documentation(DocumentationCategory.Components, DocumentationType.DataEntry, "https://gw.alipayobjects.com/zos/alicdn/UdS8y8xyZ/Cascader.svg",Title = "Cascader",SubTitle = "日历")]
+    [Documentation(DocumentationCategory.Components, DocumentationType.DataEntry, "https://gw.alipayobjects.com/zos/alicdn/UdS8y8xyZ/Cascader.svg", Title = "Cascader", SubTitle = "级联选择")]
    public partial class Cascader : AntInputComponentBase<string>
    {
        /// <summary>
--- a/components/collapse/Collapse.razor.cs
+++ b/components/collapse/Collapse.razor.cs
@ -23,7 +23,7 @@ namespace AntDesign
    </summary>
    <seealso cref="Panel"/>
    */
-    [Documentation(DocumentationCategory.Components, DocumentationType.DataDisplay, "https://gw.alipayobjects.com/zos/alicdn/IxH16B9RD/Collapse.svg", Columns = 1, Title ="Collapse",SubTitle = "折叠面板")]
+    [Documentation(DocumentationCategory.Components, DocumentationType.DataDisplay, "https://gw.alipayobjects.com/zos/alicdn/IxH16B9RD/Collapse.svg", Columns = 1, Title = "Collapse", SubTitle = "折叠面板")]
    public partial class Collapse : AntDomComponentBase
    {
        #region Parameter
--- a/components/date-picker/DatePicker.Razor.cs
+++ b/components/date-picker/DatePicker.Razor.cs
@ -26,7 +26,7 @@ namespace AntDesign
    <seealso cref="QuarterPicker{TValue}"/>
    <seealso cref="TriggerBoundaryAdjustMode"/>
    */
-    [Documentation(DocumentationCategory.Components, DocumentationType.DataEntry, "https://gw.alipayobjects.com/zos/alicdn/RT_USzA48/DatePicker.svg",Title = "DatePicker", SubTitle = "日期选择框")]
+    [Documentation(DocumentationCategory.Components, DocumentationType.DataEntry, "https://gw.alipayobjects.com/zos/alicdn/RT_USzA48/DatePicker.svg", Title = "DatePicker", SubTitle = "日期选择框")]
    public partial class DatePicker<TValue> : DatePickerBase<TValue>
    {
        /// <summary>
--- a/components/date-picker/internal/DatePickerBase.cs
+++ b/components/date-picker/internal/DatePickerBase.cs
@ -27,7 +27,7 @@ namespace AntDesign
        internal const int START_PICKER_INDEX = 0;
        internal const int END_PICKER_INDEX = 0;

-        [CascadingParameter(Name = "PrefixCls")]
+        //[CascadingParameter(Name = "PrefixCls")]
        internal string PrefixCls { get; set; } = "ant-picker";

        /// <summary>
--- a/components/divider/Divider.razor.cs
+++ b/components/divider/Divider.razor.cs
@ -18,7 +18,7 @@ namespace AntDesign
        </list>
    </summary>
    */
-    [Documentation(DocumentationCategory.Components, DocumentationType.Layout, "https://gw.alipayobjects.com/zos/alicdn/5swjECahe/Divider.svg",Title = "Divider",SubTitle = "分割线")]
+    [Documentation(DocumentationCategory.Components, DocumentationType.Layout, "https://gw.alipayobjects.com/zos/alicdn/5swjECahe/Divider.svg", Title = "Divider", SubTitle = "分割线")]
    public partial class Divider : AntDomComponentBase
    {
        /// <summary>
--- a/components/drawer/Drawer.razor.cs
+++ b/components/drawer/Drawer.razor.cs
@ -31,7 +31,7 @@ namespace AntDesign
    <seealso cref="DrawerOptions" />
    <seealso cref="DrawerRef" />
     */
-    [Documentation(DocumentationCategory.Components, DocumentationType.Feedback, "https://gw.alipayobjects.com/zos/alicdn/7z8NJQhFb/Drawer.svg", Title ="Drawer", SubTitle = "分割线")]
+    [Documentation(DocumentationCategory.Components, DocumentationType.Feedback, "https://gw.alipayobjects.com/zos/alicdn/7z8NJQhFb/Drawer.svg", Title = "Drawer", SubTitle = "抽屉")]
    public partial class Drawer : AntDomComponentBase
    {
        #region Parameters
--- a/components/flex/Flex.razor.cs
+++ b/components/flex/Flex.razor.cs
@ -26,7 +26,7 @@ namespace AntDesign

    </summary>
    */
-    [Documentation(DocumentationCategory.Components, DocumentationType.Layout, "https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*SMzgSJZE_AwAAAAAAAAAAAAADrJ8AQ/original", Columns = 1, Title = "Flex",SubTitle = "弹性布局")]
+    [Documentation(DocumentationCategory.Components, DocumentationType.Layout, "https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*SMzgSJZE_AwAAAAAAAAAAAAADrJ8AQ/original", Columns = 1, Title = "Flex", SubTitle = "弹性布局")]
    public partial class Flex : AntDomComponentBase
    {
        /// <summary>
--- a/components/form/Form.razor.cs
+++ b/components/form/Form.razor.cs
@ -33,7 +33,7 @@ namespace AntDesign
    <seealso cref="FormValidationRule"/>
    <seealso cref="FormValidateErrorMessages"/>
    */
-    [Documentation(DocumentationCategory.Components, DocumentationType.DataEntry, "https://gw.alipayobjects.com/zos/alicdn/ORmcdeaoO/Form.svg", Columns = 1, Title = "Form",SubTitle = "表单")]
+    [Documentation(DocumentationCategory.Components, DocumentationType.DataEntry, "https://gw.alipayobjects.com/zos/alicdn/ORmcdeaoO/Form.svg", Columns = 1, Title = "Form", SubTitle = "表单")]
 #if NET6_0_OR_GREATER
    [CascadingTypeParameter(nameof(TModel))]
 #endif
--- a/components/icon/Icon.razor.cs
+++ b/components/icon/Icon.razor.cs
@ -15,7 +15,7 @@ namespace AntDesign
    Semantic vector graphics. Before use icons。
    </summary>
    */
-    [Documentation(DocumentationCategory.Components, DocumentationType.General, "https://gw.alipayobjects.com/zos/alicdn/rrwbSt3FQ/Icon.svg", Title = "Icon",SubTitle = "图标")]
+    [Documentation(DocumentationCategory.Components, DocumentationType.General, "https://gw.alipayobjects.com/zos/alicdn/rrwbSt3FQ/Icon.svg", Title = "Icon", SubTitle = "图标")]
    public partial class Icon : AntDomComponentBase
    {
        /// <summary>
--- a/components/input/Input.cs
+++ b/components/input/Input.cs
@ -30,7 +30,7 @@ namespace AntDesign
    <seealso cref="InputGroup"/>
    <seealso cref="InputPassword"/>
    */
-    [Documentation(DocumentationCategory.Components, DocumentationType.DataEntry, "https://gw.alipayobjects.com/zos/alicdn/xS9YEJhfe/Input.svg", Title="Input", SubTitle = "输入框")]
+    [Documentation(DocumentationCategory.Components, DocumentationType.DataEntry, "https://gw.alipayobjects.com/zos/alicdn/xS9YEJhfe/Input.svg", Title = "Input", SubTitle = "输入框")]
    public class Input<TValue> : AntInputComponentBase<TValue>
    {
        protected const string PrefixCls = "ant-input";
--- a/components/mentions/Mentions.razor.cs
+++ b/components/mentions/Mentions.razor.cs
@ -22,6 +22,7 @@ namespace AntDesign

    <para>When need to mention someone or something.</para>
    </summary>
+    <seealso cref="MentionsOption" />
    */
    [Documentation(DocumentationCategory.Components, DocumentationType.DataEntry, "https://gw.alipayobjects.com/zos/alicdn/jPE-itMFM/Mentions.svg", Title = "Mentions", SubTitle = "提及")]
    public partial class Mentions
--- a/components/mentions/MentionsOption.razor.cs
+++ b/components/mentions/MentionsOption.razor.cs
@ -11,15 +11,21 @@ namespace AntDesign
    public partial class MentionsOption
    {
        [CascadingParameter]
-        public Mentions Mentions { get; set; }
+        private Mentions Mentions { get; set; }

+        /// <summary>
+        /// The value of option.
+        /// </summary>
        [Parameter]
        public string Value { get; set; }

+        /// <summary>
+        /// The content of option.
+        /// </summary>
        [Parameter]
        public RenderFragment ChildContent { get; set; }

-        public bool Active => Mentions?.ActiveOptionValue == Value;
+        internal bool Active => Mentions?.ActiveOptionValue == Value;

        protected override async Task OnInitializedAsync()
        {
--- a/components/popover/Popover.razor.cs
+++ b/components/popover/Popover.razor.cs
@ -35,7 +35,7 @@ namespace AntDesign
    <para>Please ensure that the child node of <c>Popover</c> accepts <c>onMouseEnter</c>, <c>onMouseLeave</c>, <c>onFocus</c>, <c>onClick</c> events.</para>
    </summary>
    */
-    [Documentation(DocumentationCategory.Components, DocumentationType.DataDisplay, "https://gw.alipayobjects.com/zos/alicdn/1PNL1p_cO/Popover.svg", Title="Popover", SubTitle = "气泡卡片")]
+    [Documentation(DocumentationCategory.Components, DocumentationType.DataDisplay, "https://gw.alipayobjects.com/zos/alicdn/1PNL1p_cO/Popover.svg", Title = "Popover", SubTitle = "气泡卡片")]
    public partial class Popover : OverlayTrigger
    {
        /// <summary>
--- a/components/radio/RadioGroup.razor.cs
+++ b/components/radio/RadioGroup.razor.cs
@ -13,7 +13,10 @@ namespace AntDesign
 #if NET6_0_OR_GREATER
    [CascadingTypeParameter(nameof(TValue))]
 #endif
-
+    /// <summary>
+    /// A group of radio buttons
+    /// </summary>
+    /// <typeparam name="TValue"> The type of <see cref="Radio{TValue}.Value" />, should have the same type with <see cref="Radio{TValue}" />s'. </typeparam>
    public partial class RadioGroup<TValue> : AntInputComponentBase<TValue>
    {
        [Inject]
--- a/components/result/Result.razor.cs
+++ b/components/result/Result.razor.cs
@ -17,7 +17,7 @@ namespace AntDesign
    <para>Use when important operations need to inform the user to process the results and the feedback is more complicated.</para>
    </summary>
    */
-    [Documentation(DocumentationCategory.Components, DocumentationType.Feedback, "https://gw.alipayobjects.com/zos/alicdn/9nepwjaLa/Result.svg", Columns = 1, Title ="Result", SubTitle = "结果")]
+    [Documentation(DocumentationCategory.Components, DocumentationType.Feedback, "https://gw.alipayobjects.com/zos/alicdn/9nepwjaLa/Result.svg", Columns = 1, Title = "Result", SubTitle = "结果")]
    public partial class Result : AntDomComponentBase
    {
        /// <summary>
--- a/components/segmented/Segmented.razor.cs
+++ b/components/segmented/Segmented.razor.cs
@ -24,7 +24,7 @@ namespace AntDesign
    </summary>
    <seealso cref="SegmentedItem{TValue}"/>
    */
-    [Documentation(DocumentationCategory.Components, DocumentationType.DataDisplay, "https://gw.alipayobjects.com/zos/bmw-prod/a3ff040f-24ba-43e0-92e9-c845df1612ad.svg",Title = "Segmented",SubTitle = "分段控制器")]
+    [Documentation(DocumentationCategory.Components, DocumentationType.DataDisplay, "https://gw.alipayobjects.com/zos/bmw-prod/a3ff040f-24ba-43e0-92e9-c845df1612ad.svg", Title = "Segmented", SubTitle = "分段控制器")]
 #if NET6_0_OR_GREATER
    [CascadingTypeParameter(nameof(TValue))]
 #endif
--- a/components/select/Select.razor.cs
+++ b/components/select/Select.razor.cs
@ -30,7 +30,7 @@ namespace AntDesign
    </list>
    </summary>
    */
-    [Documentation(DocumentationCategory.Components, DocumentationType.DataEntry, "https://gw.alipayobjects.com/zos/alicdn/_0XzgOis7/Select.svg",Title="Select",SubTitle = "选择器")]
+    [Documentation(DocumentationCategory.Components, DocumentationType.DataEntry, "https://gw.alipayobjects.com/zos/alicdn/_0XzgOis7/Select.svg", Title= "Select", SubTitle = "选择器")]
 #if NET6_0_OR_GREATER
    [CascadingTypeParameter(nameof(TItem))]
    [CascadingTypeParameter(nameof(TItemValue))]
--- a/components/slider/Slider.razor.cs
+++ b/components/slider/Slider.razor.cs
@ -26,7 +26,7 @@ namespace AntDesign
    </summary>
    <seealso cref="SliderMark"/>
    */
-    [Documentation(DocumentationCategory.Components, DocumentationType.DataEntry, "https://gw.alipayobjects.com/zos/alicdn/HZ3meFc6W/Silder.svg", Title = "Slider",SubTitle = "滑动输入条")]
+    [Documentation(DocumentationCategory.Components, DocumentationType.DataEntry, "https://gw.alipayobjects.com/zos/alicdn/HZ3meFc6W/Silder.svg", Title = "Slider", SubTitle = "滑动输入条")]
    public partial class Slider<TValue> : AntInputComponentBase<TValue>
    {
        private const string PreFixCls = "ant-slider";
--- a/components/space/Space.razor.cs
+++ b/components/space/Space.razor.cs
@ -16,6 +16,7 @@ namespace AntDesign

    <para>Avoid components clinging together and set a unified space.</para>
    </summary>
+    <seealso cref="SpaceItem"/>
    */
    [Documentation(DocumentationCategory.Components, DocumentationType.Layout, "https://gw.alipayobjects.com/zos/antfincdn/wc6%263gJ0Y8/Space.svg", Columns = 1, Title = "Space", SubTitle = "间距")]
    public partial class Space : AntDomComponentBase
--- a/components/space/SpaceItem.razor.cs
+++ b/components/space/SpaceItem.razor.cs
@ -7,11 +7,17 @@ using Microsoft.AspNetCore.Components;

 namespace AntDesign
 {
+    /// <summary>
+    /// <see cref="Space"/> item, use to set item style
+    /// </summary>
    public partial class SpaceItem : AntDomComponentBase
    {
        [CascadingParameter]
-        public Space Parent { get; set; }
+        private Space Parent { get; set; }

+        /// <summary>
+        /// Child content
+        /// </summary>
        [Parameter]
        public RenderFragment ChildContent { get; set; }

--- a/components/steps/Step.razor.cs
+++ b/components/steps/Step.razor.cs
@ -8,6 +8,9 @@ using Microsoft.AspNetCore.Components.Web;

 namespace AntDesign
 {
+    /// <summary>
+    /// A step in a Steps component
+    /// </summary>
    public partial class Step : AntDomComponentBase
    {
        private string _status = "wait";
--- a/components/steps/Steps.razor.cs
+++ b/components/steps/Steps.razor.cs
@ -20,7 +20,7 @@ namespace AntDesign
    </summary>
    <seealso cref="Step"/>
    */
-    [Documentation(DocumentationCategory.Components, DocumentationType.Navigation, "https://gw.alipayobjects.com/zos/antfincdn/UZYqMizXHaj/Steps.svg", Columns = 1, Title = "Steps",SubTitle = "步骤条")]
+    [Documentation(DocumentationCategory.Components, DocumentationType.Navigation, "https://gw.alipayobjects.com/zos/antfincdn/UZYqMizXHaj/Steps.svg", Columns = 1, Title = "Steps", SubTitle = "步骤条")]
    public partial class Steps : AntDomComponentBase
    {
        private bool _showProgressDot;
--- a/components/timeline/Timeline.razor.cs
+++ b/components/timeline/Timeline.razor.cs
@ -23,7 +23,7 @@ namespace AntDesign
    </summary>
    <seealso cref="TimelineItem" />
    */
-    [Documentation(DocumentationCategory.Components, DocumentationType.DataDisplay, "https://gw.alipayobjects.com/zos/antfincdn/vJmo00mmgR/Timeline.svg", Title="Timeline", SubTitle = "时间轴")]
+    [Documentation(DocumentationCategory.Components, DocumentationType.DataDisplay, "https://gw.alipayobjects.com/zos/antfincdn/vJmo00mmgR/Timeline.svg", Title = "Timeline", SubTitle = "时间轴")]
    public partial class Timeline : AntDomComponentBase
    {
        /// <summary>
--- a/components/transfer/Transfer.razor.cs
+++ b/components/transfer/Transfer.razor.cs
@ -32,7 +32,7 @@ namespace AntDesign
    </para>
    </summary>
    */
-    [Documentation(DocumentationCategory.Components, DocumentationType.DataEntry, "https://gw.alipayobjects.com/zos/alicdn/QAXskNI4G/Transfer.svg", Columns = 1, Title = "Transfer",SubTitle = "穿梭框")]
+    [Documentation(DocumentationCategory.Components, DocumentationType.DataEntry, "https://gw.alipayobjects.com/zos/alicdn/QAXskNI4G/Transfer.svg", Columns = 1, Title = "Transfer", SubTitle = "穿梭框")]
    public partial class Transfer : AntDomComponentBase
    {
        private const string PrefixName = "ant-transfer";
--- a/site/AntDesign.Docs/Pages/Components.razor
+++ b/site/AntDesign.Docs/Pages/Components.razor
@ -27,7 +27,7 @@
                        <Anchor Key="@_demoComponent.Title">
                            @foreach (var demo in _anchors)
                            {
-                                <AnchorLink Href="@($"/{CurrentLanguage}/components/{_demoComponent.Title}#components-{_demoComponent.Title.ToLower()}-demo-{demo.Name}")" Title="@demo.Title" />
+                                <AnchorLink Href="@($"/{CurrentLanguage}/components/{_demoComponent.Title}#components-{_demoComponent.Title.ToLower()}-demo-{demo.Name.ToLower()}")" Title="@demo.Title" />
                            }
                            @if (!string.IsNullOrEmpty(_demoComponent.ApiDoc))
                            {
@ -41,7 +41,10 @@
            <section class="markdown">
                <h1>
                    @_demoComponent.Title
-                    <span class="subtitle">@_demoComponent.SubTitle</span>
+                    @if (CurrentLanguage == "zh-CN")
+                    {
+                        <span class="subtitle">@_demoComponent.SubTitle</span>
+                    }
                    <span class="widget"></span>
                    <Tooltip Title="@Localizer["app.content.edit-demo"]">
                        <Unbound>