diff --git a/docs/api.md b/docs/api.md index 511aa135..59210fe1 100644 --- a/docs/api.md +++ b/docs/api.md @@ -2393,10 +2393,13 @@ async def _(session): - **参数:** - - `expr: Expression_T`: 要渲染的 Expression + - `expr: Expression_T`: 要渲染的 Expression,对于 Expression 的三种类型:`str`、`Sequence[str]`、`Callable`,行为分别是: + - `str`:以 `*args`、`**kwargs` 为参数,使用 `str.format()` 进行格式化 + - `Sequence[str]`:随机选择其中之一,进行上面 `str` 的操作 + - `Callable`:以 `*args`、`**kwargs` 为参数,调用该可调用对象/函数,对返回的字符串进行上面 `str` 的操作 - `escape_args: bool`: 是否对渲染参数进行转义 - - `*args: Any`: 渲染参数,用于 `str.format()` 或 Expression 函数调用时传入位置参数 - - `**kwargs: Any`: 渲染参数,用于 `str.format()` 或 Expression 函数调用时传入命名参数 + - `*args: Any`: 渲染参数 + - `**kwargs: Any`: 渲染参数 - **返回:**