Tambah kawalan editor teks kaya kepada aplikasi berpandukan model

Kawalan editor teks kaya ialah editor berasaskan HTML ringan yang dibina pada CKEditor yang popular. Ia membolehkan anda mencipta, menampal dan mengedit teks berformat dalam aplikasi dipacu model anda. Untuk memformat teks dalam editor, anda boleh menggunakan bar alat editor, memasukkan tag HTML atau menampal teks yang diformatkan daripada aplikasi lain, seperti pelayar web atau Word.

Anda boleh menyesuaikan penampilan, ciri dan tingkah laku editor. Pengalaman teks moden kawalan ditunjukkan dalam tangkapan skrin berikut.

Tangkapan skrin editor teks kaya lalai dalam aplikasi dipacu model.

Pada masa ini, editor teks kaya tersedia sebagai dua pengalaman berbeza:

  • Penyunting teks moden: Pengalaman baharu yang boleh anda dayakan
  • Penyunting teks klasik: Pengalaman lalai

Penambahbaikan editor teks moden

Editor teks moden direka bentuk untuk sejajar dengan antara muka biasa dan intuitif aplikasi Microsoft seperti Outlook, Word, dan OneNote. Kemas kini ini memperkenalkan reka bentuk moden, mod gelap, tema kontras tinggi dan ciri copilot baharu untuk meningkatkan keupayaan penyuntingan teks anda.

Nota

Fungsi tertentu yang tersedia dalam pengalaman editor teks kaya klasik belum tersedia dalam pengalaman moden. Fungsi sedemikian termasuk:

  • Pilihan konfigurasi, seperti yang diterangkan dalam artikel ini untuk pengalaman klasik
  • Sebutan

Dayakan pengalaman editor teks kaya moden

Pengalaman editor teks kaya klasik didayakan secara lalai. Lengkapkan langkah berikut untuk bertukar kepada pengalaman editor teks kaya moden.

  1. Dalam Dynamics 365, klik kanan aplikasi yang anda mahu dayakan pengalaman editor teks kaya moden dan kemudian pilih BUKA DALAM PEREKA BENTUK APLIKASI. Power Apps membuka Pereka Bentuk Aplikasi.
  2. Pada bar perintah, pilih Tetapan. Halaman tetapan dipaparkan.
  3. Dalam anak tetingkap kiri, dalam Tetapan, pilih Ciri. Halaman ciri dipaparkan.
  4. Tetapkan togol kepada Ya untuk mana-mana atau semua pilihan berikut, bergantung pada keperluan anda:
    • Dayakan pengalaman kawalan RichTextEditor moden dan perihalan e-mel: Mendayakan pengalaman kawalan editor teks kaya moden untuk perihalan e-mel. Seting ini mengatasi sebarang penyesuaian yang anda buat sebelum ini pada pengalaman e-mel klasik (lalai) editor teks kaya.
    • Dayakan pengalaman kawalan RichTextEditor moden untuk kawalan lalai: Mendayakan pengalaman editor teks kaya moden untuk tika lalai yang tidak dikonfigurasikan.
    • Dayakan pengalaman kawalan RichTextEditor moden untuk pengarangan nota: Mendayakan pengalaman editor teks kaya moden untuk nota. Seting ini menggantikan sebarang penyesuaian yang anda marah sebelum ini pada pengalaman pengarangan nota klasik (lalai) editor teks kaya.
  5. Pilih Simpan.
  6. Dalam Pereka Bentuk Aplikasi, pilih Terbitkan.

Kembali daripada pengalaman editor teks kaya moden kepada pengalaman klasik

Jika anda perlu kembali kepada pengalaman editor teks kaya klasik, ikut langkah yang sama dalam Dayakan pengalaman editor teks kaya moden, tetapi nyahpilih pilihan yang anda pilih dalam Langkah 4.

Tambah kawalan editor teks kaya pada lajur teks

Konfigurasi berikut tersedia dalam pengalaman editor teks kaya klasik.

Apabila anda memformat lajur teks sebagai teks kaya, kawalan editor teks kaya lalai ditambah secara automatik.

  1. Daftar masuk ke Power Apps.

  2. Dalam anak tetingkap navigasi kiri, pilih Penyelesaian.

  3. Buka penyelesaian dan jadual dalam penyelesaian.

  4. Dalam kawasan Lajur dan data, pilih lajur teks.

    Jika jadual tidak mengandungi lajur teks, pilih + (Lajur baharu) dan masukkan nama untuk lajur.

  5. Dalam Jenis data, pilih > di sebelah kanan Teks dan kemudian pilih pilihan teks kaya yang sesuai berdasarkan sama ada lajur mengandungi satu baris teks atau berbilang baris.

  6. Simpan lajur dan kemudian tambahkannya pada borang.

Tambah kawalan editor teks kaya pada lajur teks dalam borang

Konfigurasi berikut tersedia dalam pengalaman editor teks kaya klasik.

  1. Daftar masuk ke Power Apps.

  2. Dalam anak tetingkap navigasi kiri, pilih Penyelesaian.

  3. Buka penyelesaian dan jadual dalam penyelesaian.

  4. Dalam kawasan Pengalaman data, pilih Borang dan kemudian cari borang yang mengandungi lajur teks yang anda mahu tambah editor teks kaya.

  5. Pilih > Edit > Edit dalam tab baharu.

  6. Pada kanvas reka bentuk borang, pilih, tambah atau cipta lajur teks.

  7. Dalam anak tetingkap sifat lajur, kembangkan senarai Komponen, pilih + Komponen dan kemudian pilih Kawalan Editor Teks Kaya.

  8. Dalam anak tetingkap Kawalan Tambah Editor Teks Kaya, pilih Web , Telefon dan Tablet untuk membenarkan apl yang berjalan pada mana-mana peranti menggunakan editor.

    Jika anda ingin menyesuaikan editor, masukkan URL relatif fail konfigurasinya, sumber web JavaScript yang mengandungi sifat yang anda mahu ubah, dalam kotak Nilai statik . Jika anda membiarkan medan ini kosong, editor menggunakan konfigurasi lalainya.

  9. Pilih Selesai.

  10. Pilih Simpan dan terbitkan untuk menggunakan perubahan anda pada borang.

