在Pythonista 3中创建自动完成的TextField

Question

我想创建一个自动完成的TextField。

我的意思是-当您在字段中键入内容并在下面看到提示列表时。 提示列表是一个包含可能值的数组。 解释它的最佳方法显示出类似的情况。

我已经有一些Pythonista 3的经验，但是还没有UI编程经验。

我知道这很复杂，也许我应该使用其他“视图和委托”机制，但是我不知道如何开始。 我已经在Google花了几天的时间来寻找解决方案，但是在Pythonista的背景下，我做不到。

有人这样做吗？ 还是有人可以提供有用的阅读链接？

Answer 1

可以使用TableView在Pythonista中创建一个下拉列表。 TableView实际上只是单列列表，它们不仅仅用于表。

因此，步骤将是：

1. 创建一个tableview。
2. 将其与您的文本字段对齐。
3. 隐藏表格视图，直到开始键入为止。
4. 每当输入更改时，使用自动完成选项更新tableview的项目列表。
5. 键入结束时，可能再次隐藏tableview。

您可以通过将其.hidden属性设置为True来隐藏任何视图。

您可以通过创建实现textfield_did_change的委托对象来在TextField中键入开始时执行操作。

通过为TableView提供data_source （可能是ui.ListDataSource的实现），可以将TableView设置为具有项目列表。 每当数据源上的items属性更改时，选项列表也会自动更改。

您可以对用户从TableView中选择一个选项做出反应，方法是对TableView的delegate设置一个action 。

TableView，TextField，ListDataSource，委托和操作的文档可以在Pythonista的iOS本机GUI中找到。

这是一个基本示例：

# documentation at http://omz-software.com/pythonista/docs/ios/ui.html
import ui

# the phoneField delegate will respond whenever there is typing
# the delegate object will combine phoneField delegate, tableview delegate, and data source, so that it can share data
class AutoCompleter(ui.ListDataSource):
    def textfield_did_change(self, textfield):
        dropDown.hidden = False
        # an arbitrary list of autocomplete options
        # you will have a function that creates this list
        options = [textfield.text + x for x in textfield.text]

        # setting the items property automatically updates the list
        self.items = options
        # size the dropdown for up to five options
        dropDown.height = min(dropDown.row_height * len(options), 5*dropDown.row_height)

    def textfield_did_end_editing(self, textfield):
        #done editing, so hide and clear the dropdown
        dropDown.hidden = True
        self.items = []

        # this is also where you might act on the entered data
        pass

    def optionWasSelected(self, sender):
        phoneField.text = self.items[self.selected_row]
        phoneField.end_editing()

autocompleter = AutoCompleter(items=[])
autocompleter.action = autocompleter.optionWasSelected

# a TextField for phone number input
phoneField = ui.TextField()
phoneField.delegate = autocompleter
phoneField.keyboard_type = ui.KEYBOARD_PHONE_PAD
phoneField.clear_button_mode = 'while_editing'

# the drop-down menu is basically a list of items, which in Pythonista is a TableView
dropDown = ui.TableView()
dropDown.delegate = autocompleter
dropDown.data_source = autocompleter
# hide the dropdown until typing starts
dropDown.hidden = True

# create interface
mainView = ui.View()
mainView.add_subview(phoneField)
mainView.add_subview(dropDown)

# present the interface before aligning fields, so as to have the window size available
mainView.present()

# center text field
phoneField.width = mainView.width*.67
phoneField.height = 40

phoneField.x = mainView.width/2 - phoneField.width/2
phoneField.y = mainView.height/3 - phoneField.height/2

# align the dropdown with the phoneField
dropDown.x = phoneField.x
dropDown.y = phoneField.y + phoneField.height
dropDown.width = phoneField.width
dropDown.row_height = phoneField.height

在我的iPhone上，此代码创建一个界面，如下所示：