参考
以下所有节点都位于 Notebook 工具箱中。
Notebook Application
笔记本的 Events 图所实现的过程式基类型。它的节点作用于该图自己的笔记本,无需连接接收者。
回调
| 回调 | 运行时机 |
|---|---|
| Build | 用于布局笔记本:启动时运行一次,之后为每位访问者自己的实例再各运行一次。它只应负责布局,不应加载或计算。 |
| Site Started | 在第一位访问者到来之前、在站点自己的实例上运行一次。在这里加载所有人共享的内容。 |
| Session Started | 某位访问者的页面已加载,其实例已构建。 |
| Session Ended | 某位访问者的页面已关闭或进入空闲状态。 |
布局(在 Build 中)
| 节点 | 添加 |
|---|---|
| Site (Name, Icon Url) | 站点的名称,以及名称旁的小图标。 |
| Page (Name) | 一个页面;其后的内容都放在该页面上。 |
| Page Read Only | 使当前页面变为只读。 |
| Hide Run All | 从当前页面去掉 Run All。 |
| Answer On Load | 让站点上的每个输入在页面打开时响应其初始值;没有它时,输入在被更改之前不显示任何内容。按钮和上传仍然会等待。 |
| Heading (Text)、Markdown (Text)、Html (Html)、Image (Image, Caption) | 一个静态单元格。Image 接受 Divooka 图像或图片文件的路径。 |
| Show (Label, Compute) | 没有输入的单元格,显示其函数在页面加载时给出的结果。 |
| Slider (Label, Min, Max, Initial, On Change) | 一个滑块;其步长会选择为大约一百个档位。 |
| Number (Label, Initial, On Change) | 一个数字框。 |
| Text Box、Text Area (Label, Initial, On Change) | 单行或多行文本。 |
| Choice (Label, Options, Initial, On Change) | 一个文本选项的下拉列表。 |
| Checkbox、Toggle (Label, Initial, On Change) | 一个真值。 |
| Date (Label, Initial, On Change) | 一个日期,格式为 yyyy-MM-dd。 |
| Upload (Label, Kind, On Change) | 一个文件:任意文件、图像、文本文件或 PDF。 |
| Button (Label, On Click) | 一个按钮;单击会调用它的函数。 |
| Begin Group (Label) … End Group (On Change) | 一个输入组:两者之间的输入是它的字段,End Group 的函数一次获得所有字段。 |
| Last Read Only、Last Disabled、Last Prefer View (View) | 修改最后添加的单元格。视图可以是 table、line、scatter、bar、histogram、interactive 或 image。 |
| Add Page (Name, Cells)、Add Cell (Cell) | 放置用 Notebook Cells 生成的单元格。 |
提供服务期间(在单元格的函数中)
| 节点 | 作用 |
|---|---|
| Input (Cell) | 本会话中另一个单元格的当前值,按其在本页面上的标签或其 id 查找。 |
| Set Enabled (Cell, Enabled) | 启用或禁用另一个输入;页面在该函数响应时发生变化。 |
| Get Session Id | 此访问者的会话,以文本形式给出:可用作此访问者的函数所写入文件的名称。 |
| Shared (Key)、Set Shared (Key, Value) | 所有访问者共享的值。 |
Notebook Cells
同样的单元格,以值的形式提供,用于通过连线布局的笔记本:Slider、Number、Text Box、Text Area、Choice、Checkbox、Toggle、Date、Upload、Button、Group (Label, Fields, Compute)、Show、Heading、Markdown、Html、Image;以及 Read Only、Disabled 和 Prefer View,它们返回单元格修改后的副本。用 Add Page 或 Add Cell 放置它们。
Notebook Outputs
函数返回这些节点,用来说明其值应如何显示;否则只会按值本身来解读:
| 节点 | 显示 |
|---|---|
| Markdown (Text) | Markdown。 |
| Html (Html) | HTML 片段,已清除脚本。 |
| Html Page (Html) | 一个完整页面,位于独立的框架中。 |
| Code (Code, Language) | 带语法高亮的代码:csharp、python、json、javascript、sql…… |
| Download (Path, File Name) | 下载文件的链接。 |
| Picture (Path, Caption) | 一个带说明文字的图片文件。 |
| Series (Name, X, Y)、Chart (Kind, Title, Series, X Label, Y Label)、Line Chart、Scatter Chart | 由页面绘制的图表:line、scatter、bar、area 或 histogram。 |
| Plot Function (Title, From, To, Function, Samples, X Label, Y Label) | 一个从数字到数字的函数在某个范围内采样得到的折线图;在其引脚上使用 Edit Function 生成该函数。 |
| Plot With Parameter (Title, From, To, Parameter, Function, …) | 同上,但函数以采样的数字和一个在整条曲线上保持不变的参数为输入——请把输入的值传到这里,而不要把它存储在图表旁的数据成员中,因为 Function 图运行其未连接节点的顺序是不确定的。 |
如果希望图表看起来与 Divooka 绘制的完全一样,请改为返回来自 Plotting 工具箱的图形:页面会以交互方式绘制它,并在 Image 下显示 Divooka 自己绘制的图片。
Notebook Inputs 和上传的文件
输入组的函数接收 Notebook Inputs:Get (Field) 按原样获取值,Get Number、Get Text、Get Truth 和 Get File 按字段标签获取已知类型的值。Names 列出各个字段。
上传的函数接收上传的文件:它的 File Name、Content Type、Length,以及在访问者会话持续期间它在服务端机器上的 Path;还有 Read Text 和 Read Bytes。