Sesuaikan kawalan editor teks kaya

Penyesuaian berikut tersedia dalam pengalaman editor teks kaya klasik.

Power Apps Membolehkan anda menukar sifat kawalan Editor Teks Kaya untuk menyesuaikan rupa, ciri dan tingkah lakunya. Untuk menyesuaikan contoh tertentu kawalan, tentukan sifat dan nilainya dalam fail konfigurasi berformat JSON individu. Untuk menyesuaikan konfigurasi global kawalan, ubah sifat dalam fail konfigurasi lalai.

Tahap penyesuaian

Sehingga tiga peringkat, atau lapisan, konfigurasi boleh digunakan untuk menyesuaikan editor teks kaya:

  1. Pada tahap yang paling asas, setiap contoh kawalan mengambil konfigurasinya daripada fail RTEGlobalConfiguration_Readonly.json. Fail adalah baca sahaja, jadi anda tidak boleh mengubah sifat ini secara langsung.
  2. Pada peringkat seterusnya, setiap contoh kawalan mengambil konfigurasinya daripada sifat dalam fail RTEGlobalConfiguration.json, jika ada. Konfigurasi ini dilapisi di atas yang sebelumnya, jadi sifat dalam fail ini menggantikan sifat dinamakan yang sama dalam fail baca sahaja.
  3. Akhir sekali, pada tahap tertinggi, contoh kawalan tertentu mengambil konfigurasinya daripada fail konfigurasi tertentu, jika ada. Konfigurasi ini dilapisi di atas yang sebelumnya, jadi sifat dalam fail ini menggantikan sifat dinamakan yang sama dalam dua fail peringkat rendah.

Kita perlu menambah sedikit kelayakan di sini. Tidak semua hartanah digantikan dengan yang berada dalam konfigurasi peringkat yang lebih tinggi. Sifat extraPlugins digabungkan untuk membolehkan penggunaan pelbagai pemalam luaran dan luar kotak dalam konfigurasi lalai. Itu membolehkan anda mengaktifkan dan menyahaktifkan pemalam seperti yang diperlukan dalam fail konfigurasi untuk contoh kawalan tertentu.

Sesuaikan contoh khusus editor teks kaya

  1. Dalam Visual Studio Kod atau editor teks lain, buat fail dan beri nama yang bermakna.

    Fail RTEGlobalConfiguration.json mengandungi konfigurasi lalai editor teks kaya, atau global. Jika anda menyesuaikan kawalan dalam, katakan, borang hubungan, anda boleh menamakan fail seperti RTEContactFormConfiguration.json.

  2. Salin dan tampal cebisan kod berikut dalam fail:

    {
    "defaultSupportedProps": {
      "propertyName": "value",
      "propertyName": "value",
      "propertyName": "value"
    },
    }
    

    Pasangan propertyName:value terakhir tidak berakhir dengan koma.

  3. Gantikan propertyName dan nilai dengan sifat kawalan editor teks kaya yang anda mahu ubah. · ... Nilai rentetan mesti disertakan dalam tanda petikan.

    Kami menyediakan beberapa contoh konfigurasi untuk anda, tetapi anda boleh menentukan yang lain untuk memenuhi keperluan anda.

  4. Dalam Power Apps, buat sumber web jenis JavaScript (JS) menggunakan fail JSON yang anda buat dalam langkah 1.

  5. Tambah kawalan editor teks kaya pada lajur teks dalam borang dan dalam anak tetingkap Tambah Kawalan Editor Teks Kaya >Nilai statik, masukkan URL relatif sumber web JavaScript.

    Walaupun anda boleh memasukkan URL mutlak sumber web, kami mengesyorkan agar anda memasukkan URL relatif. Dengan cara itu, sumber web masih berfungsi jika anda mengimportnya sebagai penyelesaian ke persekitaran yang berbeza, dengan syarat laluan relatif adalah sama.

    Contohnya, jika URL sumber web ialah https://yourorg.crm.dynamics.com/WebResources/rtecontactform, URL relatif ialah /WebResources/rtecontactform.

  6. Pilih Selesai.

  7. Pilih Simpan dan terbitkan untuk menggunakan perubahan anda pada borang.

Sesuaikan editor teks kaya secara global

Fail RTEGlobalConfiguration.json konfigurasi global yang boleh diedit ialah tahap penyesuaian kedua yang boleh anda gunakan. Secara lalai, fail itu kosong. Ini bermakna bahawa semua tika editor teks kaya menggunakan sifat dalam fail RTEGlobalConfiguration_Readonly.json baca sahaja, melainkan anda mencipta fail konfigurasi untuk tika tertentu kawalan.

Jika keperluan perniagaan anda memerlukan anda menyesuaikan kawalan di mana-mana sahaja, tentukan nilai yang anda perlukan dalam RTEGlobalConfiguration.json fail. Gunakan fail baca sahaja sebagai contoh untuk memastikan anda memasukkan pasangan nilai sifat dalam format yang betul.

Gunakan Copilot untuk memperhalusi teks dalam editor

Penting

  • Ini ialah ciri akses awal. Anda boleh memilih untuk menggunakannya untuk ujian dan penerimaan dalam persekitaran anda.
  • Ciri ini dalam akses awal hanya untuk organisasi baharu. Organisasi sedia ada yang sudah menggunakan ciri ini boleh terus menggunakannya, walaupun mereka belum memilih untuk akses awal.
  • Ciri ini tersedia untuk Dynamics 365 Sales, termasuk aplikasi jualan tersuai yang mempunyai entiti bakal pelanggan dan peluang yang ditambah pada peta tapak.

