有关渲染的文件浏览器文档，请参阅https://kivy-garden.github.io/filebrowser/。

文件浏览器

FileBrowser小部件是一个高级文件浏览器。您可以使用它的方式与FileChooser类似。

它提供了一条快捷栏，包含指向特殊和系统目录的链接。当触摸链接栏旁边的快捷方式时，它将展开并显示该目录中的所有目录。它还方便指定要添加到快捷方式列表中的自定义路径。

它提供图标和列表视图来选择文件，并且还接受过滤器和文件名输入。

要创建一个FileBrowser，它在按下“选择”按钮时打印当前选定的文件以及文件名字段中的当前文本，并将文档目录的快捷方式添加到收藏夹栏中

.. code-block:: python

from kivy.app import App
from os.path import sep, expanduser, isdir, dirname
import sys

class TestApp(App):

    def build(self):
        if sys.platform == 'win':
            user_path = dirname(expanduser('~')) + sep + 'Documents'
        else:
            user_path = expanduser('~') + sep + 'Documents'
        browser = FileBrowser(select_string='Select',
                              favorites=[(user_path, 'Documents')])
        browser.bind(
                    on_success=self._fbrowser_success,
                    on_canceled=self._fbrowser_canceled)
        return browser

    def _fbrowser_canceled(self, instance):
        print 'cancelled, Close self.'

    def _fbrowser_success(self, instance):
        print instance.selection

TestApp().run()

事件

• on_canceled 当调用Cancel按钮的on_release事件时触发。
• on_success 当调用Select按钮的on_release事件时触发。

安装

pip install kivy_garden.filebrowser

CI

每次推送或拉取请求都会运行GitHub Action CI。它会在各种操作系统上测试代码，并在打上标签后生成可以发布到PyPI的wheel。还会生成文档并上传到存储库以及CI的工件。

待办事项

• 添加您的代码

贡献

查看我们的贡献指南，并随意改进花朵。

许可证

本软件根据MIT许可证条款发布。请参阅LICENSE.txt文件。

如何发布

• 在kivy-garden/filebrowser/__init__.py中更新__version__到最新版本。
• 更新CHANGELOG.md并提交更改
• 调用git tag -a x.y.z -m "Tagging version x.y.z"
• 调用python setup.py bdist_wheel --universal和python setup.py sdist，这将在dist/*目录中生成wheel和sdist
• 确保dist目录包含要上传到pypi的文件，并调用twine check dist/*
• 然后调用twine upload dist/*上传到pypi。
• 调用git push origin master --tags将最新更改和标签推送到github。