text_input
常用的輸入組件,這里注意記錄一下具體的參數,方便使用
函數簽名
st.text_input(label, value="", max_chars=None, key=None, type="default", help=None, autocomplete=None, on_change=None, args=None, kwargs=None, *, placeholder=None, disabled=False)
參數 | 說明 |
label (str) | 一個簡短的標簽,向用戶解釋此輸入的用途。 |
value (any) | 此小部件首次呈現時的文本值。這將在內部強制轉換為 str 。 |
max_chars (int or None) | 文本輸入中允許的最大字符數。 |
key (str or int) | 一個可選的字符串或整數,用作小部件的唯一鍵。如果省略,將根據其內容為小部件生成一個 key 。相同類型的多個小部件可能不共享相同的鍵。 |
type (str) | 文本輸入的類型。這可以是"default"(用于常規文本輸入)或"password"(用于屏蔽用戶鍵入值的文本輸入)。默認為"default"。 |
help (str) | 顯示在輸入旁邊的可選工具提示。 |
autocomplete (str) | 將傳遞給 元素的 autocomplete 屬性的可選值。如果未指定,則此值將設置為 “new-password” 用于 “password” 輸入,并將空字符串設置為 “default” 輸入。 |
on_change (callable) | 當此 text_input 的值更改時調用的可選回調。 |
args (tuple) | 傳遞給回調的可選參數元組。 |
kwargs (dict) | 一個可選的 kwargs 字典傳遞給回調。 |
placeholder (str or None) | 當文本輸入為空時顯示的可選字符串。如果為 None,則不顯示任何文本。此參數只能由關鍵字提供。 |
disabled (bool) | 一個可選的布爾值,如果設置為 True,則禁用文本輸入。默認值為假。此參數只能由關鍵字提供。 |
返回 | 說明 |
(str) | 文本輸入小部件的當前值。 |
示例
title = st.text_input('Movie title', 'Life of Brian')
st.write('The current movie title is', title)