API การจัดตำแหน่งโฆษณา Anchor ของ CSS

Anchor Positioning API ของ CSS ช่วยให้คุณจัดตำแหน่งองค์ประกอบโดยสัมพันธ์กับองค์ประกอบอื่นๆ ซึ่งเรียกว่า Anchor Positioning API API นี้ช่วยลดข้อกำหนดที่ซับซ้อนของเลย์เอาต์สำหรับฟีเจอร์อินเทอร์เฟซต่างๆ เช่น เมนูและเมนูย่อย เคล็ดลับเครื่องมือ ตัวเลือก ป้ายกำกับ การ์ด กล่องโต้ตอบการตั้งค่า และอื่นๆ อีกมากมาย การวางตำแหน่งจุดยึดที่ฝังอยู่ในเบราว์เซอร์ช่วยให้คุณสร้างอินเทอร์เฟซผู้ใช้แบบเลเยอร์ได้โดยไม่ต้องอาศัยไลบรารีของบุคคลที่สาม ซึ่งเปิดโอกาสให้สร้างสรรค์ได้มากมาย

แนวคิดหลัก: องค์ประกอบหลักและองค์ประกอบที่มีตำแหน่ง

หัวใจของ API นี้คือความสัมพันธ์ระหว่างจุดยึดและองค์ประกอบที่มีตำแหน่ง องค์ประกอบที่กําหนดเป็นจุดอ้างอิงโดยใช้พร็อพเพอร์ตี้ anchor-name องค์ประกอบที่มีตำแหน่งคือองค์ประกอบที่วางสัมพันธ์กับ Anchor โดยใช้พร็อพเพอร์ตี้ position-anchor หรือใช้ anchor-name อย่างชัดแจ้งในตรรกะการจัดตำแหน่ง

ตั้งค่าหมุด

การสร้างหมุดนั้นง่ายมาก ใช้พร็อพเพอร์ตี้ anchor-name กับองค์ประกอบที่เลือก และกำหนดตัวระบุที่ไม่ซ้ำกัน ตัวระบุที่ไม่ซ้ำกันนี้ต้องมีขีดกลาง 2 ขีดอยู่ข้างหน้า คล้ายกับตัวแปร CSS

.anchor-button {
    anchor-name: --anchor-el;
}

เมื่อได้รับชื่อ Anchor แล้ว .anchor-button จะทำหน้าที่เป็น Anchor ที่พร้อมแนะนำตำแหน่งขององค์ประกอบอื่นๆ คุณเชื่อมต่อจุดยึดนี้กับองค์ประกอบอื่นๆ ได้ 2 วิธีดังนี้

โฆษณา Anchor ที่ไม่ระบุ

วิธีแรกในการเชื่อมต่อแท็ก Anchor กับองค์ประกอบอื่นคือใช้แท็ก Anchor แบบไม่เจาะจงปลายทางตามตัวอย่างโค้ดต่อไปนี้ ระบบจะเพิ่มพร็อพเพอร์ตี้ position-anchor ลงในองค์ประกอบที่คุณต้องการเชื่อมต่อกับจุดยึด และมีชื่อของจุดยึด (ในกรณีนี้คือ --anchor-el) เป็นค่า

.positioned-notice {
    position-anchor: --anchor-el;
}

เมื่อใช้ความสัมพันธ์ขององค์ประกอบแอตทริบิวต์ตำแหน่งแบบนัย คุณจะจัดตำแหน่งองค์ประกอบได้โดยใช้ฟังก์ชัน anchor() โดยไม่ต้องระบุชื่อองค์ประกอบแอตทริบิวต์ตำแหน่งอย่างชัดเจนในอาร์กิวเมนต์แรก

.positioned-notice {
    position-anchor: --anchor-el;
    top: anchor(bottom);
}

โฆษณา Anchor ที่อาจไม่เหมาะสม

