Nhúng ô — <wall-cell>
Một web component nhỏ, chỉ đọc, không kéo theo framework. Dán một thẻ script và một thẻ <wall-cell> là hiển thị được một ô của Bức Tường trên bất kỳ trang HTML nào. Dữ liệu lấy qua chính API công khai mà tường tự dùng (dogfooding) — không có đường dữ liệu riêng, không thao tác ghi.
Ví dụ sống
Các ô dưới đây là dữ liệu thật, tải trực tiếp từ API công khai. Bấm vào một ô để mở về tường thật.
Cách dùng
<!-- 1. Nạp component một lần (ở <head> hoặc cuối <body>) -->
<script src="https://tuong.example/embed/wall-cell.js" async></script>
<!-- 2. Đặt ô ở bất cứ đâu trên trang -->
<wall-cell quadkey="12022110120101230"></wall-cell>
<wall-cell quadkey="12022110100000000" size="160"></wall-cell>Component tự lấy origin của API từ chính đường dẫn thẻ script — nên nó luôn gọi đúng host đã phục vụ nó, kể cả khi trang nhúng nằm ở tên miền khác.
Thuộc tính
| Thuộc tính | Mô tả | |
|---|---|---|
| quadkey | bắt buộc | Địa chỉ ô — quadkey cơ số 4, đúng 17 ký tự. |
| size | tùy chọn | Cạnh khung tính bằng px (mặc định 200, tối thiểu 48). Khung luôn vuông 1:1. |
| href | tùy chọn | Link mở khi bấm vào ô (tab mới). Mặc định trỏ về tường thật: /wall?cell={quadkey}. |
Ghi chú
- Chỉ đọc. Component không có bất kỳ thao tác ghi nào (không claim, không đổi hướng). Muốn tương tác, người xem bấm vào ô để mở về tường thật.
- CORS. Các route đọc công khai (cells, tiles, covers, districts, stats, event, stream) bật CORS cho
GETnên nhúng được ở tên miền khác. Các route ghi (đăng nhập, claim, đặt điểm) không mở CORS. - Tài liệu API. Danh sách đầy đủ endpoint đọc công khai — tham số, ví dụ, mã lỗi, header cache — nằm ở
docs/API.mdtrong kho mã. Đây là mầm của Wall Protocol.