<data>

<scheme>://<host>:<port>[<path>|<pathPrefix>|<pathPattern>|<pathAdvancedPattern>|<pathSuffix>]

แอตทริบิวต์ที่ระบุรูปแบบ URI เหล่านี้เป็นแอตทริบิวต์ที่ไม่บังคับ แต่ก็ขึ้นอยู่กับกันและกันด้วย

• หากไม่ได้ระบุ scheme สำหรับตัวกรอง Intent ระบบจะละเว้นแอตทริบิวต์ URI อื่นๆ ทั้งหมด
• หากไม่ได้ระบุ host สำหรับตัวกรอง ระบบจะไม่สนใจแอตทริบิวต์ port และแอตทริบิวต์เส้นทางทั้งหมด

องค์ประกอบ <data> ทั้งหมดที่อยู่ในองค์ประกอบ <intent-filter> เดียวกันจะส่งผลต่อ ตัวกรองเดียวกัน เช่น ข้อกำหนดตัวกรองต่อไปนี้

<intent-filter . . . >
    <data android:scheme="something" android:host="project1.example.com" />
    <data android:scheme="something-else" android:host="project2.example.com" android:path="/page1" />
    ...
</intent-filter>

เทียบเท่ากับ

<intent-filter . . . >
    <data android:scheme="something" />
    <data android:scheme="something-else" />
    <data android:host="project1.example.com" />
    <data android:host="project2.example.com" />
    <data android:path="/page1" />
    ...
</intent-filter>

คุณวางองค์ประกอบ <data> จำนวนเท่าใดก็ได้ภายใน <intent-filter> เพื่อให้มีตัวเลือกข้อมูลหลายรายการ ไม่มีแอตทริบิวต์ใดที่มีค่าเริ่มต้น

ดูข้อมูลเกี่ยวกับวิธีการทำงานของตัวกรอง Intent รวมถึงกฎเกี่ยวกับวิธีจับคู่ออบเจ็กต์ Intent กับตัวกรองได้ที่ Intent และ ตัวกรอง Intent และส่วน ตัวกรอง Intent ในภาพรวมของไฟล์ Manifest

android:scheme

ส่วนรูปแบบของ URI นี่คือแอตทริบิวต์ที่จำเป็นขั้นต่ำสำหรับ การระบุ URI ต้องตั้งค่าschemeอย่างน้อย 1 รายการ สำหรับตัวกรอง มิเช่นนั้นแอตทริบิวต์ URI อื่นๆ จะไม่มีความหมาย

มีการระบุรูปแบบโดยไม่มีเครื่องหมายโคลอนต่อท้าย เช่น http แทนที่จะเป็น http:

หากตัวกรองมีการตั้งค่าประเภทข้อมูล (ใช้แอตทริบิวต์ mimeType ) แต่ไม่มีรูปแบบ ระบบจะถือว่าใช้รูปแบบ content: และ file:

หมายเหตุ: การจับคู่รูปแบบในเฟรมเวิร์ก Android จะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ ซึ่งแตกต่างจาก RFC ดังนั้น ให้ระบุรูปแบบ โดยใช้ตัวอักษรพิมพ์เล็กเสมอ

android:host

ส่วนโฮสต์ของโดเมน/โฮสต์ของ URI แอตทริบิวต์นี้ไม่มีความหมาย เว้นแต่จะมีการระบุแอตทริบิวต์ scheme สำหรับตัวกรองด้วย หากต้องการจับคู่โดเมนย่อยหลายรายการ ให้ใช้เครื่องหมายดอกจัน (*) เพื่อ จับคู่อักขระ 0 ตัวขึ้นไปในโฮสต์ เช่น โฮสต์ *.google.com จะตรงกับ www.google.com, .google.com และ developer.google.com

เครื่องหมายดอกจันต้องเป็นอักขระแรกของแอตทริบิวต์โฮสต์ เช่น โฮสต์ google.co.* ไม่ถูกต้องเนื่องจากไวลด์การ์ดอกจันไม่ใช่ตัวอักษรแรก

หมายเหตุ: การจับคู่ชื่อโฮสต์ในเฟรมเวิร์ก Android จะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ ซึ่งแตกต่างจาก RFC อย่างเป็นทางการ ดังนั้น ให้ระบุชื่อโฮสต์โดยใช้ตัวอักษรพิมพ์เล็กเสมอ

android:port

ส่วนพอร์ตของโดเมน/โฮสต์ของ URI แอตทริบิวต์นี้จะมีความหมายก็ต่อเมื่อมีการระบุแอตทริบิวต์ scheme และ host สำหรับตัวกรองด้วย

android:path
android:pathPrefix
android:pathSuffix
android:pathPattern
android:pathAdvancedPattern