หรือจะใช้ชื่อ Anchor โดยตรงในฟังก์ชัน Anchor ก็ได้ (เช่น top: anchor(--anchor-el bottom) วิธีนี้เรียกว่าแท็ก Anchor ที่ชัดแจ้ง และมีประโยชน์ในกรณีที่คุณต้องการยึดกับองค์ประกอบหลายรายการ (อ่านตัวอย่างต่อไป)

.positioned-notice {
    top: anchor(--anchor-el bottom);
}

วางองค์ประกอบให้สัมพันธ์กับจุดยึด

การจัดตำแหน่งแบบ Anchor สร้างขึ้นจากการจัดตำแหน่งแบบสัมบูรณ์ของ CSS หากต้องการใช้ค่าการจัดตำแหน่ง คุณต้องเพิ่ม position: absolute ลงในองค์ประกอบที่จัดวางตำแหน่งของคุณได้ จากนั้นใช้ฟังก์ชัน anchor() เพื่อใช้ค่าการจัดตําแหน่ง ตัวอย่างเช่น หากต้องการวางตำแหน่งองค์ประกอบที่ตรึงอยู่ที่ด้านบนซ้ายขององค์ประกอบที่ตรึงอยู่ ให้ใช้ตำแหน่งต่อไปนี้

.positioned-notice {
    position-anchor: --anchor-el;
    /* absolutely position the positioned element */
    position: absolute;
    /* position the right of the positioned element at the right edge of the anchor */
    right: anchor(right);
    /* position the bottom of the positioned element at the top edge of the anchor */
    bottom: anchor(top);
}

ตอนนี้คุณก็มีองค์ประกอบหนึ่งที่ตรึงอยู่กับอีกองค์ประกอบหนึ่ง ดังนี้

หากต้องการใช้ตําแหน่งเชิงตรรกะสําหรับค่าเหล่านี้ ค่าที่เทียบเท่าจะแสดงดังนี้

• top = inset-block-start
• left= inset-inline-start
• bottom = inset-block-end
• right= inset-inline-end

จัดองค์ประกอบที่มีตำแหน่งให้อยู่กึ่งกลางด้วย anchor-center

มีค่าใหม่ที่เรียกว่า anchor-center ซึ่งใช้ได้กับพร็อพเพอร์ตี้ justify-self, align-self, justify-items และ align-items เพื่อให้คุณจัดองค์ประกอบที่อยู่ในตำแหน่งกึ่งกลางโดยเทียบกับแท็ก Anchor ได้ง่ายขึ้น

ตัวอย่างนี้จะแก้ไขตัวอย่างก่อนหน้าโดยใช้ justify-self: anchor-center เพื่อจัดองค์ประกอบที่วางไว้ให้อยู่ตรงกลางเหนือจุดยึด

.positioned-notice {
  position: absolute;
  /*  Anchor reference  */
  position-anchor: --anchor-el;
  /*  Position bottom of positioned elem at top of anchor  */
  bottom: anchor(top);
  /*  Center justification to the anchor */
  justify-self: anchor-center;
}

โฆษณา Anchor หลายรายการ

องค์ประกอบจะยึดกับจุดยึดได้มากกว่า 1 จุด ซึ่งหมายความว่าคุณอาจต้องตั้งค่าตำแหน่งที่สัมพันธ์กับจุดยึดมากกว่า 1 จุด โดยใช้ฟังก์ชัน anchor() และระบุให้ชัดเจนว่า Anchor ที่คุณกำลังอ้างอิงในอาร์กิวเมนต์แรก ในตัวอย่างต่อไปนี้ จากด้านบนซ้ายขององค์ประกอบที่มีตำแหน่งจะตรึงอยู่ด้านขวาล่างของ anchor 1 รายการ และด้านล่างขวาขององค์ประกอบที่อยู่ในตำแหน่งจะยึดกับด้านซ้ายบนของ Anchor ที่ 2

.anchored {
  position: absolute;
  top: anchor(--one bottom);
  left: anchor(--one right);
  right: anchor(--two left);
  bottom: anchor(--two top);
}

ตำแหน่งด้วย position-area

โดย Anchoring API มีกลไกเลย์เอาต์ใหม่ที่ใช้พร็อพเพอร์ตี้ position-area

คุณสมบัตินี้ช่วยให้คุณวางองค์ประกอบที่มีตำแหน่ง Anchor ให้สัมพันธ์กับ Anchor ที่เกี่ยวข้อง และทำงานบนตารางกริดขนาด 9 เซลล์โดยให้องค์ประกอบ Anchor อยู่ตรงกลางได้

หากต้องการใช้ position-area แทนการจัดตำแหน่งแบบสัมบูรณ์ ให้ใช้พร็อพเพอร์ตี้ position-area พร้อมค่าทางกายภาพหรือทางตรรกะ เช่น

• ตรงกลางด้านบน: position-area: top หรือ position-area: block-start
• ซ้ายกลาง: position-area: left หรือ position-area: inline-start
• กึ่งกลางด้านล่าง: position-area: bottom หรือ position-area: block-end
• กึ่งกลางด้านขวา: position-area: right หรือ position-area: inline-end

หากต้องการสำรวจอันดับเหล่านี้เพิ่มเติม ให้ลองใช้เครื่องมือต่อไปนี้

องค์ประกอบของขนาดที่มี anchor-size()

ฟังก์ชัน anchor-size() ซึ่งเป็นส่วนหนึ่งของ Anchor Positioning API สามารถใช้เพื่อปรับขนาดหรือจัดตําแหน่งขององค์ประกอบที่วางตำแหน่ง Anchor โดยอิงตามขนาดของ Anchor (ความกว้าง ความสูง หรือขนาดในบรรทัดและคําสั่ง)

CSS ต่อไปนี้แสดงตัวอย่างของการใช้ค่านี้สำหรับความสูง โดยใช้ anchor-size(height) ภายในฟังก์ชัน calc() เพื่อกำหนดความสูงสูงสุดของเคล็ดลับเครื่องมือให้เป็น 2 เท่าของความสูงของจุดยึด

.positioned-notice {
  position-anchor: --question-mark;

  /*  set max height of the tooltip to 2x height of the anchor  */
  max-height: calc(anchor-size(height) * 2);
}

ใช้องค์ประกอบแอตทริบิวต์ "แองเคอร์" กับองค์ประกอบเลเยอร์บนสุด เช่น ป๊อปอัปและกล่องโต้ตอบ

การวางตำแหน่งจุดยึดทำงานได้ดีกับองค์ประกอบเลเยอร์บนสุด เช่น popover และ <dialog> แม้ว่าองค์ประกอบเหล่านี้จะวางอยู่ในเลเยอร์แยกต่างหากจากส่วนย่อย DOM ที่เหลือ แต่การวางตำแหน่งองค์ประกอบหลักช่วยให้คุณยึดองค์ประกอบเหล่านี้กลับไปยังส่วนย่อย DOM หลักและเลื่อนไปพร้อมกับองค์ประกอบที่ไม่ได้อยู่ในเลเยอร์บนสุดได้ นี่เป็นความสำเร็จที่ยอดเยี่ยมสำหรับอินเทอร์เฟซแบบเลเยอร์

ในตัวอย่างต่อไปนี้ ชุดของป๊อปอัปเคล็ดลับเครื่องมือจะทริกเกอร์ให้เปิดโดยใช้ปุ่ม ปุ่มคือ Anchor ส่วนเคล็ดลับเครื่องมือคือองค์ประกอบที่อยู่ในตำแหน่ง คุณจัดสไตล์องค์ประกอบที่จัดตําแหน่งได้เช่นเดียวกับองค์ประกอบอื่นๆ ที่ยึดไว้ ในตัวอย่างนี้ anchor-name และ position-anchor คือสไตล์ในบรรทัดบนปุ่มและเคล็ดลับเครื่องมือ เนื่องจากแต่ละหมุดต้องมีชื่อหมุดที่ไม่ซ้ำกัน การสร้างเนื้อหาแบบไดนามิกจึงต้องใช้การฝังเป็นวิธีที่ง่ายที่สุด

ปรับตำแหน่งจุดยึดด้วย @position-try

เมื่อคุณมีตำแหน่งจุดยึดเริ่มต้นแล้ว คุณอาจต้องปรับตำแหน่งหากจุดยึดถึงขอบของบล็อกที่บรรจุ หากต้องการสร้างตำแหน่งจุดยึดอื่น คุณสามารถใช้คําสั่ง @position-try ร่วมกับพร็อพเพอร์ตี้ position-try-fallbacks

ในตัวอย่างต่อไปนี้ เมนูย่อยจะปรากฏขึ้นทางด้านขวาของเมนู เมนูและเมนูย่อยใช้ API การกำหนดตำแหน่งจุดยึดร่วมกับแอตทริบิวต์ป๊อปอัปได้เป็นอย่างดี เนื่องจากเมนูเหล่านี้มักจะยึดอยู่กับปุ่มทริกเกอร์

สำหรับเมนูย่อยนี้ หากมีพื้นที่แนวนอนไม่เพียงพอ คุณสามารถย้ายเมนูย่อยไว้ใต้เมนูหลักแทนได้ หากต้องการทำเช่นนี้ ก่อนอื่นให้ตั้งค่าตำแหน่งเริ่มต้น

#submenu {
  position: absolute;
  position-anchor: --submenu;

  /* initial position */
  margin-left: var(--padding);
  position-area: right span-bottom;
}

