Docs new dev (#1307)

rayhomie · shijia.sj · dennis.zpf · web-flow · commit 549203759541 · 2024-11-25T13:41:26.000+08:00
* feat: 删除何时使用

* fix: 修改翻译

* feat: check lastset

* fix: sticky initHeaderHeight

---------

Co-authored-by: shijia.sj &lt;shijia.sj@antfin.com&gt;
Co-authored-by: dennis.zpf &lt;dennis.zpf@antgroup.com&gt;
diff --git a/compiled/alipay/demo/pages/Card/index.axml b/compiled/alipay/demo/pages/Card/index.axml
@@ -27,7 +27,7 @@
     title="标题"
     className="card-title-radius {{titleSticky ? 'card-demo-sticky' : ''}}"
     headSticky="{{true}}"
-    stickyTop="{{0}}"
+    stickyTop="{{100}}"
     stickyTransparentTitle="{{false}}"
     onTitleSticky="handleTitleSticky"
   >
diff --git a/compiled/alipay/demo/pages/Sticky/index.axml b/compiled/alipay/demo/pages/Sticky/index.axml
@@ -1,27 +1,27 @@
 <view class="navigation-bar"></view>
 <ant-container title="基础用法">
-  <ant-sticky>
+  <ant-sticky transparentTitle>
     <view>
       我会吸顶
     </view>
   </ant-sticky>
 </ant-container>
 <ant-container title="指定吸顶高度">
-  <ant-sticky top="100px">
+  <ant-sticky top="200px">
     <view>
-      我会吸顶在距离顶部 100px 的地方
+      我会吸顶在距离顶部 200px 的地方
     </view>
   </ant-sticky>
 </ant-container>
 <view style="height: 200px;"></view>
 <ant-container title="感知是否吸顶">
   <ant-sticky
-    top="180px"
+    top="300px"
     check
     onStickyChange="handleStickyChange"
   >
     <view>
-      <view>我会吸顶在距离顶部 180px 的地方</view>
+      <view>我会吸顶在距离顶部 300px 的地方</view>
       <view>是否吸上了 {{stickyStatus}}</view>
     </view>
   </ant-sticky>
diff --git a/compiled/alipay/src/Dialog/index.en.md b/compiled/alipay/src/Dialog/index.en.md
@@ -9,8 +9,6 @@ toc: 'content'
 
 # Dialog
 
-## When to use
-
 When the application needs to alert or remind the current operation behavior of the user, the dialog box may be used. The user needs to operate on the dialog box before ending.
 
 ## Introduction
diff --git a/compiled/alipay/src/Dialog/index.md b/compiled/alipay/src/Dialog/index.md
@@ -9,8 +9,6 @@ toc: 'content'
 
 # Dialog 对话框
 
-## 何时使用
-
 当应用中需要比较明显的对用户当前的操作行为进行警示或提醒时，可以使用对话框。用户需要针对对话框进行操作后方可结束。
 
 ## 引入
diff --git a/compiled/alipay/src/NoticeBar/index.en.md b/compiled/alipay/src/NoticeBar/index.en.md
@@ -9,11 +9,7 @@ toc: content
 
 # NoticeBar
 
-Shows a set of message notifications.
-
-## When to use
-
-For the notification of information in the current page, it is a more eye-catching way of notification in the page.
+Shows a set of message notifications. Usually used for the notification of information in the current page, is a more eye-catching in-page notification.
 
 ## Introduction
 
diff --git a/compiled/alipay/src/NoticeBar/index.md b/compiled/alipay/src/NoticeBar/index.md
@@ -9,11 +9,7 @@ toc: content
 
 # NoticeBar 通告栏
 
-展示一组消息通知。
-
-## 何时使用
-
-用于当前页面内信息的通知，是一种较醒目的页面内通知方式。
+展示一组消息通知。通常用于当前页面内信息的通知，是一种较醒目的页面内通知方式。
 
 ## 引入
 
diff --git a/compiled/alipay/src/SafeArea/index.en.md b/compiled/alipay/src/SafeArea/index.en.md
@@ -8,9 +8,6 @@ toc: 'content'
 ---
 
 # SafeArea
-
-## When to use
-
 When the web page is displayed in full screen, the top and bottom of the screen can be adapted by means of a safe zone, such as a bang screen.
 
 ## Introduction
diff --git a/compiled/alipay/src/SafeArea/index.md b/compiled/alipay/src/SafeArea/index.md
@@ -8,9 +8,6 @@ toc: 'content'
 ---
 
 # SafeArea 安全区
-
-## 何时使用
-
 当网页被全屏展示时，可借助安全区进行屏幕顶部和底部适配，如刘海屏。
 
 ## 引入
diff --git a/compiled/alipay/src/Sticky/index.en.md b/compiled/alipay/src/Sticky/index.en.md
@@ -8,10 +8,7 @@ toc: 'content'
 ---
 
 # Sticky
-
-## When to use
-
-Need to be adsorbed in some places in the rolling situation.
+Used in cases where it is necessary to adsorb in some places during rolling.
 
 ## Precautions
 
diff --git a/compiled/alipay/src/Sticky/index.md b/compiled/alipay/src/Sticky/index.md
@@ -8,10 +8,7 @@ toc: 'content'
 ---
 
 # Sticky 粘性吸附
-
-## 何时使用
-
-需要在滚动中吸附在某些地方的情况。
+用在需要在滚动中吸附在某些地方的情况。
 
 ## 注意事项
 
diff --git a/compiled/alipay/src/Sticky/index.ts b/compiled/alipay/src/Sticky/index.ts
@@ -65,7 +65,6 @@ Component(
         'sticky',
         'headerHeight',
       ]);