Copilot menggunakan algoritma pemprosesan bahasa semula jadi untuk membantu menambah baik kandungan bertulis. Anda boleh menambahkan Copilot pada editor teks kaya dan kemudian mendapatkan cadangan untuk meningkatkan tatabahasa, kejelasan atau kualiti keseluruhan teks anda. Ketahui cara menggunakan Copilot dalam editor teks kaya.

Sifat editor teks beraneka

Fail JSON yang menentukan "rupa dan rasa" contoh editor teks kaya mengandungi dua set sifat:

  • Bahagian defaultSupportedProps ini mengandungi sifat pemalam yang menentukan perkara yang boleh dilakukan oleh kawalan. Anda tidak terhad kepada sifat CKEditor dan pemalamnya. Anda juga boleh mengesetkan nilai untuk sifat pemalam yang anda tambah atau cipta.
  • Bahagian sifat individu mengandungi sifat yang menentukan rupa kawalan.

Contoh fail konfigurasi

Kod berikut ialah contoh fail JSON yang mengandungi kedua-dua defaultSupportedProps sifat dan sifat konfigurasi individu. Jika sifat mempunyai nilai lalai, nilai lalai ditunjukkan. Jika sifat tidak mempunyai nilai lalai, nilai sampel ditunjukkan untuk menggambarkan sintaks. Sifat diterangkan dalam dua jadual yang berikut.

"defaultSupportedProps": {
  "height": 185,
  "stickyStyle": {
    "font-size": "9pt",
    "font-family": "'Segoe UI','Helvetica Neue',sans-serif"
  },
  "stickyStyles_defaultTag": "div",
  "font_defaultLabel": "Segoe UI",
  "fontSize_defaultLabel": "9",
  "toolbarLocation": "bottom",
  "toolbar": [
  [ "CopyFormatting" ],
  [ "Font" ],
  [ "FontSize" ],
  [ "Bold" ],
  [ "Italic" ],
  [ "Underline" ],
  [ "BGColor" ],
  [ "TextColor" ],
  [ "BulletedList" ],
  [ "NumberedList" ],
  [ "Outdent" ],
  [ "Indent" ],
  [ "Blockquote" ],
  [ "JustifyLeft" ],
  [ "JustifyCenter" ],
  [ "JustifyRight" ],
  [ "Link" ],
  [ "Unlink" ],
  [ "Subscript" ],
  [ "Superscript" ],
  [ "Strike" ],
  [ "Image" ],
  [ "BidiLtr" ],
  [ "BidiRtl" ],
  [ "Undo" ],
  [ "Redo" ],
  [ "RemoveFormat" ],
  [ "Table" ]
 ],
  "plugins": [["button,toolbar,dialogui,dialog,autogrow,notification,clipboard,textmatch,fakeobjects,link,autolink,basicstyles,bidi,blockquote,panelbutton,panel,floatpanel,colorbutton,colordialog,listblock,richcombo,menu,contextmenu,copyformatting,enterkey,entities,popup,find,floatingspace,font,format,htmlwriter,horizontalrule,indent,indentblock,indentlist,justify,lineutils,openlink,list,liststyle,maximize,undo,menubutton,notificationaggregator,xml,ajax,pastetools,pastefromword,pastetext,preview,table,quicktable,removeformat,resize,selectall,showborders,sourcearea,specialchar,stylescombo,tab,tabletools,tableresize,tableselection,widgetselection,widget,wysiwygarea,textwatcher"]],
  "extraPlugins": "accessibilityhelp,autogrow,autolink,basicstyles,bidi,blockquote,button,collapser,colorbutton,colordialog,confighelper,contextmenu,copyformatting,dialog,editorplaceholder,filebrowser,filetools,find,floatpanel,font,iframerestrictor,indentblock,justify,notification,panel,panelbutton,pastefromword,quicktable,selectall,stickystyles,superimage,tableresize,tableselection,tabletools,uploadfile,uploadimage,uploadwidget",
  "removePlugins": "a11yhelp,codemirror,magicline,scayt,showborders",
  "superimageImageMaxSize": 5,
  "disallowedContent": "form[action]; *[formaction]; script; *[on*]",
  "linkTargets": ["notSet", "_blank"],
},
"attachmentEntity": {
  "name": "msdyn_richtextfiles",
  "fileAttributeName": "msdyn_fileblob"
},
"disableContentSanitization": true,
"disableDefaultImageProcessing": false,
"disableImages": false,
"externalPlugins": [
  {
    "name": "EmbedMedia",
    "path": "/WebResources/msdyncrm_/myplugins/embedmedia/"
  }
],
"imageEntity": {
  "imageEntityName": "msdyn_richtextfiles",
  "imageFileAttributeName": "msdyn_imageblob"
},
"readOnlySettings": {
  "height": 500,
  "showFullScreenExpander": true
},
"sanitizerAllowlist": {
  "attributes": [],
  "cssProperties": [],
  "domains": [],
  "protocols": [],
  "tags": []
},
"showAsTabControl": false,
"showFullScreenExpander": false,
"showHtml": false,
"showPreview": false,
"showPreviewHeaderWarning": false,
"allowSameOriginSandbox": false

defaultSupportedProps

Jadual berikut menerangkan sifat yang paling biasa digunakan, tetapi anda boleh mengkonfigurasikan semua sifat yang disokong oleh CKEditor. Kawalan editor teks kaya menggunakan CKEditor 4.

