Site Code
ผูกข้อมูลกับหน้าออกแบบ
ส่งข้อมูลจากโค้ดไปแสดงในหน้าออกแบบด้วย collection, รับค่าจากปุ่มและฟอร์มด้วย action, ข้อมูลของหน้า, formatter, เงื่อนไข และ window.anasaki
ในหน้านี้
นักพัฒนาประกาศ แหล่งข้อมูล และ การกระทำ ในโค้ด แล้วผู้ออกแบบนำไปใช้ในหน้าออกแบบได้โดยไม่ต้องเขียนโค้ด — หน้าเว็บสร้างฝั่งเซิร์ฟเวอร์ (Google อ่านได้ ใช้ได้แม้ปิด JavaScript)
Collection: ส่งรายการไปแสดง#
site.collection('events', {
label: { th: 'อีเวนต์', en: 'Events' },
fields: { title: 'text', date: 'date', image: 'image', body: 'html' },
params: { category: 'text', q: 'text' }, // ค่าที่รับจากหน้าออกแบบ/URL
perPage: { default: 9, max: 30 },
cache: 60, // วินาที
access: ['*'], // ค่าเริ่มต้น ['administrator']
load: ({ page, perPage, params }) =>
db.table('events').where('category', params.category).paginate(page, perPage), // { items, total }
});
ในหน้าออกแบบ:
- วางชิ้น รายการข้อมูล แล้วเลือก แหล่งข้อมูล จากกลุ่ม "โค้ดของเว็บไซต์ (site.collection)" (มีกลุ่ม "ตารางในฐานข้อมูล" ให้ดึงตารางตรง ๆ พร้อมเลือกคอลัมน์ เงื่อนไข และการเรียงด้วย)
- ออกแบบการ์ดใบแรก — ใบอื่นเปลี่ยนตาม ใช้
{{item.title}},{{item.date | date:'D MMM YYYY'}}ในข้อความ - ตั้ง ค่า params เป็นนิพจน์ เช่น
query.categoryหรือ'news'และกด เพิ่มเลขหน้าให้รายการนี้ เพื่อวางชิ้น เลขหน้า (เลขหน้า, ก่อนหน้า/ถัดไป หรือปุ่มโหลดเพิ่ม)
ถ้าผู้เยี่ยมชมไม่เห็นรายการ ให้ตรวจ access ในโค้ด หรือ โค้ดของเว็บไซต์ → สิทธิ์การเข้าถึง — ค่าเริ่มต้นของ collection คือผู้ดูแลระบบเท่านั้น แถบเครื่องมือในหน้าออกแบบสลับ ดูแบบ ผู้เยี่ยมชม / ฉัน ได้
Action: รับค่าจากปุ่มและฟอร์ม#
site.action('register', {
input: { eventId: 'number', note: 'text?', email: 'email' }, // ตรวจก่อนเรียก run ('?' = ไม่บังคับ)
access: ['*'],
run: ({ input, response }) => {
db.table('registrations').insert({ event_id: input.eventId, email: input.email, note: input.note });
return { message: 'ลงทะเบียนแล้ว', refresh: ['events'] }; // แสดงข้อความ + เรนเดอร์ collection ใหม่
},
});
ในหน้าออกแบบ เลือกปุ่มหรือ layer ใดก็ได้ → interaction เรียกโค้ด (action) → เลือก action → ตั้ง ค่าที่ส่ง (input) (เป็นนิพจน์ หรือ "จากช่องในฟอร์ม") → เลือก ถามยืนยันก่อน, เรนเดอร์ layer เหล่านี้ใหม่ และ ข้อความเมื่อสำเร็จ ได้
ผลลัพธ์ที่ run คืนได้: message, redirect, refresh (ชื่อ collection), update (layer), page (ค่าใหม่ของ {{page.*}}) — ข้อผิดพลาดของ input ตอบ 400 พร้อมข้อความรายช่อง
ฟอร์ม: ทำ Frame เป็นฟอร์ม แล้ววางชิ้น ช่องกรอก (text, search, number, email, select, checkbox, textarea, hidden) ข้างใน ช่องกรอกยังใช้ กรองรายการ ได้โดยไม่ต้องมี action
ข้อมูลของหน้าและ formatter#
site.page('/checkout', { load: ({ request, user }) => ({ total: 1234.5 }) }); // {{page.total}}
site.formatter('baht', (v) => '฿' + Number(v).toFixed(2)); // {{ item.price | baht }}
formatter ในตัว: number[:ทศนิยม], date:'รูปแบบ' (ชื่อเดือนภาษาไทยบนเว็บภาษาไทย), upper, lower, truncate:n, default:v, json · formatter จากปลั๊กอินเขียนเป็น <id>:<ชื่อ> เช่น {{ price | thai:baht }}
นิพจน์และเงื่อนไข#
{{ … }} ใช้ได้ทุกที่ที่ใส่ข้อมูลอัตโนมัติ: พาธ (item.price, page.total, post.title, site.title, query.q, $index), เครื่องหมาย + - * / % < > == != && || ?? ?: และ formatter (| number:2) — เรียกฟังก์ชันหรือใช้ [ ] ไม่ได้ ทุกค่าถูก escape HTML
ทุก layer มี เงื่อนไข → แสดงเมื่อ: นิพจน์ที่เป็นเท็จ (false, null, '', 0, []) ทำให้ layer นั้น ไม่ถูกส่งไปเบราว์เซอร์เลย — เงื่อนไข $empty ใช้ออกแบบหน้าตาตอนรายการว่าง
{{ item.stock > 0 ? 'มีสินค้า' : 'หมด' }}
{{ item.price | number:2 }} บาท
แสดงเมื่อ: visitor.is.member
โค้ดหน้าเว็บ และ window.anasaki#
บล็อก โค้ดหน้าเว็บ (ต้องมี edit_scripts) มีช่อง HTML, CSS (มีผลเฉพาะในบล็อก ใช้ :scope แทนตัวบล็อก) และ JS (ES module ที่ได้ el = บล็อก และ anasaki):
const r = await anasaki.call('register', { eventId: 5, email }); // เรียก site.action
if (!r.ok) el.querySelector('.err').textContent = r.message ?? '';
const stats = await anasaki.get('/api/stats', { days: 7 }); // เรียก site.route (origin เดียวกัน)
await anasaki.refresh('events'); // เรนเดอร์ collection ใหม่
JavaScript ไม่ทำงานในผืนงานของหน้าออกแบบ — กด ลองรันในหน้าตัวอย่าง เพื่อทดสอบ
action สาธารณะจำกัด 30 ครั้ง/นาที/IP และต้องมี CSRF token (runtime ของหน้าใส่ให้เอง) อย่าเชื่อค่าจาก input โดยไม่ตรวจ — ประกาศชนิดใน input เสมอ
