การเขียนคำอธิบายแบบกำหนดเอง
แนบข้อมูลกำกับให้กับการประกาศของคุณ
การเขียนคำอธิบายแบบกำหนดเอง เป็นบทเรียน Dart Academy ฟรีบน CoddyKit นี่คือบทเรียนที่ 2 จากทั้งหมด 4 บทเรียน คุณสามารถอ่านบทเรียนทั้งหมดด้านล่างฟรี — จากนั้นลองปฏิบัติด้วยตัวคุณเองในเบราว์เซอร์พร้อมตัวแก้ไขโค้ดในตัวและติวเตอร์ AI ตลอด 24/7 บทเรียนนี้เป็นส่วนหนึ่งของเส้นทางการเรียน Dart Academy และความก้าวหน้าของคุณจะซิงค์ข้ามเว็บและแอป CoddyKit คอร์ส Dart Academy มีบทเรียนทั้งหมด 4 บทเรียน
คำอธิบายกำกับคือคลาส
คำอธิบายกำกับแบบกำหนดเองก็คือคลาสธรรมดา เมื่อคุณเขียน @MyTag คุณกำลังอ้างถึงอินสแตนซ์ของคลาสนั้นในฐานะข้อมูลเมตา 🏷️
ประกาศคลาส
เริ่มด้วยการประกาศคลาสปกติสำหรับเก็บข้อมูลเมตา ในที่นี้คำอธิบายกำกับ Todo แบบง่าย ๆ จะใช้เก็บข้อความและเจ้าของในภายหลัง
class Todo {
final String message;
const Todo(this.message);
}กฎของตัวสร้าง const
ค่าของคำอธิบายกำกับต้องเป็นค่าคงที่ขณะคอมไพล์ ดังนั้นตัวสร้างจึงต้องเป็น const หากไม่มี const คุณจะใช้คลาสนี้เป็นคำอธิบายกำกับไม่ได้
ใช้คำอธิบายกำกับของคุณ
ใช้คำนำหน้า @ ร่วมกับการสร้างแบบ const แท็ก @Todo นี้ใช้บันทึกงานที่ยังต้องทำในเมธอดด้านล่าง
@Todo('Add validation')
void saveForm() {}เก็บหลายฟิลด์
คำอธิบายกำกับของคุณสามารถเก็บ ฟิลด์ ได้มากเท่าที่ต้องการ ให้ตัวสร้างรับพารามิเตอร์แบบมีชื่อเมื่อคุณต้องการแท็กที่ชัดเจนและอธิบายตัวเองได้
class Todo {
final String task;
final String who;
const Todo(this.task, this.who);
}ใช้อาร์กิวเมนต์ค่าคงที่เท่านั้น
อาร์กิวเมนต์ทุกตัวที่ส่งต้องเป็น ค่าคงที่ ด้วย ตัวอักษร ออบเจ็กต์ const และค่าจาก enum ใช้ได้ แต่ตัวแปรขณะทำงานใช้ไม่ได้
ตัวระบุที่ไม่มีอาร์กิวเมนต์
บางครั้งคุณต้องการเพียงแฟล็ก อินสแตนซ์ const ที่ไม่มีข้อมูลจะทำหน้าที่เป็นตัวระบุอย่างเดียวสำหรับแนบกับการประกาศ
class Experimental {
const Experimental();
}
const experimental = Experimental();ค่าคงที่ตัวช่วยชื่อพิมพ์เล็ก
การเปิดให้ใช้ const อินสแตนซ์ชื่อพิมพ์เล็ก ช่วยให้ผู้เรียกใช้เขียน @experimental ได้สะดวก แทนที่จะเขียน @Experimental() ทุกครั้ง
@experimental
void betaFeature() {}พวกมันยังไม่ทำงานด้วยตัวเอง
เช่นเดียวกับคำอธิบายกำกับในตัว คำอธิบายกำกับแบบกำหนดเองของคุณไม่มีพฤติกรรมในตัวเอง ต้องมีบางสิ่ง อ่าน มันก่อนจึงจะมีประโยชน์ ซึ่งเราจะกล่าวถึงต่อไป
ใครเป็นผู้อ่านคำอธิบายกำกับ
ผู้อ่านที่สำคัญมีสองประเภท ได้แก่ ตัวสร้างโค้ด ในขณะสร้าง และเครื่องมือรูปแบบการสะท้อน ทั้งสองประเภทจะตรวจสอบแท็กของคุณและทำงานกับข้อมูลเมตาที่พบ
ทำให้คำอธิบายกำกับมีขนาดเล็ก
คำอธิบายกำกับที่ดีควรมีขนาดเล็กและเป็นแบบประกาศ เก็บข้อมูลธรรมดา ไม่ใช่ตรรกะ เพื่อให้เครื่องมือใด ๆ อ่านได้อย่างคาดเดาได้และปลอดภัย
ตรวจสอบอย่างรวดเร็ว
คลาสต้องมีสิ่งใดจึงจะใช้เป็นคำอธิบายกำกับได้
สรุปทบทวน
คำอธิบายกำกับแบบกำหนดเองคือคลาสที่มีตัวสร้าง const ใช้ @ เพื่อแนบคำอธิบายกำกับ ส่งอาร์กิวเมนต์ค่าคงที่ และให้เครื่องมืออ่านข้อมูลเมตาในภายหลัง 🎉
คำถามที่พบบ่อย
บทเรียน “การเขียนคำอธิบายแบบกำหนดเอง” ฟรีหรือไม่
ใช่ — ข้อความเต็มของ “การเขียนคำอธิบายแบบกำหนดเอง” ฟรีให้อ่านที่นี่บนเว็บ เพื่อปฏิบัติแบบโต้ตอบ (ตัวแก้ไขโค้ดในตัวและติวเตอร์ AI ตลอด 24/7) และปลดล็อคส่วนที่เหลือของคอร์ส Dart Academy ให้อัปเกรดเป็น CoddyKit PRO คอร์ส Dart Academy มีบทเรียนทั้งหมด 4 บทเรียน
คุณจะเรียนรู้อะไรในบทเรียน “การเขียนคำอธิบายแบบกำหนดเอง”
แนบข้อมูลกำกับให้กับการประกาศของคุณ คุณปฏิบัติ Dart Academy ด้วยโค้ดที่ใช้งานได้จริงที่คุณเรียกใช้โดยตรงในเบราว์เซอร์ และติวเตอร์ AI ตลอด 24/7 ตอบคำถามของคุณขณะที่คุณไปผ่านบทเรียน
คุณต้องมีประสบการณ์ก่อนที่จะเริ่มเรียน Dart Academy หรือไม่
ไม่จำเป็นต้องมีประสบการณ์มาก่อน Dart Academy บน CoddyKit ออกแบบมาสำหรับผู้เริ่มต้นไปจนถึงผู้เรียนขั้นสูง คุณสามารถเริ่มต้นที่นี่หรือเริ่มจากตัวแรกและเรียนด้วยความเร็วของคุณเอง นี่คือบทเรียนที่ 2 จากทั้งหมด 4 บทเรียน
บทเรียน “การเขียนคำอธิบายแบบกำหนดเอง” ใช้เวลานานแค่ไหน
บทเรียน CoddyKit ส่วนใหญ่ใช้เวลาประมาณ 5–10 นาที แต่ละบทเรียนจึงสั้นและเป็นแบบโต้ตอบ คุณสามารถก้าวหน้าอย่างต่อเนื่องและกลับมาเรียนต่อจากตรงที่เพิ่งหยุดบนเว็บและแอปได้เลย
ฉันเขียนและรันโค้ดในบทเรียน Dart Academy นี้ได้ไหม
ได้ บทเรียน Dart Academy ทุกบทมีตัวแก้ไขโค้ดในตัว คุณจึงเขียนและรันโค้ดจริงได้เลยในเบราว์เซอร์ และได้รับข้อเสนอแนะจาก AI ในทันที — ไม่ต้องติดตั้งในเครื่องของคุณ
บทเรียนทั้งหมดในหลักสูตรนี้
- คำอธิบายในตัว: override, deprecated
- การเขียนคำอธิบายแบบกำหนดเอง
- การสร้างโค้ดด้วย build_runner
- json_serializable ในการใช้งานจริง