# Selection.setBlockSelection
设置指定文档的选区为指定的 Blocks，该方法为异步调用。

## 可用性说明

权限要求 | 视图可用说明 | 平台可用 | 场景
---|---|---|---
可读 | 所有视图 | - PC<br>- 移动端 | 演示模式

## 输入

指定文档的引用以及需要选中的 Block 的 id 数组
| **名称**   | **数据类型**                                                                                                                                       | **是否必填** | **描述**              |
| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------------------- |
| docRef   | [DocumentRef](https://open.feishu.cn/document/uAjLw4CM/uYjL24iN/docs-add-on/05-api-doc/basic-data-reference---base/DocumentRef) | 是        | 指定文档的引用             |
| blockIds | number[]                                                                                                                                      | 是        | 需要选中的 Block 的 id 数组 |

## 输出

无

## 示例代码

### 调用示例

```js
const DocMiniApp = new BlockitClient().initAPI();
const docRef = await DocMiniApp.getActiveDocumentRef();
const rootBlock = await DocMiniApp.Document.getRootBlock(docRef);
await DocMiniApp.Selection.setBlockSelection(docRef,rootBlock.children);
```