สัญลักษณ์หัวข้อย่อยที่กำหนดเองที่มี CSS ::marker

Adam Argyle

Oriol Brufau

CSS ::marker ช่วยให้คุณเปลี่ยนแปลงเนื้อหาและสไตล์ของสัญลักษณ์หัวข้อและตัวเลขในรายการ HTML ได้

ข้อมูลเบื้องต้นเกี่ยวกับองค์ประกอบจำลอง

องค์ประกอบจำลองแสดงถึงส่วนในเอกสารที่ไม่ได้แสดงในลําดับชั้นเอกสาร เช่น คุณสามารถเลือกบรรทัดแรกของย่อหน้าได้โดยใช้องค์ประกอบจำลอง p::first-line แม้ว่าจะไม่มีองค์ประกอบ HTML ตัดขึ้นบรรทัดใหม่สำหรับบรรทัดข้อความนั้นก็ตาม

ลองดูรายการที่ไม่มีลําดับของ HTML ต่อไปนี้

<ul>
  <li>Lorem ipsum dolor sit amet consectetur adipisicing elit</li>
  <li>Dolores quaerat illo totam porro</li>
  <li>Quidem aliquid perferendis voluptates</li>
  <li>Ipsa adipisci fugit assumenda dicta voluptates nihil reprehenderit
      consequatur alias facilis rem</li>
  <li>Fuga</li>
</ul>

ซึ่งแสดงผลดังต่อไปนี้เมื่อใช้การจัดรูปแบบเริ่มต้น

ระบบจะสร้างจุดที่จุดเริ่มต้นขององค์ประกอบ <ul> แต่ละรายการเป็นส่วนหนึ่งของการแสดงผลรายการ และไม่มีองค์ประกอบ HTML เป็นของตัวเอง ::marker เป็นองค์ประกอบจำลองที่แสดงจุดนั้น หรือตัวเลขที่จุดเริ่มต้นขององค์ประกอบรายการที่เรียงลำดับ

สร้างเครื่องหมาย

ระบบจะสร้างกล่องเครื่องหมายขององค์ประกอบจำลอง ::marker โดยอัตโนมัติภายในองค์ประกอบรายการลิสต์ทุกรายการ ก่อนทั้งเนื้อหาจริงและองค์ประกอบจำลอง ::before

li::before {
  content: "::before";
  background: lightgray;
  border-radius: 1ch;
  padding-inline: 1ch;
  margin-inline-end: 1ch;
}

โดยปกติแล้วรายการในลิสต์จะเป็นองค์ประกอบ <li> HTML แต่คุณใช้ display: list-item เพื่อเปลี่ยนองค์ประกอบอื่นๆ เป็นรายการในลิสต์ได้

<dl>
  <dt>Lorem</dt>
  <dd>Lorem ipsum dolor sit amet consectetur adipisicing elit</dd>
  <dd>Dolores quaerat illo totam porro</dd>

  <dt>Ipsum</dt>
  <dd>Quidem aliquid perferendis voluptates</dd>
</dl>

dd {
  display: list-item;
  list-style-type: "🤯";
  padding-inline-start: 1ch;
}

จัดรูปแบบเครื่องหมาย

ก่อนที่ ::marker จะพร้อมใช้งาน คุณสามารถจัดรูปแบบรายการได้โดยใช้ list-style-type และ list-style-image เพื่อเปลี่ยนสัญลักษณ์รายการในรายการ ดังนี้

li {
  list-style-image: url(/right-arrow.svg);
  /* OR */
  list-style-type: '👉';
  padding-inline-start: 1ch;
}

::marker เพิ่มความสามารถในการเปลี่ยนสี ขนาด และระยะห่างของเครื่องหมายโดยให้คุณกำหนดเป้าหมายองค์ประกอบสมมติของเครื่องหมายทีละรายการหรือทั้งหมดใน CSS ได้ ดังนี้

li::marker {
  color: hotpink;
}

li:first-child::marker {
  font-size: 5rem;
}