Sifat Description Nilai lalai
tinggi Menetapkan ketinggian awal kawasan kandungan, dalam piksel. "185"
stickyStyle Menetapkan fon dan saiz editor. Lihat defaultSupportedProps
stickyStyles_defaultTag Mencipta pembungkus di sekeliling teks dalam kawasan kandungan editor. Ia pada mulanya ditetapkan kepada "div", tetapi anda boleh menukarnya kepada "p" atau mana-mana tag alternatif. "div"
font_defaultLabel Menetapkan label fon yang dipaparkan dalam bar alat. Label adalah untuk penampilan sahaja dan tidak berfungsi. Sifat menentukan stickyStyle fon dan saiz editor. "Segoe UI"
fontSize_defaultLabel Menetapkan label saiz fon yang dipaparkan dalam bar alat. Label adalah untuk penampilan sahaja dan tidak berfungsi. Sifat menentukan stickyStyle fon dan saiz editor. "9"
toolbarLocation Menetapkan lokasi bar alat dalam kawasan kandungan editor. Nilai yang disokong ialah "atas" dan "bawah". "bawah"
bar alat Menyenaraikan butang bar alat untuk dipaparkan. Lihat defaultSupportedProps
pasang masuk Menyenaraikan pemalam pratetap yang boleh digunakan oleh editor. Pemalam dalam senarai ini mungkin berbeza daripada pemalam yang dimuatkan, jika extraPlugins dan removePlugins diberi nilai. Jika anda mengesetkan sifat ini kepada rentetan kosong, editor dimuatkan tanpa bar alat. Lihat defaultSupportedProps
extraPlugins Menambah pemalam pada plugins senarai untuk memuatkan lebih banyak pemalam.
Banyak pemalam memerlukan pemalam lain untuk berfungsi. Editor teks kaya menambah mereka secara automatik dan anda tidak boleh menggunakan sifat ini untuk menggantikan mereka. Gunakan removePlugins sebaliknya.
Lihat defaultSupportedProps
removePlugins Menyenaraikan pemalam yang tidak dimuatkan. Gunakannya untuk menukar pemalam yang dimuatkan tanpa menukar plugins senarai dan extraPlugins . Lihat defaultSupportedProps
superimageImageMaxSize Menetapkan saiz maksimum dalam megabait (MB) yang dibenarkan untuk imej terbenam apabila menggunakan pemalam superimage. "5"
tidak dibenarkanKandungan Membolehkan anda menghalang pengguna daripada memasukkan elemen yang anda tidak mahu ada dalam kandungan anda. Anda boleh tidak membenarkan keseluruhan elemen atau mengikut atribut, kelas dan gaya. Lihat defaultSupportedProps
linkTargets Membolehkan anda mengkonfigurasi pilihan sasaran pautan yang tersedia untuk pengguna apabila mereka membuat pautan:
- "notSet": Tiada set sasaran
- "frame": Membuka dokumen dalam bingkai yang ditentukan
- popupWindow": Membuka dokumen dalam tetingkap pop timbul
- "_blank": Membuka dokumen dalam tetingkap atau tab baharu
- "_top": Membuka dokumen dalam badan penuh tetingkap
- "_self": Membuka dokumen dalam tetingkap atau tab yang sama di mana pautan diaktifkan
- "_parent": Membuka dokumen dalam bingkai induk
"notSet", "_blank"

Hartanah individu

Jadual berikut menerangkan lebih banyak sifat yang boleh anda gunakan untuk menyesuaikan kawalan editor teks kaya.

Sifat Description Nilai lalai
attachmentEntity Untuk menguatkuasakan lebih keselamatan pada fail yang dimuat naik dengan menggunakan jadual selain daripada lalai, tetapkan sifat ini dan tentukan jadual yang berbeza.
Sintaks: "name": "tableName", "fileAttributeName": "attributeNameofBlobReference"
Lihat defaultSupportedProps
disableContentSanitization Pembersihan kandungan mengalih keluar beberapa atribut tersuai atau tag daripada kandungan teks kaya. Ia dilumpuhkan secara lalai untuk membenarkan menyalin dan menampal kandungan teks kaya daripada sumber luaran. Sifat ini hanya digunakan untuk mod edit. Apabila kawalan editor dibaca sahaja atau dinyahdayakan, kandungan sentiasa dibersihkan. benar
disableDefaultImageProcessing Secara lalai, imej yang dimasukkan dalam editor dimuat naik ke yang attachmentEntity ditakrifkan dalam konfigurasi. Pengguna luaran mungkin tidak mempunyai keistimewaan untuk melihat kandungan dalam jadual. Sebaliknya, tetapkan sifat ini kepada benar untuk menyimpan imej sebagai rentetan base64 terus dalam lajur yang dikonfigurasikan untuk menggunakan kawalan editor teks kaya. false
disableImages Menentukan sama ada imej boleh dimasukkan dalam editor. Hartanah ini mempunyai keutamaan tertinggi. Apabila sifat ini ditetapkan kepada benar, imej dinyahdayakan, tanpa mengira nilai imageEntity sifat. false
externalPlugins Menyenaraikan pemalam luaran atau pemalam yang anda cipta yang boleh digunakan dalam kawalan editor teks kaya.
Sintaks: "nama": "pluginName", "path": "pathToPlugin" (nilai laluan boleh menjadi URL mutlak atau relatif)
Tiada; lihat defaultSupportedProps untuk contoh
imageEntity Untuk menguatkuasakan lebih keselamatan pada imej dengan menggunakan jadual selain daripada lalai, tetapkan sifat ini dan tentukan jadual yang berbeza.
Sintaks: "imageEntityName": "tableName", "imageFileAttributeName": "attributeNameofBlobReference"
Lihat defaultSupportedProps
readOnlySettings Sifat ini menentukan kelakuan lajur apabila dilihat dalam keadaan baca sahaja atau dinyahdayakan. Anda boleh menentukan sebarang sifat yang disokong. Tiada; lihat defaultSupportedProps untuk contoh
sanitizerSenarai yang dibenarkan Menyenaraikan jenis kandungan lain yang boleh dipaparkan dalam editor. Lihat defaultSupportedProps
showAsTabControl Membolehkan anda memaparkan lebih banyak arahan di atas kawasan kandungan. Mesti ditetapkan kepada benar untuk menggunakan sifat berikut: showFullScreenExpander, showHtml, showPreview, showPreviewHeaderWarning false
showFullScreenExpander Menentukan sama ada editor boleh digunakan dalam mod skrin penuh. showAsTabControl mesti ditetapkan kepada benar. false
showHtml Membolehkan pengguna memaparkan dan mengedit kandungan HTML secara langsung. showAsTabControl mesti ditetapkan kepada benar. false
showPreview Membolehkan pengguna pratonton kandungan editor yang dipaparkan sebagai HTML. showAsTabControl mesti ditetapkan kepada benar. false
showPreviewHeaderWarning Membolehkan anda menunjukkan atau menyembunyikan mesej amaran yang dipaparkan semasa pratonton kandungan. showAsTabControl dan showPreview mesti ditetapkan kepada benar. false
izinkanSameOriginSandbox Membenarkan kandungan dalam editor dianggap daripada asal yang sama dengan apl pemaparan.
Gunakan harta ini dengan berhati-hati. Hanya gunakan kandungan luaran yang dipercayai. Apabila sifat ini ditetapkan kepada benar, sebarang kandungan luaran boleh mempunyai capaian kepada sumber dalaman.
false

