Streamlit-Authenticator 登录表单参数更新指南

Streamlit-Authenticator 是一个流行的 Streamlit 身份验证组件，最近其登录表单的参数接口发生了重要变更。本文将详细介绍这一变更内容及迁移方法。

参数变更背景

在最新版本的 Streamlit-Authenticator 中，开发者移除了传统的 form_name 参数，转而采用更灵活的 fields 参数来配置登录表单。这一变更是为了提供更强大的表单定制能力，同时简化 API 设计。

变更详情

旧版本中，开发者可以这样创建登录表单：

authenticator.login('login')  # 'login'作为表单名称

新版本中，上述写法会触发以下警告：

DeprecationError: the 'form_name' parameter has been replaced with the 'fields' parameter in Streamlit.

正确的做法是使用 fields 参数来配置表单字段：

authenticator.login(fields={'username':'用户名', 'password':'密码'})

迁移建议

1. 简单迁移：如果只需要基本登录功能，可以直接移除 form_name 参数
2. 自定义表单：使用 fields 参数可以完全自定义表单字段的标签文本
3. 多语言支持：通过 fields 可以轻松实现界面语言的本地化

最佳实践

建议开发者在升级后：

1. 检查所有使用 authenticator.login() 的地方
2. 移除或替换所有作为第一个位置参数传递的字符串
3. 考虑使用 fields 参数来提升用户体验
4. 测试登录流程确保功能正常

这一变更虽然需要开发者进行少量代码调整，但提供了更好的灵活性和未来扩展性，是值得进行的升级。