จากนั้นตั้งค่าตำแหน่ง Anchor สำรองโดยใช้ @position-try ดังนี้

/* alternate position */
@position-try --bottom {
  margin: var(--padding) 0 0 var(--padding);
  posotion-area: bottom;
}

สุดท้าย ให้เชื่อมต่ออุปกรณ์ทั้ง 2 เครื่องด้วย position-try-fallbacks เมื่อรวมทั้งหมดเข้าด้วยกัน รหัสจะมีลักษณะดังนี้

#submenu {
  position: absolute;
  position-anchor: --submenu;
  /* initial position */
  margin-left: var(--padding);
  position-area: right span-bottom;
  */ connect with position-try-fallbacks */
  position-try-fallbacks: --bottom;
}

/* alternate position */
@position-try --bottom {
  margin: var(--padding) 0 0 var(--padding);
  position-area: bottom;
}

คีย์เวิร์ดพลิกอัตโนมัติในตำแหน่งโฆษณา Anchor

หากมีการปรับพื้นฐาน เช่น การพลิกจากบนลงล่างหรือจากซ้ายไปขวา (หรือทั้ง 2 อย่าง) คุณยังข้ามขั้นตอนการสร้างประกาศ @position-try ที่กำหนดเอง และใช้คีย์เวิร์ดการพลิกที่เบราว์เซอร์รองรับในตัว เช่น flip-block และ flip-inline ได้ ค่าเหล่านี้ทำหน้าที่เป็นตัวเทียบข้อมูลสําหรับการประกาศ @position-try ที่กําหนดเอง และใช้ร่วมกันได้