Contoh konfigurasi

Konfigurasi sampel berikut mencipta penyesuaian khusus editor teks kaya dalam pengalaman klasik. Anda boleh menggunakannya seperti sedia ada atau sebagai titik lompatan untuk menyesuaikan contoh tertentu editor teks kaya atau secara global.

Tetapkan fon lalai kepada Calibri 11 mata

Tetapkan sifat defaultSupportedProps ini dalam fail konfigurasi anda. Setiap nilai kecuali yang terakhir hendaklah diikuti dengan koma (,).

"font_defaultLabel": "Calibri",
"fontSize_defaultLabel": "11",
"stickyStyle": {
  "font-size": "11pt",
  "font-family": "Calibri/Calibri, Helvetica, sans-serif;"
},

Jadikan kekunci Enter masukkan baris baharu dan bukannya blok perenggan

Secara lalai, menekan kekunci Enter mencipta blok perenggan dengan <p> tag HTML. HTML menggunakan blok perenggan untuk mengumpulkan maklumat, seperti perenggan dalam dokumen Word. Pelayar boleh memformat tag sedikit <p> berbeza, jadi untuk konsistensi visual, anda mungkin mahu menggunakan tag baris baharu atau tag pemisah <br\> baris.

Tetapkan sifat ini defaultSupportedProps dalam fail konfigurasi anda . Ikut nilai ini dengan koma (,) melainkan ia adalah sifat terakhir dalam fail.

"enterMode": 2,

Tampal atau cipta kandungan HTML 5 sahaja

Walaupun kawalan editor teks kaya berfungsi paling baik dengan kandungan HTML 5, anda boleh menggunakan tag HTML 4. Walau bagaimanapun, dalam sesetengah kes, mencampurkan tag HTML 4 dan HTML 5 boleh mewujudkan cabaran kebolehgunaan. Untuk memastikan semua kandungan ialah HTML 5, sediakan semua tag HTML 5 yang disokong dalam allowedContent sifat. Kawalan editor menukar sebarang tag yang tidak patuh kepada setara HTML 5 mereka.

Tetapkan sifat ini defaultSupportedProps dalam fail konfigurasi anda . Ikut nilai ini dengan koma (,) melainkan ia adalah sifat terakhir dalam fail.

"allowedContent": "a(*)[*]{*};abbr(*)[*]{*};address(*)[*]{*};area(*)[*]{*};article(*)[*]{*};aside(*)[*]{*};audio(*)[*]{*};b(*)[*]{*};base(*)[*]{*};bdi(*)[*]{*};bdo(*)[*]{*};blockquote(*)[*]{*};body(*)[*]{*};br(*)[*]{*};button(*)[*]{*};canvas(*)[*]{*};caption(*)[*]{*};cite(*)[*]{*};code(*)[*]{*};col(*)[*]{*};colgroup(*)[*]{*};data(*)[*]{*};datalist(*)[*]{*};dd(*)[*]{*};del(*)[*]{*};details(*)[*]{*};dfn(*)[*]{*};dialog(*)[*]{*};div(*)[*]{*};dl(*)[*]{*};dt(*)[*]{*};em(*)[*]{*};embed(*)[*]{*};fieldset(*)[*]{*};figcaption(*)[*]{*};figure(*)[*]{*};footer(*)[*]{*};form(*)[*]{*};h1(*)[*]{*};h2(*)[*]{*};h3(*)[*]{*};h4(*)[*]{*};h5(*)[*]{*};h6(*)[*]{*};head(*)[*]{*};header(*)[*]{*};hr(*)[*]{*};html(*)[*]{*};i(*)[*]{*};iframe(*)[*]{*};img(*)[*]{*};input(*)[*]{*};ins(*)[*]{*};kbd(*)[*]{*};label(*)[*]{*};legend(*)[*]{*};li(*)[*]{*};link(*)[*]{*};main(*)[*]{*};map(*)[*]{*};mark(*)[*]{*};meta(*)[*]{*};meter(*)[*]{*};nav(*)[*]{*};noscript(*)[*]{*};object(*)[*]{*};ol(*)[*]{*};optgroup(*)[*]{*};option(*)[*]{*};output(*)[*]{*};p(*)[*]{*};param(*)[*]{*};picture(*)[*]{*};pre(*)[*]{*};progress(*)[*]{*};q(*)[*]{*};rp(*)[*]{*};rt(*)[*]{*};ruby(*)[*]{*};s(*)[*]{*};samp(*)[*]{*};section(*)[*]{*};select(*)[*]{*};small(*)[*]{*};source(*)[*]{*};span(*)[*]{*};strong(*)[*]{*};style(*)[*]{*};sub(*)[*]{*};summary(*)[*]{*};sup(*)[*]{*};svg(*)[*]{*};table(*)[*]{*};tbody(*)[*]{*};td(*)[*]{*};template(*)[*]{*};textarea(*)[*]{*};tfoot(*)[*]{*};th(*)[*]{*};thead(*)[*]{*};time(*)[*]{*};title(*)[*]{*};tr(*)[*]{*};track(*)[*]{*};u(*)[*]{*};ul(*)[*]{*};var(*)[*]{*};video(*)[*]{*};wbr(*)[*]{*};",

Tampal atau buat teks biasa sahaja

