Công cụ cho nhà phát triển theo khối
là một công cụ dựa trên nền tảng web dành cho nhà phát triển, giúp tự động hoá các phần của cấu hình Blockly
bao gồm cả việc tạo khối tuỳ chỉnh, xây dựng hộp công cụ,
và định cấu hình không gian làm việc Blockly trên web.
Quy trình sử dụng công cụ này dành cho nhà phát triển Blockly bao gồm ba phần:
- Tạo các khối tuỳ chỉnh bằng Block Factory và Block Exporter.
- Tạo hộp công cụ và không gian làm việc mặc định bằng Workspace Factory.
- Định cấu hình không gian làm việc bằng Workspace Factory (hiện chỉ hỗ trợ nền tảng web tính năng).
Chặn thẻ về trạng thái ban đầu
Thẻ Block Factory giúp bạn tạo chặn định nghĩa và trình tạo mã khối cho các khối tuỳ chỉnh. Trên thẻ này, bạn có thể dễ dàng tạo, sửa đổi và lưu khối tuỳ chỉnh.
Xác định một khối
Video này sẽ hướng dẫn chi tiết các bước xác định khối. Giao diện người dùng đã tắt nhưng các tính năng chặn mà nó đánh dấu vẫn chính xác.
Quản lý thư viện
Các khối được tham chiếu theo tên, vì vậy, mỗi khối mà bạn muốn tạo phải có một tên duy nhất. Giao diện người dùng thực thi việc này và làm rõ khi bạn "lưu" một khối mới hoặc "đang cập nhật" khối hiện có.
Bạn có thể chuyển đổi giữa các khối mà bạn đã lưu trước đó hoặc tạo một khối trống mới chặn bằng cách nhấp vào nút Library (Thư viện). Việc thay đổi tên của khối hiện có một cách khác để tạo nhanh nhiều khối với định nghĩa tương tự.
Xuất và nhập thư viện
Các quy tắc chặn được lưu vào bộ nhớ cục bộ của trình duyệt. Xoá tệp cục bộ của trình duyệt bộ nhớ sẽ xoá các chế độ chặn của bạn. Để lưu các quy tắc chặn vô thời hạn, bạn phải tải thư viện của bạn xuống. Thư viện khối được tải xuống dưới dạng tệp XML tệp có thể được nhập để đặt Thư viện khối về trạng thái như khi bạn đã tải tệp xuống. Lưu ý rằng việc nhập Thư viện khối sẽ thay thế tệp hiện tại, vì vậy, bạn có thể muốn xuất trước.
Các tính năng nhập và xuất cũng là cách được đề xuất để duy trì và dùng chung các nhóm khối tuỳ chỉnh khác nhau.
Chặn thẻ Trình xuất
Sau khi thiết kế xong các khối, bạn sẽ cần xuất định nghĩa khối và mã giả lập trình tạo để sử dụng trong ứng dụng. Việc này được thực hiện trên Chặn thẻ Trình xuất.
Mọi khối được lưu trữ trong Thư viện khối sẽ hiển thị trong Bộ chọn khối. Nhấp vào khối để chọn hoặc bỏ chọn khối đó để xuất. Nếu bạn muốn chọn tất cả khối trong thư viện của bạn, hãy sử dụng nút “Select” (Chọn) → “All Stored In Block” (Tất cả khối được lưu trữ trong khối) Thư viện". Nếu bạn đã tạo hộp công cụ hoặc định cấu hình không gian làm việc bằng thẻ Nhà máy của Workspace, bạn cũng có thể chọn tất cả các khối mà bạn đã sử dụng nhấp vào “Select” (Chọn) → “All Using in Workspace Factory” (Tất cả dùng trong Workspace Factory).
Chế độ cài đặt xuất cho phép bạn chọn ngôn ngữ được tạo mà bạn muốn nhắm đến và liệu bạn muốn các định nghĩa, mã giả lập trình tạo hay cả hai cho chặn đã chọn. Khi bạn đã chọn những thành phần này, hãy nhấp vào 'Xuất' để tải tệp.
Thẻ Trạng thái ban đầu của Workspace
Workspace Factory giúp bạn dễ dàng định cấu hình hộp công cụ và chế độ cài đặt mặc định trong một không gian làm việc. Bạn có thể chuyển đổi giữa chỉnh sửa hộp công cụ và bắt đầu không gian làm việc bằng "Hộp công cụ" và "Workspace" các nút.
Tạo bộ công cụ
Thẻ này giúp xây dựng tệp XML cho Hộp công cụ. Tài liệu này giả định quen thuộc với các tính năng của Hộp công cụ. Nếu đã có XML cho hộp công cụ mà bạn muốn chỉnh sửa tại đây, bạn có thể hãy tải trang tổng quan bằng cách nhấp vào "Tải để chỉnh sửa".
Hộp công cụ không có danh mục
Nếu bạn có một vài khối và muốn hiển thị chúng mà không có bất kỳ danh mục nào, chỉ cần kéo chúng vào không gian làm việc và bạn sẽ thấy các khối xuất hiện trong hộp công cụ trong bản xem trước.
Hộp công cụ có danh mục
Nếu bạn muốn chặn hiển thị trong danh mục, hãy nhấp vào nút "+" và chọn mục thả xuống cho danh mục mới. Thao tác này sẽ thêm một danh mục vào danh sách danh mục của bạn để bạn có thể chọn và chỉnh sửa. Chọn "Danh mục chuẩn" để thêm một cá nhân danh mục Blockly chuẩn (Logic, Loops, v.v.) hoặc "Standard Toolbox" (Hộp công cụ tiêu chuẩn) để thêm tất cả các danh mục Blockly chuẩn. Sử dụng các nút mũi tên để sắp xếp lại các danh mục.
Để thay đổi tên hoặc màu của danh mục đã chọn, hãy sử dụng nút "Chỉnh sửa danh mục" trình đơn thả xuống. Việc kéo một khối vào không gian làm việc sẽ thêm khối đó vào danh sách được chọn danh mục.
Khối nâng cao
Theo mặc định, bạn có thể thêm bất kỳ khối chuẩn hoặc khối nào vào thư viện của mình vào hộp công cụ. Nếu bạn có các khối được xác định trong JSON nhưng không có trong thư viện của mình, bạn có thể nhập chúng bằng cách sử dụng công cụ "Nhập khối tuỳ chỉnh" .
Một số khối nên được sử dụng cùng nhau hoặc bao gồm các khối mặc định. Việc này được thực hiện bằng nhóm và bóng. Bất kỳ hạng nào các khối được kết nối trong trình chỉnh sửa sẽ được thêm vào hộp công cụ dưới dạng một nhóm. Khối được đính kèm vào một khối khác cũng có thể được thay đổi thành khối bóng bằng cách chọn khối con và nhấp vào "Tạo bóng" . Lưu ý: Chỉ các khối con không chứa biến mới có thể được thay đổi thành bóng chặn.
Nếu bạn đưa một biến hoặc khối hàm vào hộp công cụ của chúng, hãy thêm một Danh mục "Biến" hoặc "Hàm" trong hộp công cụ của bạn để cho phép người dùng tận dụng khối. Tìm hiểu thêm về “Biến” hoặc “Hàm" danh mục.
Định cấu hình không gian làm việc (dành cho Web Blockly)
Để định cấu hình nhiều phần trong không gian làm việc của bạn, hãy chuyển đến phần “Workspace Factory” rồi chọn "Không gian làm việc".
Chọn các lựa chọn không gian làm việc
Đặt các giá trị khác nhau cho các lựa chọn cấu hình và xem kết quả trong phần xem trước. Đang bật lưới hoặc tính năng thu phóng sẽ hiện thêm nhiều tuỳ chọn để định cấu hình. Ngoài ra, việc chuyển sang sử dụng danh mục thường đòi hỏi độ phức tạp cao hơn workspace; thùng rác và thanh cuộn được thêm tự động khi bạn thêm danh mục đầu tiên.
Thêm các Khối đã tải sẵn vào Không gian làm việc
Việc này là không bắt buộc nhưng có thể cần thiết nếu bạn muốn hiển thị một tập hợp các khối trong không gian làm việc:
- Khi ứng dụng tải.
- Khi một sự kiện (nâng cấp, nhấp vào nút trợ giúp, v.v.) được kích hoạt.
Kéo các khối vào không gian chỉnh sửa để xem các khối đó trong không gian làm việc của bạn trong bản xem trước. Bạn có thể tạo nhóm khối, tắt tính năng chặn và tạo bóng đổ của một số khối khi bạn chọn chúng.
Bạn có thể xuất các khối này dưới dạng XML (xem bên dưới). Thêm chúng vào không gian làm việc của bạn bằng
Blockly.Xml.domToWorkspace, ngay sau khi bạn tạo không gian làm việc:
var xmlText = '<xml xmlns="https://developers.google.com/blockly/xml">' +
'<block type="math_number"></block></xml>';
Blockly.Xml.domToWorkspace(Blockly.utils.xml.textToDom(xmlText), workspace);
Mã mẫu này sẽ thêm một khối math_number duy nhất vào không gian làm việc.
Xuất
Workspace Factory cung cấp cho bạn các lựa chọn xuất sau đây:
- Mã khởi đầu: Tạo html và javascript bắt đầu để chèn tùy chỉnh của bạn Chặn không gian làm việc.
- Hộp công cụ: Tạo tệp XML để chỉ định hộp công cụ của bạn.
- Không gian làm việc: Tạo tệp XML có thể tải vào không gian làm việc.