position-try-fallbacks: flip-block, flip-inline, flip-block flip-inline;

การพลิกคีย์เวิร์ดอาจลดความซับซ้อนของโค้ด Anchor ได้อย่างมาก เพียงไม่กี่บรรทัด คุณก็สามารถสร้างจุดยึดที่ทำงานได้อย่างสมบูรณ์พร้อมตำแหน่งอื่นๆ ต่อไปนี้

#my-tooltip {
  position-anchor: --question-mark;
  position-area: top;
  position-try-fallbacks: flip-block;
}

position-visibility สำหรับจุดยึดในแถบเลื่อนย่อย

ในบางกรณี คุณอาจต้องการยึดองค์ประกอบภายในส่วนย่อยของการเลื่อนของหน้า ในกรณีเหล่านี้ คุณควบคุมการแสดง Anchor โดยใช้ position-visibility ได้ หมุดจะอยู่ในมุมมองเมื่อใด ข้อมูลดังกล่าวหายไปเมื่อใด คุณควบคุมตัวเลือกเหล่านี้ได้ด้วยฟีเจอร์นี้ คุณใช้ position-visibility: anchors-visible เมื่อต้องการให้องค์ประกอบที่อยู่ในตำแหน่งดังกล่าวปรากฏในมุมมองจนกว่า Anchor จะอยู่นอกมุมมอง

#tooltip {
  position: fixed;
  position-anchor: --anchor-top-anchor;
  position-visibility: anchors-visible;
  bottom: anchor(top);
}