::marker ช่วยให้คุณควบคุมสไตล์เครื่องหมายได้มากกว่า list-style-type มาก แต่ก็ใช้กับพร็อพเพอร์ตี้ CSS บางรายการไม่ได้ พร็อพเพอร์ตี้ที่อนุญาตมีดังนี้

• animation-*
• transition-*
• color
• direction
• font-*
• content
• unicode-bidi
• white-space

เปลี่ยนเนื้อหาของ ::marker โดยใช้ content ไม่ใช่ list-style-type ตัวอย่างถัดไปแสดงวิธีที่พร็อพเพอร์ตี้ของ list-style-type ใช้กับรายการลิสต์ทั้งหมด และ ::marker ช่วยให้คุณกําหนดเป้าหมายเฉพาะช่องเครื่องหมายได้ พร็อพเพอร์ตี้ background ใช้กับ list-style-type ได้ แต่ไม่สามารถใช้กับ ::marker

li:nth-child(1) {
  list-style-type: '?';
  font-size: 2rem;
  background: hsl(200 20% 88%);
  animation: color-change 3s ease-in-out infinite;
}

li:nth-child(2)::marker {
  content: '!';
  font-size: 2rem;
  background: hsl(200 20% 88%);
  animation: color-change 3s ease-in-out infinite;
}

เปลี่ยนเนื้อหาของเครื่องหมาย

ตัวอย่างวิธีกำหนดสไตล์เครื่องหมายมีดังนี้

เปลี่ยนรายการทั้งหมดในรายการ

li {
  list-style-type: "😍";
}

/* OR */

li::marker {
  content: "😍";
}

เปลี่ยนรายการในรายการเพียงรายการเดียว

li:last-child::marker {
  content: "😍";
}

กําหนดเครื่องหมายด้วย SVG

li::marker {
  content: url(/heart.svg);
  content: url(#heart);
  content: url("data:image/svg+xml;charset=UTF-8,<svg xmlns='http://www.w3.org/2000/svg' version='1.1' height='24' width='24'><path d='M12 21.35l-1.45-1.32C5.4 15.36 2 12.28 2 8.5 2 5.42 4.42 3 7.5 3c1.74 0 3.41.81 4.5 2.09C13.09 3.81 14.76 3 16.5 3 19.58 3 22 5.42 22 8.5c0 3.78-3.4 6.86-8.55 11.54L12 21.35z' fill='none' stroke='hotpink' stroke-width='3'/></svg>");
}

เปลี่ยนรายการตามลำดับ

แล้ว <ol> ล่ะ เครื่องหมายในรายการแบบจัดลำดับจะเป็นตัวเลขโดยค่าเริ่มต้น ไม่ใช่จุดหรือ "สัญลักษณ์หัวข้อ" ใน CSS องค์ประกอบเหล่านี้เรียกว่าตัวนับ และจะมีพร็อพเพอร์ตี้สำหรับตั้งค่าหรือรีเซ็ตตำแหน่งเริ่มต้นและสิ้นสุดของตัวเลข หรือเปลี่ยนเป็นตัวเลขโรมัน เป็นต้น คุณใช้ ::marker เพื่อจัดรูปแบบเคาน์เตอร์ได้ด้วย และยังสามารถใช้ค่าเนื้อหาเครื่องหมายเพื่อสร้างการนำเสนอการนับของคุณเอง

li::marker {
  content: counter(list-item) "› ";
  color: hotpink;
}

แก้ไขข้อบกพร่อง

เครื่องมือสำหรับนักพัฒนาเว็บใน Chrome ช่วยให้คุณตรวจสอบ แก้ไขข้อบกพร่อง และแก้ไขสไตล์ที่ใช้กับ::markerองค์ประกอบจำลองได้

แหล่งข้อมูล

ดูข้อมูลเพิ่มเติมเกี่ยวกับ ::marker ได้จากแหล่งต่อไปนี้

• รายการ มาร์กเกอร์ และตัวนับ CSSจาก Smashing Magazine
• การนับด้วยตัวนับ CSS และตาราง CSSจาก CSS-Tricks
• การใช้ตัวนับ CSSจาก MDN