Tetapkan sifat defaultSupportedProps ini dalam fail konfigurasi anda. Setiap nilai kecuali yang terakhir hendaklah diikuti dengan koma (,).

"enterMode": 2,
"shiftEnterMode": 2,
"allowedContent": "*",
"disallowedContent": "*",
"forcePasteAsPlainText": true,
"toolbar": [],
"removePlugins": "contextmenu,liststyle,openlink,tableresize,tableselection,tabletools",

Tetapkan sifat individu ini dalam fail konfigurasi anda . Ikut nilai ini dengan koma (,) melainkan ia adalah sifat terakhir dalam fail.

"disableImages": true,

Benarkan editor menggunakan skrin penuh

Tetapkan sifat individu ini dalam fail konfigurasi anda . Setiap nilai kecuali yang terakhir hendaklah diikuti dengan koma (,).

"showAsTabControl": true,
"showFullScreenExpander": true,

Tangkapan skrin editor teks kaya, dengan kawalan pengembang skrin penuh diserlahkan.

Benarkan melihat dan mengedit kandungan HTML

Untuk membenarkan pengguna melihat dan mengedit HTML kandungan mereka secara langsung, tunjukkan tab HTML .

Tetapkan sifat individu ini dalam fail konfigurasi anda . Setiap nilai kecuali yang terakhir hendaklah diikuti dengan koma (,).

"showAsTabControl": true,
"showHtml": true,

Tangkapan skrin editor teks kaya, dengan kawalan tab HTML diserlahkan.

Tunjukkan bar alat yang dipermudahkan atau keluarkan sepenuhnya

Secara lalai, bar alat editor mengandungi semua alat pemformatan yang tersedia. Untuk menyediakan bar alat yang dipermudahkan, gunakan sifat dan toolbar tentukan alat yang pengguna boleh gunakan untuk memformat kandungan mereka.

Tetapkan sifat ini defaultSupportedProps dalam fail konfigurasi anda . Ikut nilai ini dengan koma (,) melainkan ia adalah sifat terakhir dalam fail.

"toolbar": [ { "items": [ "FontSize", "Bold", "Italic", "Underline", "BGColor" ] } ],

Tangkapan skrin editor teks kaya, dengan bar alat ringkas diserlahkan.

Untuk mengalih keluar bar alat sepenuhnya, tetapkan nilai kepada toolbar '[]' (dua kurungan persegi).

Tambah senarai fon baharu dan tetapkan MT Skrip Berus 20 piksel sebagai fon lalai

Tetapkan sifat defaultSupportedProps ini dalam fail konfigurasi anda. Setiap nilai kecuali yang terakhir hendaklah diikuti dengan koma (,).

"font_names": "Brush Script MT/'Brush Script MT', cursive;Calibri/Calibri, Helvetica, sans-serif;Calibri Light/'Calibri Light', 'Helvetica Light', sans-serif;"
"font_defaultLabel": "Brush Script MT"
"fontSize_sizes": "8/8px;12/12px;20/20px;32/32px"
"fontSize_defaultLabel": "20"
"stickyStyle": {
  "font-size": "20px",
  "font-family": "'Brush Script MT', cursive"
},

Tangkapan skrin editor teks kaya dengan Skrip Berus sebagai fon lalai dan senarai fon baharu.

Kedudukan bar alat di bahagian atas editor teks kaya

Tetapkan sifat ini defaultSupportedProps dalam fail konfigurasi anda . Ikut nilai ini dengan koma (,) melainkan ia adalah sifat terakhir dalam fail.

"toolbarLocation": "top",

Mulakan editor pada ketinggian 30 piksel dan kembangkan agar sesuai dengan kandungan

Tetapkan sifat defaultSupportedProps ini dalam fail konfigurasi anda. Setiap nilai kecuali yang terakhir hendaklah diikuti dengan koma (,).

"autoGrow_onStartup": false,
"autoGrow_maxHeight": 0,
"autoGrow_minHeight": 30,
"height": 30,

Tangkapan skrin yang menggambarkan bahawa menaip ke dalam kawasan teks kaya atau menampal imej meningkatkannya agar sesuai dengan kandungan.

Betulkan ketinggian editor pada 500 piksel

Tetapkan sifat defaultSupportedProps ini dalam fail konfigurasi anda. Setiap nilai kecuali yang terakhir hendaklah diikuti dengan koma (,).

"removePlugins": [ "autogrow" ],
"height": 500,

Tangkapan skrin yang menggambarkan bahawa dengan ketinggian tetap, apabila kandungan yang mencukupi ditambahkan ke kawasan teks kaya, bar skrol muncul.

Buat menu konteks (klik kanan) menggunakan menu konteks lalai pelayar

Untuk menggantikan menu konteks kawalan editor dengan menu konteks lalai pelayar, alih keluar pemalam contextmenu.

Tetapkan sifat ini defaultSupportedProps dalam fail konfigurasi anda . Ikut nilai ini dengan koma (,) melainkan ia adalah sifat terakhir dalam fail.

"removePlugins": "contextmenu,liststyle,openlink,tableresize,tableselection,tabletools",

Cari konfigurasi kawalan editor teks kaya

Jika anda tidak pasti dari mana konfigurasi contoh editor teks kaya berasal, anda boleh menemuinya menggunakan alat pembangun penyemak imbas anda.

  1. Dalam atau Microsoft Edge Google Chrome, jalankan aplikasi dipacu model anda dan buka borang yang mempunyai kawalan editor teks kaya.
  2. Klik kanan kawasan kandungan editor teks kaya dan pilih Periksa.
  3. Dalam anak tetingkap pemeriksaan, pilih tab Konsol .
  4. Pilih halaman Main.aspx induk dalam kotak senarai pada bar perintah.

Tangkapan skrin alat pembangun penyemak imbas, dengan tab Konsol dan halaman main.aspx diserlahkan.

  1. Pilih ikon Kosongkan konsol pada bar arahan anak tetingkap pemeriksaan, dan kemudian masukkan CKEDITOR.config. dalam konsol.

