สัญลักษณ์

ทั้งหมด สัญลักษณ์สามารถใช้ได้ที่ต่างๆบนการแสดงผลภาพได้ ดังนั้นจึงเป็นไปได้ที่จะกำหนดเหล่านี้เป็นตัวแปรหรือข้อความ

เพื่อแสดงสัญลักษณ์บนการแสดงผลภาพ สัญลักษณ์จะถูกประกาศโดยตรงในข้อความด้วยแท็ก [icon:SYMBOLPFAD] พาธของสัญลักษณ์สามารถคัดลอกได้จากไลบรารีสัญลักษณ์ด้วยการคลิกขวาที่เมนูหรือโดยใช้ CTRL+C ควรเลือก Material Symbols เท่านั้น หากเป็นไปได้ เพื่อให้สไตล์ของการแสดงผลภาพเหมือนกัน

ไลบรารีสัญลักษณ์

ทั้งหมด สัญลักษณ์ที่มีอยู่สามารถเรียกใช้และค้นหาได้จากเมนูข้อความ การแสดงผลภาพ สัญลักษณ์ นอกจากนี้ยังสามารถนำเข้าซัทสัญลักษณ์ของตัวเองเข้าไปในไลบรารีได้ การดำเนินการจะถูกอธิบายต่อไปข้างล่าง

หมายเหตุ: ชื่อที่แสดงในรายการสัญลักษณ์ไม่เหมือนกับพาธของสัญลักษณ์ หากไม่ระบุเซทสัญลักษณ์ในพาธ เซท Glyphicons จะถูกใช้โดยอัตโนมัติ

ตัวกรองในไลบรารีสัญลักษณ์จะค้นหาแท็กที่เก็บไว้ด้วย หากไม่ต้องการพฤติกรรมนี้ ตัวกรองสามารถเริ่มต้นด้วย = เพื่อค้นหาเฉพาะชื่อเท่านั้น

เซทสัญลักษณ์ Material Symbols (มาตรฐาน)

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

สัญลักษณ์จะถูกปรับให้กลมโดยอัตโนมัติเมื่อรัศมีของปุ่มกดมีขนาดใหญ่หรือเท่ากับ 16 พิกเซล หากรัศมีเท่ากับ 0px สัญลักษณ์ที่แหลมจะถูกใช้ ในตัวแก้ไขข้อผิดพลาดสัญลักษณ์ปกติจะถูกใช้เสมอ

หมายเหตุ: แนะนำให้ใช้เซทสัญลักษณ์ "Material Symbols" เพื่อให้การแสดงผลภาพมีความเป็นหนึ่งเดียวกัน

เซทสัญลักษณ์ Material Animated

มีสัญลักษณ์ที่เลือกจาก Material Symbols ที่ถูกแอนิเมตเพื่อแสดงค่าสัญลักษณ์เหล่านี้มีแอนิเมชันเดียวกับ สัญลักษณ์ของ โครงสร้าง เมื่อเลือกจะปลดล็อกตัวแปรเพิ่มเติม

เซทสัญลักษณ์ Philips Hue

สัญลักษณ์ของ Philips Hue สามารถใช้ได้อย่างอิสระเมื่อใช้งานอินเตอร์เฟซ Hue นอกจากนี้ยังมีเซทสัญลักษณ์ Hue เพิ่มเติมของชุมชน Home Assistant HASS อีกด้วย ข้อมูลเพิ่มเติมสามารถพบได้ที่ส่วนสุดท้ายของบทนี้

เซทสัญลักษณ์อากาศอากาศ

เซทสัญลักษณ์นี้แสดงสัญลักษณ์อากาศของการแสดงผลภาพ สัญลักษณ์เหล่านี้ได้รับการสนับสนุนอย่างราบรื่นจากหลายอินเตอร์เฟซ ดูบทความต่อไปนี้ สัญลักษณ์อากาศ

เซทสัญลักษณ์ Legacy (เก่า)

เซท สัญลักษณ์ Legacy รวมถึงสัญลักษณ์ทั้งหมดของการแสดงผลภาพเก่าสไตล์การแสดงผลภาพใหม่จะเหมือนกัน สัญลักษณ์เหล่านี้ไม่ควรใช้งานอีกต่อไปเนื่องจากการแสดงผลภาพไม่ได้รับการปรับปรุงให้เหมาะสมกับสไตล์ใหม่

สัญลักษณ์เก่าหลายอย่างยังคงมีแอนิเมชัน:

  • legacy/door
  • legacy/door_2
  • legacy/lock
  • legacy/shutter
  • legacy/shutter_blinds
  • legacy/window
  • legacy/window_tilt

สัญลักษณ์ที่ซ่อนไว้