-      this.initHeaderHeight(headerHeight);
       if (sticky !== nextProps.sticky) {
         // 考虑到这个还是有点性能开销，用个属性控制
         if (nextProps.check && !this.stickyIO) {
diff --git a/compiled/wechat/demo/pages/Card/index.wxml b/compiled/wechat/demo/pages/Card/index.wxml
@@ -23,7 +23,7 @@
     title="标题"
     className="card-title-radius {{titleSticky ? 'card-demo-sticky' : ''}}"
     headSticky="{{true}}"
-    stickyTop="{{0}}"
+    stickyTop="{{100}}"
     stickyTransparentTitle="{{false}}"
     bind:titlesticky="handleTitleSticky"
   >
diff --git a/compiled/wechat/demo/pages/Sticky/index.wxml b/compiled/wechat/demo/pages/Sticky/index.wxml
@@ -1,23 +1,23 @@
 <view class="navigation-bar"></view>
 <ant-container title="基础用法">
-  <ant-sticky>
+  <ant-sticky transparentTitle>
     <view>我会吸顶</view>
   </ant-sticky>
 </ant-container>
 <ant-container title="指定吸顶高度">
-  <ant-sticky top="100px">
-    <view>我会吸顶在距离顶部 100px 的地方</view>
+  <ant-sticky top="200px">
+    <view>我会吸顶在距离顶部 200px 的地方</view>
   </ant-sticky>
 </ant-container>
 <view style="height: 200px;"></view>
 <ant-container title="感知是否吸顶">
   <ant-sticky
-    top="180px"
+    top="300px"
     check
     bind:stickychange="handleStickyChange"
   >
     <view>
-      <view>我会吸顶在距离顶部 180px 的地方</view>
+      <view>我会吸顶在距离顶部 300px 的地方</view>
       <view>是否吸上了{{stickyStatus}}</view>
     </view>
   </ant-sticky>
diff --git a/compiled/wechat/src/Dialog/index.en.md b/compiled/wechat/src/Dialog/index.en.md
@@ -9,8 +9,6 @@ toc: 'content'
 
 # Dialog
 
-## When to use
-
 When the application needs to alert or remind the current operation behavior of the user, the dialog box may be used. The user needs to operate on the dialog box before ending.
 
 ## Introduction
diff --git a/compiled/wechat/src/Dialog/index.md b/compiled/wechat/src/Dialog/index.md
@@ -9,8 +9,6 @@ toc: 'content'
 
 # Dialog 对话框
 
-## 何时使用
-
 当应用中需要比较明显的对用户当前的操作行为进行警示或提醒时，可以使用对话框。用户需要针对对话框进行操作后方可结束。
 
 ## 引入
diff --git a/compiled/wechat/src/NoticeBar/index.en.md b/compiled/wechat/src/NoticeBar/index.en.md
@@ -9,11 +9,7 @@ toc: content
 
 # NoticeBar
 
-Shows a set of message notifications.
-
-## When to use
-
-For the notification of information in the current page, it is a more eye-catching way of notification in the page.
+Shows a set of message notifications. Usually used for the notification of information in the current page, is a more eye-catching in-page notification.
 
 ## Introduction
 
diff --git a/compiled/wechat/src/NoticeBar/index.md b/compiled/wechat/src/NoticeBar/index.md
@@ -9,11 +9,7 @@ toc: content
 
 # NoticeBar 通告栏
 
-展示一组消息通知。
-
-## 何时使用
-
-用于当前页面内信息的通知，是一种较醒目的页面内通知方式。
+展示一组消息通知。通常用于当前页面内信息的通知，是一种较醒目的页面内通知方式。
 
 ## 引入
 
diff --git a/compiled/wechat/src/SafeArea/index.en.md b/compiled/wechat/src/SafeArea/index.en.md
@@ -8,9 +8,6 @@ toc: 'content'
 ---
 
 # SafeArea
-
-## When to use
-
 When the web page is displayed in full screen, the top and bottom of the screen can be adapted by means of a safe zone, such as a bang screen.
 
 ## Introduction
diff --git a/compiled/wechat/src/SafeArea/index.md b/compiled/wechat/src/SafeArea/index.md
@@ -8,9 +8,6 @@ toc: 'content'
 ---
 
 # SafeArea 安全区
-
-## 何时使用
-
 当网页被全屏展示时，可借助安全区进行屏幕顶部和底部适配，如刘海屏。
 
 ## 引入
diff --git a/compiled/wechat/src/Sticky/index.en.md b/compiled/wechat/src/Sticky/index.en.md
@@ -8,10 +8,7 @@ toc: 'content'
 ---
 
 # Sticky
-
-## When to use
-
-Need to be adsorbed in some places in the rolling situation.
+Used in cases where it is necessary to adsorb in some places during rolling.
 
 ## Precautions
 
diff --git a/compiled/wechat/src/Sticky/index.js b/compiled/wechat/src/Sticky/index.js
@@ -75,7 +75,6 @@ Component(StickyProps, {
                     'sticky',
                     'headerHeight',
                 ]), sticky = _a[0], headerHeight = _a[1];
-                this.initHeaderHeight(headerHeight);
                 if (sticky !== data.sticky) {
                     // 考虑到这个还是有点性能开销，用个属性控制
                     if (data.check && !this.stickyIO) {
diff --git a/compiled/wechat/src/Sticky/index.md b/compiled/wechat/src/Sticky/index.md
@@ -8,10 +8,7 @@ toc: 'content'
 ---
 
 # Sticky 粘性吸附
-
-## 何时使用
-
-需要在滚动中吸附在某些地方的情况。
+用在需要在滚动中吸附在某些地方的情况。
 
 ## 注意事项
 
diff --git a/demo/pages/Card/index.axml b/demo/pages/Card/index.axml
@@ -21,7 +21,7 @@
     title="标题"
     className="card-title-radius {{ titleSticky ? 'card-demo-sticky' : '' }}"
     headSticky="{{true}}"
-    stickyTop="{{0}}"
+    stickyTop="{{100}}"
     stickyTransparentTitle="{{ false }}"
     onTitleSticky="handleTitleSticky"
   >
diff --git a/demo/pages/Sticky/index.axml b/demo/pages/Sticky/index.axml
@@ -1,7 +1,9 @@
 <view class="navigation-bar"/>
 
 <ant-container title="基础用法">
-  <ant-sticky>
+  <ant-sticky
+    transparentTitle
+  >
     <view>
       我会吸顶
     </view>
@@ -10,10 +12,10 @@
 
 <ant-container title="指定吸顶高度">
   <ant-sticky
-    top="100px"
+    top="200px"
   >
     <view>
-      我会吸顶在距离顶部 100px 的地方
+      我会吸顶在距离顶部 200px 的地方
     </view>
   </ant-sticky>
 </ant-container>
@@ -22,12 +24,12 @@
 
 <ant-container title="感知是否吸顶">
   <ant-sticky
-    top="180px"
+    top="300px"
     check
     onStickyChange="handleStickyChange"
   >
     <view>
-      <view>我会吸顶在距离顶部 180px 的地方</view>
+      <view>我会吸顶在距离顶部 300px 的地方</view>
       <view>是否吸上了 {{ stickyStatus }}</view>
     </view>
   </ant-sticky>
diff --git a/src/Dialog/index.en.md b/src/Dialog/index.en.md
@@ -9,8 +9,6 @@ toc: 'content'
 
 # Dialog
 
-## When to use
-
 When the application needs to alert or remind the current operation behavior of the user, the dialog box may be used. The user needs to operate on the dialog box before ending.
 
 ## Introduction
diff --git a/src/Dialog/index.md b/src/Dialog/index.md
@@ -9,8 +9,6 @@ toc: 'content'
 
 # Dialog 对话框
 
-## 何时使用
-
 当应用中需要比较明显的对用户当前的操作行为进行警示或提醒时，可以使用对话框。用户需要针对对话框进行操作后方可结束。
 
 ## 引入
diff --git a/src/NoticeBar/index.en.md b/src/NoticeBar/index.en.md
@@ -9,11 +9,7 @@ toc: content
 
 # NoticeBar
 
-Shows a set of message notifications.
-
-## When to use
-
-For the notification of information in the current page, it is a more eye-catching way of notification in the page.
+Shows a set of message notifications. Usually used for the notification of information in the current page, is a more eye-catching in-page notification.
 
 ## Introduction
 
diff --git a/src/NoticeBar/index.md b/src/NoticeBar/index.md
@@ -9,11 +9,7 @@ toc: content
 
 # NoticeBar 通告栏
 
-展示一组消息通知。
-
-## 何时使用
-
-用于当前页面内信息的通知，是一种较醒目的页面内通知方式。
+展示一组消息通知。通常用于当前页面内信息的通知，是一种较醒目的页面内通知方式。
 
 ## 引入
 
diff --git a/src/SafeArea/index.en.md b/src/SafeArea/index.en.md
@@ -8,9 +8,6 @@ toc: 'content'
 ---
 
 # SafeArea
-
-## When to use
-
 When the web page is displayed in full screen, the top and bottom of the screen can be adapted by means of a safe zone, such as a bang screen.
 
 ## Introduction
diff --git a/src/SafeArea/index.md b/src/SafeArea/index.md
@@ -8,9 +8,6 @@ toc: 'content'
 ---
 
 # SafeArea 安全区
-
-## 何时使用
-
 当网页被全屏展示时，可借助安全区进行屏幕顶部和底部适配，如刘海屏。
 
 ## 引入
diff --git a/src/Sticky/index.en.md b/src/Sticky/index.en.md
@@ -8,10 +8,7 @@ toc: 'content'
 ---
 
 # Sticky
-
-## When to use
-
-Need to be adsorbed in some places in the rolling situation.
+Used in cases where it is necessary to adsorb in some places during rolling.
 
 ## Precautions
 
diff --git a/src/Sticky/index.md b/src/Sticky/index.md
diff --git a/src/Sticky/index.ts b/src/Sticky/index.ts

Original file line number	Diff line number	Diff line change
`@@ -27,7 +27,7 @@`
`27`	`27`	`title="标题"`
`28`	`28`	`className="card-title-radius {{titleSticky ? 'card-demo-sticky' : ''}}"`
`29`	`29`	`headSticky="{{true}}"`
`30`		`- stickyTop="{{0}}"`
	`30`	`+ stickyTop="{{100}}"`
`31`	`31`	`stickyTransparentTitle="{{false}}"`
`32`	`32`	`onTitleSticky="handleTitleSticky"`
`33`	`33`	`>`
Original file line number	Diff line number	Diff line change
`@@ -23,7 +23,7 @@`
`23`	`23`	`title="标题"`
`24`	`24`	`className="card-title-radius {{titleSticky ? 'card-demo-sticky' : ''}}"`
`25`	`25`	`headSticky="{{true}}"`
`26`		`- stickyTop="{{0}}"`
	`26`	`+ stickyTop="{{100}}"`
`27`	`27`	`stickyTransparentTitle="{{false}}"`
`28`	`28`	`bind:titlesticky="handleTitleSticky"`
`29`	`29`	`>`
Original file line number	Diff line number	Diff line change
`@@ -21,7 +21,7 @@`
`21`	`21`	`title="标题"`
`22`	`22`	`className="card-title-radius {{ titleSticky ? 'card-demo-sticky' : '' }}"`
`23`	`23`	`headSticky="{{true}}"`
`24`		`- stickyTop="{{0}}"`
	`24`	`+ stickyTop="{{100}}"`
`25`	`25`	`stickyTransparentTitle="{{ false }}"`
`26`	`26`	`onTitleSticky="handleTitleSticky"`
`27`	`27`	`>`