STTextView

sttextview

Performant MacOS และ iOS TextView พร้อมหมายเลขบรรทัดและอื่น ๆ อีกมากมาย (NSTEXTVIEW/UITEXTVIEW EIMPLEMENTATION)

เป้าหมายของโครงการนี้คือการสร้างส่วนประกอบที่ใช้ซ้ำได้ NstextView/UitextView โดยใช้ Framework TextKit 2 Framework เนื่องจากเหตุผลที่ดีมากมาย

ส่วนประกอบส่วนใหญ่ได้รับการพัฒนาเพื่อตอบสนองความต้องการสตูดิโอ Swift เป็น ตัวแก้ไขซอร์สโค้ด

TextKit 2 ได้รับการประกาศในช่วง WWDC 2021 เพื่อแทนที่ TextKit 1 สำหรับการจัดวางข้อความและอะไรก็ตาม Apple ประกาศว่า NSTextView ซึ่งเป็นส่วนประกอบมุมมองที่เชี่ยวชาญสำหรับการแก้ไขข้อความจะนำ TextKit 2 และให้การสนับสนุนตาม TextKit 1 บิต เมื่อฉันเริ่มเรียนรู้เพิ่มเติมเกี่ยวกับ NSTextView + TextKit2 ฉันก็ตระหนักว่า ณ วันนี้ (ก.พ. 2022) ทั้งคลาส NSTextView และ TextKit 2 ไม่ทำงานอย่างสมบูรณ์ ระหว่างทางฉันรายงานรายงานข้อผิดพลาดหลายฉบับไปยัง Apple ที่ขอ DTS (ตั๋วสนับสนุน) ในที่สุดฉันถูกบล็อกโดยข้อบกพร่องเฉพาะที่ผลักดันให้ฉันเริ่มโครงการนี้

คุณสมบัติ

• การรวมระบบข้อความ MacOS
• การแก้ไขข้อความที่มีประสิทธิภาพ
• แสดงหมายเลขบรรทัด
• แสดงอักขระที่มองไม่เห็น
• การปรับแต่งสีและฟอนต์
• สลับสายปิดและปิด
• ปรับความสูงของเส้น
• ไฮไลต์/เลือกช่วงในมุมมองข้อความ
• การแก้ไขหลายแอร์
• ค้นหา/แทนที่ข้อความ
• การสะกดและไวยากรณ์
• การเขียนตามคำบอก
• การสนับสนุนความสำเร็จที่ปรับแต่งได้
• การเลื่อนเนื้อหายาวอย่างราบรื่น
• LTR (ซ้ายไปขวา) / RTL (ขวาไปซ้าย) เลย์เอาต์
• เลิกทำ/ทำซ้ำ
• ปลั๊กอิน
• คำอธิบายประกอบที่ทอดสมอ (ผ่านปลั๊กอิน)
• การไฮไลต์ไวยากรณ์ซอร์สโค้ด (ผ่านปลั๊กอิน)

sttextview-30-07-2024.mp4

- สนับสนุนและผู้สนับสนุน

ความยั่งยืนทางการเงินของโครงการเป็นไปได้ด้วยการมีส่วนร่วมอย่างต่อเนื่องจากผู้สนับสนุน GitHub ของเรา

️แผนงาน

Stextview มีความเหมาะสมอยู่แล้วในฐานะส่วนประกอบตัวแก้ไขข้อความ อย่างไรก็ตามมันยังคงต้องการการปรับปรุงก่อนที่จะเปิดตัว v1.0

แนะนำ หรือ ลงคะแนน สำหรับคุณสมบัติใหม่: คำขอคุณสมบัติ

ปัญหาที่รู้จัก

• การลากข้อความ (นำไปใช้บางส่วน)

เริ่มต้น

STTextView จัดจำหน่ายโดยใช้ Swift Package Manager ติดตั้งในโครงการโดยการเพิ่มเป็นการพึ่งพาใน Package.swift ของคุณ Manifest หรือผ่าน“ การพึ่งพาแพ็คเกจ” ในการตั้งค่าโครงการ XCode

 let package = Package (
    dependencies : [
        . package ( url : " https://github.com/krzyzanowskim/STTextView " , from : " 1.0.0 " )
    ]
) 