ยังมีสัญลักษณ์ที่ซ่อนไว้สำหรับการแสดงผลภาพ สัญลักษณ์เหล่านี้จะถูกอธิบายเพิ่มเติมในบทความต่อไปนี้

เพื่อเรียกใช้สัญลักษณ์ ต้องมีเพียง URL-prefix เท่านั้น

เซทสัญลักษณ์ของตัวเอง

สามารถนำเข้าซัท สัญลักษณ์เข้าไปในโครงการได้ ทุกเซท สัญลักษณ์ต้องเตรียมเป็นไฟล์ ZIP ไฟล์ตัวอย่างบางส่วนสามารถดาวน์โหลดได้ที่นี่:

คำแนะนำ: หลังจากการนำเข้าสำเร็จ สามารถส่งออกเซทสัญลักษณ์เป็น .antobj เพื่อให้การนำเข้าได้ง่ายขึ้น คลิกขวาที่เซทสัญลักษณ์และเลือก ส่งออก

กฎต่อไปนี้กำหนดโครงสร้างและความต้องการของเซท สัญลักษณ์ กรุณาอ่านอย่างละเอียดและปฏิบัติตามอย่างเคร่งครัด

กฎ

  • Prefix
    • สามารถมี _, a–z และ 0–9 เท่านั้น
    • ตัวอักษรใหญ่จะถูกแปลงเป็นตัวอักษรเล็กโดยอัตโนมัติ
    • ชื่อที่สงวนไว้เช่น sys, src หรือ doc ไม่มีผล
    • ต้องเริ่มต้นด้วยตัวอักษร (a–z) ตัวเลขเท่านั้นไม่ได้รับอนุญาต
    • Underscore ที่อยู่หลัง (_) จะถูกลบออก
    • ต้องมีความยาวอย่างน้อย 3 ตัวอักษร
    • Underscore หลายตัว (__) จะถูกลดลงเป็นหนึ่งตัว
  • ชื่อสัญลักษณ์
    • จะถูกแปลงเป็นตัวอักษรเล็กโดยอัตโนมัติ
    • ตัวอักษรที่อนุญาตมี -, _, a–z และ 0–9
    • ชื่อที่ยาวเกินไปและ Prefix ควรหลีกเลี่ยง
    • Prefix ต้องเป็นเอกภาพและควรใช้เพียงครั้งเดียว
    • หากสัญลักษณ์มีชื่อและ Prefix เดียวกันกับสัญลักษณ์ระบบ สามารถแทนที่ได้
  • ข้อจำกัดของไฟล์
    • ขนาดไฟล์สูงสุดหลังจากการทำความสะอาด: 10 kB ไฟล์ที่ใหญ่กว่าจะถูกปฏิเสธ
    • ไฟล์ SVG ต้องได้รับการทำความสะอาด:
      • การเปลี่ยนแถวจะถูกลบออกโดยอัตโนมัติ
      • องค์ประกอบต่อไปนี้จะถูกลบออก: <title>, <desc>, <script>, <image>, <style>, <foreignObject>.
      • คุณลักษณะต่อไปนี้จะถูกลบออก: style, fill, stroke, color, stop-color, flood-color, lighting-color.
      • ไอคอนที่มีสคริปต์ที่ฝังอยู่ ภาพ CSS หรือทรัพยากรภายนอกจะถูกปฏิเสธ
      • หาก Styles มีสีหรือบล็อก Style อาจปฏิเสธการนำเข้าได้เช่นกัน
  • ความต้องการของหัวข้อ SVG
    • ต้องมี: viewBox, width และ height ค่าที่ขาดหายไปจะถูกเพิ่มเติมโดยอัตโนมัติ หากเป็นไปได้
    • ต้องมีเนมสเปซ: xmlns="http://www.w3.org/2000/svg" หากขาดหายไปหรือไม่ถูกต้องจะถูกเพิ่มเติมโดยอัตโนมัติ
    • ชื่อไอคอนต้องตรงกับมิติอย่างแม่นยำ ถ้าหากไม่ตรงจะปฏิเสธไอคอน
    • มิติต้องเป็นสี่เหลี่ยมจัตุรัส (ความกว้าง = ความสูง) มาตรฐาน: 24px
    • ควรหลีกเลี่ยง Styles ที่ขัดแย้งและมิติที่ไม่เหมาะสม
  • ทั่วไป
    • ไอคอนที่สร้างขึ้นอย่างไม่ดีอาจทำให้การแสดงผลภาพช้าลงหรือเกิดข้อผิดพลาด
    • ต้องดูแลลิขสิทธิ์ของสัญลักษณ์อย่างเคร่งครัด
    • ทั้งหมดเวกเตอร์จะถูกปรับให้เป็นสามทศนิยม