ส่วนเส้นทางของ URI ซึ่งต้องขึ้นต้นด้วย / แอตทริบิวต์ path ระบุเส้นทางที่สมบูรณ์ซึ่งตรงกับเส้นทางที่สมบูรณ์ในออบเจ็กต์ Intent แอตทริบิวต์ pathPrefix ระบุเส้นทางบางส่วนที่ตรงกับ เฉพาะส่วนเริ่มต้นของเส้นทางในออบเจ็กต์ Intent

แอตทริบิวต์ pathSuffix จะตรงกับส่วนท้ายของเส้นทางในออบเจ็กต์ Intent อย่างแน่นอน และแอตทริบิวต์นี้ไม่จำเป็นต้องขึ้นต้นด้วยอักขระ /

แอตทริบิวต์ pathPattern ระบุเส้นทางที่สมบูรณ์ซึ่งตรงกับเส้นทางที่สมบูรณ์ในออบเจ็กต์ Intent แต่สามารถมีอักขระไวลด์การ์ดต่อไปนี้

• จุด (.) จะจับคู่กับอักขระเดี่ยวตัวใดก็ได้ หากต้องการจับคู่เครื่องหมายจุดตามตัวอักษร ให้ยกเว้น เครื่องหมายดังกล่าวเป็น \\. ใน XML
• เครื่องหมายดอกจัน (*) จะจับคู่กับลำดับของอักขระที่อยู่ก่อนหน้า ซึ่งอาจปรากฏ 0 ครั้งหรือหลายครั้งก็ได้ เช่น a* จะตรงกับ "a" และ "aa" แต่ไม่ตรงกับสตริงว่าง
• จุดที่ตามด้วยเครื่องหมายดอกจัน (.*) จะจับคู่กับลำดับอักขระใดก็ได้ตั้งแต่ 0 ตัวขึ้นไป เช่น .* จะตรงกับสตริงว่าง และ b.* จะตรงกับ "b" "bc" และ "bcd"

ข้อควรพิจารณาที่สำคัญสำหรับ pathPattern

• ไม่มีการย้อนรอย: ตัวจับคู่รูปแบบของ Android จะประเมินสตริงในการส่งต่อครั้งเดียวโดยไม่มีการย้อนรอย หากไวลด์การ์ดใช้ตัวอักษรที่จำเป็นในภายหลัง ในรูปแบบ การจับคู่จะล้มเหลว
• .* เป็นแบบ Lazy: ไวลด์การ์ด .* เป็นแบบ Lazy โดยจะใช้ อักขระจนกว่าจะพบอักขระตามตัวอักษรตัวถัดไปตัวแรกใน รูปแบบ
  • "abc.*xyz" จะไม่ตรงกับ "abcpxqrxyz" .* จะหยุดอย่างช้าๆ ที่ "x" ตัวแรก (จาก "px...") สตริงที่เหลือ "qrxyz" จะไม่ตรงกับ "yz" ที่คาดไว้
  • คำเตือน: เนื่องจาก .* มองหาอักขระที่ตรงกันทุกประการเพื่อ หยุด "a.*.c" จึงไม่ตรงกับ "abbbc" ตัวจับคู่จะถือว่า . ตัวที่ 2 เป็นจุดตามตัวอักษรและสแกนสตริงเพื่อหา "." โดยจะล้มเหลวเมื่อถึงจุดสิ้นสุด
• * เป็นแบบ Greedy: อักขระที่เฉพาะเจาะจงตามด้วยเครื่องหมายดอกจัน (เช่น a*) จะเป็นแบบ Greedy โดยจะใช้ทั้งหมดของอักขระที่ต่อเนื่องกัน โดยไม่ต้องดูข้างหน้า
  • "a*a" จะไม่ตรงกับสตริง เช่น "aaa" ส่วน a* จะใช้ "a" ทั้ง 3 ตัวอย่างตะกละตะกลาม รูปแบบ คาดหวัง "a" สุดท้าย แต่สตริงหมดแล้ว ทำให้การจับคู่ไม่สำเร็จ
• แนวทางปฏิบัติแนะนำ:
  • หลีกเลี่ยงรูปแบบที่อักขระซึ่งอยู่ต่อจาก * เหมือนกับอักขระที่อยู่ก่อนหน้า (เช่น a*a)
  • หลีกเลี่ยงการวางอักขระไวด์การ์ดทันทีหลังจาก .* (เช่น .*. หรือ .*.*)
  • หากต้องการจับคู่คำนำหน้า การใช้ android:pathPrefix จะปลอดภัยและมีประสิทธิภาพมากกว่าการลงท้าย pathPattern ด้วย .*

แอตทริบิวต์ pathAdvancedPattern ระบุเส้นทางที่สมบูรณ์ ซึ่งจะจับคู่กับเส้นทางที่สมบูรณ์ของออบเจ็กต์ Intent และรองรับรูปแบบที่คล้ายกับนิพจน์ทั่วไปต่อไปนี้

