Tạo đoạn mã

Tạo

Thông thường, mẫu đoạn mã .snippet nên trực tiếp trả về một bảng, ví dụ:

return {
    name = 'Đoạn mã thử nghiệm';  -- tên đoạn mã
    description = 'Dùng để thử nghiệm nhiều trình chọn';  -- mô tả đoạn mã
    arguments = {  -- danh sách trình chọn
        {  -- trình chọn 1
            type = 'app';  -- loại trình chọn
            title = 'Chọn ứng dụng';  -- tiêu đề trình chọn
            subtitle = 'Vui lòng chọn một ứng dụng';  -- tiêu đề phụ của trình chọn
            default = 'com.xxtouch.XXTExplorer';  -- giá trị mặc định
        },
        {  -- trình chọn 2
            type = 'loc';
            title = 'Chọn vị trí';
            subtitle = 'Chọn vị trí bất kỳ';
            default = xui.get('com.darwindev.XXTExplorer', 'location1');
            -- Có thể dùng mọi API được .xui hỗ trợ bên trong .snippet
        },
        {  -- trình chọn 3

        },
        -- ...
    };
    generator = function (...)  -- hàm tạo nhận số lượng đối số biến đổi
        -- Xử lý tham số và trả về kết quả đã tạo
        local result
        return result
    end;
}

Cấp gốc

Khóa	Kiểu	Mô tả
name	string	Tên hiển thị của đoạn mã
description	string	Mô tả đoạn mã
arguments	array	Danh sách trình chọn
generator	function	Hàm tạo đoạn mã
output	string	Tên tệp đầu ra độc lập

name và description được hiển thị trong trình quản lý tệp và mục đoạn mã.

arguments là mảng chứa một hoặc nhiều từ điển tham số trình chọn. Ứng dụng tạo hàng đợi trình chọn theo thứ tự đã chỉ định và hướng dẫn người dùng chọn từng bước. Sau khi hoàn tất, ứng dụng truyền các giá trị trả về của trình chọn vào generator dưới dạng tham số biến đổi rồi trả về kết quả của hàm.

.snippet có thể được dùng độc lập. Để cho phép sử dụng độc lập, hãy đặt trường output. Văn bản do generator trả về sẽ được lưu vào tệp mà output chỉ định trong cùng thư mục.

Từ điển tham số trình chọn

Khóa	Kiểu	Mô tả
type	string	Loại trình chọn
title	string	Tiêu đề trình chọn (hiển thị bên dưới trình chọn)
subtitle	string	Tiêu đề phụ của trình chọn (hiển thị bên dưới trình chọn)
default	primitive	Giá trị mặc định

Xem các phần sau để biết chi tiết về từ điển tham số của từng loại trình chọn.

Dùng trong XUI

Nếu .snippet được dùng trong thành phần XUI TitleValue, có thể khởi chạy hàng đợi trình chọn từ XUI và lưu kết quả vào tùy chọn của thành phần. .snippet có thể gọi mọi API XUI như xui.get/xui.set/xpp.bundle_path.

Dùng trong trình soạn thảo mã

Đặt tệp .snippet vào thư mục snippets của thư mục chính để dùng trong trình soạn thảo mã của ứng dụng. Nhấn biểu tượng ngôi sao trên thanh công cụ bàn phím để nhanh chóng tạo và chèn đoạn mã vào mã đang chỉnh sửa.

Dùng làm tệp độc lập

Đặt trường output và đưa đoạn mã vào lua/scripts trong thư mục chính. Có thể nhấn vào tệp trong ứng dụng để bắt đầu hàng đợi trình chọn; văn bản do generator trả về sẽ được lưu vào tệp mà output chỉ định trong cùng thư mục.