Kivy使用篇13

Kivy使用篇之记事本小程序

1. os.path中exists join @property 的使用
2. Property使用
3. ScreenManager Screen SlideTransition使用
4. RecycleView的使用

根据kivy示例程序，编写一个可以运行在Android的记事本小程序。
可变的文本输入框
当双击时，文本框获取焦点，且可输入内容。失去焦点时，采用标签显示输入的文本。
源码如下：

class MutableTextInput(FloatLayout):
    """可变文本输入框"""
    text = StringProperty()
    multiline = BooleanProperty(True)

    def __init__(self, **kwargs):
        """初始化"""
        super(MutableTextInput, self).__init__(**kwargs)
        Clock.schedule_once(self.prepare, 0)

    def prepare(self, *args):
        """设置显示和输入"""
        self.w_textinput = self.ids.w_textinput.__self__
        self.w_label = self.ids.w_label.__self__
        self.view()

    def on_touch_down(self, touch):
        """双击标签编辑"""
        if self.collide_point(*touch.pos) and touch.is_double_tap:
            self.edit()
        return super(MutableTextInput, self).on_touch_down(touch)

    def edit(self):
        """编辑内容"""
        self.clear_widgets()
        self.add_widget(self.w_textinput)
        self.w_textinput.focus = True

    def view(self):
        self.clear_widgets()
        if not self.text:
            self.w_label.text = "Double tap/click to edit"
        self.add_widget(self.w_label)

    def check_focus_and_view(self, textinput):
        """当输入框失去焦点时显示内容"""
        if not textinput.focus:
            self.text = textinput.text
            self.view()

初始时，设置输入框和显示框。

	Clock.schedule_once(self.prepare, 0)

    def prepare(self, *args):
        """设置显示和输入"""
        self.w_textinput = self.ids.w_textinput.__self__
        self.w_label = self.ids.w_label.__self__
        self.view()

def on_touch_down(self, touch):
当双击控件时，进入编辑状态。self.add_widget(self.w_textinput)显示输入框
def check_focus_and_view(self, textinput):
当失去焦点时，进入显示状态。self.add_widget(self.w_label)显示显示框

使用Label和TextInput来实现一个可变输入/显示控件：

:
    # 普通标签
    Label:
        id: w_label
        pos: root.pos
        text: root.text
    # 输入框，双击标签时激活
    TextInput:
        id: w_textinput
        pos: root.pos
        text: root.text
        multiline: root.multiline
        on_focus: root.check_focus_and_view(self)

记事查看/编辑类
显示记事标题、内容。
源码如下：

:
    # 记事本查看/编辑
    on_note_content: app.set_note_content(self.note_index, self.note_content)
    on_note_title: app.set_note_title(self.note_index, self.note_title)

    BoxLayout:

        orientation: 'vertical'

        BoxLayout:

            orientation: 'horizontal'
            size_hint_y: None
            height: '48dp'
            padding: '5dp'
            # 背景色
            canvas:
                Color:
                    rgb: .3, .3, .3
                Rectangle:
                    pos: self.pos
                    size: self.size
            # 返回按钮，如果是新建且内容为空，则先删除再返回
            Button:
                text: '<'
                size_hint_x: None
                width: self.height
                on_release: 
                    if root.note_title == 'New note' and root.note_content == '' : \
                        app.del_note(root.note_index) 
                    app.go_notes()
            # 标题输入
            MutableLabelTextInput:
                text: root.note_title
                font_size: '16sp'
                multiline: False
                on_text: root.note_title = self.text
            # 删除按钮
            Button:
                text: 'X'
                size_hint_x: None
                width: self.height
                on_release: app.del_note(root.note_index)
        # 内容输入
        MutableLabelTextInput:
            text: root.note_content
            on_text: root.note_content = self.text

class NoteView(Screen):
    """记事本编辑/查看"""
    note_index = NumericProperty()  # 记事索引值
    note_title = StringProperty()  # 记事标题
    note_content = StringProperty()  # 记事内容
    note_mtime = NumericProperty()  # 记事修改时间

    on_note_content: app.set_note_content(self.note_index, self.note_content)
    on_note_title: app.set_note_title(self.note_index, self.note_title)

当记事标题/内容修改时，保存记事。
记事标题列表项
显示记事标题。

