AztecEditor Android Download - AztecEditor Android Source Code Download

AztecEditor Android

موارد أخرى

v2.1.4

تنزيل

Aztec: محرر HTML الأصلي لنظام Android

Aztec (الذي يمتد EditText) هو مكون محرر النص الغني لكتابة مستندات HTML في Android.

الحد الأدنى لنسخة Android المدعومة

يمكنك التحقق من الحد الأدنى من إصدار Android المدعوم من خلال النظر في تكوين minSdkVersion داخل Build.gradle.

محرر بصري

ابدء

أعلن عن المكونات الرئيسية في تخطيطك:

محرر بصري

< org .wordpress.aztec.AztecText
    android : id = " @+id/visual "
    android : layout_width = " match_parent "
    android : layout_height = " match_parent "
    android : scrollbars = " vertical "
    android : imeOptions = " flagNoExtractUi "
    aztec : historyEnable = " false " />

محرر المصدر

< org .wordpress.aztec.source.SourceViewEditText
    android : id = " @+id/source "
    android : layout_width = " match_parent "
    android : layout_height = " match_parent "
    android : inputType = " textNoSuggestions|textMultiLine "
    android : scrollbars = " vertical "
    android : imeOptions = " flagNoExtractUi "
    aztec : codeBackgroundColor = " @android:color/transparent "
    aztec : codeTextColor = " @android:color/white " />

شريط الأدوات

< org .wordpress.aztec.toolbar.AztecToolbar
    android : id = " @+id/formatting_toolbar "
    android : layout_width = " match_parent "
    android : layout_height = " @dimen/format_bar_height "
    android : layout_alignParentBottom = " true " />

تضخيم الآراء:

 val visualEditor = findViewById< AztecText >( R .id.visual)
val sourceEditor = findViewById< SourceViewEditText >( R .id.source)
val toolbar = findViewById< AztecToolbar >( R .id.formatting_toolbar)

تكوين Aztec مع لوادر الصور والفيديو المقدمة:

 Aztec . with (visualEditor, sourceEditor, toolbar, context)
    .setImageGetter( GlideImageLoader (context))
    .setVideoThumbnailGetter( GlideVideoThumbnailLoader (context))

لمزيد من الخيارات ، مثل تحرير السجل والمستمعين والمكونات الإضافية ، يرجى الرجوع إلى تطبيق التطبيق التجريبي.

بناء واختبار

قم ببناء المكتبة ، وإنشاء مثال المشروع واختبارات الوحدة:

$ ./gradlew build

تشغيل اختبارات الوحدة فقط:

$ ./gradlew test

قبل تشغيل اختبارات الأجهزة

ينصح إسبرسو تعطيل الرسوم المتحركة على الأجهزة المستخدمة للاختبار:

على جهازك ، ضمن الإعدادات-> تعطيل خيارات المطور الإعدادات الثلاثة التالية:
مقياس الرسوم المتحركة نافذة
مقياس الرسوم المتحركة الانتقالية
مقياس مدة الرسوم المتحركة

هناك حاجة أيضًا إلى خطوة إعداد إضافية للتعامل مع مشكلة إسبرسو بالنقرات (انظر التحذيرات أدناه):

على جهازك ، ضمن الإعدادات -> إمكانية الوصول -> المس والعمل ، قم بتعيين التأخير إلى Long .

قم بتشغيل اختبارات الأجهزة:

$ ./gradlew cAT

دمج Aztec في مشروعك

 repositories {
    maven { url " https://a8c-libs.s3.amazonaws.com/android " }
}

 dependencies {
    api " org.wordpress:aztec:v1.6.2 "
}

يمكن للمطورين الشجعان إما استخدام المشروع كتوزيع مصدر أو الاستمتاع بأحدث لقطة على مسؤوليتهم الخاصة:

 dependencies {
    api " org.wordpress:aztec:trunk-{commit_sha1} "
    // As an example, for '3f004c8c8cd4b53ab9748f42f373cf00a30e9d86' commit sha1, this would look like:
    // api "org.wordpress:aztec:trunk-3f004c8c8cd4b53ab9748f42f373cf00a30e9d86"
}