หรือจะใช้ position-visibility: no-overflow เพื่อไม่ให้ตัวยึดเกินขอบคอนเทนเนอร์ก็ได้

#tooltip {
  position: absolute;
  position-anchor: --anchor-top-anchor;
  position-visibility: no-overflow;
  bottom: anchor(top);
}

การตรวจหาฟีเจอร์และ polyfill

เนื่องจากในขณะนี้มีการจำกัดการรองรับเบราว์เซอร์ คุณอาจต้องการใช้ API นี้อย่างระมัดระวัง ก่อนอื่น คุณสามารถติดต่อขอรับการสนับสนุนได้โดยตรงใน CSS โดยใช้การค้นหาฟีเจอร์@supports โดยวิธีทําคือให้ตัดสไตล์ของ Anchor ไว้ดังนี้

@supports (anchor-name: --myanchor) {

  /* Anchor styles here */

}

นอกจากนี้ คุณยังอาจทำ Polyfill ฟีเจอร์การกำหนดตำแหน่งแท็ก Anchor ได้ด้วย polyfill ของตำแหน่งแท็ก Anchor สำหรับ CSS โดย Oddbird ซึ่งใช้งานได้ใน Firefox 54, Chrome 51, Edge 79 และ Safari 10 Polyfill นี้รองรับฟีเจอร์ตําแหน่งยึดพื้นฐานส่วนใหญ่ แม้ว่าการใช้งานในปัจจุบันจะยังไม่สมบูรณ์และมีไวยากรณ์ที่ล้าสมัย คุณสามารถใช้ลิงก์ unpkg หรือนำเข้าโดยตรงในตัวจัดการแพ็กเกจ

หมายเหตุเกี่ยวกับการช่วยเหลือพิเศษ

แม้ว่า API การจัดตำแหน่งแท็ก Anchor จะทำให้จัดตำแหน่งองค์ประกอบได้โดยสัมพันธ์กับองค์ประกอบอื่นๆ แต่ API ดังกล่าวไม่ได้สร้างความสัมพันธ์เชิงความหมายที่มีความหมายระหว่างองค์ประกอบเหล่านั้นโดยธรรมชาติ หากมีความสัมพันธ์เชิงความหมายระหว่างองค์ประกอบแอตทริบิวต์ "a" กับองค์ประกอบที่มีตำแหน่ง (เช่น องค์ประกอบที่มีตำแหน่งคือความคิดเห็นในแถบด้านข้างเกี่ยวกับข้อความแอตทริบิวต์ "a") วิธีหนึ่งในการทำเช่นนี้คือใช้ aria-details เพื่อชี้จากองค์ประกอบแอตทริบิวต์ "a" ไปยังองค์ประกอบที่มีตำแหน่ง ซอฟต์แวร์โปรแกรมอ่านหน้าจอยังอยู่ระหว่างเรียนรู้วิธีจัดการกับ aria-details แต่การรองรับก็ดีขึ้นเรื่อยๆ

<div class="anchor" aria-details="sidebar-comment">Main content</div>
<div class="positioned" id="sidebar-comment">Sidebar content</div>

.anchor {
  anchor-name: --anchor;
}

.positioned {
  position: fixed;
  position-anchor: --anchor;
}

หากคุณใช้การวางตำแหน่งจุดยึดกับแอตทริบิวต์ popover หรือองค์ประกอบ <dialog> เบราว์เซอร์จะจัดการการแก้ไขการนำทางโฟกัสเพื่อการเข้าถึงที่เหมาะสม คุณจึงไม่จำเป็นต้องแสดงป๊อปอัปหรือกล่องโต้ตอบตามลำดับ DOM อ่านหมายเหตุเกี่ยวกับการช่วยเหลือพิเศษในข้อกำหนด

อ่านเพิ่มเติม

• การวาดเส้นเพื่อเชื่อมต่อองค์ประกอบด้วยการวางตำแหน่งจุดยึด CSS
• CSS ในอนาคต: จุดยืนของ Roman Komarov
• คอลเล็กชัน Codepen ของ Una สำหรับเดโม Anchor
• เครื่องมือจัดตำแหน่งจุดยึด