ResizableTextArea ตัวควบคุม
องค์ประกอบสำหรับการป้อนข้อมูลของผู้ใช้
หมายเหตุ
รหัสแหล่งที่มาของส่วนประกอบและข้อมูลเพิ่มเติมใน ที่เก็บส่วนประกอบของโค้ด GitHub
Description
พื้นที่ข้อความทำให้ผู้คนสามารถป้อนและแก้ไขข้อความได้ ซึ่งถูกใช้ในแบบฟอร์ม กล่องโต้ตอบโมดอล ตาราง และพื้นผิวอื่นๆ ที่จำเป็นต้องป้อนข้อความ
ส่วนประกอบนี้อนุญาตให้ผู้ใช้ปรับขนาดพื้นที่ข้อความเพื่อความสะดวก
หมายเหตุ
รหัสแหล่งที่มาของส่วนประกอบและข้อมูลเพิ่มเติมใน ที่เก็บส่วนประกอบของโค้ด GitHub
คุณสมบัติ
คุณสมบัติที่สำคัญ
| คุณสมบัติ | Description |
|---|---|
Text |
ชุดค่าข้อความในการควบคุม นี่คือคุณสมบัติที่ถูกผูกไว้เริ่มต้นเมื่อใช้ในแอปแบบจำลอง |
Default |
ค่าเริ่มต้นที่ตัวควบคุมจะมีเมื่อตัวควบคุมถูกรีเซ็ต หรือมีการเปลี่ยนแปลงค่าเริ่มต้น ซึ่งช่วยให้ตัวควบคุมทำงานในลักษณะเดียวกันกับตัวควบคุมภายในฟอร์มแอปพื้นที่ทำงาน |
MaxLength |
จำนวนสูงสุดของอักขระที่สามารถป้อนได้ |
HintText |
ข้อความที่จะแสดงเมื่อไม่มีชุดค่าข้อความ |
EmptyPlaceholderText |
ข้อความที่จะแสดงเมื่อไม่มีค่า และตัวควบคุมไม่มีโฟกัส สิ่งนี้ให้สไตล์ที่คล้ายกันเมื่อตัวควบคุมข้อความแบบจำลองซึ่งแสดง --- เมื่อไม่มีค่าเติม |
DefaultHeight |
ความสูงที่จะตั้งค่าพื้นที่ข้อความเป็นค่าเริ่มต้น หากไม่ได้ตั้งค่าไว้ในแอปพื้นที่ทำงาน/หน้าแบบกำหนดเอง ขนาดจะมีค่าเริ่มต้นเป็นความสูงของส่วนประกอบโค้ด สำหรับแอปแบบจำลอง จำเป็นเนื่องจากฟอร์มไม่ได้ระบุความสูงเริ่มต้น |
DefaultWidth |
ความกว้างในการตั้งค่าพื้นที่ข้อความเป็นค่าเริ่มต้น หากไม่ได้ตั้งค่าไว้ในแอปพื้นที่ทำงาน/หน้าแบบกำหนดเอง ขนาดจะมีค่าเริ่มต้นเป็นความสูงของส่วนประกอบโค้ด สำหรับแอปแบบจำลอง ไม่จำเป็น เนื่องจากความกว้างเริ่มต้นจะเป็นความกว้างของคอลัมน์ของฟอร์ม |
MinHeight |
ความสูงขั้นต่ำที่ textarea สามารถปรับขนาดเป็น ตั้งค่าเป็นศูนย์ไม่จำกัด |
MaxHeight |
ความสูงสูงสุดที่ textarea สามารถปรับขนาดเป็น ตั้งค่าเป็นศูนย์ไม่จำกัด |
Min Width |
ความกว้างขั้นต่ำที่ textarea สามารถปรับขนาดเป็น ตั้งค่าเป็นศูนย์ไม่จำกัด |
MaxWidth |
ความกว้างสูงสุดที่ textarea สามารถปรับขนาดเป็น ตั้งค่าเป็นศูนย์ไม่จำกัด |
AllowResize |
กำหนดทิศทางที่ textarea สามารถปรับขนาดได้ ไม่มี ทั้งคู่ แนวตั้งหรือแนวนอน |
EnableSpellCheck |
กำหนดว่า textarea ควรตรวจการสะกดด้วยเบราว์เซอร์หรือไม่ |
คุณสมบัติ Output
| คุณสมบัติ | Description |
|---|---|
Resized Height** (output) - The user adjusted height | ปรับขนาดความกว้าง** (ผลลัพธ์) - ความกว้างที่ผู้ใช้ปรับ |
คุณสมบัติ Style
| คุณสมบัติ | Description |
|---|---|
PaddingLeft |
ช่องว่างภายในเพื่อเพิ่มภายใน textarea |
PaddingRight |
ช่องว่างภายในเพื่อเพิ่มภายใน textarea |
PaddingTop |
ช่องว่างภายในเพื่อเพิ่มภายใน textarea |
PaddingBottom |
ช่องว่างภายในเพื่อเพิ่มภายใน textarea |
Left Padding Adjustment |
ภายในแอปแบบจำลอง แม้ว่าจะซ่อนป้ายกำกับไว้ แต่ก็มีการเติมทางด้านซ้ายขององค์ประกอบโค้ดเพื่อเก็บไอคอน (เช่น ไอคอนล็อก) ในการแก้ไขปัญหานี้ ความกว้างต้องลดลงด้วยการตั้งค่า การปรับปรุงช่องว่างภายในด้านซ้าย เป็น 21 เมื่อมีป้ายกำกับด้วย จะต้องตั้งค่า การปรับปรุงช่องว่างภายในด้านซ้าย เป็นความกว้างของป้ายกำกับ |
RenderBorderStyle |
นี้สามารถเป็นได้ทั้ง ปกติ หรือ ศูนย์กลาง เมื่อตั้งค่าเป็น ปกติ ความกว้างของเส้นขอบจะเพิ่มขึ้นภายในกล่องพื้นที่ข้อความ อย่างไรก็ตาม การใช้ ศูนย์กลาง จะจัดกึ่งกลางเส้นขอบรอบขอบของกล่องพื้นที่ข้อความ ใช้ ศูนย์กลาง เพื่อให้เข้ากันได้กับตัวควบคุม Power Apps Classic และปกติสำหรับตัวควบคุม model-driven และ Fluent UI |
Accessibility Label |
ป้ายชื่อ aria |
ทุกองค์ประกอบไม่ได้นำรูปแบบ/สถานะมาผสมผสานกันทั้งหมด ดู คุณสมบัติสไตล์ขึ้นอยู่กับสถานะ ในคู่มือส่วนประกอบ GitHub
คุณสมบัติ Event
| คุณสมบัติ | Description |
|---|---|
Input Event |
ตั้งค่าคุณสมบัติ Input Event เป็นสตริงที่เริ่มต้นใน SetFocus เพื่อกำหนดโฟกัสที่ส่วนควบคุม คุณต้องใส่คำต่อท้ายแบบสุ่มเพื่อให้เหตุการณ์ทริกเกอร์ |
คุณสมบัติอื่นๆ เหมือนกับมาตรฐาน การควบคุมการป้อนข้อความ
พฤติกรรม
รองรับ SetFocus เป็น InputEvent
ข้อจำกัด
ส่วนประกอบโค้ดนี้ใช้ได้เฉพาะในแอปพื้นที่ทำงาน หน้าที่กำหนดเอง และแอปแบบจำลองเท่านั้น
ดูหมายเหตุข้อจำกัดเพิ่มเติมในส่วน ความท้าทายในการออกแบบ ของคู่มือ GitHub