التعديلات

يمكنك استخدام API لتعديل سلوك Aztec.

عناصر شريط الأدوات

إذا كنت ترغب في الحد من الوظائف التي توفرها مكتبة Aztec ، فيمكنك تغييرها استدعاء طريقة setToolbarItems على AztecToolbar . سيمكن المثال التالي فقط عناصر bold plugins وعناصر list بالترتيب المحدد.

aztecToolbar.setToolbarItems( ToolbarItems . BasicLayout ( ToolbarAction . BOLD , ToolbarItems . PLUGINS , ToolbarAction . LIST ))

يمكنك تعيين عناصر جديدة لا يتم تمكينها افتراضيًا. ToolbarAction.CODE و ToolbarAction.PRE .

يمثل CODE رمز HTML المضمون
يمثل PRE كتلة preformat (بما في ذلك كتلة الكود)

قائمة المهام

هناك نوع قائمة اختياري يمكنك تمكينه في المحرر. بالإضافة إلى القوائم المطلوبة وغير المرتبة ، يمكنك استخدام task list . قائمة المهام هي قائمة غير مرتبة تُظهر وحفظ مربعات الاختيار بدلاً من الرصاص. تمكينها عن طريق استدعاء الطريقة التالية.

aztecToolbar.enableTaskList()

كتل متداخلة

بشكل افتراضي ، يسمح Aztec كتل متداخلة. في بعض الحالات ، لا يجب أن يكون هذا هو السلوك المفضل. هناك خيار لتعطيل الكتل المتداخلة. عند التبديل ، سيقوم هذا المحرر دائمًا بإضافة الوسائط والقاعدة الأفقية بعد الكتلة المحددة حاليًا ، وليس في منتصفها.

aztecText.addMediaAfterBlocks()

API النائب

يدعم Aztec الآن العناصر النائبة لرسم وجهات نظر لا يتم دعمها أصليًا بواسطة edittext و spannable API. تقوم الوظيفة بإنشاء فترة في المحرر المرئي ويرسم عرض Android عليه. يتم تحريك العرض عندما يغير المستخدم أي شيء في المحرر ويسمح لك برسم أشياء مثل الفيديو الذي يمكن تشغيله في المحرر. من أجل استخدام واجهة برمجة التطبيقات (API) ، يجب عليك إنشاء مثيل من PlaceholderManager وتهيئته في مكالمتك onCreate مثل هذا:

 private lateinit var placeholderManager : PlaceholderManager
override fun onCreate ( savedInstanceState : Bundle ? ) {
    placeholderManager = PlaceholderManager (visualEditor, findViewById( R .id.container_frame_layout))
    aztec.addPlugin(placeholderManager)
    aztec.addOnMediaDeletedListener(placeholderManager)
}
override fun onDestroy () {
    placeholderManager.onDestroy()
}

يمكنك إنشاء PlaceholderAdapter مخصص للتحضير ورسم وجهة نظرك. يمكنك التحقق من عينة ImageWithCaptionAdapter التي ترسم طريقة عرض Android بسيطة مع صورة وتسمية توضيحية. ومع ذلك ، يمكنك تنفيذ أشياء مثل عرض YouTube أو عرض Video مع عناصر التحكم في التشغيل. لا تنسَ تسجيل PlaceholderAdapter الخاص بك مثل هذا:

placeholderManager.registerAdapter( ImageWithCaptionAdapter ())

بمجرد تهيئة كل من المدير والمحول ، يمكنك استخدام أساليب المدير لإدراج أو إزالة العناصر النائبة.

placeholderManager.insertItem(adapterType, attributes)
placeholderManager.removeItem(predicate)

تنسيق الكود

نستخدم ktlint ل cotlin linting. يمكنك تشغيل Ktlint باستخدام ./gradlew ktlint ، ويمكنك أيضًا تشغيل ./gradlew ktlintFormat للتركيب التلقائي. لا يوجد أي فكرة مكون إضافي (مثل CheckStyle's) في هذا الوقت.