屏蔽交互式脚本的代码单元格
此示例演示向交互式脚本的代码单元格添加掩码的可能性。
通过创建可视化图形界面，屏蔽可以更轻松地在脚本中参数化代码。 使用此类脚本的用户将不必处理代码单元格的内容;相反，他们将能够使用熟悉的控件调整代码中变量的值。
屏幕截图中显示了通过屏蔽代码单元格创建的图形界面的示例。:
代码单元格的掩码-Engee脚本编辑器的功能。为了熟悉交互模式下的掩码，我们建议在脚本编辑器中打开这个例子（而不是在文档或Engee社区中，因为代码单元的掩码不会显示在它们中）。
使用基础知识
掩码是代码单元的自定义用户界面。
如果至少向代码单元格添加了一个特殊注释，则代码单元格将被屏蔽。 # @param 或 # @markdown.
评论 # @param 设计用于向代码单元格添加交互参数:
*文本字段（输入）;
*标志按钮（复选框）;
*下拉列表（dropdown）;
*滑块（滑块）。
交互参数与一个变量相关联，在行的末尾添加了一个特殊注释的定义。
在代码编辑器和掩码元素之间组织双向通信:
*当您在图形界面中更改变量的值时，代码单元格中的值将自动更改。;
*相反，当您更改代码单元格中变量的值时，GUI中的值将更改。
评论 # @markdown 它们旨在将Markdown语言中的标记添加到代码单元格（这是Engee脚本编辑器的文本单元格中使用的语言）。 在特殊注释之后立即使用简单直观的Markdown语法，您可以使蒙版更加可视化。
默认情况下，代码编辑器和图形界面同时显示。 为了隐藏代码显示，双击掩码。 要再次显示代码，您可以单击"显示代码"按钮或双击单元格。
交互参数
要添加用于输入字符串变量的文本字段，请使用特殊注释。 # @param {type:"string"}:
input_string = "Hello, world!" # @param {type:"string"}
要添加用于输入任意数字的文本字段，必须使用特殊注释。 # @param {type:"number"}:
input_number = -0.123456789 # @param {type:"number"}
输入整数变量的文本字段可以使用特殊注释添加。 # @param {type:"integer"}:
input_integer = 42 # @param {type:"integer"}
要以自由格式添加文本输入字段（最灵活的选项，因为变量的数据类型不受限制），您必须使用特殊注释。 # @param {type:"raw"}:
input_raw = input_string # @param {type:"raw"}
要添加标志按钮，请使用特殊注释。 # @param {type:"boolean"}:
input_boolean = false # @param {type:"boolean"}
具有日期选择的日历（它将以格式写入字符串变量 YYYY-MM-DD）可以使用特殊注释添加 # @param {type:"date"}:
input_date = "2024-09-03" # @param {type:"date"}
要添加用于选择字符串变量的下拉列表，请使用特殊注释。 # @param [""] 通过列出数组中所有可能的选项:
dropdown_string = "Первый" # @param ["Первый", "Второй", "Третий"]
如果您需要将用于选择字符串变量的下拉列表与输入选项相结合，则可以使用特殊注释。 # @param [""] {allow-input:true}
dropdown_string_editable = "Нулевой" # @param ["Первый", "Второй", "Третий"] {allow-input:true}
要添加用于选择自由格式变量的下拉列表，请使用特殊注释。 # @param [""] {type:"raw"} 通过列出数组中所有可能的选项:
dropdown_raw = "Engee" # @param [""Engee"", "input_raw", "false", "42"] {type:"raw"}
如果您需要将自由格式的变量选择下拉列表与输入的可能性相结合，则可以使用特殊注释。 # @param [""] {type:"raw", allow-input:true}
dropdown_raw_editable = true # @param [""Engee"", "input_raw", "false", "42"] {type:"raw", allow-input:true}
要添加滑块，请使用特殊注释。 # @param {type:"slider", min:x, max:y, step:z}，代之以代替:
x-最小值;y-最大值;z-步骤:
slider_number = 0.5 # @param {type:"slider", min:-1, max:1, step:0.01}
slider_integer = 50 # @param {type:"slider", min:1, max:100, step:1}
Markdown标记语言
新闻标题:
# @markdown # Заголовок 1
# @markdown ## Заголовок 2
# @markdown ### Заголовок 3
# @markdown #### Заголовок 4
# @markdown ##### Заголовок 5
# @markdown ###### Заголовок 6
段落和换行符:
# @markdown Чтобы создать новый параграф, вставьте пустую строку между двумя строками текста.
# @markdown
# @markdown Для переноса строки внутри одного параграфа
# @markdown используйте два пробела в конце строки.
文本选择:
# @markdown *курсив*
# @markdown _italic_
# @markdown
# @markdown **жирный**
# @markdown __bold__
# @markdown
# @markdown ***жирный курсив***
# @markdown ___bold italic___
# @markdown
# @markdown ~~зачёркнутый strikethrough~~
编号列表:
# @markdown 1. Первый пункт
# @markdown 2. Второй пункт
# @markdown 3. Третий пункт
项目符号列表:
# @markdown - Первый пункт
# @markdown - Второй пункт
# @markdown - Третий пункт
嵌套列表:
# @markdown 1. Первый пункт
# @markdown - Первый подпункт
# @markdown - Второй подпункт
# @markdown 2. Второй пункт
连结:
# @markdown [Telegram-канал Engee](https://t.me/engee_com)
图像:
# @markdown 
一行代码:
# @markdown `using Plots`
代码块:
# @markdown ```Julia
# @markdown x = range(0, 10, length=100)
# @markdown y = sin.(x)
# @markdown plot(x, y)
# @markdown ```
报价:
# @markdown > Первый уровень
# @markdown >> Второй уровень
# @markdown >>> Третий уровень
水平线:
# @markdown ---
表:
# @markdown | Заголовок 1 | Заголовок 2 |
# @markdown | ----------- | ----------- |
# @markdown | Ячейка 1 | Ячейка 2 |
# @markdown | Ячейка 3 | Ячейка 4 |
表情符号:
# @markdown :smile:
# @markdown :laughing:
# @markdown :blush:
HTML标签:
# @markdown <kbd>CTRL</kbd> + <kbd>V</kbd>
结论
此示例演示了屏蔽代码单元的可能性。 这是一个简单的，并在同一时间功能的方式，使交互式脚本更具响应性和可访问性！