• จุด (.) จะจับคู่กับอักขระใดก็ได้
• ชุด ([...]) จะตรงกับช่วงของอักขระ เช่น [0-5] จะตรงกับตัวเลขตั้งแต่ 0 ถึง 5 แต่ไม่ตรงกับตัวเลขตั้งแต่ 6 ถึง 9 [a-zA-Z] ตรงกับตัวอักษรใดก็ได้ ไม่ว่าจะตัวพิมพ์เล็กหรือตัวพิมพ์ใหญ่ นอกจากนี้ ชุดยังรองรับตัวแก้ไข "not" ^ ด้วย
• ตัวแก้ไขเครื่องหมายดอกจัน (*) จะจับคู่รูปแบบก่อนหน้า 0 ครั้งขึ้นไป
• ตัวแก้ไขเครื่องหมายบวก (+) จะจับคู่รูปแบบก่อนหน้าอย่างน้อย 1 ครั้ง
• ตัวแก้ไขช่วง ({...}) จะระบุจำนวนครั้งที่รูปแบบ สามารถจับคู่ได้

pathAdvancedPatternตัวจับคู่คือการติดตั้งใช้งานการประเมินซึ่งการจับคู่ จะดำเนินการกับรูปแบบแบบเรียลไทม์โดยไม่รองรับการย้อนกลับ

เนื่องจาก\ใช้เป็นอักขระหลีกเมื่ออ่านสตริงจาก XML คุณจึงต้องกำหนดเป็นอักขระหลีกสองครั้งก่อนที่จะแยกวิเคราะห์เป็นรูปแบบ เช่น เขียนอักขระ * เป็น \\* และเขียนอักขระ \ เป็น \\\\ ซึ่งคล้ายกับสิ่งที่คุณเขียนเมื่อ สร้างสตริงในโค้ด Java

ดูข้อมูลเพิ่มเติมเกี่ยวกับรูปแบบทั้ง 5 ประเภทนี้ได้ในคำอธิบายของ PATTERN_LITERAL, PATTERN_PREFIX, PATTERN_SIMPLE_GLOB, PATTERN_SUFFIX และ PATTERN_ADVANCED_GLOB ในคลาส PatternMatcher

แอตทริบิวต์เหล่านี้จะมีความหมายก็ต่อเมื่อมีการระบุแอตทริบิวต์ scheme และ host สำหรับตัวกรองด้วย

pathSuffix และ pathAdvancedPattern เปิดตัวในระดับ API 31

android:fragment
android:fragmentPrefix
android:fragmentSuffix
android:fragmentPattern
android:fragmentAdvancedPattern

ตัวจับคู่สำหรับส่วนย่อย URI ไม่ต้องใส่คำนำหน้า # ดูความหมายและรูปแบบที่อนุญาตในแต่ละแอตทริบิวต์ได้ที่ด้านบน

หากต้องการจับคู่อักขระที่มักจะเข้ารหัส URI ให้รวมรูปแบบดิบ (ไม่ได้เข้ารหัส) ไว้ในค่าแอตทริบิวต์ เช่น <data android:fragment="test!" /> ตรงกับ #test! และ #test%21

เปิดตัวในระดับ API 35

android:query
android:queryPrefix
android:querySuffix
android:queryPattern
android:queryAdvancedPattern

ตัวจับคู่สำหรับพารามิเตอร์การค้นหา URI (และค่าหากมี) เช่น คุณสามารถจับคู่ URI ที่ลงท้ายด้วย ?param=value กับ <data android:query="param=value" /> ไม่ต้องใส่คำนำหน้า ? ดูความหมายและรูปแบบที่อนุญาตในแต่ละแอตทริบิวต์ได้ที่ด้านบน

หากต้องการจับคู่อักขระที่มักจะเข้ารหัส URI ให้รวมรูปแบบดิบ (ไม่ได้เข้ารหัส) ไว้ในค่าแอตทริบิวต์ เช่น <data android:query="test!" /> ตรงกับ ?test! และ ?test%21

เปิดตัวในระดับ API 35

android:mimeType

ประเภทสื่อ MIME เช่น image/jpeg หรือ audio/mpeg4-generic ประเภทย่อยอาจเป็นไวลด์การ์ดดอกจัน (*) เพื่อระบุว่าประเภทย่อยใดก็ได้ที่ตรงกัน

โดยทั่วไปแล้ว ตัวกรอง Intent จะประกาศองค์ประกอบ <data> ที่มีเฉพาะแอตทริบิวต์ android:mimeType

หมายเหตุ: การจับคู่ประเภท MIME ในเฟรมเวิร์ก Android จะ คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ ซึ่งต่างจากประเภท MIME ของ RFC อย่างเป็นทางการ ดังนั้น ให้ระบุประเภท MIME โดยใช้ตัวอักษรพิมพ์เล็กเสมอ