แอปพลิเคชันสาธิต

แอปพลิเคชันตัวอย่าง TextEdit และ TextEdit.swiftui ช่วยให้คุณสำรวจห้องสมุด

ปลั๊กอิน

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

• ซอร์สโค้ดปลั๊กอินซอร์สโค้นไวยากรณ์ที่เน้นด้วยต้นไม้และนีออน
• ปลั๊กอินข้อความพิมพ์เสร็จสมบูรณ์ด้วยรูปแบบข้อความ
• ปลั๊กอินคำอธิบายประกอบที่ยึดคำอธิบายประกอบ (เช่นข้อความแสดงข้อผิดพลาดที่ถูกยึด)) ปลั๊กอิน
• ปลั๊กอินปลั๊กอินปลั๊กอินเทมเพลตที่เก็บปลั๊กอินพร้อมสร้างปลั๊กอินใหม่
• ... เพิ่มปลั๊กอินเพิ่มเติม

การใช้งาน

Swiftui

TextView เป็นมุมมอง Swiftui ที่ห่อหุ้ม StextView

• รองรับข้อความที่หลากหลาย (สตริงที่มีเหตุผล)
• เร็วกว่า swiftui.textedit (https://twitter.com/krzyzanowskim/status/1677628085217243137)

import STTextViewSwiftUI

struct ContentView : View {

    @ State private var text = AttributedString ( " Hello World! " )
    @ State private var selection : NSRange ?

    var body : some View {
        TextView (
            text : $text ,
            selection : $selection ,
            options : [ . wrapLines , . highlightSelectedLine ] ,
            plugins : [ plugin1 ( ) , plugin2 ( ) ]
        )
        . textViewFont ( . preferredFont ( forTextStyle : . body ) )
    }
}

สร้าง TextView

STTextView เป็นคลาสย่อย NSView และสามารถเริ่มต้นได้เช่นเดียวกับมุมมองอื่น ๆ มันมี API ที่คล้ายกับของ NstextView

import STTextView

let textView = STTextView ( )
view . addSubview ( textView )

(macOS) เพิ่มลงในมุมมองเลื่อน

 let textView = STTextView ( )
let scrollView = NSScrollView ( )
scrollView . documentView = textView

 let scrollView = STTextView . scrollableTextView ( )
let textView = scrollView . documentView as! STTextView

ปรับแต่ง

มุมมองข้อความสามารถปรับแต่งได้หลายวิธี

 let paragraph = NSParagraphStyle . default . mutableCopy ( ) as! NSMutableParagraphStyle
// Set the line-height to 110%
paragraph . lineHeightMultiple = 1.1
paragraph . defaultTabInterval = 28

// Default Paragraph style
textView . typingAttributes [ . paragraphStyle ] = paragraph

// Set default font
textView . font = NSFont . monospacedSystemFont ( ofSize : 14 , weight : . regular )

// Set default text color
textView . textColor = . textColor

// Set text value
textView . text = " Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aenean ornare lobortis sem a vulputate. "
textView . addAttributes ( [ . foregroundColor : NSColor . red ] , range : NSRange ( location : 10 , length : 5 ) )

// Wrap/No wrap lines to editor width
textView . isHorizontallyResizable = true

// Highlight the selected line.
textView . highlightSelectedLine = true

เพิ่มรางน้ำด้วยหมายเลขบรรทัด

textView . showLineNumbers = true
textView . gutterView ? . drawSeparator = true

(macOS) เปิดใช้งานอินเทอร์เฟซค้นหาและแทนที่ที่เลือกภายในมุมมองโดยปกติจะเป็นมุมมองเลื่อน

textView . isIncrementalSearchingEnabled = true
textView . textFinder . incrementalSearchingShouldDimContentView = true

- รายการรายงานข้อบกพร่อง 2 TextKit 2

รายการของ TextKit 2 ปัญหาและข้อบกพร่องที่เกี่ยวข้องกับ NSTEXTView และกรอบ TextKit ที่ฉันรายงานไปยัง Apple จนถึงตอนนี้:

• FB9856587: TextKit2 ชิ้นส่วนบรรทัดเพิ่มเติมที่ไม่คาดคิดสำหรับบรรทัดสุดท้าย
• fb9925766: nstextselectionNavigation.deletionRanges ทำงานได้ในตอนท้ายของคำเท่านั้น
• FB9925647: nstextlayoutManager.replacecontents (ในช่วง: ด้วย ateributedString :) ได้รับการบันทึกไว้ แต่ไม่ได้เป็นส่วนหนึ่งของ API สาธารณะ
• FB9907261: nstextElementProvider.replacecontents (ใน: ด้วย :) ไม่ได้แทนที่เนื้อหาตามเอกสาร
• FB9692714: คุณลักษณะการแสดงผลไม่ได้วาดอย่างถูกต้อง
• FB9886911: NstextView ไม่สามารถจัดวางและแสดงเส้นยาวได้อย่างเหมาะสม (อันนี้น่ารังเกียจเพราะมันทำให้มุมมอง "กระโดด" เมื่อใดก็ตาม
• FB9713415: NstextView DrawInsertionPoint (ใน: Color: Turnon) ไม่เคยเรียก
• FB9971054: NSLAYOUTMANAGER.ENUMERATECARETOFFSETINLINEFRAGMENT ไม่สนใจตำแหน่งเริ่มต้น
• FB9971054: NstextView ยืนยันในการเลือกเมื่อตั้งค่าด้วย textKit2
• FB9743449, FB10019859: NSTEXTCONTENTSTORAGE.TextElements (สำหรับ :) ส่งคืนไม่มีองค์ประกอบในขณะที่ enumerAtetextElements จะส่งคืนองค์ประกอบ
• FB11898356: TextSelections (Interactingat: Incontainerat: Anchors: Modifiers: การเลือก: Bounds :) สร้างการเลือกที่ผิดสำหรับสถานที่บางแห่ง
• FB12726775: เอกสารไปยัง nstextParagraph.paragraphcontentRange ไม่ถูกต้อง
• FB13272586: NSTEXTCONTAINER.SIZE ค่าเริ่มต้นไม่ได้เป็นเอกสาร
• FB13290979: NSTEXTCONTAINER.LineFragmentPadding ไม่ส่งผลกระทบต่อการสิ้นสุดของการใช้งานส่วนหนึ่ง
• FB13291926: NstextLayoutManager.usageBoundsfortextContainer Observer ไม่เคยมี trigerred
• FB13789916: NstextInputClient.SetMarkedText ให้ช่วงการเลือก BOGUS สำหรับแป้นพิมพ์จีน
• FB14700414: NstextList ไม่ทำงานตั้งแต่ MacOS 14 (การถดถอย)
• FB15131180: Frame Line Extra TextKit ไม่ถูกต้องและไม่เคารพขนาดส่วนเลย์เอาต์ (การถดถอย)

... ฉันทราบว่ารายการปัญหายังไม่สมบูรณ์ ฉันจัดการกับปัญหาส่วนใหญ่ของปัญหาใน StextView

ทำไม ST?

(คำนำหน้า เซนต์ ย่อมาจาก " s wift s t udio" เพราะ SS ไม่ได้เป็นคำนำหน้าไม่ดีตั้งแต่ปี 1939)

ข้อเสนอแนะหรือข้อเสนอแนะ

เริ่มหัวข้อการสนทนาใหม่หรือคำขอดึง

ฉันชอบที่จะได้ยินจากคุณ! ติดต่อผ่าน X/Twitter @krzyzanowskim, mastodon @krzyzanowskim @mastodon.social

ใบอนุญาต

ใบอนุญาตโอเพ่นซอร์ส

หากคุณกำลังสร้างแอปพลิเคชันโอเพนซอร์ซภายใต้ใบอนุญาตที่เข้ากันได้กับใบอนุญาต GNU GPL V3 คุณสามารถใช้ STTextView ภายใต้ข้อกำหนดของ GPLV3

ใบอนุญาตเชิงพาณิชย์

รับหนึ่งเริ่มจาก€ 5

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