Python Streamlit st.form用法及代码示例

创建一个将元素与"Submit" 按钮一起批处理的表单。

表单是一个容器，它将其他元素和小部件可视地组合在一起，并包含一个提交按钮。当按下表单的提交按钮时，表单内的所有小部件值将被批量发送到 Streamlit。

要将元素添加到表单对象，您可以使用"with" 表示法(首选)或直接在表单上调用方法。请参阅下面的示例。

表单有一些限制：

每个表格必须包含一个st.form_submit_button.
st.button和st.download_button不能添加到表单中。
表单可以出现在应用程序的任何位置(侧边栏、列等)，但它们不能嵌入到其他表单中。

有关表格的更多信息，请查看我们的blog post。

函数签名

st.form(key, clear_on_submit=False)

参数	说明
key (str)	标识表单的字符串。每个表单都必须有自己的 key 。 (此键在接口中不显示给用户。)
clear_on_submit (bool)	如果为 True，则在用户按下提交按钮后，表单内的所有小部件都将重置为其默认值。默认为假。 (请注意，自定义组件不受此标志的影响，并且不会在表单提交时重置为默认值。)

例子

使用 "with" 表示法插入元素：

with st.form("my_form"):
    st.write("Inside the form")
    slider_val = st.slider("Form slider")
    checkbox_val = st.checkbox("Form checkbox")

    # Every form must have a submit button.
    submitted = st.form_submit_button("Submit")
    if submitted:
        st.write("slider", slider_val, "checkbox", checkbox_val)

st.write("Outside the form")

乱序插入元素：

form = st.form("my_form")
form.slider("Inside the form")
st.slider("Outside the form")

# Now add a submit button to the form:
form.form_submit_button("Submit")

相关用法

注：本文由纯净天空筛选整理自streamlit.io大神的英文原创作品 st.form。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。