♻️ Abstract AssetPickerConfig (#250)

Author: AlexV525

README-ZH.md

@@ -168,6 +168,23 @@ platform :ios, '9.0'
 
 ## 使用方法 📖
 
+### 简单的使用方法
+
+```dart
+final List<AssetEntity> assets = await AssetPicker.pickAssets(context);
+```
+
+你可以使用 `AssetPickerConfig` 来调整选择时的行为。
+
+```dart
+final AssetEntity? entity = await AssetPicker.pickAssets(
+  context,
+  pickerConfig: const AssetPickerConfig(),
+);
+```
+
+`AssetPickerConfig` 的成员说明：
+
 | 参数名                       | 类型                                 | 描述                                             | 默认值                                 |
 |---------------------------|------------------------------------|------------------------------------------------|-------------------------------------|
 | selectedAssets            | `List<AssetEntity>?`               | 已选的资源。确保不重复选择。如果你允许重复选择，请将其置空。                 | `null`                              |
@@ -192,11 +209,9 @@ platform :ios, '9.0'
 | shouldRevertGrid          | `bool?`                            | 判断资源网格是否需要倒序排列                                 | `null`                              |
 | pageRouteBuilder          | `AssetPickerPageRouteBuilder`      | 构建 `AssetPickerPageRoute`                      | `null`                              |
 
-### 简单的使用方法
+### 更详细的使用方法
 
-```dart
-final List<AssetEntity> assets = await AssetPicker.pickAssets(context);
-```
+我们已将常用的调用方法封装在 [example](example) 中。
 
 ### 使用自定义代理
 
@@ -206,10 +221,6 @@ final List<AssetEntity> assets = await AssetPicker.pickAssets(context);
 想要了解更多关于自定义代理实现的内容，
 查阅 [`example/lib/customs`](example/lib/customs)。
 
-### 更详细的使用方法
-
-我们已将常用的调用方法封装在 [example](example) 中。
-
 #### 一般的调用选择情况
 
 你可以在 `example/lib/pages/multi_assets_page.dart` 和

README.md

@@ -38,6 +38,7 @@ UI designs will be updated following the WeChat update in anytime.
 * [Usage](#usage-)
   * [Simple usage](#simple-usage)
   * [Detailed usage](#detailed-usage)
+  * [Using custom delegate](#using-custom-delegate)
   * [Display selected assets](#display-selected-assets)
   * [Register assets change observe callback](#register-assets-change-observe-callback)
   * [Customize with your own type or UI](#customize-with-your-own-type-or-ui)
@@ -162,6 +163,23 @@ platform :osx, '10.15'
 
 ## Usage 📖
 
+### Simple usage
+
+```dart
+final List<AssetEntity> assets = await AssetPicker.pickAssets(context);
+```
+
+Use `AssetPickerConfig` for more picking behaviors.
+
+```dart
+final AssetEntity? entity = await AssetPicker.pickAssets(
+  context,
+  pickerConfig: const AssetPickerConfig(),
+);
+```
+
+Fields in `AssetPickerConfig`:
+
 | Name                      | Type                          | Description                                                                                                         | Default                             |
 |---------------------------|-------------------------------|---------------------------------------------------------------------------------------------------------------------|-------------------------------------|
 | selectedAssets            | `List<AssetEntity>?`          | Selected assets. Prevent duplicate selection. If you don't need to prevent duplicate selection, just don't pass it. | `null`                              |
@@ -184,13 +202,10 @@ platform :osx, '10.15'
 | allowSpecialItemWhenEmpty | `bool`                        | Whether the special item will display or not when assets is empty.                                                  | `false`                             |
 | selectPredicate           | `AssetSelectPredicate`        | Predicate whether an asset can be selected or unselected.                                                           | `null`                              |
 | shouldRevertGrid          | `bool?`                       | Whether the assets grid should revert.                                                                              | `null`                              |
-| pageRouteBuilder          | `AssetPickerPageRouteBuilder` | Build `AssetPickerPageRoute` with the given generic type.                                                           | `null`                              |
 
-### Simple usage
+### Detailed usage
 
-```dart
-final List<AssetEntity> assets = await AssetPicker.pickAssets(context);
-```
+TL;DR, we've put multiple common usage with the packages into the [example](example).
 
 ### Using custom delegate
 
@@ -200,10 +215,6 @@ See the `Keep scroll offset` pick method in the example for how to implement it.
 For more details about custom delegates,
 head over to [`example/lib/customs`](example/lib/customs).
 
-### Detailed usage
-
-TL;DR, we've put multiple common usage with the packages into the [example](example).
-
 #### Regular picking
 
 You can both found `List<PickMethod> pickMethods` in