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

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

ที่มา: https://anasaki.live/docs/developers/designer-bindings

นักพัฒนาประกาศ **แหล่งข้อมูล** และ **การกระทำ** ในโค้ด แล้วผู้ออกแบบนำไปใช้ในหน้าออกแบบได้โดยไม่ต้องเขียนโค้ด — หน้าเว็บสร้างฝั่งเซิร์ฟเวอร์ (Google อ่านได้ ใช้ได้แม้ปิด JavaScript)

## Collection: ส่งรายการไปแสดง

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

> [!NOTE]
> ถ้าผู้เยี่ยมชมไม่เห็นรายการ ให้ตรวจ `access` ในโค้ด หรือ **โค้ดของเว็บไซต์ → สิทธิ์การเข้าถึง** — ค่าเริ่มต้นของ collection คือผู้ดูแลระบบเท่านั้น แถบเครื่องมือในหน้าออกแบบสลับ **ดูแบบ ผู้เยี่ยมชม / ฉัน** ได้

## Action: รับค่าจากปุ่มและฟอร์ม

```ts
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)** (เป็นนิพจน์ หรือ &#34;จากช่องในฟอร์ม&#34;) → เลือก **ถามยืนยันก่อน**, **เรนเดอร์ layer เหล่านี้ใหม่** และ **ข้อความเมื่อสำเร็จ** ได้

ผลลัพธ์ที่ `run` คืนได้: `message`, `redirect`, `refresh` (ชื่อ collection), `update` (layer), `page` (ค่าใหม่ของ `{{page.*}}`) — ข้อผิดพลาดของ input ตอบ 400 พร้อมข้อความรายช่อง

ฟอร์ม: ทำ Frame เป็นฟอร์ม แล้ววางชิ้น **ช่องกรอก** (text, search, number, email, select, checkbox, textarea, hidden) ข้างใน ช่องกรอกยังใช้ **กรองรายการ** ได้โดยไม่ต้องมี action

## ข้อมูลของหน้าและ formatter

```ts
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 จากปลั๊กอินเขียนเป็น `:` เช่น `{{ 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` ใช้ออกแบบหน้าตาตอนรายการว่าง

```text
{{ item.stock > 0 ? 'มีสินค้า' : 'หมด' }}
{{ item.price | number:2 }} บาท
แสดงเมื่อ: visitor.is.member
```

## โค้ดหน้าเว็บ และ window.anasaki

บล็อก **โค้ดหน้าเว็บ** (ต้องมี `edit_scripts`) มีช่อง HTML, CSS (มีผลเฉพาะในบล็อก ใช้ `:scope` แทนตัวบล็อก) และ JS (ES module ที่ได้ `el` = บล็อก และ `anasaki`):

```js
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 ไม่ทำงานในผืนงานของหน้าออกแบบ — กด **ลองรันในหน้าตัวอย่าง** เพื่อทดสอบ

> [!WARNING]
> action สาธารณะจำกัด 30 ครั้ง/นาที/IP และต้องมี CSRF token (runtime ของหน้าใส่ให้เอง) อย่าเชื่อค่าจาก input โดยไม่ตรวจ — ประกาศชนิดใน `input` เสมอ