:
    # 记事本列表项
    on_note_mtime: root.update_mtime(root.note_mtime)
    height: '48sp'
    size_hint_y: None

    canvas:
        Color:
            rgb: .3, .3, .3
        Rectangle:
            pos: self.pos
            size: self.width, 1

    BoxLayout:

        padding: '5dp'
        # 标题
        Label:
            text: root.note_title
        # 修改时间
        Label:
            id: label_mtime
            text: "1982-07-07"
        # 编写按钮
        Button:
            text: '>'
            size_hint_x: None
            width: self.height
            on_release: app.edit_note(root.note_index)

class NoteListItem(BoxLayout):
    """记事本列表"""
    note_content = StringProperty()  # 记事内容
    note_title = StringProperty()  # 记事标题
    note_index = NumericProperty()  # 记事索引
    note_mtime = NumericProperty()  # 记事修改时间

    def update_mtime(self, mtime):
        """更新修改时间"""
        self.ids.label_mtime.text = time.strftime("%Y-%m-%d\n%H:%M:%S", time.localtime(mtime))

on_note_mtime: root.update_mtime(root.note_mtime)当属性值note_mtime的值改变时，调用update_mtime函数，更新显示。
RecycleView显示记事标题

        # 记事本标题列表
        RecycleView:
            data: root.data_for_widgets
            viewclass: 'NoteListItem'
            RecycleBoxLayout:
                default_size: None, dp(56)
                default_size_hint: 1, None
                size_hint_y: None
                height: self.minimum_height
                orientation: 'vertical'
                spacing: dp(2)

class Notes(Screen):
    """记事本类"""
    data = ListProperty()

    def _get_data_for_widgets(self):
        return [{
            'note_index': index,
            'note_content': item['content'],
            'note_title': item['title'],
            'note_mtime': item['mtime']}
            for index, item in enumerate(self.data)]

    data_for_widgets = AliasProperty(_get_data_for_widgets, bind=['data'])

记事操作
记事操作在app中实现。

class NoteApp(App):
    """记事本程序"""
    def build(self):
        self.notes = Notes(name='notes')
        self.load_notes()  # 加载记事本
        self.transition = SlideTransition(duration=.35)
        root = ScreenManager(transition=self.transition)
        root.add_widget(self.notes)
        return root

    def load_notes(self):
        """加载记事本"""
        if not exists(self.notes_fn):
            self.notes.data = []
            return
        with open(self.notes_fn) as fd:
            data = json.load(fd)
        self.notes.data = data

    def add_note(self):
        """增加一个记事"""
        self.notes.data.append({'title': 'New note',
                                'content': '',
                                'mtime': time.time()})
        note_index = len(self.notes.data) - 1
        self.edit_note(note_index)

    def edit_note(self, note_index):
        """编辑记事"""
        note = self.notes.data[note_index]
        name = 'note{}'.format(note_index)

        if self.root.has_screen(name):
            self.root.remove_widget(self.root.get_screen(name))

        view = NoteView(
            name=name,
            note_index=note_index,
            note_title=note.get('title'),
            note_content=note.get('content'),
            note_mtime=note.get('mtime'))
        self.root.add_widget(view)
        self.transition.direction = 'left'
        self.root.current = view.name

    def del_note(self, note_index):
        """删除记事"""
        del self.notes.data[note_index]
        self.save_notes()
        self.refresh_notes()
        self.go_notes()

    def set_note_content(self, note_index, note_content):
        """设置记事内容"""
        self.notes.data[note_index]['content'] = note_content
        self.notes.data[note_index]['mtime'] = time.time()
        data = self.notes.data
        self.notes.data = []
        self.notes.data = data
        self.save_notes()
        self.refresh_notes()

    def set_note_title(self, note_index, note_title):
        """设置记事标题"""
        self.notes.data[note_index]['title'] = note_title
        self.notes.data[note_index]['mtime'] = time.time()
        self.save_notes()
        self.refresh_notes()

    def refresh_notes(self):
        """刷新记事本"""
        data = self.notes.data
        self.notes.data = []
        self.notes.data = data

    def save_notes(self):
        """保存记事"""
        with open(self.notes_fn, 'w') as fd:
            json.dump(self.notes.data, fd)

    def go_notes(self):
        """返回记事本列表"""
        self.transition.direction = 'right'
        self.root.current = 'notes'

    @property
    def notes_fn(self):
        return join('./', 'notes.json')

运行示例：

源码地址：https://github.com/babylco0/python3_examples/tree/master/Note