Tangkapan skrin alat pembangun penyemak imbas, dengan ikon konsol Kosong diserlahkan.

  1. Dalam konsol anak tetingkap pemeriksaan, masukkan CKEDITOR.konfig. untuk memaparkan konfigurasi yang berbeza.

Senarai konfigurasi Editor CK.

  1. Pilih konfigurasi, seperti autoGrow_minHeight, untuk memaparkan tetapan semasa.

Bar alat editor teks kaya

Jadual berikut menerangkan alat pemformatan yang tersedia dalam editor teks kaya secara lalai.

Icon Nama Kekunci pintas Description
Pelukis Format. Salin Pemformatan Ctrl+Shift+C, Ctrl+Shift+V Gunakan rupa bahagian tertentu pada bahagian lain.
Fon. Nama Fon Ctrl+Shift+F Pilih fon. Aplikasi menganggap fon yang anda pilih fon lalai. Segoe UI ialah fon lalai jika anda tidak memilihnya.

Apabila anda memilih kandungan yang diformatkan, nama fon yang digunakan padanya dipaparkan. Jika pilihan anda mengandungi berbilang fon, yang pertama digunakan pada pilihan dipaparkan.
Saiz Fon. Saiz Fon Ctrl+Shift+P Ubah saiz teks anda. Aplikasi menganggap saiz fon yang anda pilih sebagai saiz lalai. 12 ialah saiz lalai jika anda tidak memilih satu.

Apabila anda memilih kandungan yang diformatkan, saiz fon yang digunakan padanya dipaparkan. Jika pilihan anda mengandungi berbilang saiz, saiz pertama yang digunakan pada pilihan dipaparkan.
Tebal. Tebal Ctrl+B Jadikan teks anda tebal.
Italik. Italic Ctrl+I Condongkan teks anda.
Garis bawah. Garis bawah Ctrl+U Garis bawah teks anda.
Warna Serlahan Teks. Warna Latar Belakang Jadikan teks anda menonjol dengan menyerlahkannya dalam warna yang terang.
Warna Fon. Warna Teks Ubah warna teks anda.
Bulet. Masukkan/Keluarkan Senarai Berbulet Cipta senarai berbulet.
Penomboran. Masukkan/Keluarkan Senarai Bernombor Cipta senarai bernombor.
Kurangkan Inden. Kurangkan Inden Alihkan perenggan anda lebih dekat dengan margin.
Tambah Inden. Tambah Inden Alihkan perenggan anda lebih jauh dari margin.
Sekat Sebut Harga. Petikan Blok Gunakan format sebut harga peringkat blok pada kandungan anda.
Jajarkan ke Kiri. Jajar Kiri Ctrl+L Selaraskan kandungan anda dengan margin kiri.
Jajarkan ke Tengah. Sejajarkan Pusat Ctrl+E Letakkan kandungan anda di tengah halaman.
Jajarkan ke Kanan. Jajar Kanan Ctrl+R Laraskan kandungan anda dengan margin yang betul.
Pautan. Paut Buat pautan dalam dokumen anda untuk akses pantas ke halaman web dan sumber awan lain. Masukkan atau tampal teks utama dalam kotak Teks Paparan dan kemudian masukkan atau tampal URL dalam kotak URL .

Secara pilihan, pilih Jenis Pautan dan protokol jika pautan itu ke sesuatu selain daripada halaman web. Untuk menentukan tempat pautan jenis URL harus dibuka, pilih tab Sasaran dan kemudian pilih Sasaran.

URL yang ditampal atau ditaip ditukar secara automatik kepada pautan. Sebagai contoh, http://myexample.com menjadi <a href="http://myexample.com">http://myexample.com</a>.
Alih Keluar Pautan. Nyahpaut Alih keluar pautan daripada sauh dan jadikan ia teks biasa.
Superskrip. Superskrip Taip huruf kecil betul-betul di atas garis teks.
Subskrip. Subskrip Taip huruf kecil betul-betul di bawah garis teks.
Garis Lorek. Garis lorek Keluar teks dengan melukis baris melaluinya.
Masukkan Imej. Image Untuk memasukkan imej, tampalkannya daripada papan keratan anda ke dalam kawasan kandungan atau seret fail imej daripada folder ke kawasan kandungan. Seret mana-mana sudut imej untuk mengubah saiznya. Kawalan menyokong imej .png, .jpg., dan .gif.

Untuk mempunyai lebih kawalan ke atas sumber, penampilan dan tingkah laku imej, pilih butang Imej . Layari ke fail imej dalam folder setempat atau masukkan URLnya. Jika imej disimpan pada pelayan luaran, masukkan laluan mutlak. Jika ia berada pada pelayan tempatan, anda boleh memasukkan laluan relatif. Secara pilihan, masukkan ketinggian dan lebar tertentu untuk mengubah saiz imej dan pilih penjajaran. Anda juga harus memasukkan teks alt untuk menerangkan imej untuk orang yang menggunakan pembaca skrin.

Jika imej juga merupakan pautan ke halaman web atau sumber awan lain, masukkan URL sumber dalam kotak URL Sasaran dan, jika perlu, pilih Sasaran di mana pautan harus dibuka.
Kiri ke Kanan. Arah teks dari kiri ke kanan Tukar teks kepada kiri ke kanan. Tetapan ini adalah lalai.
Kanan ke Kiri. Arah teks dari kanan ke kiri Tukar teks kepada kanan ke kiri untuk kandungan bahasa dua arah.
Membatalkan. Buat asal Terbalikkan perubahan terakhir yang anda buat pada kandungan.
Buat semula. Lakukan semula Buat asal buat asal terakhir anda atau gunakan semula perubahan terakhir yang anda buat pada kandungan.
Kosongkan Semua Pemformatan. Keluarkan Format Alih keluar semua pemformatan daripada teks pilih.
Jadual. Table Masukkan jadual dengan bilangan baris dan lajur yang anda pilih. Untuk mempunyai lebih kawalan ke atas saiz dan rupa jadual, pilih butang Jadual >Lagi · dan ubah sifatnya. Anda juga boleh mengklik kanan jadual untuk melihat dan mengubah sifatnya.

