feat(Calendar): add subtitle slot (#8980)

src/calendar/Calendar.tsx

@@ -489,10 +489,10 @@ export default defineComponent({
     const renderCalendar = () => (
       <div class={bem()}>
         <CalendarHeader
-          v-slots={{ title: slots.title }}
+          v-slots={pick(slots, ['title', 'subtitle'])}
           title={props.title}
-          showTitle={props.showTitle}
           subtitle={state.subtitle}
+          showTitle={props.showTitle}
           showSubtitle={props.showSubtitle}
           firstDayOfWeek={dayOffset.value}
         />

src/calendar/CalendarHeader.tsx

@@ -26,7 +26,8 @@ export default defineComponent({
 
     const renderSubtitle = () => {
       if (props.showSubtitle) {
-        return <div class={bem('header-subtitle')}>{props.subtitle}</div>;
+        const title = slots.subtitle ? slots.subtitle() : props.subtitle;
+        return <div class={bem('header-subtitle')}>{title}</div>;
       }
     };
 

src/calendar/README.md

@@ -332,6 +332,7 @@ Following props are supported when the type is multiple
 | Name                  | Description               | SlotProps  |
 | --------------------- | ------------------------- | ---------- |
 | title                 | Custom title              | -          |
+| subtitle `v3.1.3`     | Custom subtitle           | -          |
 | footer                | Custom footer             | -          |
 | top-info `v3.0.17`    | Custom top info of day    | _day: Day_ |
 | bottom-info `v3.0.17` | Custom bottom info of day | _day: Day_ |

src/calendar/README.zh-CN.md

@@ -338,6 +338,7 @@ export default {
 | 名称                  | 说明                     | 参数       |
 | --------------------- | ------------------------ | ---------- |
 | title                 | 自定义标题               | -          |
+| subtitle `v3.1.3`     | 自定义日历副标题         | -          |
 | footer                | 自定义底部区域内容       | -          |
 | top-info `v3.0.17`    | 自定义日期上方的提示信息 | _day: Day_ |
 | bottom-info `v3.0.17` | 自定义日期下方的提示信息 | _day: Day_ |

src/calendar/test/__snapshots__/index.spec.ts.snap

@@ -900,28 +900,14 @@ exports[`row-height prop 1`] = `
 </div>
 `;
 
-exports[`should render top-info and bottom-info slot correctly 1`] = `
+exports[`should render title、footer、subtitle slot correctly 1`] = `
-<div role="gridcell"
-     style="margin-left: 71.42857142857143%;"
-     class="van-calendar__day van-calendar__day--disabled"
->
-  <div class="van-calendar__top-info">
-    top: 1
-  </div>
-  1
-  <div class="van-calendar__bottom-info">
-    bottom: 1
-  </div>
-</div>
-`;
-
-exports[`title & footer slot 1`] = `
 <div class="van-calendar">
   <div class="van-calendar__header">
     <div class="van-calendar__header-title">
       Custom Title
     </div>
     <div class="van-calendar__header-subtitle">
+      Custom Subtitle
     </div>
     <div class="van-calendar__weekdays">
       <span class="van-calendar__weekday">
@@ -1132,3 +1118,18 @@ exports[`title & footer slot 1`] = `
   </div>
 </div>
 `;
+
+exports[`should render top-info and bottom-info slot correctly 1`] = `
+<div role="gridcell"
+     style="margin-left: 71.42857142857143%;"
+     class="van-calendar__day van-calendar__day--disabled"
+>
+  <div class="van-calendar__top-info">
+    top: 1
+  </div>
+  1
+  <div class="van-calendar__bottom-info">
+    bottom: 1
+  </div>
+</div>
+`;

src/calendar/test/index.spec.ts

@@ -344,7 +344,7 @@ test('formatter prop', async () => {
   expect(wrapper.html()).toMatchSnapshot();
 });
 
-test('title & footer slot', async () => {
+test('should render title、footer、subtitle slot correctly', async () => {
   const wrapper = mount(Calendar, {
     props: {
       minDate,
@@ -356,6 +356,7 @@ test('title & footer slot', async () => {
     slots: {
       title: () => 'Custom Title',
       footer: () => 'Custom Footer',
+      subtitle: () => 'Custom Subtitle',
     },
   });