โครงสร้าง

  • ไฟล์ iconset.ini เป็นสิ่งจำเป็นเพื่อให้ระบบรู้จักเซทสัญลักษณ์
    • สามารถอยู่ในโฟลเดอร์หลักของไฟล์ ZIP หรือในซับโฟลเดอร์ได้
    • ต้องเป็นตัวอักษรเล็ก (iconset.ini)
    • ชื่อไฟล์สัญลักษณ์เองไม่มีความแตกต่างกันในการเขียน
  • การนำเข้าจะค้นหาไฟล์ SVG ไม่โดยตรง
    • โฟลเดอร์ไอคอนต้องถูกกำหนดอย่างชัดเจนใน iconset.ini (ต้องระมัดรักษากับตัวพิมพ์ใหญ่/เล็ก)
    • ในเทมเพลทไฟล์ ZIP โฟลเดอร์ที่ชื่อว่า icons/ ได้ถูกกำหนดไว้
  • ซับโฟลเดอร์
    • ซับโฟลเดอร์ในโฟลเดอร์ที่กำหนด (icons/) เป็นหมวดหมู่
    • ชื่อสัญลักษณ์ต้องเป็นเอกภาพในทุกหมวดหมู่
    • กฎการตั้งชื่อในโฟลเดอร์สัญลักษณ์:
      • ขั้นต่ำ: มีเพียงมิติและนามสกุลไฟล์ (เช่น 24.svg)
      • ตัวแปรที่มี filled24.svg หรือ round_filled_24.svg เป็นสิ่งที่ถูกต้อง
      • ชื่อไฟล์ที่มีตัวเลขหลายตัว (เช่น 24_48.svg) ไม่ถูกต้อง
      • ตัวแปรสไตล์จะถูกตรวจจับโดย:
        • เต็ม: ต้องมี filled หรือ fill
        • กลม: ต้องมี round
        • แหลม: ต้องมี sharp
        • กลมและแหลมไม่สามารถผสมผสานกันได้
      • หากกฎหลายอย่างมีผลไฟล์ที่ตรวจจับล่าสุดจะถูกใช้ (การเลือกอาจดูเหมือนจะเป็นโดยสุ่ม)
  • กฎเพิ่มเติม
    • ไม่มีซับซับโฟลเดอร์ที่ซ้อนซ้อนกันจะถูกค้นหา (เหล่านี้สามารถใช้สำหรับการ 備份 หรือต้นฉบับ)
    • ไฟล์ที่ไม่มี .svg จะถูกลืม
    • ในโฟลเดอร์สัญลักษณ์สามารถมีไฟล์ชื่อ tags.txt เพื่อเพิ่มแท็กเพื่อการค้นหา
      • แท็กสามารถแยกด้วย ,, ; หรือ การเปลี่ยนแถว

เซทสัญลักษณ์พิเศษ

ยังมีเซท สัญลักษณ์ที่ต่างๆ ที่สามารถนำเข้ามาเช่นเดียวกับเซทสัญลักษณ์ของตัวเอง แต่ไม่จำเป็นต้องกำหนดตามข้อกำหนดข้างต้น

Hass Hue Icons

หนึ่งในนั้นคือจากเว็บไซต์ Gibhub hass-hue-icons เซทสัญลักษณ์นี้เป็นเซทสัญลักษณ์ Hue เพิ่มเติมของชุมชน Home Assistant HASS และสามารถใช้ได้เฉพาะในโครงการที่ไม่มีวัตถุประสงค์ทางการค้าเนื่องจากอยู่ภายใต้ Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License ดังนั้นเซทสัญลักษณ์นี้จึงไม่ได้มาพร้อมกับ Antcas Control สัญลักษณ์เหล่านี้สามารถนำเข้ามาในโครงการได้ตลอดเวลาโดยใช้ไฟล์ ZIP hass-hue-icons-main.zip เป็นเซทสัญลักษณ์ใหม่ ควรระมัดระวังเงื่อนไขของการอนุญาตในเว็บไซต์ Github

แหล่งที่มา: https://github.com/arallsopp/hass-hue-icons

Material Design Icons จาก Pictogrammers

อีกอย่างหนึ่งคือจาก Pictogrammers เพื่อทำเช่นนั้นต้องนำไฟล์ mdi-###.json มาแปะเป็นไฟล์ ZIP และนำเข้ามา ไฟล์สามารถค้นหาและดาวน์โหลดได้ในคอนโซลของผู้พัฒนาเว็บเบราว์เซอร์ การผสมสัญลักษณ์ขอบเขตกับสัญลักษณ์ที่เต็มจะถูกทำโดยอัตโนมัติ ไลบรารีเหมือนกันกับ Material Symbols แต่มีการขยายชุมชนมากมาย หากคุณต้องการนำเซทสัญลักษณ์อื่นๆ เข้ามาในไลบรารี คุณสามารถถามเราได้

แหล่งที่มา: https://pictogrammers.com/library/mdi/

หน้าลูก