Untuk menukar lebar lajur, seret sempadannya. Anda boleh memilih satu atau lebih sel, baris atau lajur dan menggunakan pemformatan tertentu, menambah pautan ke teks yang dipilih dan memotong, menyalin dan menampal keseluruhan baris atau lajur.
Tetapan Peribadi Tetapkan fon lalai dan saiz fon anda.
Bantuan Kebolehcapaian Alt+0 Buka senarai pintasan papan kekunci yang boleh anda gunakan dalam editor teks kaya.
Kembangkan Bar Alat. Kembangkan Bar Alat Apabila tetingkap terlalu sempit untuk menunjukkan keseluruhan bar alat, pilih untuk mengembangkan bar alat ke baris kedua.

Petua

Untuk menggunakan penyemak ejaan terbina dalam penyemak imbas anda, tekan kekunci Ctrl semasa anda klik kanan teks yang ingin anda semak. Jika tidak, menu klik kanan (konteks) menyediakan pemformatan kontekstual untuk elemen yang anda pilih.
Alternatif kepada penyemak ejaan terbina dalam penyemak imbas anda ialah sambungan penyemak imbas Microsoft Editor. Editor Microsoft berfungsi dengan lancar dengan kawalan editor teks kaya, dan apabila didayakan, menyediakan tatabahasa sebaris dan keupayaan semakan ejaan yang pantas dan mudah.

Gunakan editor teks kaya di luar talian

Kawalan editor teks kaya tersedia apabila anda bekerja di luar talian, walaupun tanpa beberapa ciri dan fungsi yang biasa anda gunakan. Imej yang anda muat naik menggunakan konfigurasi lalai editor tidak tersedia apabila anda bekerja di luar talian.

Pemalam berikut tersedia untuk editor teks kaya apabila ia berada di luar talian:

  • Ajax, autogrow, basicstyles, bidi, blockquote, butang, confighelper, contextmenu, dialog, dialogui, editorplaceholder, enterkey, entiti, fakeobjects, floatingspace, floatpanel, format, horizontalrule, htmlwriter, inden, indenblock, inden list, justify, lineutils, senarai, listblock, memaksimumkan, menu, menubutton, pemberitahuan, pemberitahuan, panelbutton, pop timbul, pratonton, removeformat, ubah saiz, richcombo, selectall, showborders, sourcearea, specialchar, stylescombo, tab, textmatch, textwatcher, bar alat, buat asal, widgetselection, wysiwygarea, xml

Alat pemformatan berikut tersedia dalam editor teks kaya apabila ia berada di luar talian:

  • Senarai tebal, condong, garis bawah, berbulet dan bernombor, kurangkan dan tingkatkan inden, sekat petikan, jajarkan kiri, jajarkan tengah, jajarkan kanan, coretan, teks dua arah, buat asal dan buat semula dan alih keluar pemformatan

Amalan terbaik untuk menggunakan editor teks kaya

  • Medan teks kaya menyimpan tag HTML untuk pemformatan bersama-sama dengan data yang dimasukkan pengguna. Apabila anda menetapkan saiz maksimum medan teks kaya, pastikan anda membenarkan kedua-dua teg HTML dan data pengguna.

  • Untuk prestasi terbaik, pastikan kandungan HTML anda kepada 1 MB atau kurang. Pada saiz yang lebih besar, anda mungkin melihat masa respons yang lebih perlahan untuk memuatkan dan menyunting.

  • Dalam konfigurasi lalai, imej tidak menjejaskan prestasi secara negatif kerana ia disimpan secara berasingan daripada kandungan HTML. Walau bagaimanapun, imej disimpan sebagai kandungan base64 dalam lajur teks apabila pengguna yang memuat naiknya tidak mempunyai kebenaran pada msdyn_richtextfiles jadual. Kandungan Base64 adalah besar, jadi anda biasanya tidak mahu menyimpan imej sebagai sebahagian daripada kandungan lajur.

  • Jika anda mempunyai pentadbir sistem atau peranan keselamatan pengguna asas, ciri pemperibadian pengguna berfungsi secara lalai. Jika anda tidak mempunyai peranan ini, anda mesti mempunyai kelayakan untuk mencipta, membaca dan menulis pada msdyn_customcontrolextendedsettings jadual untuk pemalam pemperibadian pengguna berfungsi.

Soalan lazim

Mengapa aksara yang ditaip lambat dipaparkan?

Jika anda mempunyai banyak kandungan dalam editor, masa respons boleh meningkat. Pastikan kandungan kepada 1 MB atau kurang untuk prestasi terbaik. Semakan ejaan atau tatabahasa juga boleh melambatkan prestasi menaip.

Mengapa saya tidak boleh memuat naik imej? Mengapa pratonton imej gagal dimuatkan?

Jika nama fail imej, termasuk laluan, panjang, fail mungkin gagal dimuat naik atau pratonton mungkin tidak dipaparkan. Cuba pendekkan nama fail atau alihkannya ke lokasi dengan laluan yang lebih pendek, dan kemudian muat naik semula.

Mengapa saya melihat HTML dalam teks saya?

Jika kawalan editor teks kaya digunakan dalam lajur yang tidak diformatkan untuk teks kaya, kandungan muncul dalam HTML asas dan bukannya sebagai teks yang diformatkan.

Tangkapan skrin HTML yang muncul di kawasan kandungan editor.

Untuk menyelesaikan isu ini, lihat pastikan format lajur ditetapkan kepada Teks kaya.

Lihat juga

Nota

Adakah anda boleh memberitahu kami tentang keutamaan bahasa dokumentasi anda? Jawab tinjauan pendek. (harap maklum bahawa tinjauan ini dalam bahasa Inggeris)

Tinjauan akan mengambil masa lebih kurang tujuh minit. Tiada data peribadi akan dikumpulkan (pernyataan privasi).