docs(cndocs): 同步翻译更新（高质量） (#998)

Author: sunnylqm

cndocs/actionsheetios.md

@@ -3,50 +3,58 @@ id: actionsheetios
 title: ActionSheetIOS
 ---
 
-显示一个 iOS 原生的[Action Sheet](https://developer.apple.com/design/human-interface-guidelines/ios/views/action-sheets/)组件。
+显示 iOS 原生的 [Action Sheet](https://developer.apple.com/design/human-interface-guidelines/action-sheets) 组件。
 
 ## 示例
 
-```SnackPlayer name=ActionSheetIOS&supportedPlatforms=ios
-import React, { useState } from "react";
-import { ActionSheetIOS, Button, StyleSheet, Text, View } from "react-native";
+```SnackPlayer name=ActionSheetIOS%20Example&supportedPlatforms=ios
+import React, {useState} from 'react';
+import {ActionSheetIOS, Button, StyleSheet, Text} from 'react-native';
+import {SafeAreaView, SafeAreaProvider} from 'react-native-safe-area-context';
+
 const App = () => {
-  const [result, setResult] = useState("🔮");
+  const [result, setResult] = useState('🔮');
+
   const onPress = () =>
     ActionSheetIOS.showActionSheetWithOptions(
       {
-        options: ["Cancel", "Generate number", "Reset"],
+        options: ['Cancel', 'Generate number', 'Reset'],
         destructiveButtonIndex: 2,
         cancelButtonIndex: 0,
-        userInterfaceStyle: 'dark'
+        userInterfaceStyle: 'dark',
       },
       buttonIndex => {
         if (buttonIndex === 0) {
           // cancel action
         } else if (buttonIndex === 1) {
-          setResult(Math.floor(Math.random() * 100) + 1);
+          setResult(String(Math.floor(Math.random() * 100) + 1));
         } else if (buttonIndex === 2) {
-          setResult("🔮");
+          setResult('🔮');
         }
-      }
+      },
     );
+
   return (
-    <View style={styles.container}>
-      <Text style={styles.result}>{result}</Text>
-      <Button onPress={onPress} title="Show Action Sheet" />
-    </View>
+    <SafeAreaProvider>
+      <SafeAreaView style={styles.container}>
+        <Text style={styles.result}>{result}</Text>
+        <Button onPress={onPress} title="Show Action Sheet" />
+      </SafeAreaView>
+    </SafeAreaProvider>
   );
 };
+
 const styles = StyleSheet.create({
   container: {
     flex: 1,
-    justifyContent: "center"
+    justifyContent: 'center',
   },
   result: {
     fontSize: 64,
-    textAlign: "center"
-  }
+    textAlign: 'center',
+  },
 });
+
 export default App;
 ```
 
@@ -63,32 +71,36 @@ static showActionSheetWithOptions: (
 );
 ```
 
-在 iOS 设备上显示一个 ActionSheet 弹出框，其中`options`参数为一个对象，其属性必须包含以下一项或多项：
+在 iOS 设备上显示一个 ActionSheet 弹出框，其中 `options` 参数为一个对象，其属性必须包含以下一项或多项：
 
-- `options`（字符串数组） - 按钮标题列表（必需）
-- `cancelButtonIndex`（整数） - `options` 中取消按钮的索引
-- `cancelButtonTintColor`（字符串） - 用于改变取消按钮文本颜色的颜色（[颜色](colors)）
-- `destructiveButtonIndex`（整数或整数数组） - `options` 中破坏性按钮的索引
-- `title`（字符串） - 显示在操作表上方的标题
-- `message`（字符串） - 显示在标题下方的消息
-- `anchor`（数字） - 操作表应锚定的节点（用于 iPad）
-- `tintColor`（字符串） - 用于非破坏性按钮标题的颜色（[颜色](colors)）
-- `disabledButtonIndices`（数字数组） - 应禁用的按钮索引列表
-- `userInterfaceStyle`（字符串） - 用于操作表的界面样式，可以设置为 `light` 或 `dark`，否则将使用默认的系统样式
-  
-`callback`函数则仅接受一个参数，即所点击按钮的索引。
+- `options`（字符串数组）- 按钮标题列表（必需）
+- `cancelButtonIndex`（整数）- `options` 中取消按钮的索引
+- `cancelButtonTintColor`（字符串）- 用于改变取消按钮文本颜色的[颜色](colors)值
+- `destructiveButtonIndex`（整数或整数数组）- `options` 中破坏性按钮的索引
+- `title`（字符串）- 显示在操作表上方的标题
+- `message`（字符串）- 显示在标题下方的消息
+- `anchor`（数字）- 操作表应锚定的节点（用于 iPad）
+- `tintColor`（字符串）- 用于非破坏性按钮标题的[颜色](colors)值
+- `disabledButtonIndices`（数字数组）- 应禁用的按钮索引列表
+- `userInterfaceStyle`（字符串）- 用于操作表的界面样式，可以设置为 `light` 或 `dark`，否则将使用默认的系统样式
 
-一个例子：
+`callback` 函数仅接受一个参数，即所点击按钮的从零开始的索引。
 
-```
-ActionSheetIOS.showActionSheetWithOptions({
-  options: ['取消', '删除'],
-  destructiveButtonIndex: 1,
-  cancelButtonIndex: 0,
-},
-(buttonIndex) => {
-if (buttonIndex === 1) { /* 当接收到的索引为1，即点击了删除按钮时，执行对应操作 */ }
-});
+一个简单的例子：
+
+```tsx
+ActionSheetIOS.showActionSheetWithOptions(
+  {
+    options: ['Cancel', 'Remove'],
+    destructiveButtonIndex: 1,
+    cancelButtonIndex: 0,
+  },
+  buttonIndex => {
+    if (buttonIndex === 1) {
+      /* destructive action */
+    }
+  },
+);
 ```
 
 ---
@@ -113,18 +125,20 @@ static showShareActionSheetWithOptions: (
 );
 ```
 
-在 iOS 设备上显示一个分享弹出框，其中`options`参数为一个对象，其属性包含以下几项（必须至少有 message 或 url）:
+在 iOS 设备上显示一个分享弹出框，其中 `options` 参数为一个对象，必须包含 `message` 或 `url` 中的至少一项，还可以额外指定 `subject` 或 `excludedActivityTypes`：
 
-- `url` （字符串） - 要分享的 URL 地址
-- `message` （字符串） - 要分享的信息
-- `subject` （字符串） - 要分享的信息主题
-- `excludedActivityTypes` （数组） - 指定在 actionsheet 中不显示的活动
+- `url`（字符串）- 要分享的 URL 地址
+- `message`（字符串）- 要分享的信息
+- `subject`（字符串）- 要分享的信息主题
+- `excludedActivityTypes`（数组）- 指定在 ActionSheet 中不显示的活动
 
-注：如果`url`指向本地文件，或者是一个 base64 编码的 url，则会直接读取并分享相应的文件。你可以用这样的方式来分享图片、视频以及 PDF 文件等。If `url` points to a remote file or address it must conform to URL format as described in [RFC 2396](https://www.ietf.org/rfc/rfc2396.txt). For example, a web URL without a proper protocol (HTTP/HTTPS) will not be shared.
+:::note
+如果 `url` 指向本地文件，或者是一个 base64 编码的 URI，则会直接读取并分享相应的文件。你可以用这种方式来分享图片、视频以及 PDF 文件等。如果 `url` 指向远程文件或地址，则必须符合 [RFC 2396](https://www.ietf.org/rfc/rfc2396.txt) 中描述的 URL 格式。例如，不带正确协议（HTTP/HTTPS）的网址将无法被分享。
+:::
 
-`failureCallback`函数仅接受一个错误对象参数。此对象中仅包含一个可选的`stack`属性，类型为字符串。
+`failureCallback` 函数仅接受一个错误对象参数。此对象中仅包含一个可选的 `stack` 属性，类型为字符串。
 
-`successCallback`函数接受两个参数：
+`successCallback` 函数接受两个参数：
 
-- 表示成功与否的布尔值
-- 成功的话返回一个表示分享方式的字符串
+- 一个表示成功与否的布尔值
+- 成功时返回一个表示分享方式的字符串

cndocs/activityindicator.md

@@ -3,33 +3,36 @@ id: activityindicator
 title: ActivityIndicator
 ---
 
-显示一个圆形的 loading 提示符号。
+显示一个圆形的加载指示器。
 
 ## 示例
 
 ```SnackPlayer name=ActivityIndicator%20Example
-import React from "react";
-import { ActivityIndicator, StyleSheet, Text, View } from "react-native";
+import React from 'react';
+import {ActivityIndicator, StyleSheet} from 'react-native';
+import {SafeAreaView, SafeAreaProvider} from 'react-native-safe-area-context';
 
 const App = () => (
-  <View style={[styles.container, styles.horizontal]}>
-    <ActivityIndicator />
-    <ActivityIndicator size="large" />
-    <ActivityIndicator size="small" color="#0000ff" />
-    <ActivityIndicator size="large" color="#00ff00" />
-  </View>
+  <SafeAreaProvider>
+    <SafeAreaView style={[styles.container, styles.horizontal]}>
+      <ActivityIndicator />
+      <ActivityIndicator size="large" />
+      <ActivityIndicator size="small" color="#0000ff" />
+      <ActivityIndicator size="large" color="#00ff00" />
+    </SafeAreaView>
+  </SafeAreaProvider>
 );
 
 const styles = StyleSheet.create({
   container: {
     flex: 1,
-    justifyContent: "center"
+    justifyContent: 'center',
   },
   horizontal: {
-    flexDirection: "row",
-    justifyContent: "space-around",
-    padding: 10
-  }
+    flexDirection: 'row',
+    justifyContent: 'space-around',
+    padding: 10,
+  },
 });
 
 export default App;
@@ -39,15 +42,15 @@ export default App;
 
 ## Props
 
-### [View Props](view.md#props)
+### [View Props](view#props)
 
-继承了所有的[View Props](view.md#props).
+继承了所有 [View Props](view#props)。
 
 ---
 
 ### `animating`
 
-是否要显示指示器动画，默认为 true 表示显示，false 则隐藏。
+是否显示指示器动画。`true` 表示显示，`false` 表示隐藏。
 
 | 类型 | 默认值 |
 | ---- | ------ |
@@ -59,26 +62,32 @@ export default App;
 
 滚轮的前景颜色。
 
-| 类型            | 默认值                                                                                                                                                                           |
-| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| [color](colors) | `null` (系统默认的强调色)<div class="label android">Android</div><hr/><ins style={{background: '#999'}} className="color-box" />`'#999999'` <div className="label ios">iOS</div> |
+| 类型            | 默认值                                                                                                                                                                                          |
+| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [color](colors) | `null`（系统默认强调色）<div className="label android">Android</div><hr/><ins style={{background: '#999'}} className="color-box" />`'#999999'` <div className="label ios">iOS</div> |
 
 ---
 
-### `hidesWhenStopped` <div class="label ios">iOS</div>
+### `hidesWhenStopped` <div className="label ios">iOS</div>
 
-在`animating`为 false 的时候，是否要隐藏指示器（默认为 true）。如果`animating`和`hidesWhenStopped`都为 false，则显示一个静止的指示器。
+在 `animating` 为 false 的时候，是否隐藏指示器（默认为 true）。
 
 | 类型 | 默认值 |
 | ---- | ------ |
 | bool | `true` |
 
 ---
 
+### `ref`
+
+一个 ref 设置函数，在挂载时会被赋值为一个[元素节点](element-nodes)。
+
+---
+
 ### `size`
 
-指示器的大小，默认为'small'。目前只能在 Android 上设定具体的数值。
+指示器的大小，默认为 `'small'`。目前只能在 Android 上设定具体的数值。
 
-| 类型                                                                           | 默认值    |
-| ------------------------------------------------------------------------------ | --------- |
-| enum(`'small'`, `'large'`)<hr/>number <div class="label android">Android</div> | `'small'` |
+| 类型                                                                               | 默认值    |
+| ---------------------------------------------------------------------------------- | --------- |
+| enum(`'small'`, `'large'`)<hr/>number <div className="label android">Android</div> | `'small'` |