สำหรับนักพัฒนา

Site Code

ผูกข้อมูลกับหน้าออกแบบ

ส่งข้อมูลจากโค้ดไปแสดงในหน้าออกแบบด้วย collection, รับค่าจากปุ่มและฟอร์มด้วย action, ข้อมูลของหน้า, formatter, เงื่อนไข และ window.anasaki

อ่าน 7 นาทีอัปเดตล่าสุด

ดูเป็น Markdown

ในหน้านี้

นักพัฒนาประกาศ แหล่งข้อมูล และ การกระทำ ในโค้ด แล้วผู้ออกแบบนำไปใช้ในหน้าออกแบบได้โดยไม่ต้องเขียนโค้ด — หน้าเว็บสร้างฝั่งเซิร์ฟเวอร์ (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 }
});

ในหน้าออกแบบ:

  1. วางชิ้น รายการข้อมูล แล้วเลือก แหล่งข้อมูล จากกลุ่ม "โค้ดของเว็บไซต์ (site.collection)" (มีกลุ่ม "ตารางในฐานข้อมูล" ให้ดึงตารางตรง ๆ พร้อมเลือกคอลัมน์ เงื่อนไข และการเรียงด้วย)
  2. ออกแบบการ์ดใบแรก — ใบอื่นเปลี่ยนตาม ใช้ {{item.title}}, {{item.date | date:'D MMM YYYY'}} ในข้อความ
  3. ตั้ง ค่า 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 เสมอ